Freigeben über


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.

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

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

  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. 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.