ARMS用戶體驗監控的App監控提供了非常全面的移動端應用監控能力，主要包括iOS應用監控和Android應用監控。本文介紹如何將Android應用接入ARMS用戶體驗監控。
步驟一：創建應用
登錄ARMS控制臺。
在左側導航欄選擇，并在頂部菜單欄選擇目標地域。
在應用列表頁面單擊添加應用。
在創建應用面板單擊Android。
在Android面板輸入應用名稱和描述，然后單擊創建。
說明應用名稱唯一，不能與已創建的應用名稱重復。
創建成功后，當前應用將會自動生成對應的ConfigAddress（上報地址）和AppID。
步驟二：集成SDK
Maven自動集成（推薦）
在Android Studio工程的build.gradle配置腳本中添加Maven線上依賴，并導入最新版本的SDK。
在工程根目錄下的build.gradle配置腳本中添加插件依賴。
buildscript { repositories { mavenLocal() google() mavenCentral() gradlePluginPortal() } dependencies { // 導入阿里云 ARMS RUM 插件依賴 // 最新版本SDK說明請參見Android SDK版本說明文檔 classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:0.3.8" } }在工程App模塊對應的build.gradle配置腳本中啟用插件并添加SDK依賴。
// 啟用阿里云 ARMS RUM 插件 apply plugin: "com.aliyun.rum" dependencies { // 導入阿里云 ARMS RUM SDK // 最新版本SDK說明請參見Android SDK版本說明文檔 implementation("com.aliyun.rum:alibabacloud-android-rum-sdk:0.3.8") }
手動集成
下載SDK并解壓。
解壓.zip文件后得到如下內容：
libs文件夾，包含必須的jar包和jni庫
repo文件夾，包含必須的插件
配置工程。
復制repo文件夾到項目根目錄，復制libs文件夾到App Module目錄。
打開項目根目錄下的build.gradle（Gradle 7.0 及以下）或settings.gradle （Gradle 7.0以上）文件，在repositories塊中加入以下Maven配置。
build.gradle文件配置
buildscript { repositories { maven { url uri('./repo') } //... 其他配置 } } allprojects { repositories { maven { url uri('./repo') } //... 其他配置 } } //... 其他配置settings.gradle文件配置
pluginManagement { repositories { maven { url uri('./repo') } //... 其他配置 } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url uri('./repo') } //... 其他配置 } } //... 其他配置在項目根目錄下的build.gradle文件中，加入classpath配置。
// 不區分Gradle版本，加入下面內容 buildscript { dependencies { classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:0.3.5" } } //... 其他配置打開App Module下的build.gradle文件，導入AlibabaCloudRUM插件和依賴。
apply plugin: "com.aliyun.rum" //... 其他配置 android { //... 其他配置 sourceSets { main { jniLibs.srcDirs = ['libs'] } } //... 其他配置 } dependencies { implementation files('libs/alibabacloud-android-rum-sdk.jar') implementation files('libs/com.openrum.sdk.jar') //... 其他配置 }
步驟三：權限配置
ARMS RUM SDK需要宿主App授予以下權限。
<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"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>步驟四：混淆配置
若您的應用使用ProGuard混淆，請添加以下配置。
#ProGuard configurations for Aliyun ARMS RUM SDK
-keep class com.openrum.**{*;}
-keep class openrum.**{*;}
-keep 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集成成功且數據開始采集。
