Introduzione a WPF/WinForms

  • 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:

  • Il progetto è destinato a .NET Framework 4.6.2 (o versione successiva) o .NET Core 3.1 (o versione successiva).
  • .NET Core è supportato solo quando l'applicazione WPF/WinForms viene eseguita in Windows.
  • Se si usa l'SDK da una libreria portatile, deve essere destinato a .NET Standard 2.0 o versione successiva (PCL non è supportato).
  • Tipo di progetto PackageReference. Questo requisito proviene dalla SQLitePCL.raw libreria. Altre informazioni in https://github.com/ericsink/SQLitePCL.raw/issues/537.
  • Si è verificato un problema noto durante l'integrazione dell'SDK nei progetti VSTO. Per altri dettagli, vedere https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

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.

Nota

App Center SDK usa assembly con nome sicuro per la compatibilità con applicazioni che usano il segno con nome sicuro.

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

Nota

Se si usa App Center SDK in un progetto portatile, è necessario installare i pacchetti in ognuno dei progetti: portabile e il progetto che esegue l'app WPF/WinForms. A tale scopo, è necessario aprire ogni sottoprogetto e seguire i passaggi corrispondenti descritti nella sezione Visual Studio .

4. Avviare l'SDK

Per usare App Center, 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.

4.1 Aggiungere il Start() metodo

WPF

Per l'applicazione WPF, modificare App.xaml.cs e aggiungere le istruzioni using seguenti:

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

Quindi nello stesso file aggiungere il codice seguente nel OnStartup metodo:

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

Se il file non ha il App.xaml.csOnStartup metodo, è possibile aggiungere il Application.OnStartup(StartupEventArgs) metodo. Il App.xaml.cs file dovrebbe essere simile al seguente:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      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)); 
}

WinForms

Per l'applicazione WinForms, modificare il Program.cs file e aggiungere le istruzioni using seguenti:

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

Quindi nello stesso file aggiungere il codice seguente nel Main metodo, prima dell'istruzione Application.Run .

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

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)); 
}

Avviso

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

4.2 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 gli arresti anomali 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.