通过Maven方式接入Android应用

前提条件

Gradle支持版本：3.0~7.4，建议使用7.4.0版本的Gradle。

步骤一：创建应用

1. 登录ARMS控制台。

2. 在左侧导航栏选择用户体验监控 > 应用列表，并在顶部菜单栏选择目标地域。

3. 在应用列表页面单击添加应用。

4. 在创建应用面板单击Android。

5. 在Android面板输入应用名称和描述，然后单击创建。

   说明

   应用名称唯一，不能与已创建的应用名称重复。

   创建成功后，当前应用将会自动生成对应的ConfigAddress（上报地址）和AppID。

步骤二：集成SDK

在Android Studio工程的build.gradle配置脚本中添加Maven线上依赖，并导入最新版本的SDK。

1. 在工程根目录下的build.gradle配置脚本中添加插件依赖。

   buildscript {
     repositories {
       mavenLocal()
       google()
       mavenCentral()
       gradlePluginPortal()
     }
     
     dependencies {
       // 导入阿里云ARMS RUM插件依赖
       classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:0.2.0"
     }
   }

2. 在工程应用模块对应的build.gradle配置脚本中启用插件并添加SDK依赖，示例如下：

   // 启用阿里云ARMS RUM插件
   apply plugin: "com.aliyun.rum"
   
   dependencies {
     // 导入阿里云ARMS RUM SDK
     implementation("com.aliyun.rum:alibabacloud-android-rum-sdk:0.2.0")
   }

步骤三：权限配置

ARMS RUM SDK需要宿主App授予以下权限。

import com.alibabacloud.rum.AlibabaCloudRum;

public class YourApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    AlibabaCloudRum.withAppID("<your appid>") // AppID，创建RUM应用时获取。
      .withConfigAddress("<your config address>") // ConfigAddress，创建RUM应用时获取。
      .start(getApplicationContext());
  }
}

步骤四：混淆配置

若您的应用使用Proguard混淆，请添加以下配置。

#ProGuard configurations for Aliyun ARMS RUM SDK
-keep public class com.openrum.**{*;}
-keep public class openrum.**{*;}
-keep public class com.alibabacloud.rum.**{*;}
-dontwarn com.openrum.**
-dontwarn openrum.**
#End Aliyun ARMS RUM SDK

-optimizations !code/simplification/*,!field/*,!class/merging/*,!method/propagation/*,!class/unboxing/enum,!code/allocation/variable

步骤五：初始化SDK

请在自定义Application的onCreate函数中，添加以下代码。

import com.alibabacloud.rum.AlibabaCloudRum;

public class YourApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    AlibabaCloudRum.withAppID("<your appid>") // AppID，创建RUM应用时获取。
      .withConfigAddress("<your config address>") // ConfigAddress，创建RUM应用时获取。
      .start(getApplicationContext());
  }
}

接入验证

启动已经集成了SDK的APK应用，查看Android Studio Logcat日志，搜索openrum关键字（或者过滤OpenRUM标签），出现如下log则表示SDK集成成功且数据开始采集。