Udostępnij za pośrednictwem

Migrowanie z zestawu HockeySDK do centrum aplikacji WPF/Winforms

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej 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

Zastąp pakiet NuGet HockeySDK.WPF pakietem NuGet w centrum aplikacji we wszystkich projektach w rozwiązaniu.

Program Visual Studio dla systemu Windows

  • Otwórz program Visual Studio dla systemu Windows.
  • Kliknij pozycję Plik>Otwórz i wybierz rozwiązanie.
  • W nawigatorze rozwiązań kliknij prawym przyciskiem myszy pozycję Odwołania i wybierz polecenie Zarządzaj pakietami NuGet.
  • Usuń pakiet HockeySDK.WPF .
  • Wyszukaj pozycję App Center i zainstaluj pakiety Microsoft.AppCenter.Analytics i Microsoft.AppCenter.Crash .

Konsola menedżera pakietów

  • Otwórz konsolę w programie Visual Studio. W tym celu wybierz pozycję Narzędzia Konsola>Menedżera>pakietów NuGet Menedżera pakietów.
  • Jeśli pracujesz w Visual Studio dla komputerów Mac, upewnij się, że masz zainstalowane rozszerzenia zarządzania pakietami NuGet. W tym celu wybierz pozycjęRozszerzeniaprogramu Visual Studio>, wyszukaj ciąg NuGet i zainstaluj w razie potrzeby.
  • Wpisz następujące polecenia w konsoli:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Zestaw SDK centrum aplikacji korzysta z modułowego podejścia — możesz wybrać usługi, które chcesz zintegrować. Każdy moduł SDK należy dodać jako oddzielną zależność w tej sekcji.

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 centrum aplikacji, ale musisz przekonwertować go na inny format. Aby przekonwertować identyfikator, należy dodać cztery łączniki, aby uzyskać 8-4-4-4-12 reprezentację.

Przed (HockeyApp): 00112233445566778899aabbccddeeff

Po (Centrum aplikacji): 00112233-4455-6677-8899-aabbccddeeff

2.2 Zastąp inicjowanie zestawu SDK w kodzie aplikacji

  1. Usuń stary kod rejestracji hockeyApp. W deklaracji instrukcji using usuń następujący wiersz:

    using Microsoft.HockeyApp;

    Na początku konstruktora klasy App usuń następujący wiersz:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Uruchom zestaw SDK centrum aplikacji. Przed użyciem naszych interfejsów API dodaj odpowiednie przestrzenie nazw.

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

    Dodaj następujące wywołanie do konstruktora aplikacji:

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

3. Porównanie usług i funkcji

Core

Cecha HockeyApp App Center
Dostosowywanie poziomu dziennika Tak AppCenter.LogLevel

Analiza

Cecha HockeyApp App Center
Automatyczne śledzenie sesji Tak Informacje o sesji i urządzeniu
Zdarzenia niestandardowe z właściwościami HockeyClient.TrackEvent Analytics.TrackEvent

Ulega awarii

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii Domyślnie włączone Raportowanie awarii
Dołączanie dodatkowych danych meta Tak Dodawanie załączników
Śledzenie obsługiwanych wyjątków HockeyClient.Current.TrackException Obsługiwane błędy

Dystrybucja

Zestaw SDK centrum aplikacji nie obsługuje jeszcze dystrybucji aplikacji WPF/Winforms.

Usługa opinii

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