Compartir vía

Xcode@3: tarea de compilación de Xcode v3

  • Artículo

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

Syntax

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

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 .


archivePath - Ruta de acceso de archivo
string.

Opcional. Especifica un directorio donde se colocan los archivos creados.


exportPath - Ruta de acceso de exportación
string. Valor predeterminado: output/$(SDK)/$(Configuration).

Opcional. Especifica el destino del producto exportado desde el archivo.


exportOptions - Opciones de exportación
string. 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.


exportArgs - Exportar argumentos
string.

Especifica argumentos de línea de comandos adicionales que se usan para exportar.


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 usará para la compilación.


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

Especifica la contraseña en un archivo de certificado P12. 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 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 donde se colocan los resultados de compilación (binarios).


xcodeDeveloperDir - Ruta de acceso del desarrollador de Xcode
string.

Opcional. Especifica la ruta de acceso a la carpeta Desarrollador de Xcode 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 pruebas de JUnit. Debe instalarse en los hosts del agente. Más información sobre xcpretty.


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

Los resultados de pruebas de JUnit que se produjeron mediante xctool se publican en VSTS/TFS.


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 admitidas.
Categoría de la tarea: Build