接入Android应用

Maven自动集成（推荐）

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

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

   buildscript {
     repositories {
       mavenLocal()
       google()
       mavenCentral()
       gradlePluginPortal()
     }
     
     dependencies {
           // 导入阿里云 ARMS RUM 插件依赖
           // 建议导入最新版本插件，最新版本SDK说明请参见Android SDK版本说明文档
       classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.0.3"
     }
   }

2. 在工程App模块对应的build.gradle配置脚本中启用插件并添加SDK依赖。

   // 启用阿里云 ARMS RUM 插件
   apply plugin: "com.aliyun.rum"
   
   dependencies {
     // 导入阿里云 ARMS RUM SDK
     // 建议从以下链接获取最新版本SDK
     // https://help.aliyun.com/zh/arms/user-experience-monitoring/android-sdk-release-notes
     implementation("com.aliyun.rum:alibabacloud-android-rum-sdk:2.0.3")
   }

手动集成

1. 下载SDK并解压。

   解压.zip文件后得到如下内容：

   • libs文件夹，包含必须的jar包和jni库

   • repo文件夹，包含必须的插件

   • libs/assets文件夹，包含必须的资源文件

2. 配置工程。

   1. 复制repo文件夹到项目根目录，复制libs文件夹到App Module目录，复制libs/assets中的文件到App/src/assets目录中。

      

   2. 打开项目根目录下的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')
              }
              //... 其他配置
          }
      }
      //... 其他配置

   3. 在项目根目录下的build.gradle文件中，加入classpath配置。

      // 不区分Gradle版本，添加下面内容
      buildscript {
          dependencies {
              classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.0.3"
          }
      }
      //... 其他配置

   4. 打开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')
          //... 其他配置
      }