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.
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
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");
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.