Cosos Analytics 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

results matching ""

    No results matching ""