Cordova Plugin for TalkingData Analytics SDK 集成文档
Cordova Plugin for TalkingData Analytics SDK 适用于 Cordova 和 PhoneGap 跨平台项目。
集成方式
-
下载项目到本地目录:
git clone https://github.com/TalkingData/TalkingData-Analytics-SDK-Cordova-Plugin.git
-
访问 TalkingData 官网 下载最新版本的 Android 和 iOS 平台 Analytics SDK。Plugin 中的 SDK 可能不是最新版本,需要检查并使用刚刚下载的新版本,进入克隆到本地的 Plugin 目录:
-
Android 平台
使用最新版本 SDK 的jar
包替换 Plugin 中的src\android\TalkingData.jar
文件。 -
iOS 平台
使用最新版本 SDK 的.h
头文件和.a
静态库文件替换 Plugin 中src\ios
文件夹下的同名文件。
之后,参考 Analytics SDK 集成文档 配置工程。
-
-
进入 Cordova 工程目录,执行下面的命令添加 Plugin
cordova plugin add "[Plugin 路径]"
-
访问 TalkingData 官网 注册帐号并按照提示申请
AppId
。 -
使用申请到的
AppId
在 Cordova 工程的 Native 代码中集成 SDK 并初始化。-
Android 平台
在继承自CordovaActivity
类型的 JAVA 类文件,比如%Cordova工程目录%\platforms\android\src\com\talkingdata\demo\MainActivity.java
中,找到onCreate
方法,加入下面的初始化代码:TCAgent.LOG_ON = true; TCAgent.init(this, "[Your AppId]", "[Your ChannelId]"); TCAgent.setReportUncaughtExceptions(true);
[Your AppId]
就是刚刚申请的 AppId,[Your ChannelId]
是应用的渠道号。 -
iOS 平台
在%Cordova工程目录%\/platforms/ios/demo/Classes/AppDelegate.m
文件中,找到方法(BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
,添加下面的代码:[TalkingData setSignalReportEnabled:YES]; [TalkingData setLogEnabled:YES]; [TalkingData sessionStarted:@"[Your AppId]" withChannelId:@"[Your ChannelId]"];
同样的,
[Your AppId]
就是刚刚申请的 AppId,[Your ChannelId]
是应用的渠道号。
-
-
编译工程:
cordova build
Demo
下面的 Demo 中演示了不同平台上的集成方式,包括 Demo 的创建过程: