Číst v angličtině

Sdílet prostřednictvím


Vytváření aplikací v Javě pro Android

Důležité

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

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

Pokud chcete vytvořit svou první aplikaci pro Android, postupujte takto:

  1. Připojte se ke svému účtu služby úložiště (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Vyberte úložiště a větev, ve které se vaše aplikace nachází.
  3. Zvolte projekt Androidu, který chcete sestavit.
  4. Nastavte první sestavení.

Poznámka

Aby aplikace běžela na skutečném zařízení, musí být sestavení podepsané pomocí platného certifikátu.

Poznámka

App Center sleduje projekt vyhledáváním souborů adresáře gradle (a gradlew) projektu Android. Nezahrnujte tyto soubory do projektu .gitignore, protože sestavení App Center je nebude moct najít.

Upozornění

Kvůli nedávnému vypnutí JCenter můžou některé aplikace při sestavování pomocí App Center zaznamenat selhání úloh Gradle. Projděte si průvodce migrací, který poskytuje Gradle. Jako alternativní řešení lze ze souboru odebrat build.gradle všechny instance jcenter() a nahradit ho .jcenter { url "http://jcenter.bintray.com/"} Přečtěte si další informace o vypnutí JCenter zde.

1. Propojení úložiště

Pokud jste to ještě neudělali, musíte se připojit ke svému účtu služby úložiště. Po připojení účtu vyberte úložiště, ve kterém se nachází váš projekt Androidu. K nastavení sestavení pro úložiště potřebujete oprávnění správce a přijetí změn.

2. Výběr větve

Po výběru úložiště vyberte větev, kterou chcete sestavit. Ve výchozím nastavení budou uvedeny všechny aktivní větve.

3. Nastavení prvního sestavení

Před prvním sestavením je potřeba nakonfigurovat projekt Pro Android.

3.1. Triggery sestavení

Ve výchozím nastavení se nové sestavení aktivuje pokaždé, když vývojář odešle do nakonfigurované větve. Označuje se jako kontinuální integrace. Pokud chcete nové sestavení aktivovat ručně, můžete toto nastavení změnit v podokně konfigurace.

3.2. Varianta sestavení

Dostupné varianty sestavení se naplní z typů sestavení a variant produktů zadaných v souboru build.gradle (úroveň aplikace). Vyberte, která varianta sestavení má být sestavena.

Poznámka

App Center Build podporuje hledání variant sestavení jako kombinace typu sestavení (ladění, verze nebo vlastní definované) a jedné z deklarovaných variant produktu. Detekce dimenzí příchutí (kombinace více variant produktu) se v tuto chvíli nepodporuje.

3.3. Sestavení sady aplikací pro Android (.aab)

Sada aplikací pro Android je distribuční formát, který se nahrává do Obchodu Play a používá se k vygenerování optimalizovaných sad APK pro konkrétní zařízení. Další informace o sadě aplikací pro Android najdete v oficiální dokumentaci k Androidu.

Přepněte možnost sady aplikací pro Android, která vytvoří .aab kromě souboru .apk. build.gradle Pokud soubor (na úrovni aplikace) obsahuje android.bundle blok, tato možnost už bude zapnutá.

3.4. Číslo verze přírůstku

Pokud je tato možnost povolená, kód verze v AndroidManifest.xml vaší aplikace se pro každé sestavení automaticky zvýší. K této změně dojde během skutečného sestavení a nebude potvrzena do vašeho úložiště.

3.5. Podepisování kódu

Úspěšné sestavení vytvoří .apk soubor a další .aab soubor, pokud je povolený. Pokud chcete uvolnit build do obchodu Play, musí být podepsaný platným certifikátem uloženým v úložišti klíčů. Pokud chcete podepisovat buildy vytvořené z větve, povolte podepisování kódu v podokně konfigurace, nahrajte úložiště klíčů do úložiště a zadejte příslušné přihlašovací údaje v podokně konfigurace. Další informace o podepisování kódu najdete v dokumentaci k podepisování kódu pro Android v App Center. Bude .aab podepsán pomocí stejných přihlašovacích údajů jako ..apk

3.6. Spuštění úspěšného sestavení na skutečném zařízení

Pomocí nově vytvořeného souboru APK otestujte, jestli se vaše aplikace spustí na skutečném zařízení. Tím se k celkovému času sestavení přidá přibližně 10 minut. Přečtěte si další informace o konfiguraci testů spouštění.

3.7. Konfigurace ze souboru build.gradle (úroveň aplikace)

Konkrétní informace o sestavení se shromažďují ze souboru Gradle, včetně závislostí, verzí nástrojů sestavení, typů sestavení a variant produktů.

3.8. Distribuce sestavení

Každé úspěšné sestavení z větve můžete nakonfigurovat tak, aby se distribuoval do dříve vytvořené distribuční skupiny nebo cíle úložiště. Můžete přidat novou distribuční skupinu nebo nakonfigurovat připojení úložiště z distribuované služby. Vždy existuje výchozí distribuční skupina s názvem "Spolupracovníci", která zahrnuje všechny uživatele, kteří mají přístup k aplikaci.

Poznámka

Pokud se distribuuje do Obchodu Google Play, preferuje se sada aplikací pro Android (.aab) a v případě povolení se distribuuje. V případě distribučních skupin App Center a cílů v Intune Store se bude pravidelně .apk používat i v případě, že .aab se vygeneruje také.

4. Výsledky sestavení

Po aktivaci sestavení může být v těchto stavech:

  • queued – sestavení je ve frontě, která čeká na uvolnění prostředků.
  • sestavení – aplikace vytváří a spouští související úlohy.
  • úspěšně dokončeno – sestavení bylo úspěšně dokončeno.
  • selhalo – sestavení se dokončilo, ale selhalo. Pokud chcete řešit potíže, můžete si stáhnout a zkontrolovat protokol sestavení.
  • zrušeno – sestavení bylo zrušeno akcí uživatele nebo vypršel časový limit.

4.1. Protokoly sestavení

V případě dokončeného sestavení (úspěšného nebo neúspěšného) si stáhněte protokoly, abyste pochopili další informace o tom, jak sestavení proběhlo. App Center poskytuje archiv s následujícími soubory:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Protokoly specifické pro sestavení (umístěné v sestavení nebo adresáři archivu) jsou užitečné pro řešení potíží a porozumění v jakém kroku a proč sestavení selhalo.

4.2. Balíček aplikace (APK)

APK je balíček, který obsahuje aplikaci a prostředky pro Android. Pokud je sestavení správně podepsané, můžete soubor APK nainstalovat na skutečné zařízení a nasadit ho do Obchodu Play. Pokud sestavení nebylo podepsáno, můžete soubor APK spustit v emulátoru nebo ho použít pro jiné účely.

4.3. Vytváření více sad API

Pokud konfigurace aplikace sestaví několik sad APK, musíte vytvořit také univerzální apk. Náš systém sestavení funguje s jedním hlavním souborem APK a bude ignorovat všechny sady APKs specifické pro určitou hustotu procesoru ABI nebo hustoty obrazovky. Další informace o rozdělení APK a vytvoření univerzální apk, přečtěte si průvodce rozděleníM ABI.

4.4. Soubor mapování deobfuscation-mapping (mapping.txt)

Soubor mapping.txt obsahuje informace o tom, jak mapovat obfuskované trasování zásobníku pro aplikaci zpět na původní názvy tříd a metod.

  • Pokud jste dříve integrovali sadu App Center SDK do aplikace s povoleným modulem pro hlášení chyb a pomocí nástroje Proguard nebo R8 minify a obfuscate binární soubor aplikace, služba zasílání zpráv o chybách vyžaduje tento mapping.txt soubor, aby se v sestavení zobrazily zprávy o selhání čitelné (deobfuscated).
  • Pokud jste do aplikace dříve integrovali jinou sadu SDK pro účely hlášení chybových ukončení (například HockeyApp SDK), odpovídající služba vyžaduje, mapping.txt aby soubor zobrazoval čitelné zprávy o chybách.

5. Podporované verze a požadavky

Minimální verze podporovaná pro sestavování aplikací pro Android je 7.0 (úroveň rozhraní API 24). Aplikace pro Android můžou mít ke spuštění nižší minimální úroveň rozhraní API, ale musí cílit alespoň na úroveň 24 rozhraní API.

Aplikace musí sestavovat pomocí Gradle a modulu plug-in Android Gradle, aby se správně nakonfigurovaly. Úložiště musí obsahovat obálku Gradle.

Viz také: Informace o cloudových buildech