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
, analyze
test
, 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 , Release
nella 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 |