Aracılığıyla paylaş

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

  • Makale

Ö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

Projenin uygulama düzeyi build.gradle dosyasını (app/build.gradle) açın ve yapılandırmada dependencies { ... } aşağıdaki satırı değiştirin.

Önce:

implementation 'net.hockeyapp.android:HockeySDK:...'

Sonra:

def appCenterSdkVersion = '5.0.6'
implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"

App Center SDK modüler bir yaklaşımla tasarlanmıştır; yalnızca ilgilendiğiniz hizmetleri tümleştirebilirsiniz. Her SDK modülünün bu bölümde ayrı bir bağımlılık olarak eklenmesi gerekir. Sonraki tabloda denkliklere bakın:

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

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österimini 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. Etkinlik sınıfınızda aşağıdaki içeri aktarmaları değiştirin.

    Önce:

    import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

    Sonra:

    import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;
import com.microsoft.appcenter.distribute.Distribute;

  2. Uygulamanızın ana etkinlik sınıfındaki kayıt kodunu değiştirin' onCreate-callback.

    Önce:

    CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);

    Sonra:

    AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class, Distribute.class);

    Uygulama tanımlayıcısını sağlamak için meta veriler kullandıysanız, bunu oradan başlatma koduna kopyalamanız ve kaldırmanız gerekir

    <meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />

    AndroidManifest.xml dosyanızdan.

  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 HockeyLog.setLogLevel AppCenter.setLogLevel
Yüklemeleri tanımlama Yalnızca iç kullanım için AppCenter.getInstallId
Kullanıcıları tanımlama Yalnızca kilitleniyor AppCenter.setUserId

Analiz

Özellik HockeyApp App Center
Oturumları otomatik olarak izleme Evet, şu şekilde devre dışı bırakılabilir: MetricsManager.setSessionTrackingDisabled Belgeler (devre dışı bırakılamaz)
Özelliklere sahip özel olaylar MetricsManager.trackEvent Analytics.trackEvent
Çalışma zamanında hizmeti devre dışı bırakma MetricsManager.disableUserMetrics ve MetricsManager.enableUserMetrics Analytics.setEnabled

Çökü -yor

Özellik HockeyApp App Center
Kilitlenmeleri otomatik olarak gönderme Varsayılan olarak devre dışıdır Belgeler (varsayılan olarak etkin)
Ek meta veri ekleme Yes Belgeler (dinleyiciden eklenebilir)
Kullanıcıyı özelleştir iletişim kutusu Yes Belgeler (varsayılan olarak sağlanmaz)
Gönderme durumu hakkında bilgi edinin Yes Belgeler
Önceki kilitlenme hakkında bilgi CrashManager.getLastCrashDetails Crashes.getLastSessionCrashReport

Dağıt

Not

HockeyApp'in aksine App Center uygulama içi güncelleştirmeler özelliği yalnızca App Center Distribute hizmeti kullanılarak dağıtılan RELEASE derlemeleriyle (varsayılan olarak) çalışır. Uygulama özel bir dağıtım grubu kullanıyorsa, uygulama yüklendikten ve App Center Dağıtım SDK'sı eklendikten sonra ilk kez açıldıktan sonra, kullanıcının kimliğini doğrulamak ve uygulama içi güncelleştirmeleri etkinleştirmek için bir tarayıcı açılır. Çalışma zamanında özel uygulama içi güncelleştirme izlemesini ayarlarsanız bu tarayıcı da açılır. Bu, uygulamanızın sonraki sürümleri için gerçekleşmeyecek tek SEFERLIK bir adımdır. Daha fazla ayrıntı için App Center Dağıtım Belgeleri'ne bakın.

Özellik HockeyApp App Center
Kısıtlı uygulama içi güncelleştirmeler LoginManager.verifyLogin Distribute.setUpdateTrack
Çalışma zamanında hizmeti devre dışı bırakma UpdateManager.unregister Distribute.setEnabled
Güncelleştirme iletişim kutusunu özelleştirme Yes Belgeler

Geri Bildirim Hizmeti

Geri bildirim hizmeti App Center'da desteklenmez. Bkz . HockeyApp geri bildirimi.