Xcode@3 - Attività Xcode Build v3

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.

Input

actions - Azioni
string. Obbligatorio. Valore predefinito: build.

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


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

Specifica il progetto Xcode o la configurazione dell'area di lavoro da compilare. Quando si usa una variabile, specificare un valore , ad esempio , Releasenella scheda Variabili .


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

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


xcWorkspacePath - Area di lavoro/Percorso progetto
string. Valore predefinito: **/*.xcodeproj/*.xcworkspace.

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

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


packageApp - Creare il 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, vedere input aggiuntivi nella sezione Opzioni pacchetto .


archivePath - Percorso archivio
string.

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


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

facoltativo. 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 le opzioni di esportazione durante l'esportazione dell'archivio.


exportMethod - Export, metodo
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, enterprise o development.


exportTeamId - Team ID
string. facoltativo. Usare quando exportOptions == specify.

Specifica l'ID team del portale per sviluppatori Apple a 10 cifre da usare per l'esportazione.


exportOptionsPlist - Esporta opzioni Plist
string. Obbligatorio quando exportOptions == plist.

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


exportArgs - Esportare argomenti
string.

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


xcode8AutomaticSigning - Firma automatica
boolean. Valore predefinito: false.

Usare questo input se si dispone di un progetto Xcode 8 o Xcode 9 configurato per la firma automatica.


teamId - Team ID
string. facoltativo. 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 di usare un certificato P12 e un profilo di provisioning. Scegliere Identifiers di recuperare le impostazioni di firma dal portachiavi 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. facoltativo. Usare quando signMethod = id.

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


unlockDefaultKeychain - Sblocca portachiavi predefinita
boolean. facoltativo. Usare quando signMethod = id. Valore predefinito: false.

Risolve gli errori di interazione utente non consentiti sbloccando il keychain predefinito.


defaultKeychainPassword - Password portachiavi predefinita
string. facoltativo. Usare quando signMethod = id.

Specifica la password per sbloccare il portachiavi predefinito.


provProfileUuid - UUID profilo di provisioning
string. facoltativo. 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. facoltativo. Usare quando signMethod = file.

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


p12pwd - P12 Password
string. facoltativo. Usare quando signMethod = file.

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


provProfile - File del profilo di provisioning
string. facoltativo. 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 diverse 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. facoltativo. Usare quando signMethod = file. Valore predefinito: false.

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


args - Argomenti
string.

Specifica altri argomenti della riga di comando usati per compilare. 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. Impostazione predefinita alla radice del repository.


outputPattern - Output Directory
string. Obbligatorio. Valore predefinito: output/$(SDK)/$(Configuration).

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


xcodeDeveloperDir - Percorso sviluppatore Xcode
string.

facoltativo. 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 l'output e genera un report dei risultati dei test JUnit. Deve essere installato sugli host dell'agente. Altre informazioni su xcpretty.


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

I risultati dei test di JUnit generati tramite 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
Esecuzione in Agente, DeploymentGroup
Richieste Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: xcode
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Compilazione