Xcode@2 – úloha Xcode Build v2

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

Syntax

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  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
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # 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.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

Vstupy

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

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

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

Určuje konfiguraci projektu nebo pracovního prostoru Xcode, 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 zobrazte platný seznam sad SDK.

xcWorkspacePath - Cesta k pracovnímu prostoru nebo projektu
string. Výchozí hodnota: **/*.xcodeproj/*.xcworkspace.

Nepovinný parametr. Určuje relativní cestu z kořenového adresáře úložiště k pracovnímu prostoru nebo projektu Xcode. Příklad: MyApp/MyApp.xcworkspace nebo MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Pokud máte v úmyslu použít -target flag pole Upřesnit argumenty, ponechte prázdné.

scheme - Schéma
string.

Nepovinný parametr. Určuje název schématu Xcode. Musí se jednat o 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. Informace o exportu archivů pomocí Xcode 7 a Xcode 8 najdete v části Možnosti balíčku .

packageTool - Vytvoření balíčku (IPA) pomocí
string. Povinná hodnota. Povolené hodnoty: xcrun (xcrun (zastaralé Apple)), xcodebuild (xcodebuild archive a export). Výchozí hodnota: xcodebuild.

Určuje nástroj, který se má použít ke generování IPA.

archivePath - Cesta k archivu
string. Nepovinný parametr. Použijte, když packageTool == xcodebuild.

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

exportPath - Exportovat cestu
string. Nepovinný parametr. Použijte, když packageTool == xcodebuild. Výchozí hodnota: output/$(SDK)/$(Configuration).

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

exportOptions - Možnosti exportu
string. Nepovinný parametr. Použijte, když packageTool == xcodebuild. Povolené hodnoty: auto, plist, specify. Výchozí hodnota: auto.

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

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

Určuje metodu Xcode používá k exportu archivu. Například app-store, , package, ad-hocenterprisenebo 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 - Seznam Plist možností exportu
string. Vyžaduje se, když exportOptions == plist.

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

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

Tento vstup použijte, pokud máte v projektu Xcode 8 nebo Xcode 9 nakonfigurované 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 je nutné, 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 načtení nastavení podepisování z výchozího klíčenky a předinstalovaných profilů. Pokud nechcete přepsat výchozí nastavení sestavení, nechte odpovídající pole prázdná.

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

Určuje přepsání podpisové identity, které se použije k podepsání sestavení. Výchozí nastavení projektu Xcode. Je možné, že 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 Nepovolené interakce uživatele 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 profilu zřizování
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, pokud je zadáno. 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.

useXctool - Použití nástroje xctool
boolean.

Používá xctool místo .xcodebuild Musí být nainstalovaný na hostitelích agentů. Přečtěte si další informace o nástroji xctool.
Poznámka:xctool je zastaralý a nefunguje s Xcode 8.

xctoolReporter - xctool Test Reporter – formát
string.

Otestuje formát reporteru, který se má použít, když je zadána akce testu a je zaškrtnuto políčko Použít xctool . Zadejte junit:output-file-path-here.xml , aby se vygeneroval formát souboru kompatibilní s úlohou Publikovat výsledky testu. Po zadání se automaticky přidá prostý formát. xctool musí být nainstalovaný na hostitelích agentů. Přečtěte si další informace o nástroji xctool.
Poznámka:xctool je zastaralý a nefunguje s Xcode 8.

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í