Mulai menggunakan Android

2025-05-06

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

App Center SDK menggunakan arsitektur modular sehingga Anda dapat menggunakan salah satu atau semua layanan.

Anda dapat menemukan informasi tentang data yang dikumpulkan oleh App Center pada Data yang Dikumpulkan oleh SDK App Center, Peraturan Perlindungan Data Umum, dan halaman FAQ .

Mari kita mulai menyiapkan App Center Android SDK di aplikasi Anda untuk menggunakan App Center Analytics dan App Center Crash. Untuk menambahkan App Center Distribute ke aplikasi Anda, lihat dokumentasi untuk App Center Distribute.

1. Prasyarat

Sebelum memulai, pastikan prasyarat berikut terpenuhi:

Proyek Android Anda disiapkan di Android Studio.
Anda menargetkan perangkat yang menjalankan Android Versi 5.0 (API level 21) atau yang lebih baru.

2. Buat aplikasi Anda di Portal App Center untuk mendapatkan Rahasia Aplikasi

Jika Anda sudah membuat aplikasi di portal App Center, Anda dapat melewati langkah ini.

Pergilah ke appcenter.ms.
Daftar atau masuk dan klik tombol Tambahkan baru di sudut kanan atas halaman, dan pilih Tambahkan aplikasi baru dari menu dropdown.
Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
Pilih Android sebagai OS dan Java sebagai platform.
Klik tombol Tambahkan aplikasi baru .

Setelah membuat aplikasi, Anda dapat memperoleh Rahasia Aplikasi di halaman Memulai di bawah 2. Mulai SDK. Atau, Anda dapat mengklik Pengaturan, dan di sudut kanan atas, klik titik vertikal tiga kali dan pilih Salin rahasia aplikasi untuk mendapatkan Rahasia Aplikasi Anda.

3. Tambahkan modul App Center SDK

Buka file build.gradle tingkat aplikasi proyek (app/build.gradle) dan tambahkan baris berikut setelah apply plugin. Sertakan dependensi yang Anda inginkan dalam proyek Anda. Setiap modul SDK perlu ditambahkan sebagai dependensi terpisah di bagian ini. Jika Anda ingin menggunakan App Center Analytics dan Crash, tambahkan baris berikut:

dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Nota

Jika versi plugin Android Gradle Anda lebih rendah dari 3.0.0, maka Anda perlu mengganti implementasi kata dengan mengkompilasi.

Nota

Karena penghentian dukungan jCenter, semua rakitan kami dipindahkan ke repositori Maven Central. Ikuti panduan ini tentang migrasi dari jCenter Ke Maven Central. Harap dicatat bahwa Maven Central tidak berisi modul yang tidak digunakan lagi. Pastikan proyek Anda tidak memiliki dependensi modul App Center SDK yang tidak digunakan lagi.

Pastikan untuk memicu sinkronisasi Gradle di Android Studio.

Sekarang setelah Anda mengintegrasikan SDK di aplikasi Anda, saatnya untuk memulai SDK dan memanfaatkan App Center.

4. Mulai SDK

4.1 Tambahkan metode start()

Untuk menggunakan App Center, Anda harus ikut serta dalam modul yang ingin Anda gunakan. Secara default tidak ada modul yang dimulai dan Anda harus secara eksplisit memanggil masing-masing modul saat memulai SDK.
Sisipkan baris berikut di dalam kelas aktivitas utama aplikasi Anda ' onCreate-callback untuk menggunakan App Center Analytics dan App Center Crash:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

Jika Anda perlu memulai layanan App Center secara terpisah, Anda harus:

Konfigurasikan atau mulai dengan Kode Rahasia Aplikasi.
Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
Mulai layanan yang diperlukan tanpa Rahasia Aplikasi.

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Jika Anda memiliki lebih dari satu titik masuk ke aplikasi Anda (misalnya, aktivitas tautan mendalam, layanan atau penerima siaran), panggil start di kelas kustom aplikasi atau di setiap titik masuk. Dalam kasus terakhir, periksa apakah App Center sudah dikonfigurasi sebelum start panggilan:

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

