Introduzione a UWP/WinUI

  • Articolo

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.

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

Iniziamo a configurare App Center SDK nell'app per usare App Center Analytics e App Center Arresti anomali.

1. Prerequisiti

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

Per il progetto UWP:

  • Il progetto viene configurato in Visual Studio 2017 Update 15.9 o versione successiva.
  • I dispositivi che eseguono Windows 10 build 16299 o versioni successive.
  • I riferimenti al progetto piattaforma UWP (Universal Windows Platform) 6.2.8 o versioni successive (questo pacchetto viene in genere fatto riferimento in modo implicito).
  • NuGet 4.3 o versione successiva.

Per il progetto WinUI:

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

Nota

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 superiore destro 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 relativo segreto app nella pagina Impostazioni nel 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 app Center SDK

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

Visual Studio

  • Aprire Visual Studio.
  • 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.
  • 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>di Gestione pacchetti NuGetPackage Manager> Console.
  • Digitare i comandi seguenti:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Dopo aver integrato l'SDK nell'applicazione, è possibile avviare l'SDK e usare i servizi di App Center.

Nota

Se si usa App Center SDK in un progetto portatile (ad esempio Xamarin.Forms), è necessario installare i pacchetti in ognuno dei progetti: quelli portatili, 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 selezionare la funzionalità Internet (Client).

5. Avviare l'SDK

Per usare App Center, è necessario acconsentire esplicitamente ai moduli che si desidera usare. Per impostazione predefinita, nessun modulo viene avviato ed è necessario chiamarli in modo esplicito quando si avvia l'SDK.

5.1 Aggiungere le direttive using

Aggiungere gli spazi dei nomi appropriati prima di usare le 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));

Avviso

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

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

  1. Configurarlo o avviarlo con il segreto dell'app.
  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 {Your App Secret} il testo con il valore effettivo per l'applicazione. Il segreto dell'app è disponibile nella pagina Introduzione o nella pagina Impostazioni del portale di App Center.

La pagina Introduzione contiene l'esempio di codice precedente con il segreto dell'app in esso, è possibile copiare l'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 registrano un avviso alla console e saranno disponibili solo i servizi inclusi nella prima chiamata.

Ottimo, è tutto impostato per visualizzare Analytics nel portale che l'SDK raccoglie automaticamente.

Esaminare la documentazione per App Center Analytics e App Center Arresti anomali per informazioni su come personalizzare e usare funzionalità più avanzate di entrambi i servizi.