Condividi tramite

Introduzione a UWP/WinUI

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

App Center SDK usa un'architettura modulare per poter usare qualsiasi o tutti i servizi.

Iniziamo a configurare l'SDK di App Center nell'app per usare App Center Analytics e App Center Crashes.

1. Prerequisiti

Prima di iniziare, verificare che i prerequisiti seguenti siano soddisfatti:

Per il progetto UWP:

  • Il progetto è configurato in Visual Studio 2017 Update 15.9 o versione successiva.
  • Stai puntando su dispositivi che eseguono Windows 10 build 16299 o versioni successive.
  • Il progetto fa riferimento alla piattaforma UWP (Universal Windows Platform 6.2.8 o versione successiva). Questo pacchetto viene in genere fatto riferimento in modo implicito.
  • NuGet 4.3 o versione successiva.

Per il progetto WinUI:

  • Il progetto è configurato in Visual Studio 2019 Update 16.9 o versione successiva.
  • Stai puntando a dispositivi che eseguono Windows 10 build 17763 o versioni successive.
  • Il progetto fa riferimento a WinUI 3 0.8.0 o versione successiva.

Annotazioni

Se si vuole usare Xamarin.Forms per UWP, seguire la documentazione introduttiva di Xamarin anziché questa.

2. Creare l'app nel portale di App Center per ottenere il segreto dell'app

Se l'app è già stata creata nel portale di App Center, è possibile ignorare questo passaggio.

  1. Iscriversi o accedere e premere il pulsante blu nell'angolo in alto a destra del portale che indica Aggiungi nuovo e selezionare Aggiungi nuova app dal menu a discesa.
  2. Immettere un nome e una descrizione facoltativa per l'app.
  3. Selezionare il sistema operativo e la piattaforma appropriati a seconda del progetto, come descritto in precedenza.
  4. Premere il pulsante in basso a destra che indica Aggiungi nuova app.

Dopo aver creato un'app, è possibile ottenere il segreto dell'app nella pagina Impostazioni del portale di App Center. Nell'angolo superiore destro della pagina Impostazioni fare clic sui punti verticali tripli e selezionare Copy app secret per ottenere il segreto dell'app.

3. Aggiungere i moduli di App Center SDK

App Center SDK può essere integrato usando Visual Studio o la console di Gestione pacchetti.

Visual Studio

  • Apri Visual Studio.
  • Fare clic su FileOpen (>) e scegliere la soluzione.
  • Nello strumento di spostamento della soluzione fare clic con il pulsante destro del mouse su Riferimenti e scegliere Gestisci pacchetti NuGet.
  • Nella scheda Sfoglia cercare App Center e installare i pacchetti Microsoft.AppCenter.Analytics e Microsoft.AppCenter.Crashes .

Console di gestione pacchetti

  • Aprire la console in Visual Studio. A tale scopo, scegliere Strumenti>Gestione pacchetti NuGet>Console di gestione pacchetti.
  • Digitare i comandi seguenti:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Ora che l'SDK è stato integrato nell'applicazione, è possibile avviare l'SDK e usare i servizi di App Center.

Annotazioni

Se si usa App Center SDK in un progetto portabile (ad esempio Xamarin.Forms), è necessario installare i pacchetti in ognuno dei progetti: quelli portabili, Android e iOS. A tale scopo, è necessario aprire ogni sottoprogetto e seguire i passaggi corrispondenti descritti nella sezione Visual Studio .

4. Aggiungere la Internet (Client) funzionalità

In Esplora Soluzioni di Visual Studio, fare doppio clic sul file Package.appxmanifest per l'applicazione. Fare clic sulla scheda Funzionalità e quindi selezionare la funzionalità Internet (client).

5. Avviare l'SDK

Per usare App Center, è necessario acconsentire esplicitamente ai moduli da usare. Per impostazione predefinita, non vengono avviati moduli ed è necessario chiamarli in modo esplicito all'avvio dell'SDK.

5.1 Aggiungere le direttive di utilizzo

Aggiungi i namespace appropriati prima di usare le nostre API.

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

5.2 Aggiungere il Start() metodo

Aggiungere la chiamata seguente al costruttore dell'applicazione:

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

Avvertimento

Non è consigliabile incorporare il segreto dell'app nel codice sorgente.

Se è necessario avviare i servizi di App Center separatamente, è necessario:

  1. Configuralo o avvialo con il codice segreto dell'applicazione.
  2. Se il codice può essere chiamato più volte, verificare se App Center è già configurato.
  3. Avviare i servizi necessari senza il segreto dell'app.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Sostituire il segnaposto con il segreto dell'app

Assicurarsi di sostituire il testo {Your App Secret} con il valore effettivo per l'applicazione. Il segreto dell'app è disponibile nella pagina Attività iniziali o nella pagina Impostazioni del portale di App Center.

La pagina Introduzione contiene l'esempio di codice precedente che include il tuo segreto dell'app. È possibile effettuare il copia-incolla dell'intero esempio.

L'esempio precedente illustra come usare il Start() metodo e include App Center Analytics.

A meno che non si specifichi in modo esplicito ogni servizio come parametri nel metodo start, non è possibile usare il servizio App Center. Inoltre, l'API Start() può essere usata una sola volta nel ciclo di vita dell'app. Tutte le altre chiamate includono un avviso nella console e saranno disponibili solo i servizi inclusi nella prima chiamata.

Perfetto, sei pronto a visualizzare le analisi nel portale che l'SDK raccoglie automaticamente.

Consultare la documentazione per App Center Analytics e App Center Crashes per informazioni su come personalizzare e utilizzare funzionalità più avanzate di entrambi i servizi.