Kom igång med Android

2025-05-05

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

App Center SDK använder en modulär arkitektur så att du kan använda alla eller alla tjänster.

Du hittar information om data som samlas in av App Center om data som samlas in av App Center SDK:er, allmänna dataskyddsförordningar och sidor med vanliga frågor och svar .

Nu ska vi komma igång med att konfigurera App Center Android SDK i din app för att använda App Center Analytics och App Center Crashes. Om du vill lägga till App Center-distribution till din app kan du titta på dokumentationen för App Center Distribute.

1. Förutsättningar

Innan du börjar kontrollerar du att följande krav uppfylls:

Ditt Android-projekt har konfigurerats i Android Studio.
Du riktar in dig på enheter som kör Android Version 5.0 (API-nivå 21) eller senare.

2. Skapa din app i App Center-portalen för att hämta apphemligheten

Om du redan har skapat din app i App Center-portalen kan du hoppa över det här steget.

Gå över till appcenter.ms.
Registrera dig eller logga in och klicka på knappen Lägg till ny i det övre högra hörnet på sidan och välj Lägg till ny app på den nedrullningsbara menyn.
Ange ett namn och en valfri beskrivning för din app.
Välj Android som operativsystem och Java som plattform.
Klicka på knappen Lägg till ny app .

När du har skapat en app kan du hämta dess apphemlighet på sidan Komma igång under 2. Starta SDK:et. Eller så kan du klicka på Inställningar, och i det övre högra hörnet klickar du på de tre lodräta punkterna och väljer Kopiera apphemlighet för att hämta din apphemlighet.

3. Lägg till App Center SDK-modulerna

Öppna projektets build.gradle-fil på appnivå (app/build.gradle) och lägg till följande rader efter apply plugin. Inkludera de beroenden som du vill använda i projektet. Varje SDK-modul måste läggas till som ett separat beroende i det här avsnittet. Om du vill använda App Center Analytics och Krascher lägger du till följande rader:

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

Anmärkning

Om versionen av plugin-programmet Android Gradle är lägre än 3.0.0 måste du ersätta ordet implementering med kompilering.

Anmärkning

På grund av att jCenter-supporten avslutats flyttades alla våra sammansättningar till Maven Central-lagringsplatsen. Följ den här guiden om migrering från jCenter till Maven Central. Observera att Maven Central inte innehåller inaktuella moduler. Kontrollera att projektet inte har beroenden av inaktuella App Center SDK-moduler.

Se till att utlösa en Gradle-synkronisering i Android Studio.

Nu när du har integrerat SDK:et i ditt program är det dags att starta SDK och använda App Center.

4. Starta SDK

4.1 Lägg till metoden start()

Om du vill använda App Center måste du välja de moduler som du vill använda. Som standard startas inga moduler och du måste uttryckligen anropa var och en av dem när du startar SDK:n.
Infoga följande rad i appens huvudaktivitetsklass' onCreate-återanrop för att använda App Center Analytics och 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)

Varning

Vi rekommenderar inte att du bäddar in din apphemlighet i källkoden.

Om du behöver starta App Center-tjänster separat bör du:

Konfigurera eller starta den med apphemligheten.
Om koden kan anropas flera gånger kontrollerar du om App Center redan har konfigurerats.
Starta de nödvändiga tjänsterna utan apphemligheten.

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

Om du har mer än en startpunkt i ditt program (till exempel en djuplänksaktivitet, en tjänst eller en sändningsmottagare) ska du anropa start i den anpassade klassen för programmet eller vid varje startpunkt. I det senare fallet kontrollerar du om App Center redan har konfigurerats före anropet start :

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 Ersätt platshållaren med din apphemlighet

Ersätt {Your App Secret} text med det faktiska värdet för ditt program. Apphemligheten finns på sidan Komma igång eller på sidan Inställningar i App Center-portalen.

Sidan Komma igång innehåller kodexemplet ovan med din apphemlighet i. Du kan bara kopiera och klistra in hela exemplet.

Exemplet ovan visar hur du använder metoden start() och inkluderar både App Center Analytics och App Center Crashes.

Om du inte vill använda någon av de två tjänsterna tar du bort motsvarande parameter från metodanropet ovan.

Om du inte uttryckligen anger varje modul som parametrar i startmetoden kan du inte använda den App Center-tjänsten. Dessutom kan API:et start() endast användas en gång i appens livscykel – alla andra anrop loggar en varning till konsolen och endast modulerna som ingår i det första anropet är tillgängliga.

Till exempel – Om du bara vill registrera dig för App Center Analytics bör du ändra API-anropet start() på följande sätt:

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

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

Android Studio föreslår automatiskt de nödvändiga importinstruktionerna start() när du infogar metoden, men om du ser ett fel om att klassnamnen inte känns igen lägger du till följande rader i importinstruktionerna i aktivitetsklassen:

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

Du är redo att visualisera analys- och kraschdata på portalen som SDK:et samlar in automatiskt.

Titta på dokumentationen för App Center Analytics och App Center Crashes för att lära dig hur du anpassar och använder mer avancerade funktioner i tjänsterna.

Mer information om hur du kommer igång med uppdateringar i appen finns i dokumentationen för App Center Distribute.

5. Säkerhetskopieringsregler (endast Android)

Anmärkning

Appar som riktar in sig på Android 6.0 (API-nivå 23) eller senare har automatisk säkerhetskopiering aktiverad automatiskt.

Anmärkning

Om du redan har en anpassad fil med säkerhetskopieringsregeln växlar du till det tredje steget.

Om du använder automatisk säkerhetskopiering för att undvika felaktig information om enheter följer du nästa steg:

5.1. För Android 11 (API-nivå 30) eller lägre.

Skapa appcenter_backup_rule.xml fil i mappen res/xml .

Öppna projektets AndroidManifest.xml-fil . android:fullBackupContent Lägg till attributet i elementet<application>. Den bör peka på resursfilenappcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

Lägg till följande säkerhetskopieringsregler i filenappcenter_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. För Android 12 (API-nivå 31) eller senare.

Skapa appcenter_backup_rule.xml fil i mappen res/xml .

Öppna projektets AndroidManifest.xml-fil . android:dataExtractionRules Lägg till attributet i elementet<application>. Den bör peka på resursfilenappcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

Lägg till följande säkerhetskopieringsregler i filenappcenter_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>

Dela via

Kom igång med Android

1. Förutsättningar

2. Skapa din app i App Center-portalen för att hämta apphemligheten

3. Lägg till App Center SDK-modulerna

4. Starta SDK

4.1 Lägg till metoden start()

4.2 Ersätt platshållaren med din apphemlighet

5. Säkerhetskopieringsregler (endast Android)

5.1. För Android 11 (API-nivå 30) eller lägre.

5.2. För Android 12 (API-nivå 31) eller senare.

Feedback

Ytterligare resurser