Android 部署

1.获取SDK

(1)在服务端上注册需要监测的 Android APP ,获取到 APP Key

(2)下载 Android SDK:https://mobile.uyun.cn/agent/UYUN_Android_Agent.zip

下载 Android SDK 下载 Android SDK 到本地磁盘目录(记为:PATH_SDK) 三个jar中,android-classrewriter.jar 和 android-gradle-plugin.jar只作为编译辅助使用,不会打包到最终的apk中。因此,在引入 SDK的jar依赖时,android-classrewriter.jar和android-gradle-plugin.jar必须配置在 buildscript中。

注:对于团队开发,可以将下载下来的jar发布到本地maven仓库或放到公共的libs目录;

2.配置开发环境

(1)配置Gradle

打开模块的build.gradle

(2)修改buildscript节点,在dependencies子节点中增加一行:

classpath fileTree( dir: 'PATH_SDK', include:[ 'android-classrewriter.jar', 'android-gradle-plugin.jar']) 

注:如果 build.gradle 文件中没有 buildscript 脚本段,请自行添加。

(3)修改dependencies节点 ,增加一行:

 compile files('PATH_SDK/android-agent.jar')

注:PATH_AGENT 请替换为步骤2中存放agent相关jar的目录

(4)启用gradle插件,在顶上增加一行:

apply plugin: 'com.android.application'

apply plugin: 'cn.uyun.mobile'  // 应用 gradle 插件

建议:建议执行clean 和 rebuild 操作,以确保上述的修改生效

3.配置授权信息

(1)Agent上传数据需要联网,因此需要以下两个授权:

<uses-permission android:name= "android.permission.INTERNET" >

<uses-permission android:name= "android.permission.ACCESS_NETWORK_STATE" >

<uses-permission android:name="android.permission.READ_PHONE_STATE">

(2)嵌入agent代码,启动监控:编辑默认 Activity (一般是APP的入口 Activity 或 启动 Activity),增加 import 语句:

 import com.broada.apm.mobile.agent.android.Demeter;  

(3)然后在 onCreate() 方法中增加以下一行代码:

Demeter.withApplicationToken( "<appkey>" ).start(this);   // <appkey> 请替换为步骤1中生成的 AppKey 串 

(4)修改 proguard 文件,增加以下代码:

 1
 2
 3
 4
 5
 6
 -keep class com.broada.** { *; }
 -dontwarn com.broada.**

4.启动Agent

如果在 logcat 中看到如下日志,表明 agent 安装成功,且能成功上报采集数据:

I/cn.uyun.mobile.agent: Start Agent...

I/cn.uyun.mobile.agent: Successfully connected to collector server.

注:若部署成功,就能在服务端看到 SDK 上报的数据了。

最后更新于 28th Oct 2016