Aan de slag met Android

2025-05-05

Belangrijk

Visual Studio App Center is op 31 maart 2025 buiten gebruik gesteld, met uitzondering van de functies analyse en diagnose, die tot 30 juni 2026 nog steeds worden ondersteund. Meer informatie.

De App Center SDK maakt gebruik van een modulaire architectuur, zodat u alle of alle services kunt gebruiken.

U vindt informatie over gegevens die door App Center worden verzameld op gegevens die zijn verzameld door App Center SDK's, algemene verordening gegevensbescherming en pagina's met veelgestelde vragen .

Laten we aan de slag gaan met het instellen van App Center Android SDK in uw app voor het gebruik van App Center Analytics en App Center-crashes. Als u App Center Distribute wilt toevoegen aan uw app, raadpleegt u de documentatie voor App Center Distribute.

1. Vereisten

Voordat u begint, moet u ervoor zorgen dat aan de volgende vereisten wordt voldaan:

Uw Android-project is ingesteld in Android Studio.
U richt zich op apparaten met Android-versie 5.0 (API-niveau 21) of hoger.

2. Maak uw app in de App Center-portal om het app-geheim te verkrijgen

Als u uw app al hebt gemaakt in de App Center-portal, kunt u deze stap overslaan.

Ga naar appcenter.ms.
Meld u aan of meld u aan en klik op de knop Nieuwe toevoegen in de rechterbovenhoek van de pagina en selecteer Nieuwe app toevoegen in de vervolgkeuzelijst.
Voer een naam en een optionele beschrijving voor uw app in.
Selecteer Android als besturingssysteem en Java als platform.
Klik op de knop Nieuwe app toevoegen .

Nadat u een app hebt gemaakt, kunt u het app-geheim ophalen op de pagina Aan de slag onder 2. Start de SDK. U kunt ook op Instellingen klikken en in de rechterbovenhoek op de drie verticale puntjes klikken en app-geheim kopiëren selecteren om uw app-geheim op te halen.

3. De App Center SDK-modules toevoegen

Open het build.gradle-bestand op app-niveau van het project (app/build.gradle) en voeg de volgende regels toe na apply plugin. Neem de gewenste afhankelijkheden op in uw project. Elke SDK-module moet worden toegevoegd als een afzonderlijke afhankelijkheid in deze sectie. Als u App Center Analytics en Crashes wilt gebruiken, voegt u de volgende regels toe:

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

Opmerking

Als de versie van uw Android Gradle-invoegtoepassing lager is dan 3.0.0, moet u het woord implementatie vervangen door te compileren.

Opmerking

Vanwege beëindiging van jCenter worden al onze assembly's verplaatst naar de Maven Central-opslagplaats. Volg deze handleiding over migratie van jCenter naar Maven Central. Maven Central bevat geen afgeschafte modules. Zorg ervoor dat uw project geen afhankelijkheden heeft van afgeschafte App Center SDK-modules.

Zorg ervoor dat u een Gradle-synchronisatie activeert in Android Studio.

Nu u de SDK in uw toepassing hebt geïntegreerd, is het tijd om de SDK te starten en gebruik te maken van App Center.

4. Start de SDK

4.1 Voeg de methode start() toe

Als u App Center wilt gebruiken, moet u zich aanmelden bij de module(s) die u wilt gebruiken. Standaard worden er geen modules gestart en moet u deze expliciet aanroepen bij het starten van de SDK.
Plaats de volgende regel binnen de onCreate-callback van de hoofdactiviteitsklasse van uw app om App Center Analytics en App Center Crashes te gebruiken:

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

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

Waarschuwing

Het is niet raadzaam om uw app-geheim in te sluiten in de broncode.

Als u App Center-services afzonderlijk moet starten, moet u het volgende doen:

Configureer of start het met de App Secret.
Als de code meerdere keren kan worden aangeroepen, controleert u of het App Center al is geconfigureerd.
Start de vereiste service(s) zonder het app-geheim.

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);
}

