Řešení potíží se sadou Android SDK

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

• Android
• iOS
• macOS
• tvOS
• React Native
• Cordova
• Unity
• Windows
• MAUI/Xamarin

Jaká oprávnění Androidu se vyžadují?

V závislosti na službách, které používáte, se vyžadují následující oprávnění:

• Všechny služby: INTERNET, ACCESS_NETWORK_STATE
• Distribuovat: REQUEST_INSTALL_PACKAGES, DOWNLOAD_WITHOUT_NOTIFICATION

Sada SDK automaticky sloučí požadovaná oprávnění s manifestem vaší aplikace.

Žádná z těchto oprávnění nevyžaduje schválení uživatele za běhu, všechna se jedná o oprávnění v době instalace.

Analytická data se nezobrazují na portálu

1. Ujistěte se, že jste správně integrovali moduly sady SDK.

2. Ujistěte se, že spolu s voláním start() metody je zahrnutý správný tajný kód aplikace. Přesný start() kód můžete zkopírovat tak, že aplikaci otevřete na portálu a přejdete na stránku Začínáme.

3. Pokud chcete zobrazit protokoly, které se odesílají do back-endu, změňte úroveň protokolu ve vaší aplikaci na Podrobné a sada SDK vytiskne protokoly v konzole. Před spuštěním sady SDK zavolejte níže uvedené rozhraní API.

   AppCenter.setLogLevel(Log.VERBOSE);
   

   AppCenter.setLogLevel(Log.VERBOSE)
   

   Zkontrolujte protokoly "Sada App Center SDK se úspěšně nakonfigurovala" (na úrovni protokolu informací) a pak zkontrolujte, jestli se zobrazují protokoly požadavků HTTPS.

4. Ujistěte se, že je vaše zařízení online.

5. Někdy může trvat několik minut, než se protokoly na portálu proberou. V takovém případě nějakou dobu počkejte.

6. Pokud chcete zkontrolovat, jestli back-end App Center přijal vaše data, přejděte do části Tok protokolu ve službě Analytics. Vaše události by se měly zobrazit po odeslání.

Chybové ukončení se na portálu nezobrazují

1. Ujistěte se, že jste správně integrovali moduly sady SDK.

2. Ujistěte se, že spolu s voláním start() metody je zahrnutý správný tajný kód aplikace. Přesný start() kód můžete zkopírovat tak, že aplikaci otevřete na portálu a přejdete na stránku Začínáme.

3. Po chybovém ukončení restartujte aplikaci. Naše sada SDK předá protokol chybových ukončení až po jeho restartování.

4. Pokud chcete zobrazit protokoly, které se odesílají do back-endu, změňte úroveň protokolu ve vaší aplikaci na Podrobné a sada SDK vytiskne protokoly v konzole. Před spuštěním sady SDK zavolejte níže uvedené rozhraní API.

   AppCenter.setLogLevel(Log.VERBOSE);
   

   AppCenter.setLogLevel(Log.VERBOSE)
   

   Zkontrolujte protokoly "Sada App Center SDK se úspěšně nakonfigurovala" (na úrovni protokolu informací) a pak zkontrolujte, jestli se zobrazují protokoly požadavků HTTPS.

5. Ujistěte se, že je vaše zařízení online.

6. Někdy může trvat několik minut, než se protokoly na portálu proberou. V takovém případě nějakou dobu počkejte.

7. Pokud chcete zkontrolovat, jestli sada SDK zjistila chybové ukončení při příštím spuštění aplikace, můžete voláním rozhraní API zkontrolovat, jestli aplikace havarovala v poslední relaci a jestli se zobrazilo upozornění. Nebo můžete zpětné volání při selhání rozšířit a zjistit, jestli se úspěšně odeslalo na server.

8. Pokud chcete zkontrolovat, jestli back-end App Center obdržel chybové ukončení, přejděte ve službě Analytics do části Tok protokolu. Po odeslání by se tam měla objevit chyba.

Distribuce a aktualizace v aplikaci blokují automatizované testy uživatelského rozhraní

Pokud spouštíte automatizované testy uživatelského rozhraní, povolené aktualizace v aplikaci zablokují vaše automatizované testy uživatelského rozhraní, protože se pokusí ověřit v back-endu App Center. Pro testy uživatelského rozhraní doporučujeme nepovolovat distribuci v App Center.

Jaký vliv má sada App Center SDK na velikost aplikace pro Android?

Sada App Center SDK je navržená tak, aby měla minimální dopad na velikost instalace vaší aplikace.

Pro ilustraci jsme vytvořili prázdnou aplikaci v Javě pomocí šablony "prázdná aplikace" v Android Studiu. Aplikaci jsme sestavili v konfiguraci vydané verze a nainstalovali ji na zařízení s Androidem 7.0.

Testy se spustily bez povolené funkce Proguard.

Následující čísla se můžou lišit a záviset na nastavení sestavení, proto je považujte za přibližný návod. Pokud použijete Proguard, bude dopad sady SDK na vaši aplikaci ještě nižší.

Použité moduly App Center	Exportovaná velikost souboru APK	Velikost instalace (podle hlášení zařízení)
Žádná (prázdná aplikace)	1,3 MB	3,43 MB
Analýzy služby App Center	1,4 MB	3,63 MB
Chybové ukončení app center	1,4 MB	3,70 MB
Distribuce v App Center	1,4 MB	3,71 MB
Všechny moduly App Center	1,4 MB	3,82 MB

Ochrana hodnoty tajného kódu app center

Je app_secret identifikátor vaší aplikace, musí vědět, na kterou aplikaci se provoz vztahuje, a nedá se použít k načtení nebo úpravě existujících dat. Pokud je vaše app_secret zařízení vystavené, je největším rizikem odeslání špatných dat do aplikace, ale nebude to mít vliv na zabezpečení dat.

Pokud chcete načíst citlivá data, musíte zadat token aplikace nebo uživatele, který se vygeneruje na straně klienta. Neexistuje žádný způsob, jak úplně zabezpečit data na straně klienta.

Zabezpečení aplikace můžete zlepšit použitím proměnné prostředí, která vloží tajný kód aplikace do kódu. Tajný kód se tak v kódu nezobrazí.

Migrace z jCenter na Maven Central

Z důvodu ukončení podpory jCenter byla všechna naše sestavení přesunuta do centrálního úložiště Maven. Pokud chcete používat App Center, musíte ho přidat mavenCentral() do úložiště v souboru Gradle, jak je znázorněno níže:

repositories {
   google()
   mavenCentral()
}