Migrasi dari HockeySDK ke App Center SDK untuk tvOS

  • 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

1.1 Menghapus HockeySDK lama

Manual

Jika Anda telah menambahkan SDK secara manual, ikuti langkah-langkah berikut:

  1. Hapus HockeySDK.framework referensi dari proyek XCode. Klik tombol Hapus referensi , jangan klik tombol Pindahkan ke Sampah .

  2. Buka pengaturan proyek Anda dan di bawah tab Pengaturan Build di bagianJalur Pencarian Kerangka KerjaJalur / Pencarian Header, hapus lokasi untuk file header yang terkait dengan HockeySDK.

  3. Buka pengaturan proyek Anda dan di bawah tab Fase Build di bagian Tautkan Biner dengan Pustaka , hapus entri dependensi yang terkait dengan HockeySDK.

  4. Hapus HockeySDK.framework dari sistem file.

Podfile

Jika Anda telah menambahkan SDK menggunakan CocoaPods, hapus pod "HockeySDK-tvOS" baris dari Podfile, lalu jalankan pod install.

Carthage

  1. Hapus referensi HockeySDK dari Cartfile. Hapus Cartfile.Resolved dari sistem file.

  2. Hapus HockeySDK.framework dan HockeySDK.framework.dSYM dari proyek XCode dan klik tombol Pindahkan ke Sampah .

  3. Buka tab Fase Build dan temukan bagian Jalankan Skrip . Hapus HockeyApp dari input.xcfilelist dan output.xcfilelist.

1.2 Menambahkan SDK App Center baru

App Center SDK mendukung integrasi melalui Cocoapods, Carthage, Swift Package Manager dan dengan menggunakan Frameworks dalam proyek Xcode Anda. Baca instruksi terperinci cara mengintegrasikan App Center SDK dalam dokumentasi App Center SDK.

Catatan

App Center SDK dirancang dengan pendekatan modular sehingga Anda dapat menggunakan salah satu atau semua layanan. Lihat kesetaraan dalam tabel berikutnya:

Kelas HockeyApp Modul App Center
MetricsManager Analytics
CrashManager Crashes

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 AppDelegate Anda.

    Sebelumnya:

    @import HockeySDK;

    import HockeySDK

    Setelahnya:

    @import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Ganti kode pendaftaran

    didFinishLaunchingWithOptions Temukan metode dan ganti kemunculan kode HockeyApp.

    Sebelumnya:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    Setelahnya:

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

  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 [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analitik

HockeySDK mengumpulkan metrik secara default. App Center SDK tidak mengumpulkan metrik (analitik) apa pun secara default. Untuk mengumpulkan metrik menggunakan App Center SDK, teruskan MSACAnalytics ke start: metode .

Fitur HockeyApp Pusat Aplikasi
Melacak sesi secara otomatis Diaktifkan secara default Dokumentasi (diaktifkan secara default)
Peristiwa kustom dengan properti Ya [MSACAnalytics trackEvent:withProperties:]
Menonaktifkan layanan saat runtime [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Crash

HockeySDK melaporkan crash secara default. Crash akan segera dikirim ke server saat aplikasi diluncurkan berikutnya. App Center SDK tidak melaporkan crash secara default. Untuk mengumpulkan crash menggunakan App Center SDK, teruskan MSACCrashes ke start: metode .

Fitur HockeyApp Pusat Aplikasi
Mengirim crash secara otomatis Diaktifkan secara default Dokumentasi (diaktifkan secara default)
Membuat crash pengujian [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Info tentang crash sebelumnya [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Melampirkan data meta tambahan Ya Dokumentasi (dapat dilampirkan dari delegasi)
Mengkustomisasi dialog pengguna setCrashReportUIHandler Dokumentasi (tidak disediakan secara default)
Menonaktifkan layanan saat runtime [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]