Skip to content

三分钟快速接入

akathink edited this page Apr 12, 2019 · 7 revisions

三分钟快速集成ArgusAPM

一. Gradle配置 在 Project 的 build.gradle 文件中添加ArgusAPM的相关配置,示例如下:

在项目根目录的 build.gradle(注意:不是 app/build.gradle) 中添加以下配置:

buildscript {
    repositories {
        jcenter()
    }
	
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
	classpath 'com.qihoo360.argusapm:argus-apm-gradle-asm:3.0.1.1001'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

在app的build.gradle 文件中添加插件引用,示例如下:

apply plugin: 'argusapm'

//在android的配置代码块里面(为了兼容Android6.0系统):
android {
    useLibrary ‘org.apache.http.legacy‘
}

二. AndroidManifest.xml配置

a. 权限相关

<!--需要申请如下权限-->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.BATTERY_STATS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

b. 组件使用 需要在AndroidManifest.xml里添加如下组件声明:

    <provider
        android:name="com.argusapm.android.core.storage.ApmProvider"
		android:authorities="{当前应用的applicationId}.apm.storage"
		android:exported="false" />

三. 一个简单的SDK初始化代码

在项目的Application的attachBaseContext里调用如下代码即可

Config.ConfigBuilder builder = new Config.ConfigBuilder()
        .setAppContext(this)
        .setAppName("apm_demo")
		.setRuleRequest(new RuleSyncRequest())
		.setUpload(new CollectDataSyncUpload())
        .setAppVersion("0.0.1")
        .setApmid("apm_demo");
Client.attach(builder.build());
Client.startWork();

注意:

  1. apmid(appkey)名称必须保证唯一性,由Argus APM统一分配,请勿随意填写。

    停止对外接入服务,请创建自己的数据服务端。

  2. 上面的初始化只是针对单进程的APP,若是多进程请参考详细接入文档。

如此,移动性能监控 SDK就接入完成,更多技巧请参考详细接入文档。

四. 接入成功日志输出

接入完毕,运行应用,如果看到以下log,说明接入成功:

五. 混淆相关

无需任何混淆配置,因为ArgusAPM的AAR自带Proguard文件,直接接入ArgusAPM-SDK即可生效。