Cosos Analytics Android SDK 接入文档

SDK下载

Android SDK

导入 SDK

将 SDK 的 jar 包合并到目标工程的构建路径

Eclipse ADT 17 以上版本用户

使用 Eclipse ADT 17 以上版本的用户，请在工程目录下建一个文件夹 libs，把 jar 包直接拷贝到这个文件夹下，然后刷新下 Eclipse 中的工程就好了。

Eclipse ADT 17 以下版本用户

使用 Eclipse ADT 17 以下版本的用户，通过右键点击工程根目录，选择 Properties -> Java Build Path -> Libraries，然后点击 Add External JARs... 选择指向 jar 的路径，点击 OK，即可导入成功。

Android Studio 接入

将 jar 文件放到 libs 目录下，并在 build.gradle 文件的对应位置添加 compile 字段：

...
dependencies {
    ...
    compile files('libs/libcocosanalytics.jar')
    ...
}
...

添加权限

在 AndroidManifest.xml 文件的 manifest 标签内添加属性

<manifest …="">
    ...
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <application ...>
        ...
    </application>
    ...
</manifest>

权限说明：

权限	用途
android.permission.INTERNET（必须）	发送日志到我们的服务器
android.permission.ACCESS_NETWORK_STATE（必须）	检测设备网络状态
android.permission.ACCESS_FINE_LOCATION（可选）	获取用户的地理位置

SDK 初始化

当前 SDK 仅提供代码方式的初始化，请在入口 Activity 的 onCreate() 中调用初始化接口，接口如下：

CAAgent.init(
    Context context,
    String appID,       // 游戏 ID
    String storeID,     // 分发渠道
    String engine,      // 游戏引擎 默认 “Cocos”
);

最后，所有的 Activity（包括入口 Activity）中的 onResume() 和 onPause() 都需要调用接口：

@Override
public void onResume() {
    super.onResume();
    CAAgent.onResume(this);
}
@Override
public void onPause() {
    super.onPause();
    CAAgent.onPause(this);
}

本地调试

SDK 还提供了 CAAgent.enableDebug(boolean) 来开启/关闭本地日志的输出。调试成功后，设置为 False 或者移除此方法。SDK 所有日志的 Tag 统一为 CocosAnalytics

初始化