Introduzione a WPF/WinForms

2025-05-05

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:

Il progetto è destinato a .NET Framework 4.6.2 (o versione successiva) o a .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 portabile, 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. Per altre informazioni, vedere https://github.com/ericsink/SQLitePCL.raw/issues/537.
Si è verificato un problema noto durante l'integrazione dell'SDK nei progetti VSTO. Per altri dettagli, visitare 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.

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.
Immettere un nome e una descrizione facoltativa per l'app.
Selezionare il sistema operativo e la piattaforma appropriati a seconda del progetto, come descritto in precedenza.
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.

Annotazioni

App Center SDK utilizza assembly con nome forte per garantire la compatibilità con le applicazioni che usano una firma con nome forte.

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

Annotazioni

Se si usa App Center SDK in un progetto portabile, è necessario installare i pacchetti in ognuno dei progetti: il portatile 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 utilizzare App Center, seleziona i moduli che desideri usare. Per impostazione predefinita, non vengono avviati moduli ed è necessario chiamarli in modo esplicito all'avvio dell'SDK.

4.1 Aggiungere il `Start()` metodo

WPF (Windows Presentation Foundation)

Per la tua applicazione WPF, modifica App.xaml.cs e aggiungi le seguenti istruzioni using:

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 App.xaml.cs file non ha il OnStartup 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));
    }
  }
}

Avvertimento

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

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

Configuralo o avvialo con l'App Secret.
Se il codice può essere chiamato più volte, verificare se App Center è già configurato.
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:

Configuralo o avvialo con l'App Secret.
Se il codice può essere chiamato più volte, verificare se App Center è già configurato.
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)); 
}

Avvertimento

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

4.2 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.

Ottimo, sei pronto per visualizzare gli arresti anomali nel portale raccolti automaticamente dall'SDK.

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.

Condividi tramite