HockeySDK'den Cordova 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
Bir terminal penceresi açın, Cordova proje klasörüne gidin ve aşağıdaki komutu yürütür:
cordova plugin add cordova-plugin-appcenter-analyticsUygulama > platformlarınız > android > platform_www > plugins klasörüne gidin ve cordova-plugin-hockeyapp dosyasını silin.
1.2 Yeni App Center SDK'sı ekleme
App Center SDK modüler bir yaklaşımla tasarlanmıştır; yalnızca ilgilendiğiniz hizmetleri tümleştirebilirsiniz. Sonraki tabloda denkliklere bakın:
| HockeyApp modülü | App Center modülü | Yükle komutu |
|---|---|---|
Crashes and Exceptions |
Crashes |
cordova plugin add cordova-plugin-appcenter-crashes |
Metrics |
Analytics |
cordova plugin add cordova-plugin-appcenter-analytics |
İhtiyacınız olan modülü (veya her ikisini birden) yüklemek için komutlardan birini çalıştırın.
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
İşleyici içinde HockeyApp başlatmasını
devicereadykaldırın:hockeyapp.start(null, null, "APP_ID");App Center SDK'sını yapılandırma
Apache Cordova projesinin config.xml dosyasını açın; Apache Cordova projenizin hedef
platformöğelerinin her biri için (bugün yalnızca Android ve iOS) aşağıdaki biçimde bir altpreferenceöğe ekleyin:<preference name="APP_SECRET" value="{App Secret from the previous step}" />Daha fazla bilgi için App Center Cordova belgelerine bakın.
Uygulama genelindeki tüm 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 |
|---|---|---|
| Kullanıcıları Tanımlama | hockeyapp.setUserName veya hockeyapp.setUserEmail | AppCenter.setUserId |
Analiz
| Özellik | HockeyApp | App Center |
|---|---|---|
| Oturumları otomatik olarak izleme | Belgeler (devre dışı bırakılamaz) | Belgeler (varsayılan olarak etkindir) |
| Olayları izleme | hockeyapp.trackEvent | Analytics.trackEvent |
Çökü -yor
| Özellik | HockeyApp | App Center |
|---|---|---|
| Kilitlenmeleri otomatik olarak gönderme | autoSend parametresi (varsayılan olarak devre dışı) | APPCENTER_CRASHES_ALWAYS_SEND (varsayılan olarak etkindir) |
| Ek meta veri ekleme | hockeyapp.addMetaData | Belgeler (dinleyiciden eklenebilir) |
| Test kilitlenmesi oluşturma | hockeyapp.forceCrash | AppCenter.Crashes.generateTestCrash |
| Kilitlenmeyle ilgili iletişim kutusu görüntüleme | ignoreDefaultHandler (varsayılan olarak devre dışı, yalnızca Android) | AppCenter.Crashes.process (kilitlenmeyi işlerken geri çağırma) |
Sürüm güncelleştirmeleri
App Center Distribute hizmeti henüz App Center Cordova SDK'sında desteklenmiyor.
Geri Bildirim Hizmeti
Geri bildirim hizmeti App Center'da desteklenmez. Bkz . HockeyApp geri bildirimi.