Xcode@3 – úloha Xcode Build v3

Pomocí této úlohy můžete vytvořit pracovní prostor Xcode v systému macOS.

Syntax

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Export Options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export Method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export Options Plist. 
    #exportArgs: # string. Export Arguments. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.

Vstupy

actions - Akce
string. Povinná hodnota. Výchozí hodnota: build.

Určuje seznam akcí oddělených mezerami. Platné možnosti jsou build, clean, testanalyze, a archive. Příklad: build clean provede čisté sestavení. Podívejte se na článek Apple: Vytváření z příkazového řádku pomocí Xcode – nejčastější dotazy.

configuration - Konfigurace
string. Výchozí hodnota: $(Configuration).

Určuje konfiguraci projektu Xcode nebo pracovního prostoru, který se má sestavit. Při použití proměnné zadejte hodnotu (například Release) na kartě Proměnné .

sdk - SDK
string. Výchozí hodnota: $(SDK).

Vytvoří projekt nebo pracovní prostor Xcode proti zadané sadě SDK. Spuštěním příkazu xcodebuild -showsdks zobrazíte platný seznam sad SDK.

xcWorkspacePath - Pracovní prostor nebo cesta k projektu
string. Výchozí hodnota: **/*.xcodeproj/*.xcworkspace.

Nepovinný parametr. Určuje relativní cestu z kořene úložiště k pracovnímu prostoru nebo projektu Xcode. Příklad: MyApp/MyApp.xcworkspace nebo MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Pokud chcete použít -target flag v části Upřesnit argumenty, nechte prázdné.

scheme - Schéma
string.

Nepovinný parametr. Určuje název schématu Xcode. Musí to být sdílené schéma (sdílené zaškrtávací políčko v části Spravovaná schémata v Xcode). Vyžaduje se, pokud je zadaný pracovní prostor.

packageApp - Vytvoření balíčku aplikace
boolean. Výchozí hodnota: true.

Určuje, jestli se jako součást sestavení vygeneruje IPA. Pokud chcete exportovat archivy pomocí Xcode 7 a Xcode 8, projděte si další vstupy v části Možnosti balíčku .

archivePath - Cesta k archivu
string.

Nepovinný parametr. Určuje adresář, do kterého jsou umístěny vytvořené archivy.

exportPath - Cesta exportu
string. Výchozí hodnota: output/$(SDK)/$(Configuration).

Nepovinný parametr. Určuje cíl produktu exportovaného z archivu.

exportOptions - Možnosti exportu
string. Povolené hodnoty: auto, plist, specify. Výchozí hodnota: auto.

Určuje způsob předání možnosti exportu při exportu archivu.

exportMethod - Export – metoda
string. Vyžaduje se, když exportOptions == specify. Výchozí hodnota: development.

Určuje metodu, pomocí které Xcode exportuje archiv. Například app-store, package, ad-hoc, enterprisenebo development.

exportTeamId - ID týmu
string. Nepovinný parametr. Použijte, když exportOptions == specify.

Určuje 10místné ID týmu portálu Apple Developer Portal, které se má použít pro export.

exportOptionsPlist - Plist možností exportu
string. Vyžaduje se, když exportOptions == plist.

Určuje cestu k souboru plist, který konfiguruje export archivu.

exportArgs - Exportovat argumenty
string.

Určuje další argumenty příkazového řádku použité k exportu.

xcode8AutomaticSigning - Automatické podepisování
boolean. Výchozí hodnota: false.

Tento vstup použijte, pokud máte projekt Xcode 8 nebo Xcode 9 nakonfigurovaný pro automatické podepisování.

teamId - ID týmu
string. Nepovinný parametr. Použijte, když xcode8AutomaticSigning = true.

Určuje 10místné ID vývojářského týmu. To se vyžaduje, pokud jste členem více vývojových týmů.

signMethod - Přepsat pomocí
string. Povolené hodnoty: file (Obsah souboru), id (Identifikátory). Výchozí hodnota: file.

Tento vstup použijte, pokud sestavení používá metodu podepisování nebo zřizování, která se liší od výchozího nastavení. Zvolte File Contents , jestli chcete použít certifikát P12 a profil zřizování. Zvolte Identifiers , jestli chcete načíst nastavení podepisování z výchozího řetězce klíčů a předinstalovaných profilů. Pokud nechcete přepsat výchozí nastavení sestavení, nechte příslušná pole prázdná.

iosSigningIdentity - Podpisová identita
string. Nepovinný parametr. Použijte, když signMethod = id.

Určuje přepsání podpisové identity, které se používá k podepsání sestavení. Výchozí hodnota je nastavení projektu Xcode. Možná bude potřeba vybrat možnost Odemknout výchozí řetězce klíčů.

unlockDefaultKeychain - Odemknutí výchozího řetězce klíčů
boolean. Nepovinný parametr. Použijte, když signMethod = id. Výchozí hodnota: false.

Řeší chyby interakce uživatele není povolena odemknutím výchozího řetězce klíčů.

defaultKeychainPassword - Výchozí heslo řetězce klíčů
string. Nepovinný parametr. Použijte, když signMethod = id.

Určuje heslo pro odemknutí výchozího řetězce klíčů.

provProfileUuid - UUID zřizovacího profilu
string. Nepovinný parametr. Použijte, když signMethod = id.

Určuje UUID nainstalovaného zřizovacího profilu, který se má použít pro sestavení. Pomocí samostatných úloh sestavení s různými schématy nebo cíli můžete určit zřizovací profily podle cíle v jednom pracovním prostoru (iOS, WatchKit, tvOS).

p12 - Soubor certifikátu P12
string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje relativní cestu k souboru certifikátu P12 ve formátu PKCS12, který obsahuje podpisový certifikát, který se má použít pro sestavení.

p12pwd - Heslo P12
string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje heslo k souboru certifikátu P12. K šifrování použijte proměnnou sestavení.

provProfile - Soubor se zřizovacím profilem
string. Nepovinný parametr. Použijte, když signMethod = file.

Určuje relativní cestu k souboru obsahujícímu přepsání zřizovacího profilu, který se má použít pro sestavení. Pomocí samostatných úloh sestavení s různými schématy nebo cíli můžete určit zřizovací profily podle cíle v jednom pracovním prostoru (iOS, WatchKit, tvOS).

removeProfile - Odebrat profil po sestavení
boolean. Nepovinný parametr. Použijte, když signMethod = file. Výchozí hodnota: false.

Odebere obsah souboru zřizovacího profilu z agenta sestavení po dokončení sestavení. Zkontrolujte jenom, jestli používáte jednoho agenta na uživatele.

args - Argumenty
string.

Určuje další argumenty příkazového řádku použité k sestavení. Tento vstup je užitečný, pokud chcete použít -target pracovní prostor a schéma nebo -project místo toho, abyste zadali pracovní prostor a schéma.

cwd - Pracovní adresář
string.

Určuje pracovní adresář pro spuštění sestavení. Výchozí hodnota je kořen úložiště.

outputPattern - Výstupní adresář
string. Povinná hodnota. Výchozí hodnota: output/$(SDK)/$(Configuration).

Určuje relativní cestu, kam se umístí výstup sestavení (binární soubory).

xcodeDeveloperDir - Cesta pro vývojáře Xcode
string.

Nepovinný parametr. Určuje cestu ke složce Xcode Developer, pokud se nejedná o výchozí systém. Pro použití v případě, že je v systému nainstalováno více verzí Xcode. Příklad: /Applications/Xcode 7.app/Contents/Developer.

useXcpretty - Použití xcpretty
boolean. Výchozí hodnota: false.

Formátuje xcodebuild výstup a vygeneruje sestavu výsledků testu JUnit. Musí být nainstalovaný na hostitelích agentů. Přečtěte si další informace o xcpretty.

publishJUnitResults - Publikování do VSTS/TFS
boolean. Výchozí hodnota: false.

Výsledky testů JUnit vytvořené pomocí xctool se publikují na VSTS/TFS.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
Spustí se	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby bylo možné spouštět úlohy, které používají tuto úlohu: xcode
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Sestavení