Als u meer dan één toegangspunt naar uw toepassing hebt (bijvoorbeeld een deep link-activiteit, een service of een broadcast-ontvanger), roep start aan in de aangepaste klasse van de toepassing of in elk toegangspunt. Controleer in het laatste geval of App Center al is geconfigureerd vóór de start aanroep:

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 Vervang de tijdelijke aanduiding door uw app-geheim

Zorg ervoor dat u de {Your App Secret} tekst vervangt door de werkelijke waarde voor uw toepassing. Het app-geheim vindt u op de pagina Aan de slag of instellingen op de portal van App Center.

De pagina Aan de slag bevat het bovenstaande codevoorbeeld met uw app-geheim. U kunt gewoon het hele voorbeeld kopiëren en plakken.

In het bovenstaande voorbeeld ziet u hoe u de start() methode gebruikt en zowel App Center Analytics als App Center Crashes opneemt.

Als u geen van de twee services wilt gebruiken, verwijdert u de bijbehorende parameter uit de bovenstaande methodeoproep.

Tenzij u elke module expliciet opgeeft als parameters in de startmethode, kunt u die App Center-service niet gebruiken. Bovendien kan de start() API slechts eenmaal worden gebruikt in de levenscyclus van uw app. Alle andere aanroepen melden een waarschuwing aan de console en alleen de modules die in de eerste aanroep zijn opgenomen, zijn beschikbaar.

Als u bijvoorbeeld alleen de onboarding naar App Center Analytics wilt uitvoeren, moet u de start() API-aanroep als volgt wijzigen:

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

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

Android Studio stelt automatisch de vereiste importinstructies voor nadat u de start() methode hebt ingevoegd, maar als er een fout wordt weergegeven dat de klassenamen niet worden herkend, voegt u de volgende regels toe aan de importinstructies in uw activiteitsklasse:

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

U bent klaar om analyse- en crashgegevens te visualiseren in de portal die door de SDK wordt verzameld.

Bekijk de documentatie voor App Center Analytics en App Center Crashes voor meer informatie over het aanpassen en gebruiken van meer geavanceerde functies van beide services.

Lees de documentatie van App Center Distribute voor meer informatie over hoe u aan de slag gaat met updates in apps.

5. Backupregels (alleen Android)

Opmerking

Apps die zijn gericht op Android 6.0 (API-niveau 23) of hoger, hebben automatisch back-up ingeschakeld.

Opmerking

Als u al een aangepast bestand met een back-upregel hebt, schakelt u over naar de derde stap.

Als u automatische back-up gebruikt om onjuiste informatie over apparaten te voorkomen, volgt u de volgende stappen:

5.1. Voor Android 11 (API-niveau 30) of lager.

Maak appcenter_backup_rule.xml bestand in de map res/xml .

Open het AndroidManifest.xml-bestand van het project. Voeg het android:fullBackupContent kenmerk toe aan het <application> element. Het moet verwijzen naar het appcenter_backup_rule.xml hulpbestand.

android:fullBackupContent="@xml/appcenter_backup_rule"

Voeg de volgende back-upregels toe aan het appcenter_backup_rule.xml-bestand :

<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. Voor Android 12 (API-niveau 31) of hoger.

Maak appcenter_backup_rule.xml bestand in de map res/xml .

Open het AndroidManifest.xml-bestand van het project. Voeg het android:dataExtractionRules kenmerk toe aan het <application> element. Het moet verwijzen naar het appcenter_backup_rule.xml hulpbestand.

android:dataExtractionRules="@xml/appcenter_backup_rule"

Voeg de volgende back-upregels toe aan het appcenter_backup_rule.xml-bestand :

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

Delen via

Aan de slag met Android

1. Vereisten

2. Maak uw app in de App Center-portal om het app-geheim te verkrijgen

3. De App Center SDK-modules toevoegen

4. Start de SDK

4.1 Voeg de methode start() toe

4.2 Vervang de tijdelijke aanduiding door uw app-geheim

5. Backupregels (alleen Android)

5.1. Voor Android 11 (API-niveau 30) of lager.

5.2. Voor Android 12 (API-niveau 31) of hoger.

Feedback

Aanvullende resources