Introduzione ad Android

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 App Center Android SDK nell'app per 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 Android è configurato in Android Studio.
• I dispositivi che eseguono Android versione 5.0 (livello API 21) o versione successiva sono destinati ai dispositivi.

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 Introduzione 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. Per usare App Center Analytics e arresti anomali, aggiungere le righe seguenti:

dependencies {
    def appCenterSdkVersion = '5.0.4'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

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

Dopo aver integrato l'SDK 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.
Inserire la riga seguente all'interno della classe di attività principale dell'app: onCreatecallback per usare App Center Analytics e App Center Arresti anomali:

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

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

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(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 si dispone di più di un punto di ingresso all'applicazione (ad esempio, un'attività di collegamento diretto, un servizio o un ricevitore broadcast), chiamare start nella classe personalizzata dell'applicazione o in ogni punto di ingresso. In quest'ultimo caso, controllare 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 {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, è sufficiente copiare e incollare 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 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

Tutti sono impostati per visualizzare i dati di Analisi e arresti anomali nel portale che l'SDK raccoglie automaticamente.

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 res/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 res/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>