Migrasi dari HockeySDK ke App Center SDK untuk Unity
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
Pilih objek game yang akan Anda buat untuk SDK dan hapus
HockeyAppAndroid/HockeyAppiOSkomponen dengan mengklik ikon >PengaturanHapus Komponen.Hapus folder HockeyAppUnityAndroid / HockeyAppUnityiOS dari folder Aset di dalam proyek Unity Anda.
1.2 Menambahkan App Center SDK baru
App Center SDK terintegrasi dengan mengimpor Paket Unity ke dalam proyek Anda. Untuk melakukannya, pertama-tama instal plugin App Center Unity Editor Extensions. Buka Ekstensi Editor melalui menu Unity: Window>App Center>Editor Extensions dan pilih Instal App Center SDK.
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 |
|---|---|
Crashes and Exceptions |
Crashes |
Metrics |
Analytics |
Version Updates |
Distribute |
Untuk menginstal layanan secara terpisah, Anda dapat memilih Instal SDK di setiap tab.
Catatan
App Center Unity SDK adalah satu untuk ketiga platform: Android, iOS, dan UWP. Anda tidak perlu menginstal setiap SDK secara terpisah.
Cara yang disarankan untuk mengintegrasikan App Center Unity SDK adalah dengan menggunakan App Center Editor Extension, tetapi kami mendukung skenario lain. Untuk informasi selengkapnya, lihat Dokumentasi Unity App Center.
2. Siapkan 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 Mengonfigurasi SDK
Lampirkan skrip App Center
Di jendela Proyek, navigasikan ke folder AppCenter yang ditambahkan ke proyek Anda. Temukan skrip dengan logo App Center sebagai ikonnya, bernama AppCenterBehavior, dan seret ke objek game yang Anda gunakan sebelumnya untuk HockeySDK.
Mengonfigurasi pengaturan App Center
Klik objek game ini dan di jendela Inspektur , Anda akan melihat konfigurasi App Center.
Isi informasi tambahan menggunakan tabel pemetaan konfigurasi terperinci, yang diberikan di bawah ini.
3. Perbandingan layanan dan fitur
| Pengaturan HockeyApp | Pengaturan Pusat Aplikasi | Catatan |
|---|---|---|
| ID Aplikasi | Rahasia Aplikasi Android/iOS | Gunakan ID Aplikasi yang telah Anda konversi di langkah sebelumnya |
| URL Server | URL Log Kustom, bagian Penyetelan Lainnya | Centang Gunakan URL Log Kustom |
| Pembaruan dalam aplikasi terbatas | NA | Distribute.UpdateTrack |
| Crash dan Pengecualian (diaktifkan secara default) | Menggunakan Crash | Modul crash |
| Unggah Otomatis Crash | NA (diaktifkan secara default) | Dokumentasi (diaktifkan secara default, dapat dikonfigurasi) |
| Pengelogan Pengecualian | Tingkat Log Awal, bagian Penyetelan Lainnya | Jika Anda ingin pengelogan yang lebih rinci, gunakan Verbose |
| Metrik Pengguna | Menggunakan Analitik | Modul analitik |
| Versi Updates (diaktifkan secara default) | Gunakan Distribusi | Mendistribusikan modul |
| Perbarui Pemberitahuan | NA | Dokumentasi (harus dikonfigurasi) |
Catatan
Jika proyek Anda tidak mendukung salah satu dari tiga platform yang tercantum dalam pengaturan, biarkan bidang rahasia aplikasi apa adanya; itu tidak akan berpengaruh. Jika proyek Anda mendukung platform yang tidak didukung App Center, API dan konfigurasi tidak akan berpengaruh bagi platform tersebut.
Jika proyek Anda memiliki panggilan API HockeySDK di seluruh aplikasi, ganti menggunakan tabel pemetaan API terperinci yang diberikan di bawah ini.
| Fitur | HockeyApp | Pusat Aplikasi |
|---|---|---|
| Peristiwa kustom dengan properti | HockeyAppIOS.TrackEvent atau HockeyAppAndroid.TrackEvent | Analytics.TrackEvent |
| Periksa pembaruan secara eksplisit | HockeyAppIOS.CheckForUpdate atau HockeyAppAndroid.CheckForUpdate | Distribute.CheckforUpdate |
| Menampilkan formulir umpan balik | HockeyAppIOS.ShowFeedbackForm atau HockeyAppAndroid.ShowFeedbackForm | NA (lihat bagian di bawah) |
Layanan Umpan Balik
Layanan umpan balik tidak akan didukung di App Center. Lihat Umpan balik HockeyApp.