Sdílet prostřednictvím

Migrace z HockeySDK na App Center Android SDK

  • Článek

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Pokud chcete aplikaci aktualizovat tak, aby místo Sady HockeySDK používala sadu App Center SDK, postupujte podle této dokumentace.

1. Aktualizace knihoven

Otevřete soubor build.gradle na úrovni aplikace projektu (app/build.gradle) a v dependencies { ... } konfiguraci nahraďte následující řádek.

Před:

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}"

Sada App Center SDK je navržená s modulárním přístupem – můžete integrovat jenom ty služby, které vás zajímají. Každý modul SADY SDK je potřeba v této části přidat jako samostatnou závislost. Podívejte se na ekvivalence v následující tabulce:

HockeyApp – třída Modul App Center
MetricsManager Analytics
CrashManager Crashes
UpdateManager Distribute

2. Aktualizace instalačního kódu sady SDK

2.1 Převod identifikátoru aplikace

Sada App Center SDK používá identifikátory aplikace ve formátu globálně jedinečného identifikátoru (GUID). App Center může id aplikace HockeyApp používat, ale musíte ho převést do jiného formátu. Chcete-li převést identifikátor, musíte přidat čtyři pomlčky, abyste získali reprezentaci 8-4-4-4-12.

Před (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Nahrazení inicializace sady SDK v kódu aplikace

  1. Nahraďte následující importy ve třídě aktivity.

    Před:

    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. Nahraďte registrační kód v hlavní třídě aktivity vaší aplikace – onCreatezpětné volání.

    Před:

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

    Po:

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

    Pokud jste k zadání identifikátoru aplikace použili metadata, musíte ho zkopírovat odsud do inicializačního kódu a odebrat.

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

    z vašehoAndroidManifest.xml souboru.

  3. Nahraďte volání rozhraní API HockeyApp v celé aplikaci. Podrobné tabulky mapování rozhraní API jsou uvedeny níže.

3. Porovnání služeb a funkcí

Jádro

Funkce HockeyApp App Center
Úprava úrovně protokolu HockeyLog.setLogLevel AppCenter.setLogLevel
Identifikace instalací Pouze pro interní účely AppCenter.getInstallId
Identifikace uživatelů Pouze chyby AppCenter.setUserId

Analýzy

Funkce HockeyApp App Center
Automatické sledování relací Ano, dá se zakázat MetricsManager.setSessionTrackingDisabled Dokumentace (nelze zakázat)
Vlastní události s vlastnostmi MetricsManager.trackEvent Analytics.trackEvent
Zakázání služby za běhu MetricsManager.disableUserMetrics a MetricsManager.enableUserMetrics Analytics.setEnabled

Pády

Funkce HockeyApp App Center
Automatické odesílání chybových ukončení Ve výchozím nastavení zakázaná Dokumentace (ve výchozím nastavení povoleno)
Připojit další metadata Yes Dokumentace (lze připojit z naslouchacího procesu)
Dialogové okno Přizpůsobit uživatele Yes Dokumentace (ve výchozím nastavení není k dispozici)
Získání informací o stavu odeslání Yes Dokumentace
Informace o předchozím chybovém ukončení CrashManager.getLastCrashDetails Crashes.getLastSessionCrashReport

Rozmístit

Poznámka

Na rozdíl od HockeyApp funguje funkce aktualizací v aplikaci App Center jenom s buildy RELEASE (ve výchozím nastavení), které se distribuují pomocí služby App Center Distribute . Pokud aplikace používá privátní distribuční skupinu, po instalaci a prvním otevření aplikace po přidání sady App Center Distribute SDK se otevře prohlížeč pro ověření uživatele a povolení aktualizací v aplikaci. Tento prohlížeč se také otevře, pokud za běhu nastavíte privátní trasu aktualizací v aplikaci. Jedná se o jednorázový krok, ke kterému nedojde v dalších verzích vaší aplikace. Další podrobnosti najdete v dokumentaci k distribuci app center .

Funkce HockeyApp App Center
Omezené aktualizace v aplikaci LoginManager.verifyLogin Distribute.setUpdateTrack
Zakázání služby za běhu UpdateManager.unregister Distribute.setEnabled
Přizpůsobení dialogového okna aktualizace Yes Dokumentace

Služba Feedback

Služba zpětné vazby nebude v App Center podporována. Přečtěte si článek o zpětné vazbě aplikace HockeyApp.