Migrace z HockeySDK na Sadu App Center SDK pro Unity

  • Č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

1.1 Odstranit staré HockeySDK

  1. Zvolte herní objekt, který jste vytvořili pro sadu SDK, a odeberte HockeyAppAndroid / HockeyAppiOS komponentu kliknutím na ikonu >NastaveníOdebrat komponentu.

  2. Odeberte složky HockeyAppUnityAndroid / HockeyAppUnityiOS ze složky Assets ve vašem projektu Unity.

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

Sada App Center SDK se integruje importem balíčků Unity do projektu. Uděláte to tak, že nejprve nainstaluje modul plug-in App Center Unity Editor Extensions. Otevřete rozšíření Editor z nabídky Unity: Windows>App Center>Editor Extensions a vyberte Nainstalovat sadu App Center SDK.

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í. Podívejte se na ekvivalence v následující tabulce:

Modul HockeyApp Modul App Center
Crashes and Exceptions Crashes
Metrics Analytics
Version Updates Distribute

Pokud chcete služby nainstalovat samostatně, můžete na každé kartě vybrat Nainstalovat sadu SDK .

Poznámka

App Center Unity SDK je jedna sada pro všechny tři platformy: Android, iOS a UPW. Nemusíte instalovat každou sadu SDK zvlášť.

Doporučeným způsobem integrace sady App Center Unity SDK je použití rozšíření App Center Editor, ale podporujeme i jiné scénáře. Další informace najdete v dokumentaci k Unity pro App Center.

2. Nastavení 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 Konfigurace sady SDK

Připojit skript App Center

V okně Projekt přejděte do složky AppCenter , která byla přidána do projektu. Vyhledejte skript s logem App Center jako ikonou s názvem AppCenterBehaviora přetáhněte ho na herní objekt, který jste dříve použili pro HockeySDK.

Konfigurace nastavení App Center

Klikněte na tento herní objekt a v okně Inspektoru uvidíte konfiguraci App Center.

Konfigurace skriptu App Center

Další informace vyplňte pomocí tabulky podrobného mapování konfigurace, která je uvedena níže.

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

Nastavení Aplikace HockeyApp Nastavení App Center Poznámky
ID aplikace Tajný kód aplikace pro Android/iOS Použijte ID aplikace, které jste převedli v předchozím kroku.
Adresa URL serveru Vlastní adresa URL protokolu, oddíl Další nastavení Zaškrtněte políčko Použít vlastní adresu URL protokolu.
Omezené aktualizace v aplikaci NA Distribute.UpdateTrack
Chyby a výjimky (povolené ve výchozím nastavení) Použití chybových ukončení Chybový modul
Chybové ukončení automatického nahrávání NA (povolené ve výchozím nastavení) Dokumentace (ve výchozím nastavení povoleno, dá se nakonfigurovat)
Protokolování výjimek Úroveň počátečního protokolu, část Další nastavení Pokud chcete podrobnější protokolování, použijte Verbose
Metriky uživatelů Použití analýz Modul Analýzy
Aktualizace verze (povolené ve výchozím nastavení) Použití distribuce Distribuce modulu
Aktualizace výstrahy NA Dokumentace (musí být nakonfigurovaná)

Poznámka

Pokud váš projekt nepodporuje některou ze tří platforem uvedených v nastavení, ponechte pole tajných kódů aplikace tak, jak je. nebude mít žádný účinek. Pokud váš projekt podporuje platformy, které App Center nepodporuje, nebudou mít rozhraní API a konfigurace pro tyto platformy žádný vliv.

Pokud váš projekt zahrnuje volání rozhraní API HockeySDK v celé aplikaci, nahraďte je pomocí níže uvedené podrobné tabulky mapování rozhraní API.

Funkce HockeyApp App Center
Vlastní události s vlastnostmi HockeyAppIOS.TrackEvent nebo HockeyAppAndroid.TrackEvent Analytics.TrackEvent
Explicitní kontrola aktualizací HockeyAppIOS.CheckForUpdate nebo HockeyAppAndroid.CheckForUpdate Distribute.CheckforUpdate
Zobrazení formuláře pro zpětnou vazbu HockeyAppIOS.ShowFeedbackForm nebo HockeyAppAndroid.ShowFeedbackForm NA (viz část níže)

Služba Feedback

Služba zpětné vazby nebude v App Center podporovaná. Podívejte se na váš názor na HockeyApp.