Introduzione a MAUI e Xamarin

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

Per iniziare a configurare App Center .NET SDK nell'app, è possibile iniziare a usare App Center Analytics e Gli arresti anomali di App Center. Per aggiungere App Center Distribute all'app, vedere la documentazione relativa a App Center Distribute.

1. Prerequisiti

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

• Il progetto è configurato in Visual Studio o in Visual Studio per Mac.
• Per i dispositivi che eseguono iOS 11.0 o versione successiva o Android 5.0 (livello API 21) o versione successiva.
• Non si usano altri SDK che forniscono funzionalità di creazione di report di arresto anomalo del sistema.

Piattaforme supportate:

• MAUI iOS
• MAUI Android
• MAUI Windows
• .NET 6.0 macOS
• Xamarin.Android
• Xamarin.iOS
• Xamarin.Mac
• Xamarin.Forms (applicazioni iOS, macOS Android, UWP e Windows Desktop)

1.1 MAUI

1.2 Informazioni su Xamarin.Android

Creare un'app nel portale di App Center con Android come sistema operativo e Xamarin come piattaforma.

1.3 Informazioni su Xamarin.iOS

Creare un'app nel portale di App Center con iOS come sistema operativo e Xamarin come piattaforma.

1.4 Informazioni su Xamarin.Mac

Creare un'app nel portale di App Center con macOS come sistema operativo e Xamarin come piattaforma.

1.5 Informazioni su Xamarin.Forms (iOS, macOS, Android, UWP e Windows Desktop)

Creare 5 app in App Center, una per ogni sistema operativo.

È necessario selezionare Xamarin come piattaforma per le applicazioni Android, iOS e macOS (le applicazioni UWP e Desktop non hanno un'opzione Xamarin).

Per le applicazioni Desktop e macOS di Windows è necessario configurare il progetto per la compatibilità con la piattaforma Xamarin.Forms.

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. Vai a appcenter.ms.
2. 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.
3. Immettere un nome e una descrizione facoltativa per l'app.
4. Selezionare il sistema operativo e la piattaforma appropriati a seconda del progetto, come descritto in precedenza.
5. 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 tre punti verticali e selezionare Copy app secret per ottenere il segreto dell'app.

3. Aggiungere App Center SDK alla soluzione

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

Visual Studio per Mac

• Aprire Visual Studio.
• Fare clic su Apri file> e scegliere la soluzione.
• Nello strumento di spostamento della soluzione fare clic con il pulsante destro del mouse sulla sezione Pacchetti e scegliere Aggiungi pacchetti NuGet.
• Cercare App Center e selezionare App Center Analytics and App Center Crashes (Arresti anomali di App Center e App Center).
• Fare clic su Aggiungi pacchetti.

Visual Studio per Windows

• Aprire Visual Studio.
• Fare clic su Apri file> 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.
• 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> console diGestione>pacchetti NuGet.
• Se si lavora in Visual Studio per Mac, assicurarsi di aver installato le estensioni di gestione pacchetti NuGet. A questo scopo, scegliereEstensioni di Visual Studio>, cercare NuGet e installare, se necessario.
• Digitare il comando seguente nella console:

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.

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

4.1 Aggiungere le istruzioni using

Aggiungere gli spazi dei nomi appropriati nei file seguenti:

• MAUI e Xamarin.Forms - App.xaml.cs
• Xamarin.iOS e Xamarin.Mac - AppDelegate.cs
• Xamarin.Android - MainActivity.cs

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

4.2 Aggiungere il Start() metodo

4.2.1 MAUI e Xamarin.Forms

È necessario creare applicazioni diverse per ogni piattaforma nel portale di App Center. Per ogni app si avrà un segreto dell'app diverso. Aprire il file di App.xaml.cs del progetto e aggiungere la riga seguente nel costruttore (o nel OnStart() metodo per Xamarin.Forms).

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics), typeof(Crashes));

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

1. Configurarlo o avviarlo con il segreto dell'app.
2. Se il codice può essere chiamato più volte, controllare se App Center è già configurato.
3. Avviare i servizi necessari senza il segreto dell'app.

AppCenter.Configure("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

Aprire il file di MainActivity.cs del progetto e aggiungere la Start() chiamata all'interno del OnCreate() metodo

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

4.2.3 Xamarin.iOS e Xamarin.Mac

Aprire il file del AppDelegate.cs progetto e aggiungere la Start() chiamata all'interno del FinishedLaunching() metodo

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

4.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, è possibile copiare l'intero esempio.

L'esempio precedente illustra come usare il Start() metodo e includere sia App Center Analytics che App Center Crashes.

Se non si vuole usare uno dei due servizi, rimuovere il parametro corrispondente dalla chiamata al metodo precedente.

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

Ad esempio, se si vuole eseguire l'onboarding in App Center Analytics, è necessario modificare la Start() chiamata come indicato di seguito:

4.3.1 MAUI e Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Xamarin Native

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

Si è tutti impostati per visualizzare i dati di Analisi e arresti anomali nel portale raccolti automaticamente dall'SDK.

Per informazioni su come personalizzare e usare funzionalità più avanzate di entrambi i servizi, vedere la documentazione relativa ad App Center Analytics e App Center Crashes .

Per informazioni su come iniziare a usare gli aggiornamenti in-app, leggere la documentazione di App Center Distribute.

5. Regole di backup (solo Android)

Se si usa il backup automatico per evitare di ottenere informazioni errate sui dispositivi, seguire questa procedura:

5.1. Per Android 11 (livello API 30) o inferiore.

1. Creare appcenter_backup_rule.xml file nella cartella Resources/xml .

2. Aprire il file diAndroidManifest.xml del progetto. Aggiungere l'attributo android:fullBackupContent all'elemento <application> . Deve puntare al file di risorse appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Aggiungere le regole di backup seguenti al file appcenter_backup_rule.xml :

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Per Android 12 (livello API 31) o versione successiva.

1. Creare appcenter_backup_rule.xml file nella cartella Resources/xml .

2. Aprire il file diAndroidManifest.xml del progetto. Aggiungere l'attributo android:dataExtractionRules all'elemento <application> . Deve puntare al file di risorse appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Aggiungere le regole di backup seguenti al file appcenter_backup_rule.xml :

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>