Freigeben über


Migrieren vom HockeySDK zu App Center WPF/Winforms

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Befolgen Sie diese Dokumentation, wenn Sie Ihre Anwendung aktualisieren möchten, um das App Center SDK anstelle von HockeySDK zu verwenden.

1. Aktualisieren der Bibliotheken

Ersetzen Sie das NuGet-Paket HockeySDK.WPF durch die App Center-Pakete in allen Projekten in Ihrer Projektmappe.

Visual Studio für Windows

  • Öffnen Sie Visual Studio für Windows.
  • Klicken Sie auf Datei>öffnen , und wählen Sie Ihre Projektmappe aus.
  • Klicken Sie im Lösungsnavigator mit der rechten Maustaste auf Verweise , und wählen Sie NuGet-Pakete verwalten aus.
  • Entfernen Sie das HockeySDK.WPF-Paket .
  • Suchen Sie nach App Center, und installieren Sie die Pakete Microsoft.AppCenter.Analytics und Microsoft.AppCenter.Crashes .

Paket-Manager-Konsole

  • Öffnen Sie die Konsole in Visual Studio. Wählen Sie hierzu Tools> NuGet-Paket-Manager-Paket-Manager-Paket-Manager-Konsole> aus.
  • Wenn Sie in Visual Studio für Mac arbeiten, stellen Sie sicher, dass NuGet-Paketverwaltungserweiterungen installiert sind. Wählen Sie hierzu VisualStudio-Erweiterungen> aus, suchen Sie nach NuGet, und installieren Sie sie bei Bedarf.
  • Geben Sie die folgenden Befehle in der Konsole ein:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Das App Center SDK verwendet einen modularen Ansatz– Sie können auswählen, welche Dienste Sie integrieren möchten. Sie müssen jedes SDK-Modul in diesem Abschnitt als separate Abhängigkeit hinzufügen.

2. Aktualisieren des SDK-Setupcodes

2.1 Konvertieren des Anwendungsbezeichners

Das App Center SDK verwendet Anwendungsbezeichner im GUID-Format (Globally Unique Identifier). Ihre HockeyApp-App-ID kann von App Center verwendet werden, sie muss jedoch in ein anderes Format konvertiert werden. Um den Bezeichner zu konvertieren, müssen Sie vier Bindestriche hinzufügen, um die Darstellung zu erhalten 8-4-4-4-12 .

Vor (HockeyApp): 00112233445566778899aabbccddeeff

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

2.2 Ersetzen der SDK-Initialisierung im Anwendungscode

  1. Entfernen Sie den alten HockeyApp-Registrierungscode. Entfernen Sie in der using Anweisungsdeklaration die folgende Zeile:

    using Microsoft.HockeyApp;
    

    Entfernen Sie am Anfang des App-Klassenkonstruktors die folgende Zeile:

    HockeyClient.Current.Configure("Your_App_ID");
    
  2. Starten Sie das App Center SDK. Fügen Sie die entsprechenden Namespaces hinzu, bevor Sie unsere APIs verwenden.

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

    Fügen Sie dem Konstruktor Ihrer Anwendung den folgenden Aufruf hinzu:

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

3. Vergleich von Diensten und Features

Core

Funktion HockeyApp App Center
Anpassen der Protokollebene Yes AppCenter.LogLevel

Analyse

Funktion HockeyApp App Center
Automatisches Nachverfolgen von Sitzungen Yes Sitzungs- und Geräteinformationen
Benutzerdefinierte Ereignisse mit Eigenschaften HockeyClient.TrackEvent Analytics.TrackEvent

Crashes

Funktion HockeyApp App Center
Automatisches Senden von Abstürze Standardmäßig aktiviert Absturzberichte
Anfügen zusätzlicher Metadaten Yes Hinzufügen von Anlagen
Nachverfolgen behandelter Ausnahmen HockeyClient.Current.TrackException Behandelte Fehler

Distribution

Das App Center SDK unterstützt die Verteilung für WPF-/Winforms-Apps noch nicht.

Feedback-Dienst

Der Feedbackdienst wird in App Center nicht unterstützt. Weitere Informationen finden Sie unter HockeyApp-Feedback.