Az Android használatának első lépései

2025-05-05

Fontos

A Visual Studio App Center 2025. március 31-én megszűnt, kivéve az Elemzési és diagnosztikai funkciókat, amelyek 2026. június 30-ig továbbra is támogatottak lesznek. Tudj meg többet.

Az App Center SDK moduláris architektúrát használ, így bármely vagy az összes szolgáltatást használhatja.

Az App Center által az App Center SDK-k által gyűjtött adatokról, az általános adatvédelmi rendeletről és a GYIK-oldalakról talál információkat.

Első lépésként állítsa be az App Center Android SDK-t az alkalmazásban az App Center Analytics és az App Center Crashes használatára. Az App Center Distribute alkalmazáshoz való hozzáadásához tekintse meg az App Center Distribute dokumentációját.

1. Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következő előfeltételek teljesülnek:

Android-projektje az Android Studióban van beállítva.
Android 5.0-s (API 21-es szintű) vagy újabb verziót futtató eszközöket céloz meg.

2. Az alkalmazás létrehozása az App Center portálon az alkalmazás titkos kódjának beszerzéséhez

Ha már létrehozta az alkalmazást az App Center portálon, kihagyhatja ezt a lépést.

Irány appcenter.ms.
Regisztráljon vagy jelentkezzen be, majd kattintson az Új hozzáadása gombra a lap jobb felső sarkában, és válassza az Új alkalmazás hozzáadása lehetőséget a legördülő menüben.
Adja meg az alkalmazás nevét és leírását.
Válassza az Androidot operációs rendszerként és Java-t platformként.
Kattintson az Új alkalmazás hozzáadása gombra.

Miután létrehozott egy alkalmazást, a 2. lépés alatt található Első lépések lapon beszerezheti az alkalmazás titkos kódját . Indítsa el az SDK-t. Vagy kattintson a Beállítások gombra, és a jobb felső sarokban kattintson a három függőleges pontra , és válassza az Alkalmazás titkos kódjának másolása lehetőséget az alkalmazás titkos kódjának lekéréséhez.

3. Az App Center SDK-moduljainak hozzáadása

Nyissa meg a projekt alkalmazásszintű build.gradle fájlját (app/build.gradle), és adja hozzá a következő sorokat.apply plugin Adja meg a projektben használni kívánt függőségeket. Ebben a szakaszban minden SDK-modult külön függőségként kell hozzáadni. Ha az App Center Analytics és az Összeomlások szolgáltatást szeretné használni, adja hozzá a következő sorokat:

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

Megjegyzés:

Ha az Android Gradle plugin verziója kisebb, mint 3.0.0, akkor a implementation szót a compile szóval kell lecserélnie.

Megjegyzés:

A jCenter támogatásának megszűnése miatt az összes szerelvényeket áthelyeztük a Maven Central-adattárba. Kövesse ezt az útmutatót a jCenterből a Maven Centralba való migrálásról. Vegye figyelembe, hogy a Maven Central nem tartalmaz elavult modulokat. Győződjön meg arról, hogy a projekt nem rendelkezik elavult App Center SDK-modulok függőségével.

Mindenképpen aktiváljon Gradle-szinkronizálást az Android Studióban.

Most, hogy integrálta az SDK-t az alkalmazásba, ideje elindítani az SDK-t, és használni az App Centert.

4. Az SDK indítása

4.1 A start() metódus hozzáadása

Az App Center használatához be kell jelentkeznie a használni kívánt modul(ok)ba. Alapértelmezés szerint nem indulnak el modulok, és az SDK indításakor mindegyiknek explicit módon kell meghívnia őket.
Helyezze be a következő sort az alkalmazás fő tevékenységosztályának onCreate visszahívásán belül az App Center Analytics és az App Center Crashes használatához:

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

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

Figyelmeztetés

Nem ajánlott az alkalmazás titkos kódjának beágyazása a forráskódba.

Ha külön kell elindítania az App Center-szolgáltatásokat, a következőt kell elvégeznie:

Konfigurálja vagy indítsa el az alkalmazás titkos kódjával.
Ha a kód többször is meghívható, ellenőrizze, hogy az App Center már konfigurálva van-e.
Indítsa el a szükséges szolgáltatás(ok)t az App Secret nélkül.

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

