Vytváření React Native aplikací pro Android

  • Článek

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, 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 a alternativách podpory.

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

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

  1. Připojte se k účtu služby úložiště (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Vyberte úložiště a větev, ve které vaše aplikace žije.
  3. Zvolte projekt package.json , který chcete sestavit.
  4. Nastavte si svůj první build.

Poznámka

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

1. Propojení úložiště

Pokud jste se ještě nepřipojili ke svému účtu služby úložiště, musíte to udělat napřed. Jakmile je váš účet připojený, vyberte úložiště, ve kterém se nachází váš projekt React Native. K nastavení 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 vytvořit. App Center ve výchozím nastavení zobrazuje seznam všech aktivních větví.

3. Nastavení prvního buildu

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

3.1. Project

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 příchutí produktu.

Poznámka

Pro zajištění nejlepšího výkonu je analýza v současné době omezená 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 příchutí produktu zadaných v souboru build.gradle (úroveň aplikace) projektu. Vyberte variantu sestavení, která se má sestavit.

Poznámka

App Center Build podporuje vyhledání variant sestavení jako kombinace typu sestavení (definovaného pro ladění, vydání nebo vlastní) a jedné volitelné varianty produktu. Zjišťování kombinací více druhů produktů se v tuto chvíli nepodporuje.

3.3. Node.js verze

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

3.4. Triggery sestavení

Ve výchozím nastavení se nové sestavení aktivuje pokaždé, když vývojář odešle oznámení do nakonfigurované větve. To se označuje jako "kontinuální integrace". Pokud dáváte přednost ruční aktivaci nového sestavení, můžete toto nastavení změnit v podokně konfigurace.

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

Balíček aplikací pro Android je distribuční formát, který je možné nahrát do Obchodu Play. Používá se ke generování optimalizovaných sad API pro konkrétní zařízení. Další informace o balíčku aplikací pro Android najdete v oficiální dokumentaci k Androidu, která vám také pomůže pochopit, jestli chcete společně s běžnými sadami sestavit sadu. .apk.

Zapněte možnost pro Android App Bundle, aby se .aab kromě .apk. build.gradle Pokud soubor (na úrovni aplikace) obsahuje android.bundle blok, tato možnost se automaticky zapne.

3.6. Zvýšení čísla verze

Pokud je tato možnost povolená, kód verze v AndroidManifest.xml vaší aplikace se automaticky zvýší pro každé sestavení. Ke 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 buildu na skutečném zařízení

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

3.8. Podepisování kódu

Úspěšné sestavení vytvoří .apk soubor a další .aab soubor, pokud je povoleno. Pokud chcete build vydat do Obchodu Play, musí být podepsaný platným certifikátem uloženým v úložišti klíčů. Pokud chcete podepsat sestavení vygenerovaná z větve, povolte podepisování kódu v podokně konfigurace, nahrajte úložiště klíčů do úložiště a v podokně konfigurace zadejte příslušné hodnoty. Můžete si přečíst další informace o dokumentaci k podepisování kódu androidu v App Center. Podepíše .aab se 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ě. Ve službě Distribute můžete přidat novou distribuční skupinu nebo nakonfigurovat připojení k úložišti . Vždy existuje výchozí distribuční skupina s názvem "Spolupracovníci", která zahrnuje všechny uživatele, kteří mají k aplikaci přístup.

Poznámka

Pokud se distribuuje do Obchodu Google Play, preferuje se sada aplikací pro Android (.aab), která se distribuuje, pokud je povolená. Pro distribuční skupiny App Center a cíle Intune storu se použije běžný .apk způsob, i když .aab se vygeneruje také.

4. Výsledky sestavení

Po aktivaci sestavení bude sestavení v jednom z následujících stavů:

  • ve frontě – sestavení je ve frontě, která čeká na uvolnění prostředků
  • sestavení – sestavení spouští předdefinované úlohy.
  • succeeded – sestavení se dokončí a je úspěšné.
  • failed – sestavení se dokončilo, ale selhalo; Problém můžete vyřešit 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 lépe pochopili, 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 jednotlivé kroky sestavení (umístěné v build/ adresáři archivu) jsou užitečné pro řešení potíží a pochopení toho, v jakém kroku a proč sestavení selhalo.

4.2. Aplikace (.apk)

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

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 nižší minimální úroveň rozhraní API, která se vyžaduje ke spuštění, ale musí cílit na alespoň úroveň rozhraní API 21.

6. Tipy pro sestavení

6.1. Příze

Správce balíčků Yarn je rychlejší a determinističtější náhradou za npm. yarn.lock Pokud je ve vašem úložišti vedle package.jsonsouboru soubor , App Center použije Yarn, a to yarn install na začátku sestavení. V opačném případě provede npm install.

6.2. Skripty vlastního sestavení

Existuje několik možností, jak spustit skripty před spuštěním výchozích příkazů sestavení app center.

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

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

  • Napište skript prostředí pomocí funkce 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 APK

Pro React Native na Androidu je univerzální generace apk ve výchozím nastavení zakázaná. Pokud je konfigurace vaší aplikace nastavená tak, aby sestavila několik sad APK, například různé sady API pro každou architekturu procesoru nebo konfiguraci obrazovky, musíte se ujistit, že je vytvořený také univerzální soubor APK. Buildovací systém App Center funguje s jedním hlavním souborem APK a bude ignorovat všechny sady APK specifické pro určitou hustotu cpu/ABI nebo obrazovky.

Chcete-li se dozvědět více o rozdělení apk a jak vytvořit univerzální soubor APK, přečtěte si odpovídající příručku pro vývojáře androidu. V důsledku toho se ujistěte, že universalApk je pro konfiguraci sestavení React Native nastavena na true hodnotu .