Introduzione a Unity

  • Articolo

Importante

Visual Studio App Center è pianificato 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 a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

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

Per iniziare e configurare App Center Unity SDK, è possibile usare App Center Analytics e arresti anomali. Per aggiungere App Center Distribute all'app, vedere la documentazione per App Center Distribute.

1. Prerequisiti

Prima di iniziare, assicurarsi che il progetto sia configurato in Unity 2018.1 o versione successiva.

App Center SDK per Unity supporta le piattaforme seguenti:

  • iOS (9.0 o versione successiva)
  • Android (5.0/API 21 o versione successiva)
  • UWP (Build 16299 o versione successiva)

Nota

La versione del runtime di scripting .NET 3.5 e il back-end di scripting .NET non sono più supportati nella piattaforma UWP.

Per informazioni su come usare coroutine/callback anziché async/await con .NET 3.5 back-end, vedere le API asincrone nella sezione Unity SDK della documentazione.

Inoltre, App Center SDK per Unity è disponibile solo in C#.

2. Creare l'app nel portale di App Center per acquisire 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 ad App Center.
  3. Fare clic sul pulsante blu nell'angolo superiore destro del portale che indica Aggiungi nuovo e selezionare Aggiungi nuova app dal menu a discesa.
  4. Immettere un nome e una descrizione facoltativa per l'app.
  5. Selezionare il sistema operativo e la piattaforma appropriati a seconda del progetto, come descritto in precedenza.
  6. Fare clic sul pulsante Aggiungi nuova app nella parte inferiore destra della pagina.

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 al progetto

3a Installare l'estensione Editor

App Center SDK è integrato importando pacchetti Unity nel progetto. A tale scopo, installare prima di tutto il plug-in App Center Unity Editor Extensions. Aprire le estensioni Editor tramite il menu Unity: Window App Center Editor Extensions (Estensioni di Windows > App Center > ) e selezionare "Install App Center SDK" (Installa App Center SDK).

Nota

Nelle versioni di Unity 2019.1.2f1 e successive potrebbero verificarsi errori nei log durante l'installazione, ad Coroutine continue failureesempio . Si tratta di un problema noto di Unity ed è consigliabile ignorarlo.

3.1b Installare singoli pacchetti

In alternativa, ognuno dei singoli pacchetti Unity può essere scaricato e importato. Sono disponibili nella pagina GitHub di App Center Unity SDK. Scaricare la versione più recente dei pacchetti da usare. Il nome deve essere nel formato AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Importare il pacchetto

Aprire il progetto Unity, quindi fare doppio clic sul pacchetto scaricato. Nel progetto Unity dovrebbe essere visualizzata una finestra popup contenente un elenco di file. Selezionare Importa e l'SDK verrà aggiunto al progetto. Ripetere questo passaggio per ogni pacchetto scaricato e pianificare l'uso nel progetto.

4. Abilitare l'SDK

4.1 Creare un oggetto gioco vuoto

App Center funziona come componente associato a un oggetto gioco nella scena in cui viene avviato il gioco. Passare a questa scena e aggiungere un oggetto gioco vuoto. Assegnargli un nome descrittivo, ad esempio "App Center".

4.2 Allegare lo script di App Center

Nella finestra Progetto passare alla cartella "AppCenter" aggiunta al progetto. Individuare lo script, denominato AppCenterBehavior, e trascinarlo nell'oggetto gioco appena creato nella finestra Hierarchy (Gerarchia ).

Nota

Non è necessario aggiungere App Center a ogni scena in cui si vuole usarlo. L'aggiunta alla prima scena caricata è sufficiente.

4.3 Configurare le impostazioni di App Center

Fare clic su questo nuovo oggetto "App Center" e aggiungere i segreti dell'app ai campi corrispondenti nella finestra Inspector (Controllo ). Assicurarsi di selezionare anche le caselle "Usa {servizio}" per ogni servizio App Center che si intende usare

Configurazione dello script di App Center App

Avviso

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

Nota

Se il progetto non supporta una delle tre piattaforme elencate nelle impostazioni, lasciare invariato il campo segreto dell'app; non avrà alcun effetto. Se il progetto supporta piattaforme non supportate da App Center, le API e la configurazione non avranno alcun effetto per tali piattaforme.

Si è tutti impostati per visualizzare i dati di analisi e diagnostica (arresto anomalo e errore) nel portale che l'SDK raccoglierà automaticamente.

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

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

5. Regole di backup (solo Android)

Nota

Le app destinate ad Android 6.0 (livello API 23) o versioni successive hanno l'abilitazione automatica del backup automatico.

Nota

Se si dispone già di un file personalizzato con una regola di backup, passare al terzo passaggio.

Nota

Se non si ha già il proprio file diAndroidManifest.xml , crearlo nella cartella Assets/Plugins/Android . Questo manifesto verrà unito con quello predefinito creato da Unity al momento della compilazione.

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

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

  1. Creare appcenter_backup_rule.xml file nella cartella Assets/Plugins/Android/res/xml .
  1. 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"
  1. 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 Assets/Plugins/Android/res/xml .
  1. 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"
  1. 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>