Integrasikan aplikasi Android - Application Real-Time Monitoring Service

Real User Monitoring (RUM) menyediakan pemantauan komprehensif untuk aplikasi seluler, termasuk pemantauan dan analisis waktu nyata terhadap metrik utama seperti performa aplikasi, crash, dan stuttering. Topik ini menjelaskan cara mengintegrasikan aplikasi Android.

Prasyarat

SDK mendukung Android 7.0 dan versi yang lebih baru.

Langkah 1: Integrasikan SDK

Integrasi otomatis Maven (Direkomendasikan)

Tambahkan dependensi online Maven ke skrip konfigurasi build.gradle dalam proyek Android Studio Anda untuk mengimpor versi terbaru SDK.

Tambahkan dependensi plugin ke skrip konfigurasi build.gradle di direktori root proyek.

buildscript {
  repositories {
    mavenLocal()
    google()
    mavenCentral()
    gradlePluginPortal()
  }
  
  dependencies {
        // Impor dependensi plugin Alibaba Cloud ARMS RUM.
        // Impor versi terbaru plugin. Untuk informasi lebih lanjut tentang versi SDK terbaru, lihat catatan rilis SDK Android.
    classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.0.5"
  }
}

Aktifkan plugin dan tambahkan dependensi SDK di skrip konfigurasi build.gradle untuk modul aplikasi proyek.

// Aktifkan plugin Alibaba Cloud ARMS RUM.
apply plugin: "com.aliyun.rum"

dependencies {
  // Impor SDK Alibaba Cloud ARMS RUM.
  // Dapatkan versi SDK terbaru dari URL berikut:
  // https://www.alibabacloud.com/help/zh/arms/user-experience-monitoring/android-sdk-release-notes
  implementation("com.aliyun.rum:alibabacloud-android-rum-sdk:2.0.5")
}

Integrasi manual

Unduh dan ekstrak SDK.
Setelah file .zip diekstrak, konten berikut akan tersedia:
- Folder libs, yang berisi paket JAR dan library JNI yang diperlukan.
- Folder repo, yang berisi plugin yang diperlukan.
- Folder libs/assets, yang berisi file resource yang diperlukan.

Konfigurasikan proyek.

Salin folder repo ke direktori root proyek. Salin folder libs ke direktori modul aplikasi. Salin file dari libs/assets ke direktori App/src/assets.

Buka file build.gradle (untuk Gradle 7.0 dan sebelumnya) atau file settings.gradle (untuk Gradle 7.0 dan setelahnya) di direktori root proyek. Tambahkan konfigurasi Maven berikut ke blok repositories.

Konfigurasi file build.gradle

buildscript {
    repositories {
        maven {
            url uri('./repo')
        }
        //... Konfigurasi lainnya
    }
}

allprojects {
    repositories {
        maven {
            url uri('./repo')
        }
        //... Konfigurasi lainnya
    }
}

//... Konfigurasi lainnya

Konfigurasi file settings.gradle

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

Tambahkan konfigurasi classpath ke file build.gradle di direktori root proyek.

// Tambahkan konten berikut terlepas dari versi Gradle.
buildscript {
    dependencies {
        classpath "com.aliyun.rum:alibabacloud-android-rum-plugin:2.0.3"
    }
}
//... Konfigurasi lainnya

Buka file build.gradle di modul aplikasi dan impor plugin serta dependensi AlibabaCloudRUM.

apply plugin: "com.aliyun.rum"
//... Konfigurasi lainnya
android {
    //... Konfigurasi lainnya
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
    //... Konfigurasi lainnya
}

dependencies {
    implementation files('libs/alibabacloud-android-rum-sdk.jar')
    //... Konfigurasi lainnya
}

Langkah 2: Konfigurasikan plugin

Di file build.gradle modul aplikasi, tambahkan konfigurasi plugin sesuai kebutuhan:

AlibabacloudRumExt {
    // Kecualikan paket yang tidak perlu diinstrumentasi.
    excludePackages = [
        "com.example.internal",      // Kecualikan paket implementasi internal.
        "com.myapp.debug",           // Kecualikan paket terkait debugging.
        "com.thirdparty.analytics"   // Kecualikan SDK analitik pihak ketiga.
    ]
}
//... Konfigurasi lainnya

Langkah 3: Konfigurasikan izin

SDK ARMS RUM memerlukan izin berikut pada aplikasi host.

<!--  Wajib  -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!--  Opsional  -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.READ_BASIC_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

Langkah 4: Konfigurasikan obfuscation

Jika aplikasi Anda menggunakan ProGuard untuk obfuscation, tambahkan aturan berikut.

-keep public class com.alibabacloud.rum.** { *; }
-dontwarn com.alibabacloud.rum.**

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

Langkah 5: Inisialisasi SDK

Tambahkan kode berikut ke baris pertama fungsi onCreate di kelas Application kustom Anda.

import com.alibabacloud.rum.AlibabaCloudRum;

public class YourApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    // Versi SDK >= 2.0.0
    AlibabaCloudRum.withServiceId("") // Dapatkan ServiceId saat membuat aplikasi RUM.
          .withWorkspace("") // Dapatkan Workspace saat membuat aplikasi RUM.
          .withEndpoint("") // Dapatkan Endpoint saat membuat aplikasi RUM.
          .start(getApplicationContext());

    // Versi SDK < 2.0.0
    AlibabaCloudRum.withAppID("<your appid>") // AppID. Dapatkan saat membuat aplikasi RUM di Langkah 1.
        .withConfigAddress("<your config address>") // ConfigAddress. Dapatkan saat membuat aplikasi RUM di Langkah 1.
        .start(getApplicationContext());
  }
}

Verifikasi integrasi

Jalankan aplikasi yang telah terintegrasi SDK dan lihat log di Android Studio Logcat. Cari kata kunci AlibabaCloudRUM atau filter berdasarkan tag AlibabaCloudRUM. Jika entri log berikut muncul, SDK berhasil diintegrasikan dan mulai mengumpulkan data.