Aracılığıyla paylaş


HockeySDK'den macOS için App Center SDK'sına geçiş

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

Uygulamanızı HockeySDK yerine App Center SDK'sını kullanacak şekilde güncelleştirmek istiyorsanız bu belgeleri izleyin.

1. Kitaplıkları güncelleştirme

1.1 Eski HockeySDK'yi kaldırın

El ile

SDK'yı el ile eklediyseniz şu adımları izleyin:

  1. XCode projesinden başvuruyu kaldırın HockeySDK.framework . Başvuruyu kaldır düğmesine tıklayın, Çöp Sepetine Taşı düğmesine tıklamayın.

  2. Proje ayarlarınızı açın ve Üst Bilgi Arama Yolları / Çerçevesi Arama Yolları bölümlerindeki Derleme Ayarları sekmesinin altında HockeySDK ile ilgili üst bilgi dosyalarının konumlarını kaldırın.

  3. Proje ayarlarınızı açın ve İkiliYi Kitaplıklarla Bağla bölümündeki Derleme Aşamaları sekmesinin altında HockeySDK ile ilgili bağımlılık girdilerini kaldırın.

  4. Dosya sisteminden silin HockeySDK.framework .

Podfile

CocoaPods kullanarak SDK'yı eklediyseniz pod dosyasından pod "HockeySDK-Mac" satırı kaldırın ve komutunu çalıştırınpod install.

Kartaca

SDK'yı Kartaj kullanarak eklediyseniz şu adımları izleyin:

  1. HockeySDK başvurularını içinden Cartfilekaldırın. Dosya sisteminden silin Cartfile.Resolved .

  2. XCode projesini silin HockeySDK.framework ve HockeySDK.framework.dSYMÇöp Kutusuna Taşı düğmesine tıklayın.

1.2 Yeni App Center SDK'sını ekleme

App Center SDK'sı Cocoapods, Carthage, Swift Paket Yöneticisi ve Xcode projenizde Çerçeveler kullanılarak tümleştirilmesini destekler. App Center SDK'sını tümleştirmeye ilişkin ayrıntılı yönergeleri App Center SDK belgelerinde okuyun.

Not

App Center SDK'sı modüler bir yaklaşımla tasarlanmıştır, böylece hizmetlerin herhangi birini veya tümünü kullanabilirsiniz. Sonraki tabloda denkliklere bakın:

HockeyApp sınıfı App Center modülü
MetricsManager Analytics
CrashManager Crashes

2. SDK kurulum kodunu güncelleştirme

2.1 Uygulama tanımlayıcısını dönüştürme

App Center SDK'sı, uygulama tanımlayıcılarını genel olarak benzersiz tanımlayıcı (GUID) biçiminde kullanır. HockeyApp Uygulama Kimliğiniz App Center tarafından kullanılabilir ancak bunu farklı bir biçime dönüştürmeniz gerekir. Tanımlayıcıyı dönüştürmek için 8-4-4-4-12 gösterimi almak için dört kısa çizgi eklemeniz gerekir.

Önce (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Uygulama kodunda SDK başlatmasını değiştirme

  1. AppDelegate sınıfınızda aşağıdaki içeri aktarmaları değiştirin.

    Önce:

    @import HockeySDK;
    
    import HockeySDK
    

    Sonra:

    @import AppCenter;
    @import AppCenterAnalytics;
    @import AppCenterCrashes;
    
    import AppCenter
    import AppCenterAnalytics
    import AppCenterCrashes
    
  2. Kayıt kodunu değiştirme

    didFinishLaunchingWithOptions yöntemini bulun ve HockeyApp kod oluşumlarını değiştirin.

    Önce:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
    [[BITHockeyManager sharedHockeyManager] startManager];
    
    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
    BITHockeyManager.shared().start()
    

    Sonra:

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
    
    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])
    
  3. Uygulama genelinde HockeyApp API çağrılarını değiştirin. Ayrıntılı API eşleme tabloları aşağıda verilmiştir.

3. Hizmetler ve özellik karşılaştırması

Çekirdek

Özellik HockeyApp App Center
Günlük düzeyini ayarlama [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Analiz

HockeySDK varsayılan olarak ölçümleri toplar. App Center SDK'sı varsayılan olarak herhangi bir (analiz) ölçümü toplamaz. App Center SDK'sını kullanarak ölçümleri toplamak için yöntemine start: geçinMSACAnalytics.

Özellik HockeyApp App Center
Oturumları otomatik olarak izleme Varsayılan olarak etkindir Belgeler (varsayılan olarak etkindir)
Özelliklere sahip özel olaylar Yes [MSACAnalytics trackEvent:withProperties:]
Çalışma zamanında hizmeti devre dışı bırakma [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Çökü -yor

HockeySDK raporları varsayılan olarak kilitleniyor. Kilitlenmeler, uygulamanın bir sonraki başlatılışında hemen sunucuya gönderilir. App Center SDK'sı varsayılan olarak kilitlenme bildirmez. App Center SDK'sını kullanarak kilitlenmeleri toplamak için yöntemine start: geçinMSACCrashes.

Özellik HockeyApp App Center
Kilitlenmeleri otomatik olarak gönderme [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Belgeler (varsayılan olarak etkin)
Test kilitlenmesi oluşturma [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Önceki kilitlenme hakkında bilgi [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Mach özel durum işleme [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Belgeler (varsayılan olarak etkin)
Ek meta veri ekleme Yes Belgeler (temsilciden eklenebilir)
Kullanıcıyı özelleştir iletişim kutusu setCrashReportUIHandler Belgeler (varsayılan olarak sağlanmaz)
Çalışma zamanında hizmeti devre dışı bırakma [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]