Condividi tramite

Introduzione ad Android

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.

È possibile trovare informazioni sui dati raccolti da App Center sui dati raccolti dagli SDK di App Center, regolamento generale sulla protezione dei dati e pagine delle domande frequenti .

Iniziamo a configurare l'SDK Android di App Center nell'app per usare App Center Analytics e App Center Crashes. Per aggiungere App Center Distribute all'app, vedere la documentazione per App Center Distribute.

1. Prerequisiti

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

  • Il progetto Android è configurato in Android Studio.
  • I dispositivi destinati all'esecuzione di Android versione 5.0 (livello API 21) o versioni successive.

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 fare clic sul pulsante Aggiungi nuovo nell'angolo superiore destro della pagina e selezionare Aggiungi nuova app dal menu a discesa.
  3. Immettere un nome e una descrizione facoltativa per l'app.
  4. Selezionare Android come sistema operativo e Java come piattaforma.
  5. Fare clic sul pulsante Aggiungi nuova app .

Dopo aver creato un'app, è possibile ottenere il segreto dell'app nella pagina Attività iniziali in 2. Avviare l'SDK. In alternativa, è possibile fare clic su Impostazioni e nell'angolo superiore destro fare clic sui tre punti verticali e selezionare Copia segreto dell'app per ottenere il segreto dell'app .

3. Aggiungere i moduli di App Center SDK

  1. Aprire il file build.gradle a livello di app del progetto (app/build.gradle) e aggiungere le righe seguenti dopo apply plugin. Includere le dipendenze desiderate nel progetto. Ogni modulo SDK deve essere aggiunto come dipendenza separata in questa sezione. Se si vuole usare Analisi e arresti anomali di App Center, aggiungere le righe seguenti:
dependencies {
    def appCenterSdkVersion = '5.0.6'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

Annotazioni

Se la versione del plug-in Android Gradle è inferiore alla 3.0.0, è necessario sostituire la parola implementazione per compilazione.

Annotazioni

A causa della chiusura del supporto di jCenter , tutti gli assembly sono stati spostati nel repository di Maven Central. Seguire questa guida sulla migrazione da jCenter a Maven Central. Si noti che Maven Central non contiene moduli deprecati. Assicurarsi che il progetto non abbia dipendenze dei moduli deprecati di App Center SDK.

  1. Assicurarsi di attivare una sincronizzazione Gradle in Android Studio.

Ora che l'SDK è stato integrato nell'applicazione, è possibile avviare l'SDK e usare App Center.

4. Avviare l'SDK

4.1 Aggiungere il metodo start()

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.
Inserisci la riga seguente all'interno della callback nella classe principale dell'attività dell'app per usare onCreate e App Center Crashes:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)

Avvertimento

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

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

  1. Configuralo o avvialo con l'App Secret.
  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(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Se nell'applicazione sono presenti più punti di ingresso, ad esempio un'attività di collegamento diretto, un servizio o un ricevitore di trasmissione, chiamare start nella classe personalizzata dell'applicazione o in ogni punto di ingresso. Nel secondo caso, verificare se App Center è già configurato prima della start chiamata:

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

if (!AppCenter.isConfigured()) {
  AppCenter.start(application, "{Your App Secret}", Analytics::class.java, Crashes::class.java)
}

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 Attività iniziali contiene l'esempio di codice precedente con il segreto dell'app, è sufficiente copiare l'intero esempio.

L'esempio precedente mostra come usare il metodo start() 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 il servizio App Center. Inoltre, l'API start() può essere usata solo una volta nel ciclo di vita dell'app. Tutte le altre chiamate includono un avviso nella console e saranno disponibili solo i moduli inclusi nella prima chiamata.

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

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Android Studio suggerisce automaticamente le istruzioni di importazione necessarie dopo aver inserito il start() metodo , ma se viene visualizzato un errore che indica che i nomi delle classi non vengono riconosciuti, aggiungere le righe seguenti alle istruzioni import nella classe di attività:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

Sei pronto a visualizzare i dati analitici e le anomalie di sistema sul 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.

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

5. Regole di backup (solo Android)

Annotazioni

Le app destinate ad Android 6.0 (livello API 23) o versioni successive hanno automaticamente abilitato il backup automatico. 

Annotazioni

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

Se si usa il backup automatico per evitare di ottenere informazioni errate sui dispositivi, attenersi alla procedura seguente:

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

  1. Creare appcenter_backup_rule.xml file nella cartella res/xml .
  1. Apri il file AndroidManifest.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 res/xml .
  1. Apri il file AndroidManifest.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>