Bermigrasi dari HockeySDK ke App Center SDK untuk Cordova
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 alih-alih HockeySDK.
1. Perbarui pustaka
1.1 Menghapus HockeySDK lama
Buka jendela terminal, navigasikan ke folder proyek Cordova, dan jalankan perintah berikut:
cordova plugin add cordova-plugin-appcenter-analyticsNavigasikan ke folder plugin android > platform_www > platform > aplikasi > Anda dan hapus cordova-plugin-hockeyapp darinya.
1.2 Menambahkan App Center SDK baru
App Center SDK dirancang dengan pendekatan modular – Anda hanya dapat mengintegrasikan layanan yang Anda minati. Lihat kesetaraan dalam tabel berikutnya:
| Modul HockeyApp | Modul App Center | Perintah instal |
|---|---|---|
Crashes and Exceptions |
Crashes |
cordova plugin add cordova-plugin-appcenter-crashes |
Metrics |
Analytics |
cordova plugin add cordova-plugin-appcenter-analytics |
Jalankan salah satu perintah untuk menginstal modul yang Anda butuhkan (atau keduanya).
2. Perbarui 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 (Pusat Aplikasi): 00112233-4455-6677-8899-aabbccddeeff
2.2 Mengganti inisialisasi SDK dalam kode aplikasi
Hapus inisialisasi HockeyApp di
devicereadydalam handler:hockeyapp.start(null, null, "APP_ID");Mengonfigurasi SDK App Center
Buka file config.xml proyek Apache Cordova; untuk setiap elemen target
platformproyek Apache Cordova Anda (hanya Android dan iOS hari ini), tambahkan elemen turunanpreferencedalam format berikut:<preference name="APP_SECRET" value="{App Secret from the previous step}" />Untuk informasi selengkapnya, lihat dokumentasi App Center Cordova.
Ganti semua panggilan HockeyApp API di seluruh aplikasi. Tabel pemetaan API terperinci diberikan di bawah ini.
3. Perbandingan layanan dan fitur
Core
| Fitur | HockeyApp | Pusat Aplikasi |
|---|---|---|
| Identifikasi Pengguna | hockeyapp.setUserName atau hockeyapp.setUserEmail | AppCenter.setUserId |
Analitik
| Fitur | HockeyApp | Pusat Aplikasi |
|---|---|---|
| Melacak sesi secara otomatis | Dokumentasi (tidak dapat dinonaktifkan) | Dokumentasi (diaktifkan secara default) |
| Melacak peristiwa | hockeyapp.trackEvent | Analytics.trackEvent |
Crash
| Fitur | HockeyApp | Pusat Aplikasi |
|---|---|---|
| Mengirim crash secara otomatis | parameter autoSend (dinonaktifkan secara default) | APPCENTER_CRASHES_ALWAYS_SEND (diaktifkan secara default) |
| Melampirkan data meta tambahan | hockeyapp.addMetaData | Dokumentasi (dapat dilampirkan dari pendengar) |
| Hasilkan crash pengujian | hockeyapp.forceCrash | AppCenter.Crashes.generateTestCrash |
| Menampilkan dialog saat crash | ignoreDefaultHandler (dinonaktifkan secara default, hanya Android) | AppCenter.Crashes.process (panggilan balik saat memproses crash) |
Pembaruan versi
Layanan Distribusi App Center belum didukung di App Center Cordova SDK.
Layanan Umpan Balik
Layanan umpan balik tidak akan didukung di App Center. Lihat Umpan balik HockeyApp.