Application Real-Time Monitoring Service:Integrate an Android application

Maven automatic integration

In your Android Studio project, add the Maven dependency to your build.gradle files to import the latest SDK version.

1. Add the plugin dependency to the build.gradle file in the project's root directory.

   buildscript {
     repositories {
       mavenLocal()
       google()
       mavenCentral()
       gradlePluginPortal()
     }
     
     dependencies {
           // Import the Alibaba Cloud ARMS RUM plugin dependency.
           // Import the latest plugin version. For more information about the latest SDK version, see the Android SDK release notes.
       classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.2.14"
     }
   }

2. In the build.gradle file for the project's App module, enable the plugin and add the SDK dependency.

   // Enable the Alibaba Cloud ARMS RUM plugin.
   apply plugin: "com.aliyun.rum"
   
   dependencies {
     // Import the Alibaba Cloud ARMS RUM SDK.
     // Obtain the latest SDK version from the following URL:
     // https://www.alibabacloud.com/help/zh/arms/user-experience-monitoring/android-sdk-release-notes
     implementation("com.aliyun.rum:alibabacloud-android-rum-sdk:2.2.14")
   }

Manual integration

1. Download the SDK and decompress the package.

   The .zip file contains the following:

   • The libs folder, which contains required JAR packages and JNI libraries.

   • The repo folder, which contains the required plugin.

   • The libs/assets folder, which contains required resource files.

2. Configure your project.

   1. Copy the repo folder to the project root directory, the libs folder to the app module directory, and the files from libs/assets to the App/src/assets directory.

      

   2. Open the build.gradle file (for Gradle 7.0 and earlier) or the settings.gradle file (for Gradle 7.0 and later) in the project root directory. Add the following Maven configuration to the repositories block.

      build.gradle

      buildscript {
          repositories {
              maven {
                  url uri('./repo')
              }
              //... Other configurations
          }
      }
      
      allprojects {
          repositories {
              maven {
                  url uri('./repo')
              }
              //... Other configurations
          }
      }
      
      //... Other configurations

      settings.gradle

      pluginManagement {
          repositories {
              maven {
                  url uri('./repo')
              }
              //... Other configurations
          }
      }
      dependencyResolutionManagement {
          repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
          repositories {
              maven {
                  url uri('./repo')
              }
              //... Other configurations
          }
      }
      //... Other configurations

   3. Add the classpath configuration to the build.gradle file in the project root directory.

      // Add the following content regardless of your Gradle version.
      buildscript {
          dependencies {
              classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.2.14"
          }
      }
      //... Other configurations

   4. Open the build.gradle file in your app module and import the AlibabaCloudRUM plugin and its dependencies.

      apply plugin: "com.aliyun.rum"
      //... Other configurations
      android {
          //... Other configurations
          sourceSets {
              main {
                  jniLibs.srcDirs = ['libs']
              }
          }
          //... Other configurations
      }
      
      dependencies {
          implementation files('libs/alibabacloud-android-rum-sdk.jar')
          //... Other configurations
      }