Bermigrasi dari HockeySDK ke App Center SDK untuk macOS

  • 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 alih-alih 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-Mac" baris dari Podfile, lalu jalankan pod install.

Carthage

Jika Anda telah menambahkan SDK menggunakan Carthage, ikuti langkah-langkah berikut:

  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 .

1.2 Menambahkan SDK App Center baru

App Center SDK mendukung untuk diintegrasikan melalui Cocoapods, Carthage, Swift Package Manager dan menggunakan Kerangka Kerja 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. 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

  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 HockeyApp API di seluruh aplikasi. Tabel pemetaan API terperinci diberikan di bawah ini.

3. Perbandingan layanan dan fitur

Core

Fitur HockeyApp Pusat Aplikasi
Menyesuaikan tingkat log [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analitik

HockeySDK mengumpulkan metrik per default. App Center SDK tidak mengumpulkan metrik (analitik) apa pun per 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 per default. Crash akan segera dikirim ke server saat aplikasi diluncurkan berikutnya. App Center SDK tidak melaporkan crash per default. Untuk mengumpulkan crash menggunakan App Center SDK, teruskan MSACCrashes ke start: metode .

Fitur HockeyApp Pusat Aplikasi
Mengirim crash secara otomatis [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Dokumentasi (diaktifkan secara default)
Membuat crash pengujian [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Info tentang crash sebelumnya [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Penanganan pengecualian Mach [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Dokumentasi (diaktifkan secara default)
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]