Flutter SDK
诸葛io移动统计支持Flutter框架，以下为集成方法。
1.在项目中添加安装插件
在Flutter项目的pubspec.yaml文件中添加zhugeio依赖包
dependencies:
# zhugeio flutter plugin
zhuge: <1.0.5
执行flutter packages get 命令安装插件
flutter packages get
请参考：Flutter官网文档
2.Android端
2.1 添加诸葛分析所需相关权限：
注意：4.0.2版本开始不再需要如下权限，如使用老版本，需进行权限声明
### 2.2 添加项目依赖
dependencies { implementation 'io.github.zhugefe:zhugeio-analytics:4.0.2' }
### 2.3 初始化SDK
通过代码配置AppKey及Channel并启动；
若你希望通过代码传递appKey及渠道信息,请使用ZhugeParam实体类来定义信息，然后使用该参数初始化SDK：
import com.zhuge.analysis.stat.ZhugeParam; import com.zhuge.analysis.stat.ZhugeSDK;
public class MainActivity extends FlutterActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ZhugeParam param = new ZhugeParam.Builder().appKey("appkey") .appChannel("channel") .build(); ZhugeSDK.getInstance().initWithParam(getApplicationContext(), param); } }
若是私有部署的用户，需要更改数据上传地址，请将上述`onCreate()`里的代码更改为：
@Override public void onCreate(){ Super.onCreate(); ... ZhugeParam param = new ZhugeParam.Builder() .appKey("app key") .appChannel("your app channel") .uploadEventUrlAndBackupUrl('上报地址', '备用上报地址') //设置上传地址，普通用户请勿更改 .build(); ZhugeSDK sdk = ZhugeSDK.getInstance(); sdk.initWithParam(context, param); ...
}
## 3.iOS端
### 3.1 项目目录下执行`pod install`，依赖原始的SDK
cd ios pod install
### 3.2 用应用的Appkey启动诸葛io SDK
import "Zhuge.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[[Zhuge sharedInstance] startWithAppKey:@"Your AppKey" launchOptions:launchOptions];
}
若是私有部署的用户，需要更改数据上传地址，请将上述代码更改为：
#import "Zhuge.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[[Zhuge sharedInstance] setUploadURL:@"URL" andBackupUrl:@"BackUpURL"];
[[Zhuge sharedInstance] startWithAppKey:@"Your AppKey" launchOptions:launchOptions];
}
如果你需要修改SDK的默认设置，如设置版本渠道时，一定要在startWithAppKey前执行；代码如下：
Zhuge *zhuge = [Zhuge sharedInstance];
// 实时调试开关
// 设置为YES，可在诸葛io的「实时调试」页面实时观察事件数据上传
// 建议仅在需要时打开，调试完成后，请及时关闭
[zhuge.config setDebug : NO];
// 自定义应用版本
[zhuge.config setAppVersion:@"0.9-beta"]; // 默认是info.plist中CFBundleShortVersionString值
[zhuge.config setChannel:@"My App Store"]; // 默认是@"App Store"
// 开启行为追踪
[zhuge startWithAppKey:@"Your AppKey" launchOptions:launchOptions];
## 4.Flutter中使用插件
在具体dart文件中导入`zhuge.dart`
import 'package:zhuge/zhuge.dart';
### 4.1 记录用户行为
在需要记录用户行为的部分，调用如下方法：
Zhuge.track('事件名称',{'属性1':'值1','属性2':'值2'});
**注意：**在添加事件属性时，需注意事件属性类型。如果事件属性类型为「数值型属性」，需要上传数据时修改数据类型为「数值型」，并且在诸葛io后台埋点管理中修改为「数值型」。
### 4.2 绑定用户信息
为了保持对用户的跟踪，你需要为他们记录一个识别码，可以使用手机号、email等唯一值来作为用户的识别码。另外，也可以在跟踪用户的时候， 记录用户更多的属性信息，便于你更了解你的用户：
Zhuge.identify('用户ID',{'用户属性':'用户值'}) ```
隐私政策说明
SDK简介
- SDK名称：诸葛IO SDK
- SDK开发者：北京诸葛云游科技有限公司
- 主要功能：支持采集基础数据，用于对应用的新增、激活、留存等统计性指标进行分析。