Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez cette tâche pour générer un espace de travail Xcode sur macOS.
Syntaxe
# 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.
Entrées
actions
-
actions
string
. Obligatoire. Valeur par défaut : build
.
Spécifie une liste délimitée par un espace d’actions. Les options valides sont build
, clean
, test
, analyze
et archive
. Par exemple : build clean
effectue une build propre. Consultez la Apple : Building from the command line with Xcode FAQ.
configuration
-
Configuration
string
. Valeur par défaut : $(Configuration)
.
Spécifie la configuration du projet ou de l’espace de travail Xcode à générer. Lorsque vous utilisez une variable, spécifiez une valeur (par exemple, Release
) sous l’onglet Variables.
sdk
-
sdk
string
. Valeur par défaut : $(SDK)
.
Génère un projet ou un espace de travail Xcode sur le Kit de développement logiciel (SDK) spécifié. Exécutez xcodebuild -showsdks
pour afficher une liste valide de kits SDK.
xcWorkspacePath
-
espace de travail/chemin de projet
string
. Valeur par défaut : **/*.xcodeproj/*.xcworkspace
.
Optionnel. Spécifie le chemin relatif de la racine du dépôt vers l’espace de travail ou le projet Xcode. Par exemple : MyApp/MyApp.xcworkspace
ou MyApp/MyApp.xcworkspace/MyApp.xcodeproj
. Laissez vide si vous envisagez d’utiliser -target flag
sous arguments avancés.
scheme
-
schéma
string
.
Optionnel. Spécifie le nom du schéma Xcode. Doit être un schéma partagé (case à cocher partagée sous Schémas managés dans Xcode). Obligatoire si l’espace de travail est spécifié.
packageApp
-
créer un package d’application
boolean
. Valeur par défaut : true
.
Spécifie si un IPA est généré dans le cadre de la build. Pour exporter des archives avec Xcode 7 et Xcode 8, passez en revue des entrées supplémentaires dans la section Options de package.
archivePath
-
chemin d’accès d’archivage
string
.
Optionnel. Spécifie un répertoire dans lequel les archives créées sont placées.
exportPath
-
le chemin d’exportation
string
. Valeur par défaut : output/$(SDK)/$(Configuration)
.
Optionnel. Spécifie la destination du produit exporté à partir de l’archive.
options d’exportation exportOptions
-
string
. Valeurs autorisées : auto
, plist
, specify
. Valeur par défaut : auto
.
Spécifie un moyen de transmettre options d’exportation lors de l’exportation de l’archive.
de méthode d’exportation exportMethod
-
string
. Obligatoire lorsque exportOptions == specify
. Valeur par défaut : development
.
Spécifie la méthode utilisée par Xcode pour exporter l’archive. Par exemple, app-store
, package
, ad-hoc
, enterprise
ou development
.
exportTeamId
-
ID d’équipe
string
. Optionnel. Utilisez quand exportOptions == specify
.
Spécifie l’ID d’équipe du Portail des développeurs Apple à 10 chiffres à utiliser pour l’exportation.
exportOptionsPlist
-
Exporter les options Plist
string
. Obligatoire lorsque exportOptions == plist
.
Spécifie le chemin d’accès à un fichier plist qui configure l’exportation d’archive.
exportArgs
-
exporter des arguments
string
.
Spécifie des arguments de ligne de commande supplémentaires utilisés pour l’exportation.
xcode8AutomaticSigning
-
de signature automatique
boolean
. Valeur par défaut : false
.
Utilisez cette entrée si vous avez un projet Xcode 8 ou Xcode 9 configuré pour la signature automatique.
teamId
-
ID d’équipe
string
. Optionnel. Utilisez quand xcode8AutomaticSigning = true
.
Spécifie l’ID d’équipe de développeur à 10 chiffres. Cela est nécessaire si vous êtes membre de plusieurs équipes de développement.
signMethod
-
remplacer à l’aide de
string
. Valeurs autorisées : file
(Contenu du fichier), id
(Identificateurs). Valeur par défaut : file
.
Utilisez cette entrée si la build utilise une méthode de signature ou d’approvisionnement différente de la valeur par défaut. Choisissez File Contents
pour utiliser un certificat P12 et un profil d’approvisionnement. Choisissez Identifiers
pour récupérer les paramètres de signature à partir du trousseau par défaut et des profils préinstallés. Laissez les champs correspondants vides si vous ne souhaitez pas remplacer les paramètres de build par défaut.
iosSigningIdentity
-
signature d’identité
string
. Optionnel. Utilisez quand signMethod = id
.
Spécifie le remplacement d’identité de signature utilisé pour signer la build. La valeur par défaut est le paramètre du projet Xcode. déverrouiller le trousseau par défaut peut avoir besoin d’être sélectionné.
unlockDefaultKeychain
-
déverrouiller le trousseau par défaut
boolean
. Optionnel. Utilisez quand signMethod = id
. Valeur par défaut : false
.
Résout 'interaction utilisateur n’est pas autorisée erreurs en déverrouillant le trousseau par défaut.
defaultKeychainPassword
-
mot de passe de trousseau par défaut
string
. Optionnel. Utilisez quand signMethod = id
.
Spécifie le mot de passe pour déverrouiller le trousseau par défaut.
provProfileUuid
-
profil d’approvisionnement UUID
string
. Optionnel. Utilisez quand signMethod = id
.
Spécifie l’UUID d’un profil d’approvisionnement installé à utiliser pour la build. Utilisez des tâches de génération distinctes avec différents schémas ou cibles pour spécifier des profils d’approvisionnement par cible dans un espace de travail unique (iOS, WatchKit, tvOS).
p12
-
de fichier de certificat P12
string
. Optionnel. Utilisez quand signMethod = file
.
Spécifie le chemin relatif d’un fichier de certificat P12 au format PKCS12 qui contient un certificat de signature à utiliser pour la build.
p12pwd
-
de mot de passe P12
string
. Optionnel. Utilisez quand signMethod = file
.
Spécifie le mot de passe d’un fichier de certificat P12. Utilisez une variable de build pour chiffrer.
provProfile
-
de fichier de profil d’approvisionnement
string
. Optionnel. Utilisez quand signMethod = file
.
Spécifie le chemin d’accès relatif à un fichier contenant un remplacement de profil d’approvisionnement à utiliser pour la build. Utilisez des tâches de génération distinctes avec différents schémas ou cibles pour spécifier des profils d’approvisionnement par cible dans un espace de travail unique (iOS, WatchKit, tvOS).
removeProfile
-
supprimer le profil après la génération
boolean
. Optionnel. Utilisez quand signMethod = file
. Valeur par défaut : false
.
Supprime le contenu du fichier de profil d’approvisionnement de l’agent de build une fois la build terminée. vérifiez uniquement si vous exécutez un agent par utilisateur.
args
-
arguments
string
.
Spécifie des arguments de ligne de commande supplémentaires utilisés pour générer. Cette entrée est utile si vous souhaitez utiliser -target
ou -project
au lieu de spécifier un espace de travail et un schéma.
cwd
-
répertoire de travail
string
.
Spécifie le répertoire de travail pour les exécutions de build. La valeur par défaut est la racine du référentiel.
outputPattern
-
répertoire de sortie
string
. Obligatoire. Valeur par défaut : output/$(SDK)/$(Configuration)
.
Spécifie le chemin relatif où la sortie de build (binaires) est placée.
xcodeDeveloperDir
-
chemin du développeur Xcode
string
.
Optionnel. Spécifie le chemin d’accès au dossier développeur Xcode s’il n’est pas le système par défaut. Pour une utilisation lorsque plusieurs versions de Xcode sont installées sur un système. Par exemple : /Applications/Xcode 7.app/Contents/Developer
.
useXcpretty
-
Utiliser des xcpretty
boolean
. Valeur par défaut : false
.
Met en forme xcodebuild
sortie et génère un rapport de résultats de test JUnit. Doit être installé sur les hôtes de l’agent. En savoir plus sur xcpretty .
publishJUnitResults
-
publier sur VSTS/TFS
boolean
. Valeur par défaut : false
.
Les résultats des tests JUnit générés à l’aide de xctool
sont publiés sur VSTS/TFS.
Options de contrôle de la tâche
Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.
Variables de sortie
Aucun.
Spécifications
Besoin | Descriptif |
---|---|
Types de pipelines | YAML, build classique |
Exécutions sur | Agent, DeploymentGroup |
demandes | Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences de suivantes pour exécuter des travaux qui utilisent cette tâche : xcode |
fonctionnalités de | Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail. |
restrictions de commande | N'importe quel |
variables settables | N'importe quel |
Version de l’agent | Toutes les versions de l’agent prises en charge. |
Catégorie de tâche | Construire |