Introduzione a WPF/WinForms

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.

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

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

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

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.