七牛APM SDK 通过虚拟机技术在应用打包编译过程中对应用采样点(Http 标准协议和 Https 标准协议)进行嵌码操作,该操作会在协议库方法前后部署 SDK 探针,该过程不会影响用户代码逻辑; 每当 App 启动时,七牛 Agent 开始工作,应用有网络请求时,通过之前部署的 SDK 探针以一定的采集频率来采集数据,并对采集的数据进行汇总后,上传到服务器(已报表的形式展现) 应用退出到后台或用户关闭App时,七牛Agent 停止工作,以便减少不必要的流量和CPU消耗
- 应用 App 嵌码后体积增量为 117K 左右
需要确保已安装 Gradle 构建环境和 AS开发环境
-
打开项目根目录下的build.gradle (Project) 文件
-
在buildscript模块加入代码
dependencies { ... classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:1.0.10' classpath 'org.aspectj:aspectjtools:1.8.9' ... }
-
打开项目工程主模块下的build.gradle ( app ) 文件
-
在文件中引入 aspectj 插件
apply plugin: 'android-aspectjx' -
在dependencies模块添加 SDK 依赖
dependencies { ... compile 'com.qiniu:pre-dem-android-sdk:1.0.0' ... }
构建完成后,请在待检测的 App 工程的 AndroidMainfest.xml 文件中增加以下的权限:
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
```
在 "MainActivity" 中的 onResume() 方法(如未找到该方法请新增)中初始化 Android APM SDK
```
DEMManager.start("apm.domain.com", "appkey", this.getApplicationContext());
```
`gradle clean build`
发布前请在 proguard 混淆配置文件中增加以下内容,以免 SDK 不可用 若需要保留行号信息,请在 proguard.cfg 中添加以下内容
-
数据收集服务器校验
-
嵌码完成后可通过 "LogCat" 查看 SDK 日志输出结果,用以进行数据收集服务器校验,TAG 为 DEMManager, 标准日志输出结果如下所示
08-28 09:40:26.370 6726-6726/qiniu.predem.example D/DEMManager: DemManager start 08-28 09:40:26.674 6726-7109/qiniu.predem.example D/DEMManager: ---Http monitor true 08-28 09:40:26.682 6726-7109/qiniu.predem.example D/DEMManager: ---Crash report true 08-28 09:40:26.682 6726-7109/qiniu.predem.example D/DEMManager: ----Lag monitor true