Konfigurace buildu React Native iOS v App Center
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 React Native aplikace napsané v React Native verze 0.34 nebo novější.
Vytvoření aplikace React Native pro iOS:
- Připojte se k účtu služby úložiště (například Azure DevOps, Bitbucket, GitHub nebo VSTS).
- Vyberte úložiště a větev, ve které vaše aplikace žije.
- Nakonfigurujte projekt nebo pracovní prostor sestavení a schéma, které chcete vytvořit.
Poznámka
Aby aplikace běžela na skutečném zařízení, musí být sestavení podepsané kódem s platným zřizovacím profilem a certifikátem.
1. Propojení úložiště
Nejprve připojte svůj účet služby úložiště k App Center. Jakmile je váš účet připojený, vyberte úložiště, ve kterém se nachází váš projekt iOS. 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. Ve výchozím nastavení budou uvedené všechny aktivní větve.
3. Nastavení prvního buildu
Před prvním sestavením je potřeba nakonfigurovat projekt React Native.
3.1. Project
Vyberte projekt package.json
. App Center automaticky rozpozná přidružený projekt nebo pracovní prostor Xcode.
3.2. Verze Xcode
V rozevíracím seznamu vyberte verzi Xcode, na které chcete build spustit.
Pokud je On
přepínač Použít starší verzi buildového systému , použije se systém sestavení starší verze bez ohledu na nastavení projektu nebo pracovního prostoru.
Pokud je Off
přepínač Použít starší verzi buildového systému , použije se konfigurace systému sestavení z nastavení projektu nebo pracovního prostoru.
Poznámka
- Nastavení pracovního prostoru by mělo být potvrzeno v úložišti.
- Pokud nastavení pracovního prostoru není potvrzené, použije se moderní systém sestavení.
3.3. Node.js verze
Vyberte verzi Node.js, která se má použít pro sestavení. Další informace o výběru verze 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. Pokud dáváte přednost ruční aktivaci nového sestavení, můžete toto nastavení změnit v podokně konfigurace.
3.5. Zvýšení čísla sestavení
Pokud je tato možnost povolená, CFBundleVersion
hodnota v souboru Info.plist projektu vaší aplikace se automaticky zvýší pro každé sestavení. Změna proběhne před sestavením a nebude potvrzena do vašeho úložiště.
3.6. Podepisování kódu
Úspěšné sestavení vytvoří .ipa
soubor. Pokud chcete sestavení nainstalovat na zařízení, musí být podepsané platným zřizovacím profilem a certifikátem. Pokud chcete podepsat sestavení vygenerovaná z větve, povolte podepisování kódu v podokně konfigurace a nahrajte zřizovací profil (.mobileprovision
soubor) a platný certifikát (.p12) spolu s heslem pro certifikát.
Nastavení v projektu Xcode musí být kompatibilní se soubory, které nahráváte. Přečtěte si další informace o podepisování kódu pro iOS v App Center a dokumentaci pro vývojáře Apple.
Podepisování aplikací pomocí rozšíření app nebo watchOS vyžaduje další zřizovací profil pro každé rozšíření.
3.7. Spuštění úspěšného buildu na skutečném zařízení
Pomocí nově vytvořeného .ipa
souboru otestujte, jestli se aplikace spouští na skutečném zařízení. Test spuštění přidá k celkové době sestavení dalších asi 10 minut. Přečtěte si další informace o konfiguraci spouštěcích testů.
3.8. Kakaovépody
App Center prohledá vybranou větev, a pokud najde podfile, automaticky provede krok pod install
na začátku každého sestavení. Tím se zajistí, že se nainstalují všechny závislosti.
3.9. Distribuce do distribuční skupiny
Nakonfigurujte každé úspěšné sestavení z větve tak, aby se distribuoval do dříve vytvořené distribuční skupiny. V části Distribuce přidejte novou distribuční skupinu. 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.
Po uložení konfigurace se automaticky spustí nové sestavení.
4. Výsledky sestavení
Sestavení můžou být v jednom z následujících stavů:
- queued – sestavení je zařazeno do fronty a čeká na dostupné prostředky.
- sestavování – sestavení běží a spouští předdefinované úlohy.
- succeeded – sestavení se úspěšně dokončilo.
- selhalo – sestavení se úspěšně dokončilo; řešení potíží stažením a kontrolou protokolu sestavení
- zrušeno – sestavení se zrušilo prostřednictvím akce 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> (e.g. 2_Get Sources.txt)
|-- <build-step-2> (e.g. 3_Pod install.txt)
|--
|-- <build-step-n> (e.g. n_Post Job Cleanup.txt)
Protokoly 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 (.ipa)
Soubor .ipa
je archivní soubor aplikace pro iPhone, který obsahuje aplikaci pro iOS.
- Pokud se sestavení správně podepsalo, můžete soubor nainstalovat
.ipa
na skutečné zařízení, které je součástí zřizovacího profilu použitého při podepisování. Další podrobnosti o podepisování a distribuci kódu pomocí App Center najdete v dokumentaci k podepisování kódu pro iOS. - Pokud sestavení není během sestavení podepsané, můžou vývojáři soubor podepsat
.ipa
(místně pomocí kodesignu) nebo ho použít k jiným účelům (například nahrát do testovací služby pro testování uživatelského rozhraní na skutečných zařízeních nebo spustit v simulátoru). - Nepodepsaná sestavení nevytvoří
.ipa
soubor. Artefaktem nepodepsaného sestavení je.xcarchive
soubor, který lze použít k vygenerování.ipa
souboru s organizátorem archivu Xcode.
4.3. Zdrojové mapy a soubory symbolů
Při sestavení aplikace React Native pro iOS se s každým buildem automaticky vygeneruje zdrojová mapa JavaScriptu a jeden nebo více .dsym
souborů a po dokončení sestavení se dá stáhnout.
- Pokud jste dříve integrovali sadu App Center SDK do aplikace s povoleným modulem zasílání zpráv o chybách, signál zasílání zpráv o chybách vyžaduje tento
.dsym
soubor a mapu zdroje JavaScriptu pro sestavení, aby se zobrazovaly zprávy o chybách čitelné (symbolické). - Pokud jste dříve integrovali jinou sadu SDK pro účely zasílání zpráv o chybách do vaší aplikace, odpovídající služba vyžaduje
.dsym
soubor a mapu zdroje JavaScriptu, aby zobrazovaly zprávy o chybách čitelné pro člověka (symbolické).
Mějte na paměti, že při .dsym
podepsání .ipa
kódu se soubor nezmění. Pokud se později rozhodnete sestavení podepsat, .dsym
vygenerovaný před podepsáním kódu je stále platný.
Pokud je součástí této aplikace sada SDK pro chybové ukončení, odesílají se do služby App Center Crashes symboly iOS a zdrojové mapy. Symboly umožní zprávy o chybách čitelné pro člověka (symbolické) v nativním i javascriptovém zásobníku.
5. Tipy pro sestavení
5.1. Příze
Yarn je rychlejší a determinističtější náhrada za npm
. yarn.lock
Pokud je v úložišti vedle package.json
souboru soubor , App Center použije Yarn, a to yarn install
na začátku sestavení. V opačném případě provede npm install
.
5.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. To se automaticky spustí po instalaci závislostí."scripts": { ... "postinstall" : "eslint ./" // 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: Create a file that's not in version control (from base64 encoded environment variable) base64 -d <<< "$MY_FILE_CONTENTS" > ios/SuperSecretFile.txt