Xcode@2: tarea de compilación v2 de Xcode

Use esta tarea para compilar un área de trabajo de Xcode en macOS.

Syntax

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  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
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # 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.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

Entradas

actions - Acciones
string. Obligatorio. Valor predeterminado: build.

Especifica una lista delimitada por espacios de acciones. Las opciones válidas son build, clean, test, analyze y archive. Por ejemplo, build clean realiza una compilación limpia. Consulte las preguntas más frecuentes de Apple: Compilación desde la línea de comandos con Xcode.

configuration - Configuración
string. Valor predeterminado: $(Configuration).

Especifica la configuración del proyecto o del á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 .

sdk - SDK
string. Valor predeterminado: $(SDK).

Compila un proyecto o área de trabajo de Xcode en el SDK especificado. Ejecute xcodebuild -showsdks para ver una lista válida de SDK.

xcWorkspacePath - Ruta de acceso del área de trabajo o del proyecto
string. Valor predeterminado: **/*.xcodeproj/*.xcworkspace.

Opcional. Especifica la ruta de acceso relativa de la raíz del repositorio al área de trabajo o proyecto de Xcode. Por ejemplo: MyApp/MyApp.xcworkspace o MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Deje en blanco si piensa usar -target flag en Argumentos avanzados.

scheme - Esquema
string.

Opcional. Especifica el nombre del esquema Xcode. Debe ser un esquema compartido (casilla compartida en Esquemas administrados en Xcode). Obligatorio si se especifica Workspace.

packageApp - Crear paquete de aplicación
boolean. Valor predeterminado: true.

Especifica si se genera un IPA como parte de la compilación. Para exportar archivos con Xcode 7 y Xcode 8, revise las entradas adicionales de la sección Opciones de paquete .

packageTool - Creación de un paquete (IPA) mediante
string. Obligatorio. Valores permitidos: xcrun (xcrun (en desuso por Apple)), xcodebuild (archivo y exportación de xcodebuild). Valor predeterminado: xcodebuild.

Especifica la herramienta que se va a usar para generar el IPA.

archivePath - Ruta de acceso de archivo
string. Opcional. Use cuando packageTool == xcodebuild.

Especifica un directorio donde se colocan los archivos creados.

exportPath - Ruta de acceso de exportación
string. Opcional. Use cuando packageTool == xcodebuild. Valor predeterminado: output/$(SDK)/$(Configuration).

Especifica el destino del producto exportado desde el archivo.

exportOptions - Opciones de exportación
string. Opcional. Use cuando packageTool == xcodebuild. Valores permitidos: auto, plist y specify. Valor predeterminado: auto.

Especifica una manera de pasar opciones de exportación al exportar el archivo.

exportMethod - Export (método)
string. Necesario cuando exportOptions == specify. Valor predeterminado: development.

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

exportTeamId - Id. de equipo
string. Opcional. Use cuando exportOptions == specify.

Especifica el identificador de equipo de 10 dígitos del Portal para desarrolladores de Apple que se va a usar para la exportación.

exportOptionsPlist - Opciones de exportación Plist
string. Necesario cuando exportOptions == plist.

Especifica la ruta de acceso a un archivo plist que configura la exportación de archivos.

xcode8AutomaticSigning - Firma automática
boolean. Valor predeterminado: false.

Use esta entrada si tiene un proyecto Xcode 8 o Xcode 9 configurado para firma automática.

teamId - Id. de equipo
string. Opcional. Use cuando xcode8AutomaticSigning = true.

Especifica el identificador del equipo de desarrollador de 10 dígitos. Esto es necesario si es miembro de varios equipos de desarrollo.

signMethod - Invalidación mediante
string. Valores permitidos: file (Contenido del archivo), id (identificadores). Valor predeterminado: file.

Use esta entrada si la compilación usa un método de firma o aprovisionamiento diferente al predeterminado. Elija File Contents usar un certificado P12 y un perfil de aprovisionamiento. Elija Identifiers recuperar la configuración de firma de la cadena de claves predeterminada y los perfiles preinstalados. Deje los campos correspondientes en blanco si no desea invalidar la configuración de compilación predeterminada.

iosSigningIdentity - Identidad de firma
string. Opcional. Use cuando signMethod = id.

Especifica la invalidación de identidad de firma que se usa para firmar la compilación. El valor predeterminado es la configuración del proyecto de Xcode. Es posible que sea necesario seleccionar Desbloquear llavero predeterminado.

unlockDefaultKeychain - Desbloquear cadena de claves predeterminada
boolean. Opcional. Use cuando signMethod = id. Valor predeterminado: false.

Resuelve los errores de interacción del usuario no permitidos desbloqueando la cadena de claves predeterminada.

defaultKeychainPassword - Contraseña de cadena de claves predeterminada
string. Opcional. Use cuando signMethod = id.

Especifica la contraseña para desbloquear la cadena de claves predeterminada.

provProfileUuid - UUID del perfil de aprovisionamiento
string. Opcional. Use cuando signMethod = id.

Especifica el UUID de un perfil de aprovisionamiento instalado que se va a usar 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, WatchKit, tvOS).

p12 - Archivo de certificado P12
string. Opcional. Use cuando signMethod = file.

Especifica la ruta de acceso relativa a un archivo de certificado PKCS12 con formato P12 que contiene un certificado de firma que se va a usar para la compilación.

p12pwd - Contraseña P12
string. Opcional. Use cuando signMethod = file.

Especifica la contraseña a un archivo de certificado P12 si se especifica. Use una variable de compilación para cifrar.

provProfile - Archivo de perfil de aprovisionamiento
string. Opcional. Use cuando signMethod = file.

Especifica la ruta de acceso relativa a un archivo que contiene una invalidación de perfil de aprovisionamiento que se va a usar 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, WatchKit, tvOS).

removeProfile - Quitar perfil después de la compilación
boolean. Opcional. Use cuando signMethod = file. Valor predeterminado: false.

Quita el contenido del archivo de perfil de aprovisionamiento del agente de compilación una vez completada la compilación. Compruebe solo si está ejecutando un agente por usuario.

args - Argumentos
string.

Especifica argumentos de línea de comandos adicionales que se usan para compilar. Esta entrada es útil si desea usar -target o -project en lugar de especificar un área de trabajo y un esquema.

cwd - Directorio de trabajo
string.

Especifica el directorio de trabajo para las ejecuciones de compilación. El valor predeterminado es la raíz del repositorio.

outputPattern - Directorio de salida
string. Obligatorio. Valor predeterminado: output/$(SDK)/$(Configuration).

Especifica la ruta de acceso relativa en la que se colocan los resultados de compilación (binarios).

xcodeDeveloperDir - Ruta de desarrollo de Xcode
string.

Opcional. Especifica la ruta de acceso a la carpeta Xcode Developer si no es el valor predeterminado del sistema. Para su uso cuando se instalan varias versiones de Xcode en un sistema. Por ejemplo: /Applications/Xcode 7.app/Contents/Developer.

useXcpretty - Uso de xcpretty
boolean. Valor predeterminado: false.

Da formato a la xcodebuild salida y genera un informe de resultados de prueba de JUnit. Debe instalarse en hosts del agente. Más información sobre xcpretty.

publishJUnitResults - Publicar en VSTS/TFS
boolean. Valor predeterminado: false.

Los resultados de prueba de JUnit que se generaron mediante xctool se publican en VSTS/TFS.

useXctool - Uso de xctool
boolean.

Usa xctool en lugar de xcodebuild. Debe instalarse en hosts del agente. Más información sobre xctool.
Nota:xctool está en desuso y no funciona con Xcode 8.

xctoolReporter - Formato xctool Test Reporter
string.

Comprueba el formato del informador que se usará cuando se especifica la acción de prueba y se comprueba Usar xctool . Especifique junit:output-file-path-here.xml para generar un formato de archivo compatible con la tarea Publicar resultados de pruebas. Cuando se especifica, se agrega automáticamente plain . xctool debe instalarse en los hosts del agente. Más información sobre xctool.
Nota:xctool está en desuso y no funciona con Xcode 8.

Opciones de control de tareas

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

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: xcode
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente compatibles.
Categoría de la tarea:	Build