Vytváření aplikací Objective-C nebo Swift pro iOS

Pokud chcete vytvořit první nativní aplikaci pro iOS, musíte provést následující akce:

  1. Připojení k úč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. Nakonfigurujte projekt nebo pracovní prostor sestavení a schéma, které chcete sestavit.

Poznámka

Pokud chcete aplikaci spustit na skutečném zařízení, musí být sestavení podepsané pomocí platného zřizovacího profilu a certifikátu.

1. Propojení úložiště

Pokud jste se ještě nepřipojili k účtu služby úložiště, musíte připojení autorizovat. Po připojení účtu vyberte úložiště, ve kterém se nachází váš projekt pro iOS. App Center vyžaduje, aby váš účet s oprávněním správce a přijetí změn nastavil sestavení pro úložiště.

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 uvedené všechny aktivní větve.

3. Nastavení prvního sestavení

Nakonfigurujte projekt pro iOS před prvním sestavením.

3.1 Project/pracovní prostor a schéma

Pro konfiguraci sestavení se vyžaduje projekt Xcode nebo pracovní prostor Xcode a vyžaduje se sdílené schéma. App Center automaticky rozpozná projekty, pracovní prostory a sdílená schémata (pokud jsou schémata ve správné složce) ve vaší větvi. Vyberte projekt nebo pracovní prostor, který chcete sestavit, a odpovídající schéma.

Pokud se nenajde žádné schéma, ujistěte se, že je požadované schéma sdílené a jeho kontejner je projekt nebo pracovní prostor, který jste vybrali. Měli byste také potvrdit, že jsou tyto změny ve větvi, kterou konfigurujete, zaškrtnuté.

Mějte na paměti, že nemůžete exportovat .xcscheme soubor a umístit ho kamkoliv do projektu. Musí být ve xcshareddata/xcschemes/ složce. Ujistěte se, že tato cesta není v .gitignore souboru.

Mark scheme as shared

3.2. Verze Xcode

Vyberte verzi Xcode, na které se má sestavení spustit.

3.3. Triggery sestavení

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

3.4. Zvýšení čísla buildu

Když je tato možnost povolená, CFBundleVersionInfo.plist automaticky se v aplikaci zvýší pro každé sestavení. K této změně dochází před sestavením a nebude potvrzeno do vašeho úložiště.

Poznámka

Pokud chcete, aby číslo sestavení přírůstku fungovalo, pojmenujte ho .plist file například Production-Info.plist*Info.plist .

3.5. Testy

Pokud vybrané schéma obsahuje testovací akci s vybraným cílovým testem, můžete testy nakonfigurovat tak, aby se spouštěly jako součást každého sestavení. App Center v současné době může spouštět testy jednotek XCTest.

3.6. Podepisování kódu

Vytvoření aplikace pro iOS pro skutečná zařízení vyžaduje podepsání pomocí platných přihlašovacích údajů. Pokud chcete podepsat buildy v App Center, povolte přihlašování kódu v podokně konfigurace a nahrajte zřizovací profil (.mobileprovision) a platný certifikát (.p12) spolu s heslem pro certifikát.

Nastavení projektu Xcode musí být kompatibilní se soubory, které nahráváte. Další informace o přihlašování kódu najdete v oficiální dokumentaci pro vývojáře Apple.

Aplikace s rozšířeními aplikace nebo watchOS vyžadují podepsání dalšího zřizovacího profilu pro každé rozšíření.

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

Pomocí nově vytvořeného .ipa souboru otestujte, jestli se aplikace spustí na skutečném zařízení. Spuštění na skutečném zařízení přidá 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. CocoaPods

App Center prohledá vybranou větev a pokud najde podfile, automaticky provede pod install krok na začátku každého sestavení. Tento krok zajistí instalaci všech závislostí.

Upozornění

Pokud úložiště již obsahuje složku /Pods , App Center předpokládá, že jste se přihlásili do podů ve vašem úložišti a už nebude provádět pod install. Pokud složku /Pods odeberete nebo upravíte, možná budete muset konfiguraci sestavení znovu ručně použít nebo Save and Build aby se aktualizace projevilaSave.

3.9. Distribuce do distribuční skupiny

Každé úspěšné sestavení z větve můžete nakonfigurovat tak, aby se distribuoval do dříve vytvořené distribuční skupiny. V oddílu Distribuce můžete přidat 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í přístup k aplikaci.

Po uložení konfigurace se automaticky spustí nové sestavení.

4. Výsledky sestavení

Po aktivaci sestavení může být v následujících stavech:

  • fronta – sestavení se zařadí do fronty a čeká na uvolnění prostředků.
  • sestavení – sestavení spouští předdefinované úlohy.
  • úspěšné – sestavení se dokončilo a bylo úspěšné.
  • selhalo – sestavení bylo dokončeno, ale selhalo. Pokud chcete zjistit, co se nepovedlo, zkontrolujte protokoly sestavení.
  • zrušeno – sestavení bylo zrušeno akcí uživatele nebo vypršel časový limit

4.1. Protokoly sestavení

Pro dokončené sestavení (úspěšné nebo neúspěšné) si stáhněte protokoly, abyste 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 specifické pro sestavení (umístěné v build/ adresáři archivu) jsou užitečné pro řešení potíží a pochopení v jakém kroku a proč sestavení selhalo.

4.2. Aplikace (.ipa)

Soubor .ipa je soubor archivu aplikace zařízení s iOSem, který obsahuje aplikaci pro iOS.

  • Nepodepsané sestavení nevygenerují .ipa soubor. Artefaktem nepodepsaného sestavení je .xcarchive soubor, který lze použít k vygenerování .ipa souboru s organizátorem Xcode Archives.
  • Pokud je sestavení podepsáno správně, .ipa je možné soubor nainstalovat na skutečné zařízení odpovídající zřizovacímu profilu použitému 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 v App Center.
  • Pokud sestavení nebylo podepsáno, .ipa může ho podepsat vývojář (například místně pomocí codesignu) nebo použít pro jiné účely (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).

4.3. Soubor symbolů (.dsym)

Soubory .dsym obsahují symboly ladění aplikace.

  • Pokud jste do aplikace dříve integrovali sadu App Center SDK s povoleným modulem zasílání zpráv o chybách, služba zasílání zpráv o chybách vyžaduje tento .dsym soubor, aby se v buildu zobrazily zprávy o chybách čitelné (symbolické) zprávy o chybách.
  • Pokud jste dříve integrovali jinou sadu SDK pro účely hlášení chyb v aplikaci (například HockeyApp SDK), vyžaduje odpovídající služba .dsym , aby soubor zobrazoval zprávy o chybách čitelné pro člověka.

Mějte na paměti, že soubory .dsym se při podepisování .ipakódu nemění . Pokud se později rozhodnete podepsat sestavení, .dsym vygenerované před podepsáním kódu je stále platné.

Podporované verze a požadavky

Podrobnosti o verzi Xcode počítače buildu se aktualizují pokaždé, když se přidá nová verze Xcode. Mějte přehled o nejnovějších verzích vydaných společností Apple a co nejdříve je zahrneme na virtuálních počítačích používaných ke spuštění buildů.