Condividi tramite

Xcode@3 - Attività Xcode Build v3

  • Articolo

Usare questa attività per compilare un'area di lavoro Xcode in macOS.

Sintassi

# 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.

Ingressi dati

actions - Azioni
string. Obbligatorio. Valore predefinito: build

Specifica un elenco delimitato da spazi di azioni. Le opzioni valide sono build, clean, testanalyze, e archive. Ad esempio: build clean esegue una compilazione pulita. Vedere Apple: Building from the command line with Xcode FAQ (Domande frequenti su Xcode).


configuration - configurazione
string. Valore predefinito: $(Configuration)

Specifica la configurazione del progetto Xcode o dell'area di lavoro da compilare. Quando si usa una variabile, specificare un valore (ad esempio, Release) nella scheda Variabili.


sdk - SDK
string. Valore predefinito: $(SDK)

Compila un progetto Xcode o un'area di lavoro sull'SDK specificato. Eseguire xcodebuild -showsdks per visualizzare un elenco valido di SDK.


xcWorkspacePath - 'area di lavoro/percorso del progetto
string. Valore predefinito: **/*.xcodeproj/*.xcworkspace

Opzionale. Specifica il percorso relativo dalla radice del repository all'area di lavoro o al progetto Xcode. Ad esempio: MyApp/MyApp.xcworkspace o MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Lasciare vuoto se si intende usare -target flag in argomenti avanzati .


scheme - schema
string.

Opzionale. Specifica il nome dello schema Xcode. Deve essere uno schema condiviso (casella di controllo condivisa in schemi gestiti in Xcode). Obbligatorio se è specificata l'area di lavoro.


packageApp - Creare un pacchetto dell'app
boolean. Valore predefinito: true

Specifica se un IPA viene generato come parte della compilazione. Per l'esportazione di archivi con Xcode 7 e Xcode 8, esaminare gli input aggiuntivi nella sezione Opzioni pacchetto.


percorso di archiviazione archivePath -
string.

Opzionale. Specifica una directory in cui vengono inseriti gli archivi creati.


exportPath - percorso di esportazione
string. Valore predefinito: output/$(SDK)/$(Configuration)

Opzionale. Specifica la destinazione del prodotto esportato dall'archivio.


exportOptions - Opzioni di esportazione
string. Valori consentiti: auto, plist, specify. Valore predefinito: auto

Specifica un modo per passare Opzioni di esportazione durante l'esportazione dell'archivio.


exportMethod - metodo export
string. Obbligatorio quando exportOptions == specify. Valore predefinito: development

Specifica il metodo utilizzato da Xcode per esportare l'archivio. Ad esempio, app-store, package, ad-hoc, enterpriseo development.


exportTeamId - ID team
string. Opzionale. Usare quando exportOptions == specify.

Specifica l'ID team di Apple Developer Portal a 10 cifre da usare per l'esportazione.


exportOptionsPlist - Opzioni di esportazione Plist
string. Obbligatorio quando exportOptions == plist.

Specifica il percorso di un file plist che configura l'esportazione dell'archivio.


exportArgs - esportare argomenti
string.

Specifica argomenti aggiuntivi della riga di comando utilizzati per l'esportazione.


xcode8AutomaticSigning - di firma automatica
boolean. Valore predefinito: false

Usa questo input se hai un progetto Xcode 8 o Xcode 9 configurato per la firma automatica.


teamId - ID team
string. Opzionale. Usare quando xcode8AutomaticSigning = true.

Specifica l'ID del team di sviluppo a 10 cifre. Questa operazione è necessaria se si è membri di più team di sviluppo.


signMethod - eseguire l'override tramite
string. Valori consentiti: file (contenuto file), id (identificatori). Valore predefinito: file

Usare questo input se la compilazione usa un metodo di firma o di provisioning diverso da quello predefinito. Scegliere File Contents per usare un certificato P12 e un profilo di provisioning. Scegliere Identifiers per recuperare le impostazioni di firma dal keychain predefinito e dai profili preinstallati. Lasciare vuoti i campi corrispondenti se non si desidera eseguire l'override delle impostazioni di compilazione predefinite.


iosSigningIdentity - 'identità di firma
string. Opzionale. Usare quando signMethod = id.

Specifica l'override dell'identità di firma utilizzata per firmare la compilazione. Il valore predefinito è l'impostazione del progetto Xcode. potrebbe essere necessario selezionare sblocca portachiavi predefinita.


unlockDefaultKeychain - sbloccare il keychain predefinito
boolean. Opzionale. Usare quando signMethod = id. Valore predefinito: false

Risolve l'interazione dell'utente non è consentita errori sbloccando il keychain predefinito.


defaultKeychainPassword - password portachiavi predefinita
string. Opzionale. Usare quando signMethod = id.

Specifica la password per sbloccare il portachiavi predefinito.


UUID del profilo di provisioning provProfileUuid -
string. Opzionale. Usare quando signMethod = id.

Specifica l'UUID di un profilo di provisioning installato da usare per la compilazione. Usare attività di compilazione separate con schemi o destinazioni diversi per specificare i profili di provisioning per destinazione in una singola area di lavoro (iOS, WatchKit, tvOS).


p12 - file di certificato P12
string. Opzionale. Usare quando signMethod = file.

Specifica il percorso relativo di un file di certificato P12 formattato da PKCS12 che contiene un certificato di firma da usare per la compilazione.


password p12pwd - P12
string. Opzionale. Usare quando signMethod = file.

Specifica la password di un file di certificato P12. Usare una variabile di compilazione per crittografare.


provProfile - file di profilo di provisioning
string. Opzionale. Usare quando signMethod = file.

Specifica il percorso relativo di un file contenente un override del profilo di provisioning da usare per la compilazione. Usare attività di compilazione separate con schemi o destinazioni diversi per specificare i profili di provisioning per destinazione in una singola area di lavoro (iOS, WatchKit, tvOS).


removeProfile - Rimuovere il profilo dopo la compilazione
boolean. Opzionale. Usare quando signMethod = file. Valore predefinito: false

Rimuove il contenuto del file del profilo di provisioning dall'agente di compilazione al termine della compilazione. Controllare solo se si esegue un agente per utente.


args - argomenti
string.

Specifica argomenti della riga di comando aggiuntivi usati per la compilazione. Questo input è utile se si vuole usare -target o -project anziché specificare un'area di lavoro e uno schema.


cwd - directory di lavoro
string.

Specifica la directory di lavoro per le esecuzioni di compilazione. L'impostazione predefinita è la radice del repository.


outputPattern - directory di output
string. Obbligatorio. Valore predefinito: output/$(SDK)/$(Configuration)

Specifica il percorso relativo in cui vengono inseriti l'output di compilazione (file binari).


xcodeDeveloperDir - percorso sviluppatore Xcode
string.

Opzionale. Specifica il percorso della cartella Xcode Developer se non è l'impostazione predefinita del sistema. Per l'uso quando vengono installate più versioni di Xcode in un sistema. Ad esempio: /Applications/Xcode 7.app/Contents/Developer.


useXcpretty - Usare xcpretty
boolean. Valore predefinito: false

Formatta xcodebuild output e genera un report dei risultati del test JUnit. Deve essere installato sugli host dell'agente. Altre informazioni su xcpretty.


publishJUnitResults - pubblica in VSTS/TFS
boolean. Valore predefinito: false

I risultati dei test JUnit prodotti con xctool vengono pubblicati in VSTS/TFS.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica
Viene eseguito in Agente, DeploymentGroup
richieste Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: xcode
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente Tutte le versioni dell'agente supportate.
Categoria attività Costruire