Condividi tramite


Eseguire la migrazione da HockeySDK a App Center UWP

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Seguire questa documentazione se si vuole aggiornare l'applicazione per usare App Center SDK anziché HockeySDK.

1. Aggiornare le librerie

Nota

Le piattaforme come WinRT, Windows Phone 8.0 e 8.1, WPF e PCL non sono supportate in App Center SDK. È possibile continuare a usare HockeySDK con loro.

Sostituire il pacchetto NuGet HockeySDK.UWP con quelli di App Center in tutti i progetti nella soluzione.

Visual Studio per Windows

  • Aprire Visual Studio per Windows.
  • Fare clic su Apri file> e scegliere la soluzione.
  • Nel navigatore della soluzione fare clic con il pulsante destro del mouse su Riferimenti e scegliere Gestisci pacchetti NuGet.
  • Rimuovere il pacchetto HockeySDK.UWP .
  • Cercare App Center e installare pacchetti Microsoft.AppCenter.Analytics e Microsoft.AppCenter.Crashes.

Console di Gestione pacchetti

  • Aprire la console in Visual Studio. A tale scopo, scegliere Strumenti>di Gestione pacchetti NuGetPackage Manager> Console.
  • Se si lavora in Visual Studio per Mac, assicurarsi di aver installato Le estensioni di gestione pacchetti NuGet. Per questo motivo, scegliere Estensioni di Visual Studio>, cercare NuGet e installare, se necessario.
  • Digitare il comando seguente nella console:
Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK usa un approccio modulare: è possibile integrare solo i servizi interessati. È necessario aggiungere ogni modulo SDK come dipendenza separata in questa sezione.

2. Aggiornare il codice di installazione dell'SDK

2.1 Convertire l'identificatore dell'applicazione

App Center SDK usa gli identificatori dell'applicazione nel formato GUID (Global Unique Identifier). L'ID app HockeyApp può essere usato da App Center, ma è necessario convertirlo in un formato diverso. Per convertire l'identificatore è necessario aggiungere quattro trattini per ottenere 8-4-4-4-12 la rappresentazione.

Prima (HockeyApp):

00112233445566778899aabbccddeeff

Dopo (App Center):

00112233-4455-6677-8899-aabbccddeeff

2.2 Sostituire l'inizializzazione SDK nel codice dell'applicazione

  1. Rimuovere il codice di registrazione di HockeyApp precedente.

    Nella dichiarazione dell'istruzione using rimuovere la riga seguente:

    using Microsoft.HockeyApp;
    

    All'inizio del costruttore della classe App rimuovere la riga seguente:

    HockeyClient.Current.Configure("Your_App_ID");
    
  2. Avviare App Center SDK.

    Aggiungere gli spazi dei nomi appropriati prima di usare le API.

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

    Aggiungere la chiamata seguente al costruttore dell'applicazione:

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

3. Servizi e confronto delle funzionalità

Core

Funzionalità HockeyApp App Center
Modificare il livello di log AppCenter.LogLevel

Analisi

Funzionalità HockeyApp App Center
Tenere traccia automatica delle sessioni Informazioni sulla sessione e sul dispositivo
Eventi personalizzati con proprietà HockeyClient.TrackEvent Analytics.TrackEvent

Crashes

Funzionalità HockeyApp App Center
Invia automaticamente arresti anomali Abilitata per impostazione predefinita Segnalazione di arresti anomali del sistema
Collegare metadati aggiuntivi Non supportato
Tenere traccia delle eccezioni gestite HockeyClient.Current.TrackException Non supportato

Distribuzione

App Center SDK non supporta ancora la distribuzione per le app UWP.

Servizio commenti e suggerimenti

Il servizio di feedback non sarà supportato in App Center. Vedere Feedback di HockeyApp.