Xcode@5 - Tâche Xcode v5

Utilisez cette tâche pour générer, tester ou archiver un espace de travail Xcode sur macOS et éventuellement empaqueter une application.

Syntaxe

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. 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. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Données d'entrée

actions - actions
string. Obligatoire. Valeur par défaut : build.

Spécifie une liste délimitée par un espace d’actions. Certaines options valides sont build, , cleantest, analyzeet archive. Par exemple,clean build effectue une build propre. Voir Apple : Construire à partir de la ligne de commande avec 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).

Spécifie un Kit de développement logiciel (SDK) à utiliser lors de la génération du projet ou de l’espace de travail Xcode. À partir de l’application macOS Terminal, exécutez xcodebuild -showsdks pour afficher la liste valide des kits SDK. Lorsque vous utilisez une variable, spécifiez une valeur (par exemple, iphonesimulator) sous l’onglet Variables.

xcWorkspacePath - espace de travail ou chemin d’accès au projet
string. Valeur par défaut : **/*.xcodeproj/project.xcworkspace.

Optionnel. Spécifie un 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.xcodeproj. Des caractères génériques peuvent être utilisés. En savoir plus sur les modèles de correspondance de fichiers .

scheme - schéma
string.

Optionnel. Spécifie un nom de schéma Xcode. Doit être un schéma partagé (case à cocher partagée sous Schémas managés dans Xcode). Si vous ne spécifiez pas de schéma et que l’espace de travail spécifié a un schéma partagé unique, le schéma d’espace de travail sera utilisé.

xcodeVersion - version Xcode
string. Valeurs autorisées : 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), (Xcode 12), 1213 (Xcode 13), defaultspecifyPath , (Spécifier le chemin d’accès). Valeur par défaut : default.

Spécifie la version cible de Xcode. Sélectionnez Default pour utiliser la version par défaut de Xcode sur l’ordinateur agent. La spécification d’un numéro de version (par exemple, Xcode 9) repose sur l’emplacement de la version à définir par des variables d’environnement sur l’ordinateur de l’agent (par exemple, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Sélectionnez Specify path pour fournir un chemin d’accès spécifique au répertoire du développeur Xcode.

xcodeDeveloperDir - chemin du développeur Xcode
string. Optionnel. Utilisez quand xcodeVersion == specifyPath.

Spécifie un chemin d’accès à un répertoire de développeur Xcode spécifique (par exemple, /Applications/Xcode_9.0.0.app/Contents/Developer). Cette entrée est utile lorsque plusieurs versions de Xcode sont installées sur l’ordinateur de l’agent.

packageApp - Créer un package d’application
boolean. Valeur par défaut : false.

Spécifie si un fichier de package d’application IPA est généré dans le cadre de la build.

archivePath - chemin d’accès archive
string. Optionnel. Utilisez quand packageApp == true.

Spécifie un répertoire dans lequel les archives créées sont placées.

exportPath - exporter le chemin d’accès
string. Optionnel. Utilisez quand packageApp == true. Valeur par défaut : output/$(SDK)/$(Configuration).

Spécifie la destination du produit exporté à partir de l’archive.

options d’exportation exportOptions -
string. Optionnel. Utilisez quand packageApp == true. Valeurs autorisées : auto (automatique), plist, specify. Valeur par défaut : auto.

Spécifie les options d’exportation de l’archive. Lorsque la valeur par défaut de Automatic est sélectionnée, la méthode d’exportation est automatiquement détectée à partir de l’archive. Sélectionnez Plist pour spécifier un fichier plist contenant des options d’exportation. Sélectionnez Specify pour fournir une méthode d’exportation spécifique et ID d’équipe.

exportMethod - méthode Export
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 10 caractères du Portail des développeurs Apple à utiliser pendant l’exportation.

exportOptionsPlist - options d’exportation plist
string. Obligatoire lorsque exportOptions == plist.

Spécifie le chemin d’accès au fichier plist qui contient les options à utiliser pendant l’exportation.

exportArgs - Exporter des arguments
string. Optionnel. Utilisez quand packageApp == true.

Spécifie des arguments de ligne de commande supplémentaires utilisés pendant l’exportation.

signingOption - style de signature
string. Valeurs autorisées : nosign (ne pas signer le code), default (valeurs par défaut du projet), manual (signature manuelle), auto (signature automatique). Valeur par défaut : nosign.

Spécifie la méthode de signature de la build. Sélectionnez Do not code sign pour désactiver la signature. Sélectionnez Project defaults pour utiliser uniquement la configuration de signature du projet. Sélectionnez Manual signing pour forcer la signature manuelle et éventuellement spécifier une identité de signature et un profil d’approvisionnement. Sélectionnez Automatic signing pour forcer la signature automatique et éventuellement spécifier un ID d’équipe de développement. Si votre projet nécessite la signature, utilisez la Installer Apple... tâches pour installer des certificats et des profils d’approvisionnement avant la génération Xcode.

signingIdentity - d’identité de signature
string. Optionnel. Utilisez quand signingOption = manual.

Spécifie un remplacement d’identité de signature avec lequel signer la build. Le déverrouillage du trousseau par défaut sur l’ordinateur agent peut être nécessaire. Si aucune valeur n’est entrée, le paramètre du projet Xcode est utilisé.

provisioningProfileUuid - profil d’approvisionnement UUID
string. Optionnel. Utilisez quand signingOption = manual.

Spécifie l’UUID d’un profil d’approvisionnement installé utilisé 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, tvOS, watchOS).

provisioningProfileName - Nom du profil d’approvisionnement
string. Optionnel. Utilisez quand signingOption = manual.

Spécifie le nom d’un profil d’approvisionnement installé utilisé pour la build. S’il est spécifié, il est prioritaire sur l’UUID du profil d’approvisionnement. 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, tvOS, watchOS).

teamId - ID d’équipe
string. Optionnel. Utilisez quand signingOption = auto.

Obligatoire si vous êtes membre de plusieurs équipes de développement. Spécifie l’ID d’équipe de développement à 10 caractères.

destinationPlatformOption - plateforme de destination
string. Valeurs autorisées : default, iOS (iOS et watchOS), tvOS, macOS, custom. Valeur par défaut : default.

Spécifie la plateforme de l’appareil de destination utilisée pour les tests d’interface utilisateur lorsque l’appareil de build générique n’est pas valide. Choisissez Custom de spécifier une plate-forme qui n’est pas incluse dans cette liste. Lorsque Default est sélectionné, aucun simulateur ou appareil n’est ciblé.

destinationPlatform - plateforme de destination personnalisée
string. Optionnel. Utilisez quand destinationPlatformOption == custom.

Spécifie la plateforme d’un appareil de destination utilisée pour les tests d’interface utilisateur lorsque l’appareil de build générique n’est pas valide. Choisissez Custom pour spécifier une plateforme non incluse dans la liste. Lorsque Default cette option est sélectionnée, aucun simulateur ni appareil n’est ciblé.

destinationTypeOption - type de destination
string. Optionnel. Utilisez quand destinationPlatformOption != default && destinationPlatformOption != macOS. Valeurs autorisées : simulators (Simulateur), devices (Appareil connecté). Valeur par défaut : simulators.

Spécifie le type de destination à utiliser pour les tests d’interface utilisateur. Les appareils doivent être connectés au Mac exécutant la build via un câble ou une connexion réseau. Pour plus d’informations, consultez appareils et simulateurs dans Xcode.

destinationSimulators - simulateur
string. Optionnel. Utilisez quand destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Spécifie un nom de simulateur Xcode utilisé pour les tests d’interface utilisateur. Par exemple, iPhone X (iOS et watchOS) ou Apple TV 4K (tvOS). Une version facultative du système d’exploitation cible peut être spécifiée au format OS=<versionNumber>, par exemple iPhone X,OS=11.1. Pour plus d’informations, consultez cette liste de simulateurs installés sur l’agent macOS hébergé.

destinationDevices - appareil
string. Optionnel. Utilisez quand destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Spécifie le nom de l’appareil utilisé pour les tests d’interface utilisateur, tels que Raisa's iPad. Un seul appareil est actuellement pris en charge. Notez qu’Apple n’autorise pas les apostrophes (') dans les noms d’appareils. Au lieu de cela, les guillemets' simples () peuvent être utilisés.

args - arguments
string.

Optionnel. Spécifie des arguments de ligne de commande supplémentaires avec lesquels générer. Cette entrée est utile pour spécifier des arguments -target ou -project au lieu d’un espace de travail/projet et d’un schéma. Voir Apple : Construire à partir de la ligne de commande avec Xcode FAQ.

workingDirectory - répertoire de travail
Alias d’entrée : cwd. string.

Optionnel. Spécifie le répertoire de travail dans lequel exécuter la build. Si aucune valeur n’est entrée, la racine du référentiel est utilisée.

useXcpretty - Utiliser des xcpretty
boolean. Valeur par défaut : true.

Spécifie s’il faut utiliser xcpretty pour formater xcodebuild la sortie. xcpretty doit être installé sur l’ordinateur de l’agent (il est préinstallé sur les agents de build hébergés par Azure Pipelines). S’il xcpretty n’est pas installé, la sortie brute xcodebuild est affichée. Pour plus d’informations, consultez xcpretty.

xcprettyArgs - Arguments Xcpretty
string. Optionnel. Utilisez quand useXcpretty == true.

Si xcpretty est activé, cette entrée spécifie des arguments pour xcpretty. Consultez la liste des arguments xcpretty sur GitHub.

publishJUnitResults - Publier les résultats des tests dans Azure Pipelines
boolean. Valeur par défaut : false.

Spécifie s’il faut publier les résultats des tests JUnit dans Azure Pipelines. Cela nécessite xcpretty d’être activé pour générer les résultats des tests JUnit.

testRunTitle - titre d’exécution de test
string. Optionnel. Utilisez quand publishJUnitResults == true.

Si xcpretty et publishJUnitResults sont activés, vous pouvez spécifier le titre de la série de tests.

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.

Remarques

Utilisez cette tâche pour générer, tester ou archiver un espace de travail Xcode sur macOS et éventuellement empaqueter une application.

Utilisation de plusieurs profils de provisionnement

À l’heure actuelle, il n’existe pas de prise en charge de plusieurs profils d’approvisionnement pour la tâche Xcode (par exemple, pour l’extension d’application iOS).

Exemples

Créez votre application Xcode

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
Capacités	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe lequel
variables settables	N'importe lequel
Version de l’agent	Toutes les versions de l’agent prises en charge.
Catégorie de tâche	Construire