Migrace ze sady HockeySDK na sadu App Center SDK pro Cordovu

  • Článek

Důležité

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

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

1.1 Odebrat starý HockeySDK

  1. Otevřete okno terminálu, přejděte do složky projektu Cordova a spusťte následující příkaz:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. Přejděte do složky Vaše platformy aplikací >> pro Android > platform_www > plugins a odstraňte z ní cordova-plugin-hockeyapp .

1.2 Přidání nové sady App Center SDK

Sada App Center SDK je navržená modulárním způsobem – můžete integrovat jenom ty služby, které vás zajímají. Podívejte se na ekvivalence v další tabulce:

Modul HockeyApp Modul App Center Příkaz Nainstalovat
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

Spuštěním jednoho z příkazů nainstalujte modul, který potřebujete (nebo obojí).

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ých identifikátorů (GUID). Id aplikace HockeyApp může App Center používat, ale musíte ho převést do jiného formátu. Pokud chcete převést identifikátor, musíte přidat čtyři spojovní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. Odeberte inicializaci HockeyApp v obslužné rutině deviceready :

    hockeyapp.start(null, null, "APP_ID");

  2. Konfigurace sady App Center SDK

    Otevřete soubor config.xml projektu Apache Cordova. Pro každý z cílových platform prvků projektu Apache Cordova (dnes jenom Android a iOS) přidejte podřízený preference prvek v následujícím formátu:

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

    Další informace najdete v dokumentaci k aplikaci App Center Cordova.

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

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

Jádro

Funkce HockeyApp App Center
Identifikace uživatelů hockeyapp.setUserName nebo hockeyapp.setUserEmail AppCenter.setUserId

Analýzy

Funkce HockeyApp App Center
Automatické sledování relací Dokumentace (nejde zakázat) Dokumentace (ve výchozím nastavení povoleno)
Sledování událostí hockeyapp.trackEvent Analytics.trackEvent

Pády

Funkce HockeyApp App Center
Automatické odesílání chybových ukončení parametr autoSend (ve výchozím nastavení zakázaný) APPCENTER_CRASHES_ALWAYS_SEND (ve výchozím nastavení povoleno)
Připojení dalších metadat hockeyapp.addMetaData Dokumentace (lze připojit z naslouchacího procesu)
Generování chybového ukončení testu hockeyapp.forceCrash AppCenter.Crashes.generateTestCrash
Zobrazení dialogového okna při chybovém ukončení ignoreDefaultHandler (ve výchozím nastavení zakázáno, pouze Android) AppCenter.Crashes.process (zpětné volání při zpracování chybového ukončení)

Aktualizace verzí

App Center Distribuce služby zatím není v sadě App Center Cordova SDK podporovaná.

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.