Udostępnij za pośrednictwem

Migrowanie z zestawu HockeySDK do zestawu SDK systemu Android w usłudze App Center

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Postępuj zgodnie z tą dokumentacją, jeśli chcesz zaktualizować aplikację do używania zestawu SDK centrum aplikacji zamiast zestawu HockeySDK.

1. Aktualizowanie bibliotek

Otwórz plik build.gradle na poziomie aplikacji projektu (app/build.gradle) i zastąp następujący wiersz w dependencies { ... } konfiguracji.

Przed:

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

Po:

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

Zestaw SDK centrum aplikacji został zaprojektowany z modułowym podejściem — możesz zintegrować tylko te usługi, które cię interesują. Każdy moduł SDK musi zostać dodany jako osobna zależność w tej sekcji. Zobacz równoważności w następnej tabeli:

HockeyApp, klasa Moduł usługi App Center
MetricsManager Analytics
CrashManager Crashes
UpdateManager Distribute

2. Aktualizowanie kodu konfiguracji zestawu SDK

2.1 Konwertowanie identyfikatora aplikacji

Zestaw SDK centrum aplikacji używa identyfikatorów aplikacji w formacie globalnie unikatowego identyfikatora (GUID). Identyfikator aplikacji HockeyApp może być używany przez usługę App Center, ale musisz przekonwertować go na inny format. Aby przekonwertować identyfikator, należy dodać cztery łączniki, aby uzyskać reprezentację 8-4-4-4-12.

Przed (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Zastępowanie inicjowania zestawu SDK w kodzie aplikacji

  1. Zastąp następujące importy w klasie działań.

    Przed:

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

    Po:

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

  2. Zastąp kod rejestracji wewnątrz głównej klasy działań aplikacji " onCreate-callback.

    Przed:

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

    Po:

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

    Jeśli użyto metadanych do podania identyfikatora aplikacji, musisz skopiować go stamtąd do kodu inicjowania i usunąć

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

    z pliku AndroidManifest.xml .

  3. Zastąp wywołania interfejsu API hockeyApp w całej aplikacji. Szczegółowe tabele mapowania interfejsu API podano poniżej.

3. Porównanie usług i funkcji

Core

Cecha HockeyApp App Center
Dostosowywanie poziomu dziennika HockeyLog.setLogLevel AppCenter.setLogLevel
Identyfikowanie instalacji Tylko do użytku wewnętrznego AppCenter.getInstallId
Identyfikowanie użytkowników Tylko awarie AppCenter.setUserId

Analiza

Cecha HockeyApp App Center
Automatyczne śledzenie sesji Tak, można wyłączyć przez MetricsManager.setSessionTrackingDisabled Dokumentacja (nie można jej wyłączyć)
Zdarzenia niestandardowe z właściwościami MetricsManager.trackEvent Analytics.trackEvent
Wyłączanie usługi w czasie wykonywania MetricsManager.disableUserMetrics i MetricsManager.enableUserMetrics Analytics.setEnabled

Ulega awarii

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii Domyślnie wyłączone Dokumentacja (domyślnie włączona)
Dołączanie dodatkowych metadanych Tak Dokumentacja (można dołączyć z odbiornika)
Okno dialogowe Dostosowywanie użytkownika Tak Dokumentacja (nie dostarczona domyślnie)
Uzyskiwanie informacji o stanie wysyłania Tak Dokumentacja
Informacje o poprzedniej awarii CrashManager.getLastCrashDetails Crash.getLastSessionCrashReport

Rozłóż

Uwaga

W przeciwieństwie do usługi HockeyApp funkcja aktualizacji w aplikacji usługi App Center działa tylko z kompilacjami RELEASE (domyślnie), które są dystrybuowane przy użyciu usługi rozproszonej App Center . Jeśli aplikacja korzysta z prywatnej grupy dystrybucyjnej, po zainstalowaniu i otwarciu aplikacji po raz pierwszy po dodaniu zestawu SDK dystrybucji centrum aplikacji zostanie otwarta przeglądarka w celu uwierzytelnienia użytkownika i włączenia aktualizacji w aplikacji. Ta przeglądarka zostanie również otwarta, jeśli ustawisz prywatną ścieżkę aktualizacji w aplikacji w czasie wykonywania. Jest to jednorazowy krok, który nie będzie występować w przypadku kolejnych wydań aplikacji. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją dystrybucji centrum aplikacji .

Cecha HockeyApp App Center
Ograniczone aktualizacje w aplikacji LoginManager.verifyLogin Distribute.setUpdateTrack
Wyłączanie usługi w czasie wykonywania UpdateManager.unregister Distribute.setEnabled
Dostosowywanie okna dialogowego aktualizacji Tak Dokumentacja

Usługa opinii

Usługa opinii nie będzie obsługiwana w centrum aplikacji. Zobacz Opinie hockeyApp.