Migrasi dari HockeySDK ke App Center Android SDK

  • 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.

Ikuti dokumentasi ini jika Anda ingin memperbarui aplikasi untuk menggunakan App Center SDK, bukan HockeySDK.

1. Perbarui pustaka

Buka file build.gradle tingkat aplikasi proyek (app/build.gradle) dan ganti baris berikut dalam dependencies { ... } konfigurasi.

Sebelumnya:

implementation 'net.hockeyapp.android:HockeySDK:...'

Setelahnya:

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

App Center SDK dirancang dengan pendekatan modular – Anda hanya dapat mengintegrasikan layanan yang Anda minati. Setiap modul SDK perlu ditambahkan sebagai dependensi terpisah di bagian ini. Lihat kesetaraan dalam tabel berikutnya:

Kelas HockeyApp Modul App Center
MetricsManager Analytics
CrashManager Crashes
UpdateManager Distribute

2. Memperbarui kode penyiapan SDK

2.1 Mengonversi pengidentifikasi aplikasi

App Center SDK menggunakan pengidentifikasi aplikasi dalam format pengidentifikasi unik global (GUID). ID Aplikasi HockeyApp Anda dapat digunakan oleh App Center tetapi Anda perlu mengonversinya ke format yang berbeda. Untuk mengonversi pengidentifikasi, Anda harus menambahkan empat tanda hubung untuk mendapatkan representasi 8-4-4-4-12.

Sebelum (HockeyApp): 00112233445566778899aabbccddeeff

Setelah (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Mengganti inisialisasi SDK dalam kode aplikasi

  1. Ganti impor berikut di kelas aktivitas Anda.

    Sebelumnya:

    import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

    Setelahnya:

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

  2. Ganti kode pendaftaran di dalam kelas aktivitas utama aplikasi Anda' onCreate-callback.

    Sebelumnya:

    CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);

    Setelahnya:

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

    Jika Anda menggunakan metadata untuk menyediakan pengidentifikasi aplikasi, Anda harus menyalinnya dari sana ke kode inisialisasi dan menghapus

    <meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />

    dari file AndroidManifest.xml Anda.

  3. Ganti panggilan API HockeyApp di seluruh aplikasi. Tabel pemetaan API terperinci diberikan di bawah ini.

3. Layanan dan perbandingan fitur

Core

Fitur HockeyApp Pusat Aplikasi
Menyesuaikan tingkat log HockeyLog.setLogLevel AppCenter.setLogLevel
Mengidentifikasi penginstalan Khusus internal AppCenter.getInstallId
Mengidentifikasi pengguna Hanya crash AppCenter.setUserId

Analitik

Fitur HockeyApp Pusat Aplikasi
Melacak sesi secara otomatis Ya, dapat dinonaktifkan oleh MetricsManager.setSessionTrackingDisabled Dokumentasi (tidak dapat dinonaktifkan)
Peristiwa kustom dengan properti MetricsManager.trackEvent Analytics.trackEvent
Menonaktifkan layanan saat runtime MetricsManager.disableUserMetrics dan MetricsManager.enableUserMetrics Analytics.setEnabled

Crash

Fitur HockeyApp Pusat Aplikasi
Mengirim crash secara otomatis Dinonaktifkan secara default Dokumentasi (diaktifkan secara default)
Melampirkan data meta tambahan Ya Dokumentasi (dapat dilampirkan dari pendengar)
Mengkustomisasi dialog pengguna Ya Dokumentasi (tidak disediakan secara default)
Mendapatkan info tentang status pengiriman Ya Dokumentasi
Info tentang crash sebelumnya CrashManager.getLastCrashDetails Crashes.getLastSessionCrashReport

Distribusikan

Catatan

Tidak seperti di HockeyApp, fitur pembaruan dalam aplikasi App Center hanya berfungsi dengan build RILIS (secara default) yang didistribusikan menggunakan layanan Distribusi App Center . Jika aplikasi menggunakan grup distribusi privat, setelah aplikasi diinstal dan dibuka untuk pertama kalinya setelah App Center Distribute SDK ditambahkan, browser akan terbuka untuk mengautentikasi pengguna dan mengaktifkan pembaruan dalam aplikasi. Browser ini juga akan terbuka jika Anda mengatur trek pembaruan dalam aplikasi privat pada waktu proses. Ini adalah langkah SATU KALI yang tidak akan terjadi untuk rilis aplikasi Anda berikutnya. Lihat Dokumentasi Distribusi App Center untuk detail selengkapnya.

Fitur HockeyApp Pusat Aplikasi
Pembaruan dalam aplikasi terbatas LoginManager.verifyLogin Distribute.setUpdateTrack
Menonaktifkan layanan saat runtime UpdateManager.unregister Distribute.setEnabled
Mengkustomisasi dialog pembaruan Ya Dokumentasi

Layanan Umpan Balik

Layanan umpan balik tidak akan didukung di App Center. Lihat Umpan balik HockeyApp.