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.

Syntax

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

Entrées

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

Spécifie une liste d’actions délimitée par des espaces. Certaines options valides sont build, clean, test, analyzeet archive. Par exemple,clean build effectue une build propre. Consultez Apple : Création à partir de la ligne de commande avec Xcode FAQ.

configuration - Configuration
string. Valeur par défaut : $(Configuration).

Spécifie la configuration du projet Xcode ou de l’espace de travail à 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 terminal macOS, 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 - Chemin d’accès de l’espace de travail ou du projet
string. Valeur par défaut : **/*.xcodeproj/project.xcworkspace.

facultatif. Spécifie un chemin relatif à partir 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 - Régime
string.

facultatif. 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 seul schéma partagé, le schéma d’espace de travail est utilisé.

xcodeVersion - Version de Xcode
string. Valeurs autorisées : 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Spécifier le chemin). Valeur par défaut : default.

Spécifie la version cible de Xcode. Sélectionnez cette option Default pour utiliser la version par défaut de Xcode sur l’ordinateur de l’agent. La spécification d’un numéro de version (par exemple, Xcode 9) s’appuie sur l’emplacement de la version à définir par les variables d’environnement sur l’ordinateur agent (par exemple, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Sélectionnez cette option 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. facultatif. 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 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 à l’archive
string. facultatif. Utilisez quand packageApp == true.

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

exportPath - Chemin d’exportation
string. facultatif. Utilisez quand packageApp == true. Valeur par défaut : output/$(SDK)/$(Configuration).

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

exportOptions - Options d’exportation
string. facultatif. 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. Permet Plist de spécifier un fichier plist contenant des options d’exportation. Sélectionnez cette option Specify pour fournir une méthode d’exportation et un ID d’équipe spécifiques.

exportMethod - Méthode d’exportation
string. Nécessaire lorsque exportOptions == specify. Valeur par défaut : development.

Spécifie la méthode que Xcode utilise pour exporter l’archive. Par exemple : app-store, package, ad-hoc, enterprise ou development.

exportTeamId - ID d’équipe
string. facultatif. Utilisez quand exportOptions == specify.

Spécifie l’ID d’équipe à 10 caractères du portail des développeurs Apple à utiliser lors de l’exportation.

exportOptionsPlist - Options d’exportation plist
string. Nécessaire 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. facultatif. Utilisez quand packageApp == true.

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

signingOption - Style de signature
string. Valeurs autorisées : nosign (Ne pas coder le signe), 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 spécifier éventuellement un ID d’équipe de développement. Si votre projet nécessite une signature, utilisez les tâches Installer Apple... pour installer des certificats et des profils d’approvisionnement avant la build Xcode.

signingIdentity - Identité de signature
string. facultatif. Utilisez quand signingOption = manual.

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

provisioningProfileUuid - UUID de profil d’approvisionnement
string. facultatif. 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. facultatif. Utilisez quand signingOption = manual.

Spécifie le nom d’un profil d’approvisionnement installé utilisé pour la build. S’il est spécifié, cela 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. facultatif. 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 et watchOS), tvOS, , macOScustom. iOS Valeur par défaut : default.

Spécifie la plateforme de l’appareil de destination utilisée pour le test de l’interface utilisateur lorsque l’appareil de build générique n’est pas valide. Choisissez Custom de spécifier une plateforme non incluse dans cette liste. Quand Default est sélectionné, aucun simulateur ou appareil n’est ciblé.

destinationPlatform - Plateforme de destination personnalisée
string. facultatif. Utilisez quand destinationPlatformOption == custom.

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

destinationTypeOption - Type de destination
string. facultatif. 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 de l’interface utilisateur. Les appareils doivent être connectés au Mac effectuant la génération via un câble ou une connexion réseau. Pour plus d’informations, consultez Appareils et simulateurs dans Xcode.

destinationSimulators - Simulateur
string. facultatif. Utilisez quand destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

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

destinationDevices - Appareil
string. facultatif. Utilisez quand destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Spécifie le nom de l’appareil utilisé pour le test de l’interface utilisateur, par exemple 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, vous pouvez utiliser des guillemets simples à droite (').

args - Arguments
string.

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

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

facultatif. Spécifie le répertoire de travail dans lequel exécuter la build. Si aucune valeur n’est entrée, la racine du dépôt est utilisée.

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

Spécifie s’il faut utiliser pour mettre xcpretty en forme 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). Si xcpretty n’est pas installé, la sortie brute xcodebuild s’affiche. Pour plus d’informations, consultez xcpretty .

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

Si xcpretty est activé, cette entrée spécifie les 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 doit xcpretty être activé pour générer les résultats du test JUnit.

testRunTitle - Titre de la série de tests
string. facultatif. 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.

Notes

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 d’approvisionnement

Actuellement, 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éer votre application Xcode

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : xcode
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Build