Sdílet prostřednictvím

Vytváření nativních aplikací React pro Android

  • Článek

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.

App Center může vytvářet aplikace React Native pomocí React Native verze 0.34 nebo novější.

Pokud chcete začít vytvářet svou první aplikaci React Native pro Android, musíte:

  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 package.json , který chcete sestavit.
  4. Nastavte první sestavení.

Poznámka:

Aby aplikace běžela na skutečném zařízení, musí být sestavení kód podepsaný platným certifikátem.

1. Propojení úložiště

Pokud jste se ještě nepřipojili k účtu služby úložiště, musíte to udělat jako první. Po připojení účtu vyberte úložiště, ve kterém se nachází váš projekt React Native. Abyste mohli vytvořit sestavení pro úložiště, musíte mít 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í App Center zobrazí seznam všech aktivních větví.

3. Nastavení prvního sestavení

Před prvním sestavením musíte nakonfigurovat projekt React Native.

3.1. Projekt

Vyberte projekt package.json. App Center automaticky extrahuje informace z přidruženého souboru build.gradle (úroveň aplikace), včetně závislostí, verze nástrojů sestavení, typů sestavení a variant produktů.

Poznámka:

Pro zajištění nejlepšího výkonu je analýza aktuálně omezena na čtyři úrovně adresáře, včetně kořenového adresáře úložiště.

3.2. Varianta sestavení

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

Poznámka:

App Center Build podporuje vyhledání variant sestavení jako kombinace typu sestavení (ladění, verze nebo vlastní definice) a jedné volitelné varianty produktu. Detekce kombinací více variant produktu se v tuto chvíli nepodporuje.

3.3. verze Node.js

Vyberte verzi Node.js, která se má použít pro sestavení, přečtěte si další informace o tom, jak vybrat Node.js verzi.

3.4. 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.5. Sestavení sady aplikací pro Android (.aab)

Sada aplikací pro Android je distribuční formát, který lze nahrát do Obchodu Play. Slouží k vygenerování optimalizovaných sad AKS pro konkrétní zařízení. Další informace o sadě aplikací pro Android najdete v oficiální dokumentaci k Androidu, která vám také pomůže pochopit, jestli chcete vytvořit sadu společně s běžnou sadou. .apk.

Zapněte možnost sady aplikací pro Android, která .aab vytvoří kromě souboru .apk. build.gradle Pokud soubor (na úrovni aplikace) obsahuje android.bundle blok, tato možnost se automaticky zapne.

3.6. Čí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.7. 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í. Testy spuštění přidají do celkového času sestavení přibližně 10 minut. Přečtěte si další informace o konfiguraci testů spouštění.

3.8. 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é hodnoty v podokně konfigurace. Můžete si přečíst další informace o dokumentaci k podepisování kódu pro Android v App Centeru pro Android. Bude .aab podepsán pomocí stejných přihlašovacích údajů jako ..apk

3.9. 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í bude sestavení v jednom z následujících stavů:

  • queued – sestavení je ve frontě čekající na uvolnění prostředků
  • sestavení – sestavení spouští předdefinované úlohy.
  • succeeded – sestavení se dokončilo a bylo úspěšné.
  • selhalo – sestavení se dokončilo, ale selhalo. Můžete vyřešit potíže s tím, co se pokazilo stažením a kontrolou protokolu 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 build/ adresáři archivu) jsou užitečné pro řešení potíží a porozumění v jakém kroku a proč sestavení selhalo.

4.2. Aplikace (.apk)

Soubor .apk je soubor zabalený aplikací pro Android, který ukládá aplikaci pro Android. Pokud je sestavení správně podepsané, můžete aplikaci nainstalovat na skutečné zařízení a nasadit ji do Obchodu Play. Pokud sestavení nebylo podepsáno, může aplikace běžet v emulátoru nebo ji používat pro jiné účely.

5. Podporované verze a požadavky

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

6. Tipy k sestavení

6.1. Příze

Správce balíčků Yarn je rychlejší, determinističtější nahrazení .npm yarn.lock Pokud se soubor nachází ve vašem úložišti vedle package.json, App Center použije Yarn, a to yarn install na začátku sestavení. Jinak to udělá npm install.

6.2. Vlastní skripty sestavení

Před spuštěním výchozích příkazů sestavení app Center existuje několik možností spuštění skriptů.

  • V souboru projektu package.json vytvořte poinstalační skript. Tento skript se po instalaci závislostí automaticky spustí.

      "scripts": {
    ...
    "postinstall" : "npx jetify" // other examples: "node ./postinstall.js" or "./postinstall.sh"
  },

  • Napište skript prostředí pomocí funkcí vlastních skriptů sestavení app Center.

    #!/usr/bin/env bash

# Example: Authenticate with private NPM registry
echo "//registry.npmjs.org/:_authToken=$NPM_AUTH_TOKEN" > ~/.npmrc

# Example: Add your signing key file (from base64 encoded environment variable)
base64 -d <<< "$ANDROID_JSON_KEY_FILE" > android/keystores/json_key_file.json

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

Pro React Native v Androidu je univerzální generování APK ve výchozím nastavení zakázané. Pokud je vaše konfigurace aplikace nastavená tak, aby se sestavila více sad API, například různé na architekturu procesoru nebo konfiguraci obrazovky, musíte se ujistit, že je také sestaven univerzální apk. Systém sestavení app Center funguje s jedním hlavním souborem APK a bude ignorovat všechny sady APK specifické pro určitý procesor/ABI nebo hustotu obrazovky.

Další informace o apk rozdělení a jak vytvořit univerzální APK, přečtěte si odpovídající příručku pro vývojáře pro Android. Proto se ujistěte, že universalApk je pro konfiguraci sestavení React Native nastavená true .