Migrace z HockeySDK na App Center WPF/Winforms

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

Nahraďte balíček NuGet HockeySDK.WPF balíčkem App Center ve všech projektech ve vašem řešení.

Visual Studio pro Windows

  • Otevřete Visual Studio pro Windows.
  • Klikněte na Otevřít soubor> a zvolte řešení.
  • V navigátoru řešení klikněte pravým tlačítkem na Odkazy a zvolte Spravovat balíčky NuGet.
  • Odeberte balíček HockeySDK.WPF .
  • Vyhledejte App Center a nainstalujte balíčky Microsoft.AppCenter.Analytics a Microsoft.AppCenter.Crashes .

Konzola Správce balíčků

  • Otevřete konzolu v sadě Visual Studio. Chcete-li to provést, zvolte Nástroje> Správce >balíčků NuGetKonzola správce balíčků.
  • Pokud pracujete v Visual Studio pro Mac, ujistěte se, že máte nainstalovaná rozšíření Pro správu balíčků NuGet. K tomu zvolteRozšířenísady Visual Studio>, vyhledejte NuGet a v případě potřeby nainstalujte.
  • V konzole zadejte následující příkazy:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Sada App Center SDK používá modulární přístup – můžete si vybrat, které služby chcete integrovat. V této části musíte přidat každý modul sady SDK jako samostatnou závislost.

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 8-4-4-4-12 reprezentaci.

Před (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Nahrazení inicializace sady SDK v kódu aplikace

  1. Odeberte starý registrační kód HockeyApp. using V deklaraci příkazu odeberte následující řádek:

    using Microsoft.HockeyApp;

    Na začátku konstruktoru třídy aplikace odeberte následující řádek:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Spusťte sadu App Center SDK. Před použitím našich rozhraní API přidejte příslušné obory názvů.

    using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

    Do konstruktoru vaší aplikace přidejte následující volání:

    AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));

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

Jádro

Funkce HockeyApp App Center
Úprava úrovně protokolu Yes AppCenter.LogLevel

Analýzy

Funkce HockeyApp App Center
Automatické sledování relací Yes Informace o relacích a zařízeních
Vlastní události s vlastnostmi HockeyClient.TrackEvent Analytics.TrackEvent

Pády

Funkce HockeyApp App Center
Automatické odesílání chybových ukončení Ve výchozím nastavení povolená Zasílání zpráv o chybách
Připojení dalších metadat Yes Přidávání příloh
Sledování zpracovaných výjimek HockeyClient.Current.TrackException Zpracovávané chyby

Distribuce

Sada App Center SDK zatím nepodporuje distribuci aplikací WPF/Winforms.

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.