Ha egynél több belépési ponttal rendelkezik az alkalmazásához (például egy mélyhivatkozási tevékenység, szolgáltatás vagy közvetítési fogadó esetén), akkor hívja meg a start az alkalmazás egyedi osztályában vagy minden egyes belépési pontban. Az utóbbi esetben ellenőrizze, hogy az App Center már konfigurálva van-e a start hívás előtt:

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 Cserélje le a helyőrzőt az alkalmazás titkos kódjára

Ügyeljen arra, hogy a {Your App Secret} szöveget cserélje le az alkalmazás tényleges értékére. Az alkalmazás titkos kódja az Első lépések lapon vagy a Beállítások lapon található az App Center portálon.

Az Első lépések lap tartalmazza a fenti kódmintát, benne az alkalmazás titkos kódjával, egyszerűen másolhatja és beillesztheti a teljes mintát.

A fenti példa bemutatja, hogyan használható a start() módszer, és hogyan foglalható bele az App Center Analytics és az App Center Crashes.

Ha nem szeretné használni a két szolgáltatás egyikét, távolítsa el a megfelelő paramétert a fenti metódushívásból.

Hacsak nem adja meg az egyes modulokat paraméterekként a kezdőmetódusban, nem használhatja az App Center szolgáltatást. Emellett az start() API csak egyszer használható az alkalmazás életciklusában – minden más hívás figyelmeztetést fog naplózni a konzolon, és csak az első hívásban szereplő modulok lesznek elérhetők.

Ha például csak az App Center Analytics szolgáltatásba szeretne bejelentkezni, módosítsa az API-hívást az start() alábbiak szerint:

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

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

Az Android Studio automatikusan javasolja a szükséges importálási utasításokat a start() metódus beszúrása után, de ha hibaüzenet jelenik meg, hogy az osztálynevek nem ismerődnek fel, adja hozzá a következő sorokat a tevékenységosztály importálási utasításaihoz:

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

Minden készen áll az SDK által automatikusan gyűjtött analitikai és összeomlási adatok portálon történő megjelenítésére.

Az App Center Analytics és az App Center Crashes dokumentációjában megtudhatja, hogyan szabhatja testre és használhatja a két szolgáltatás fejlettebb funkcióit.

Az alkalmazáson belüli frissítések használatának megkezdéséhez olvassa el az App Center Distribute dokumentációját.

5. Biztonsági mentési szabályok (csak Android esetén)

Megjegyzés:

Az Android 6.0-s (API 23-es szintű) vagy újabb verziót megcélzott alkalmazások automatikusan engedélyezve vannak az Automatikus biztonsági mentés funkcióval.

Megjegyzés:

Ha már rendelkezik biztonsági mentési szabálysal rendelkező egyéni fájllal, váltson a harmadik lépésre.

Ha automatikus biztonsági mentést használ az eszközökkel kapcsolatos helytelen információk lekérésének elkerülése érdekében, kövesse a következő lépéseket:

5.1. Android 11 (API level 30) vagy alacsonyabb.

Hozzon létre appcenter_backup_rule.xml fájlt a res/xml mappában.

Nyissa meg a projekt AndroidManifest.xml fájlját. Adja hozzá az android:fullBackupContent attribútumot az <application> elemhez. A appcenter_backup_rule.xml erőforrásfájlra kell mutatnia.

android:fullBackupContent="@xml/appcenter_backup_rule"

Adja hozzá a következő biztonsági mentési szabályokat a appcenter_backup_rule.xml fájlhoz:

<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. Android 12 (API level 31) vagy újabb verzióhoz.

Hozzon létre appcenter_backup_rule.xml fájlt a res/xml mappában.

Nyissa meg a projekt AndroidManifest.xml fájlját. Adja hozzá az android:dataExtractionRules attribútumot az <application> elemhez. A appcenter_backup_rule.xml erőforrásfájlra kell mutatnia.

android:dataExtractionRules="@xml/appcenter_backup_rule"

Adja hozzá a következő biztonsági mentési szabályokat a appcenter_backup_rule.xml fájlhoz:

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

Megosztás a következőn keresztül:

Az Android használatának első lépései

1. Előfeltételek

2. Az alkalmazás létrehozása az App Center portálon az alkalmazás titkos kódjának beszerzéséhez

3. Az App Center SDK-moduljainak hozzáadása

4. Az SDK indítása

4.1 A start() metódus hozzáadása

4.2 Cserélje le a helyőrzőt az alkalmazás titkos kódjára

5. Biztonsági mentési szabályok (csak Android esetén)

5.1. Android 11 (API level 30) vagy alacsonyabb.

5.2. Android 12 (API level 31) vagy újabb verzióhoz.

Visszajelzés

További források