Migrieren von HockeySDK zu App Center UWP
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 möglicherweise eine Migration in Erwägung ziehen.
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
Hinweis
Plattformen wie WinRT, Windows Phone 8.0 und 8.1, WPF und PCL werden im App Center SDK nicht unterstützt. Sie können das HockeySDK weiterhin mit ihnen verwenden.
Ersetzen Sie das NuGet-Paket HockeySDK.UWP 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.UWP-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 Extras>NuGet-Paket-Manager-Paket-Manager-Konsole>aus.
- Wenn Sie in Visual Studio für Mac arbeiten, stellen Sie sicher, dass Sie NuGet-Paketverwaltungserweiterungen installiert haben. Wählen Sie hierzu VisualStudio-Erweiterungen> aus, suchen Sie nach NuGet, und installieren Sie sie bei Bedarf.
- Geben Sie den folgenden Befehl in die Konsole ein:
Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes
Das App Center SDK verwendet einen modularen Ansatz: Sie können nur die Dienste integrieren, die Sie interessieren. Sie müssen jedes SDK-Modul als separate Abhängigkeit in diesem Abschnitt 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 vom 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 eine Darstellung zu erhalten 8-4-4-4-12
.
Vorher (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. Dienste- und Featurevergleich
Core
Funktion | HockeyApp | App Center |
---|---|---|
Anpassen der Protokollebene | Yes | AppCenter.LogLevel |
Analyse
Funktion | HockeyApp | App Center |
---|---|---|
Sitzungen automatisch nachverfolgen | 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 | Ja | Nicht unterstützt |
Nachverfolgen behandelter Ausnahmen | HockeyClient.Current.TrackException |
Nicht unterstützt |
Distribution
Das App Center SDK unterstützt die Verteilung für UWP-Apps noch nicht.
Feedbackdienst
Der Feedbackdienst wird in App Center nicht unterstützt. Siehe HockeyApp-Feedback.