• 极光统计 Android SDK 集成指南
    • 使用提示
    • 产品说明
      • 主要场景：
      • janalytics-android-release-2.x.y.zip 集成压缩包内容
      • Android SDK 版本
      • Gradle 版本
    • 创建应用
      • 创建极光开发者帐号
      • Portal上创建应用
      • 查看应用信息
    • JCenter 自动集成方式
    • 本地工程配置
    • 添加代码
      • 基础 API
      • 更多 API
      • 运行 demo
    • 技术支持

    极光统计 Android SDK 集成指南

    使用提示

    本文是JAnalytics Android SDK 标准的集成指南文档。

    匹配的 SDK 版本为：v1.0.0及以后版本。

    • 如果您想要快速地测试、请参考本文在几分钟内跑通Demo。
    • 极光推送文档网站上，有相关的所有指南、API、教程等全部的文档。包括本文档的更新版本，都会及时地发布到该网站上。

    产品说明

    利用事件模板统计App用户的行为事件并上报给极光服务器，极光提供加工过的数据通过WebPortal展示给开发者，让开发者更加了解自己的应用在用户手中的使用情况。

    主要场景：

    1. 1.统计页面流
    2. 2.统计自定义计数事件
    3. 3.统计自定义计算事件
    4. 4.动态圈选功能（JAnalytics2.0.0开始支持）

    janalytics-android-release-2.x.y.zip 集成压缩包内容

    • AndroidManifest.xml
      • 客户端嵌入SDK参考的配置文件
    • libs/jcore-android_v1.x.x.jar
      • sdk 核心包
    • libs/xxx/xx.so
      • sdk需要用的so文件
    • libs/janalytics-android-sdk_v2.x.x.jar
      • SDK analysis 开发包
    • example
      • 是一个完整的 Android 项目，通过这个演示了 JAnalysis SDK 的基本用法，可以用来做参考。

    Android SDK 版本

    目前SDK只支持Android 2.3或以上版本的手机系统。 动态圈选功能只支持Android4.2或以上版本的手机系统。

    Gradle 版本

    动态圈选功能建议使用gradle版本为3.3，gradle插件版本2.3.2。 在gradle-wrapper.properties里配置 distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip

    创建应用

    创建极光开发者帐号

    请访问极光推送官方网站 注册您的极光账号。

    jpush_android_guide

    Portal上创建应用

    使用注册账号登陆，进入极光控制台后，点击“创建应用”按钮，进入创建应用的界面。填上你的应用程序的名称以及应用包名这二项就可以了，最后点击最下方的 “创建我的应用”按钮，创建应用完毕。

    jpush_android_guidejpush_android_guide

    查看应用信息

    创建应用之后返回用户主页面可以看到应用清单，点选你刚才创建的应用来查看应用信息。

    jpush_android_guide

    JCenter 自动集成方式

    说明1 ： 使用jcenter自动集成的开发者，不需要在项目中添加jar，jcenter会自动完成依赖；jcenter 也会自动导入 JAnalytics 所需的权限和 meta-data 节点进你项目的 AndroidManifest 中。 说明2 ： 想添加动态圈选功能的开发者，将以下集成步骤与动态圈选相关的配置加上即可

    • 确认android studio的 Project 根目录的主 gradle 中配置了jcenter支持。
    1. buildscript {
    2.     repositories {
    3.         jcenter()
    4.     }
    5.     ......
    6.     dependencies {
    7.         //gradle建议版本
    8.         classpath 'com.android.tools.build:gradle:2.3.2'
    9.         //可选: 动态圈选plugin
    10.         classpath 'cn.jiguang.android:janalytics-gradle-plugin:2.0.0'
    11.     }
    12. }
    14. allprojects {
    15.     repositories {
    16.         jcenter()
    17.     }
    18. }
    • 在 module 的 gradle 中添加依赖和AndroidManifest的替换变量。
    1. //可选：动态圈选需要的插件。如果已经集成了动态圈选功能，又想关闭，只注释掉这行配置代码即可
    2. apply plugin: 'cn.jiguang.android.analytics'
    4. android {
    5.     ......
    6.     defaultConfig {
    7.         applicationId "com.xxx.xxx" // 你应用的包名.
    8.         ......
    10.         manifestPlaceholders = [
    11.             JPUSH_APPKEY : "你的appkey", //JPush上注册的包名对应的appkey.
    12.             JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
    13.         ]
    14.         ......
    15.     }
    16.     ......
    17. }
    19. dependencies {
    20.     ......
    22.     compile 'cn.jiguang.sdk:janalytics:2.0.0' // 此处以JAnalytics 2.0.0 版本为例。
    23.     compile 'cn.jiguang.sdk:jcore:1.2.6' // 此处以JCore 1.2.6 版本为例。
    24.     ......
    25. }
    • 可选：动态圈选功能，需要在你的AndroidManifest.xml里，主页面Activity标签下添加intent-filter，以实现扫码唤出圈选功能
    1. <!-- 应用主页面-->
    2. <activity
    3.     android:name=".MainActivity"
    4.     android:exported="true"
    5.     android:label="@string/app_name"
    6.     android:launchMode="singleTask">
    7.     <intent-filter>
    8.         <action android:name="android.intent.action.MAIN" />
    9.         <category android:name="android.intent.category.LAUNCHER" />
    10.     </intent-filter>
    11.     <!--可选：动态圈选需要单独添加这个intent-filter 区块-->
    12.     <intent-filter>
    13.         <action android:name="android.intent.action.VIEW" />
    14.         <category android:name="android.intent.category.DEFAULT"/>
    15.         <category android:name="android.intent.category.BROWSABLE"/>
    16.         <data android:scheme="jiguang-您应用的APPKEY" android:host="jiguang" />
    17.     </intent-filter>
    18. </activity>

    本地工程配置

    说明 ： 想添加动态圈选功能的开发者，需要将以下集成步骤与动态圈选相关的配置加上即可

    • 解压压缩包，将libs下的所有文件复制到工程的libs下面.
      • jcore 和 janalytics 两个 jar 文件。
      • 所有 CPU 平台的 so 文件。
    • 配置 AndroidManifest:
    1.      <!-- 必需  一些系统要求的权限，如 访问网络等-->
    2.     <uses-permission android:name="android.permission.INTERNET" />
    3.     <uses-permission android:name="android.permission.WAKE_LOCK" />
    4.     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    5.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    6.     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    7.     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    8.     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    10.     <!-- 可选 -->
    11.     <uses-permission android:name="android.permission.VIBRATE" />
    12.     <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    13.     <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    14.     <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
    15.     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
    16.     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    17.     <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    18.     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    19.     <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    20.     <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    21.     <uses-permission android:name="android.permission.GET_TASKS" />
    23.     <activity
    24.         android:name=".MainActivity"
    25.         android:exported="true"
    26.         android:label="@string/app_name"
    27.         android:launchMode="singleTask">
    28.         <intent-filter>
    29.             <action android:name="android.intent.action.MAIN" />
    30.             <category android:name="android.intent.category.LAUNCHER" />
    31.         </intent-filter>
    32.         <!-- 可选：动态圈选需要在主页面Activity标签下添加这个intent-filter 区块，以实现扫码唤出圈选功能-->
    33.         <intent-filter>
    34.             <action android:name="android.intent.action.VIEW" />
    35.             <category android:name="android.intent.category.DEFAULT"/>
    36.             <category android:name="android.intent.category.BROWSABLE"/>
    37.             <data android:scheme="jiguang-您应用的APPKEY" android:host="jiguang" />
    38.         </intent-filter>
    39.     </activity>
    41.     <!-- 可选： 动态圈选圈选必要的Activity-->
    42.     <activity android:name="cn.jiguang.analytics.android.view.BuryWebActivity"
    43.             android:theme="@android:style/Theme.NoTitleBar"
    44.             android:screenOrientation="portrait"/>
    46.     <!-- 配置appkey：从 portal 上应用信息中获取 AppKey，并填写你的 Channel-->
    47.     <meta-data android:name="JPUSH_APPKEY" android:value="Your AppKey"/>
    48.     <meta-data android:name="JPUSH_CHANNEL" android:value="Your Channel"/>
    • 可选：动态圈选功能，在android studio的 Project 根目录的主 gradle 中配置插件支持。
    1. buildscript {
    2.     repositories {
    3.         jcenter()
    4.     }
    5.     ......
    6.     dependencies {
    7.         //gradle建议版本
    8.         classpath 'com.android.tools.build:gradle:2.3.2'
    9.         //可选: 动态圈选plugin
    10.         classpath 'cn.jiguang.android:janalytics-gradle-plugin:2.0.0'
    11.     }
    12. }
    14. allprojects {
    15.     repositories {
    16.         jcenter()
    17.     }
    18. }
    • 可选：动态圈选功能，在 module 的 gradle 中添加插件依赖。如果已经集成了动态圈选功能，又想关闭，只注释掉这行配置代码即可
    1. apply plugin: 'cn.jiguang.android.analytics'
    • 混淆相关：在混淆文件中添加以下配置，防止 sdk 的接口被混淆。
    1.     -keep public class cn.jiguang.analytics.android.api.** {
    2.         *;
    3.     }

    添加代码

    基础 API

    • 初始化 sdk ： 传入 application 的 context 来初始化 sdk 。
    1. JAnalyticsInterface.init(Context context);
    • 设置调试模式：参数为 true 表示打开调试模式，可看到 sdk 的日志。
    1. JAnalyticsInterface.setDebugMode(boolean isDebugMode);

    更多 API

    其他 API 的使用方法请参考接口文档：Android SDK API

    运行 demo

    压缩包附带的 example 是一个 API 演示例子。你可以将它导入到你的工程，并将你的 AppKey 填入到 example 的 AndroidManifest 中，然后直接运行起来测试。

    技术支持

    邮件联系：support@jiguang.cn