Mulai menggunakan Android

  • Artikel

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

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 App Center SDK, 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 Distribusi App Center.

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 sudah membuat aplikasi di portal App Center, Anda dapat melewati langkah ini.

  1. Pergilah ke appcenter.ms.
  2. Daftar atau masuk dan klik tombol Tambahkan baru di sudut kanan atas halaman, dan pilih Tambahkan aplikasi baru dari menu dropdown.
  3. Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
  4. Pilih Android sebagai OS dan Java sebagai platform.
  5. 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

  1. 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 Analitik dan Crash App Center, tambahkan baris berikut:
dependencies {
    def appCenterSdkVersion = '5.0.4'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Catatan

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

Catatan

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.

  1. 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.
Masukkan 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:

  1. Mengonfigurasi atau memulainya dengan Rahasia Aplikasi.
  2. Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
  3. 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 tempat penampung 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 Pusat Aplikasi.

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 start() metode dan menyertakan App Center Analytics dan App Center Crash.

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 semua diatur untuk memvisualisasikan data Analytics dan Crash di portal yang dikumpulkan SDK secara otomatis.

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 dalam aplikasi, baca dokumentasi Distribusi App Center.

5. Aturan pencadangan (khusus Android)

Catatan

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

Catatan

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.

  1. Buat file appcenter_backup_rule.xml di folder res/xml .
  1. Buka file AndroidManifest.xml 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"
  1. 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.

  1. Buat file appcenter_backup_rule.xml di folder res/xml .
  1. Buka file AndroidManifest.xml 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"
  1. 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>