4.2 Ganti placeholder dengan Rahasia Aplikasi Anda

Pastikan untuk mengganti {Your App Secret} teks dengan nilai aktual untuk aplikasi Anda. Rahasia Aplikasi dapat ditemukan di halaman Memulai atau halaman Pengaturan di portal App Center.

Halaman Memulai berisi sampel kode di atas dengan Rahasia Aplikasi Anda di dalamnya, Anda cukup menyalin-tempel seluruh sampel.

Contoh di atas menunjukkan cara menggunakan metode start() serta menyertakan App Center Analytics dan App Center Crashes.

Jika Anda tidak ingin menggunakan salah satu dari dua layanan, hapus parameter yang sesuai dari panggilan metode di atas.

Kecuali Anda secara eksplisit menentukan setiap modul sebagai parameter dalam metode mulai, Anda tidak dapat menggunakan layanan App Center tersebut. Selain itu, start() API hanya dapat digunakan sekali dalam siklus hidup aplikasi Anda - semua panggilan lain akan mencatat peringatan ke konsol dan hanya modul yang disertakan dalam panggilan pertama yang akan tersedia.

Misalnya - Jika Anda hanya ingin onboarding ke App Center Analytics, Anda harus memodifikasi start() panggilan API sebagai berikut:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Android Studio secara otomatis menyarankan pernyataan impor yang diperlukan setelah Anda menyisipkan start() metode, tetapi jika Anda melihat kesalahan bahwa nama kelas tidak dikenali, tambahkan baris berikut ke pernyataan impor di kelas aktivitas Anda:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

Anda sudah siap untuk memvisualisasikan data Analytics dan Kecelakaan di portal yang dikumpulkan secara otomatis oleh SDK.

Lihat dokumentasi untuk App Center Analytics dan App Center Crash untuk mempelajari cara menyesuaikan dan menggunakan fungsionalitas yang lebih canggih dari kedua layanan.

Untuk mempelajari cara memulai pembaruan aplikasi, baca dokumentasi App Center Distribute.

5. Aturan pencadangan (khusus Android)

Nota

Aplikasi yang menargetkan Android 6.0 (API level 23) atau yang lebih tinggi mengaktifkan Pencadangan Otomatis secara otomatis.

Nota

Jika Anda sudah memiliki file kustom dengan aturan cadangan, beralihlah ke langkah ketiga.

Jika Anda menggunakan pencadangan otomatis untuk menghindari mendapatkan informasi yang salah tentang perangkat, ikuti langkah-langkah berikutnya:

5.1. Untuk Android 11 (API level 30) atau yang lebih rendah.

Buat file appcenter_backup_rule.xml di folder res/xml .

Buka file AndroidManifest.xml dari proyek. android:fullBackupContent Tambahkan atribut ke <application> elemen . Ini harus menunjuk ke file sumber daya appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

Tambahkan aturan cadangan berikut ke file appcenter_backup_rule.xml :

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Untuk Android 12 (API level 31) atau yang lebih tinggi.

Buat file appcenter_backup_rule.xml di folder res/xml .

Buka file AndroidManifest.xml dari proyek. android:dataExtractionRules Tambahkan atribut ke <application> elemen . Ini harus menunjuk ke file sumber daya appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

Tambahkan aturan cadangan berikut ke file appcenter_backup_rule.xml :

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>

Bagikan melalui

Mulai menggunakan Android

1. Prasyarat

2. Buat aplikasi Anda di Portal App Center untuk mendapatkan Rahasia Aplikasi

3. Tambahkan modul App Center SDK

4. Mulai SDK

4.1 Tambahkan metode start()

4.2 Ganti placeholder dengan Rahasia Aplikasi Anda

5. Aturan pencadangan (khusus Android)

5.1. Untuk Android 11 (API level 30) atau yang lebih rendah.

5.2. Untuk Android 12 (API level 31) atau yang lebih tinggi.

Saran dan Komentar

Sumber Daya Tambahan: