Ir al contenido principal

Microsoft Build 2026

Catch up on keynotes, sessions, and announcements. Learn anytime, on demand, at your own pace. Learn

Iniciar sesión Azure DevOps

Es posible que algunas partes de este tema se traduzcan de manera automática o mediante IA. Versión Buscar

• Azure Pipelines task index
• Xcode@5
  • Xcode@4

Xcode@5 - Tarea de Xcode v5

Use esta tarea para compilar, probar o archivar un área de trabajo de Xcode en macOS y, opcionalmente, empaquetar una aplicación.

Sintaxis

YAML

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

Entradas

acciones de actions - string. Obligatorio. Valor predeterminado: build.

Especifica una lista delimitada por espacios de acciones. Algunas opciones válidas son build, clean, test, analyze, y archive. Por ejemplo,clean build realiza una compilación limpia. Consulta Apple: Preguntas frecuentes sobre cómo compilar desde la línea de comandos con Xcode.

Especifica la configuración del proyecto o área de trabajo de Xcode que se va a compilar. Al usar una variable, especifique un valor (por ejemplo, Release) en la pestaña Variables de .

Especifica un SDK que se usará al compilar el proyecto o el área de trabajo de Xcode. En la aplicación Terminal de macOS, ejecute xcodebuild -showsdks para mostrar la lista válida de SDK. Al usar una variable, especifique un valor (por ejemplo, iphonesimulator) en la pestaña Variables de .

Opcional. Especifica una ruta de acceso relativa desde la raíz del repositorio hasta el área de trabajo o el proyecto de Xcode. Por ejemplo, MyApp/MyApp.xcworkspace o MyApp/MyApp.xcodeproj. Pueden emplearse comodines. Obtenga más información sobre los patrones de coincidencia de archivos .

Opcional. Especifica un nombre de esquema de Xcode. Debe ser un esquema compartido (casilla compartida en esquemas administrados en Xcode). Si no especifica un esquema y el área de trabajo especificada tiene un único esquema compartido, se utilizará el esquema de área de trabajo.

Especifica la versión de destino de Xcode. Seleccione Default esta opción para usar la versión predeterminada de Xcode en el equipo del agente. La especificación de un número de versión (por ejemplo, Xcode 9) depende de la ubicación de la versión que se establecerá mediante variables de entorno en el equipo del agente (por ejemplo, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Seleccione Specify path esta opción para proporcionar una ruta de acceso específica al directorio de desarrolladores de Xcode.

Especifica una ruta de acceso a un directorio de desarrollador de Xcode específico (por ejemplo, /Applications/Xcode_9.0.0.app/Contents/Developer). Esta entrada es útil cuando hay varias versiones de Xcode instaladas en el equipo del agente.

Especifica si se genera un archivo de paquete de aplicación IPA como parte de la compilación.

Especifica un directorio donde se colocan los archivos creados.

Especifica el destino del producto exportado desde el archivo.

Especifica las opciones para exportar el archivo. Cuando se selecciona el valor predeterminado de, el método de Automatic exportación se detecta automáticamente desde el archivo. Seleccione Plist esta opción para especificar un archivo plist que contenga opciones de exportación. Seleccione Specify esta opción para proporcionar un método de exportación y un ID de equipo específicos.

Especifica el método que Xcode utiliza para exportar el archivo. Por ejemplo, app-store, package, ad-hoc, enterprise o development.

Especifica el ID de equipo de 10 caracteres del Portal para desarrolladores de Apple que se utilizará durante la exportación.

Especifica la ruta de acceso al archivo plist que contiene las opciones que se van a utilizar durante la exportación.

Especifica los argumentos adicionales de la línea de comandos utilizados durante la exportación.

Especifica el método de firma de la compilación. Seleccione Do not code sign esta opción para deshabilitar la firma. Seleccione Project defaults esta opción para usar solo la configuración de firma del proyecto. Seleccione Manual signing esta opción para forzar la firma manual y, opcionalmente, especificar una identidad de firma y un perfil de aprovisionamiento. Seleccione esta opción Automatic signing para forzar la firma automática y, opcionalmente, especifique un ID de equipo de desarrollo. Si el proyecto requiere firma, use las tareas Instalar Apple... para instalar certificados y perfiles de aprovisionamiento antes de la compilación de Xcode.

Especifica una invalidación de identidad de firma con la que se va a firmar la compilación. Es posible que sea necesario desbloquear el llavero predeterminado en el equipo del agente. Si no se especifica ningún valor, se utiliza la configuración del proyecto de Xcode.

Especifica el UUID de un perfil de aprovisionamiento instalado que se usa para la compilación. Use tareas de compilación independientes con diferentes esquemas o destinos para especificar perfiles de aprovisionamiento por destino en una sola área de trabajo (iOS, tvOS, watchOS).

Especifica el nombre de un perfil de aprovisionamiento instalado que se usa para la compilación. Si se especifica, tiene prioridad sobre el UUID del perfil de aprovisionamiento. Use tareas de compilación independientes con diferentes esquemas o destinos para especificar perfiles de aprovisionamiento por destino en una sola área de trabajo (iOS, tvOS, watchOS).

Obligatorio si es miembro de varios equipos de desarrollo. Especifica el identificador del equipo de desarrollo de 10 caracteres.

Especifica la plataforma del dispositivo de destino que se usa para las pruebas de interfaz de usuario cuando el dispositivo de compilación genérico no es válido. Elija Custom especificar una plataforma que no esté incluida en esta lista. Cuando Default se selecciona, no se selecciona ningún simulador o dispositivo.

Especifica la plataforma de un dispositivo de destino que se usa para las pruebas de interfaz de usuario cuando el dispositivo de compilación genérico no es válido. Elija Custom especificar una plataforma que no esté incluida en la lista. Cuando Default se selecciona, no se dirigen simuladores ni dispositivos.

Especifica el tipo de destino que se va a utilizar para las pruebas de interfaz de usuario. Los dispositivos deben estar conectados al Mac que realiza la compilación a través de un cable o una conexión de red. Consulte Dispositivos y simuladores en Xcode para obtener más información.

Especifica un nombre de simulador de Xcode que se usa para las pruebas de interfaz de usuario. Por ejemplo, iPhone X (iOS y watchOS) o Apple TV 4K (tvOS). Se puede especificar una versión opcional del sistema operativo de destino en el formato OS=<versionNumber>, como iPhone X,OS=11.1. Consulte esta lista de simuladores instalados en el agente de macOS alojado para obtener más información.

Especifica el nombre del dispositivo utilizado para las pruebas de interfaz de usuario, como Raisa's iPad. Actualmente solo se admite un dispositivo. Ten en cuenta que Apple no permite apóstrofes (') en los nombres de los dispositivos. En su lugar, se pueden utilizar comillas simples derechas (').

Opcional. Especifica argumentos adicionales de la línea de comandos con los que se va a compilar. Esta entrada es útil para especificar -target argumentos or -project en lugar de un espacio de trabajo/proyecto y esquema. Consulta Apple: Preguntas frecuentes sobre cómo compilar desde la línea de comandos con Xcode.

Opcional. Especifica el directorio de trabajo en el que se va a ejecutar la compilación. Si no se introduce ningún valor, se utiliza la raíz del repositorio.

Especifica si se va a utilizar xcpretty para dar formato xcodebuild a la salida. xcpretty debe estar instalado en el equipo del agente (está preinstalado en los agentes de compilación hospedados de Azure Pipelines). Si xcpretty no está instalado, se muestra la salida sin procesar xcodebuild . Consulte xcpretty para obtener más información.

Si xcpretty está habilitado, esta entrada especifica argumentos para xcpretty. Vea una lista de argumentos xcpretty en GitHub.

Especifica si se publican los resultados de las pruebas de JUnit en Azure Pipelines. Esto requiere xcpretty estar habilitado para generar los resultados de la prueba JUnit.

xcpretty Si publishJUnitResults y están habilitados, puede especificar el título de la ejecución de la prueba.

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para compilar, probar o archivar un área de trabajo de Xcode en macOS y, opcionalmente, empaquetar una aplicación.

Uso de varios perfiles de aprovisionamiento

Actualmente, no se admiten varios perfiles de aprovisionamiento para la tarea de Xcode (por ejemplo, para la extensión de aplicación de iOS).

Ejemplos

Compila tu aplicación de Xcode

Requisitos

• Last updated on 27/04/2026

En este artículo

1. Sintaxis
2. Entradas
3. Variables de salida
4. Observaciones
5. Ejemplos
6. Requisitos

¿Le ha resultado útil esta página?

• Declinación de responsabilidades de IA
• Versiones anteriores
• Blog
• Contribuir
• Privacidad
• Privacidad de estado del consumidor
• Términos de uso
• Marcas comerciales
• © Microsoft 2026