Android SDK接入（Maven集成）

前提条件

• 已创建项目和应用，具体操作请参见创建项目和应用。

• 已设置上报网络数据的URL过滤，具体操作请参见设置URL过滤。

• 已下载应用的配置文件，具体操作请参见下载配置文件。

  Android配置文件：aliyun-emas-services.json。

使用限制

• 仅支持Android 4.2及以上版本。

• 仅支持arm64-v8a/armeabi-v7a/x86/x86_64架构。

• 仅支持gradle 3.0.0及以上版本。

• 仅支持以下网络库版本：

  • okhttp2：2.0.0-2.7.5

  • okhttp3: 3.0.0-3.14.7

  • okhttp4: 4.0.0-4.8.1

接入概述

1. 准备：获取应用信息AppKey/AppSecret/PackageName；获取公钥。

2. 应用插件：添加插件依赖；应用插件。

3. 添加依赖：采用Maven方式集成SDK。SDK功能变更历史参见：Android SDK发布说明。

4. 接入服务：添加自定义Application，以及SDK初始化代码。

5. 混淆配置：如App对代码进行乱序混淆，则修改混淆配置文件。

6. 编译：常见编译问题排查。

准备

获取应用信息AppKey/AppSecret/PackageName

1：登录移动研发平台 EMAS控制台，打开工作空间概览页面。

2：在我的应用区域，单击Android应用图标，打开指定Android应用的编辑配置页面。

3：在编辑配置页面，查询指定应用的AppKey/AppSecret/PackageName。

各参数说明如下：

获取公钥

4：在编辑配置页面，单击下载Android配置按钮，下载指定应用的配置文件：aliyun-emas-services.json。

5：打开Android配置文件，查询appmonitor.rsaSecret字段内容，即为性能分析公钥。

应用插件

1：在build.gradle项目文件的buildscript{}代码段添加插件依赖。

buildscript {
    repositories {
        google()
        jcenter()
    }
dependencies {
    classpath 'com.android.tools.build:gradle:${gradle-version}'//配置项
    classpath 'com.aliyun.ams:alicloud-android-networkmonitor-plugin:1.3.0-open'
}

配置说明如下：

2：在build.gradle项目文件中添加代码段应用插件。

apply plugin: 'com.aliyun.emas.networkmonitor'

添加依赖

在build.gradle项目文件中：

1：在repositories{}代码段添加阿里云Maven仓库地址。

repositories {
    maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
}

2：在android{}代码段设置应用包名和.so库。

android {
    ......
    defaultConfig {
        applicationId "com.xxx.xxx" //配置项
        ......
        ndk {
            //选择要添加的对应cpu类型的.so库，当前支持四种
            abiFilters 'arm64-v8a', 'armeabi-v7a', 'x86', 'x86_64' //配置项
        }
        ......
    }
    ......
}

配置说明如下：

3：在dependencies{}代码段添加SDK依赖。

dependencies {
    ......
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "com.squareup.okhttp3:okhttp:${okhttp3version}"//配置项

    //线上测试
    implementation 'com.aliyun.ams:alicloud-android-ha-adapter:1.2.3.0-open'
    implementation 'com.aliyun.ams:alicloud-android-apm:1.1.3.0-open'
    ......
}

配置说明如下：

接入服务

1、预初始化SDK

预初始化SDK可以在Appcalition.onCreate函数中完成。

public class MyApplication extends Application {
   @Override
   public void onCreate() {
     super.onCreate();  
     AliHaAdapter.getInstance().preStart(this);
   }
}

2、开启性能分析

在同意隐私协议之后，可以开启崩溃分析。

private void startHa() {
  AliHaConfig config = new AliHaConfig();
  config.appKey = "xxxxxxxx"; //配置项
  config.appVersion = "x.xx"; //配置项
  config.appSecret = "xxxxxxxxxxxx"; //配置项
  config.channel = "mqc_test"; //配置项
  config.userNick = null; //配置项
  config.application = this; //配置项
  config.context = getApplicationContext(); //配置项
  config.isAliyunos = false; //配置项
  config.rsaPublicKey = "xxxxxxx"; //配置项
  AliHaAdapter.getInstance().addPlugin(Plugin.apm);
  AliHaAdapter.getInstance().start(config);
}

配置说明如下：

3、在AndroidManifest.xml中添加代码段注册Application。

<application
        android:name=".MyApplication"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" >
</application>

混淆配置

如App对代码进行乱序混淆，则在混淆配置文件中添加代码段：

-keep class com.taobao.monitor.impl.**{*;}
-keep class com.taobao.monitor.adapter.**{*;}
-keep class com.taobao.application.common.**{*;}
-keep class com.facebook.drawee.generic.RootDrawable{*;}
-keep class com.facebook.drawee.drawable.FadeDrawable{*;}
-keep class androidx.fragment.app.Fragment{*;}
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,*Annotation*,EnclosingMethod

编译

如同时使用其他阿里云产品，可能会因为依赖中存在UTDID冲突，造成编译失败。解决办法参见：SDK UTDID冲突解决方案。

样例代码

性能分析服务Android SDK接入工程样例请参见Demo工程。

功能验证

Android SDK接入操作完成后，可操作App，查看性能分析服务控制台显示数据，进行功能验证。

1：手机端：启动App。（2分钟后）控制台：查看概览页签的启动速度是否显示数据。

2：手机端：在App中跳转几个页面。（2分钟后）控制台：查看概览页签的加载时间是否显示数据。

如数据显示正常，则Android SDK接入成功；否则，可能的原因是：SDK接入失败、SDK未获取数据、数据发送失败、后端问题，请联系我们解决。