Compartir a través de

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

  • Artículo

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

Sintaxis

# 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

acciones de actions -
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 la Apple: Compilación desde la línea de comandos con preguntas más frecuentes de Xcode.


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

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 .


sdk - sdk de
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 - área de trabajo o ruta de acceso 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.


esquema de scheme -
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 de.


ruta de acceso de archivo de archivePath -
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.


opciones de exportación de exportOptions -
string. Valores permitidos: auto, plist, specify. Valor predeterminado: auto.

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


del método export de exportMethod -
string. Obligatorio cuando exportOptions == specify. Valor predeterminado: development.

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


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

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


exportOptionsPlist - opciones de exportación
string. Obligatorio 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 - de firma automática
boolean. Valor predeterminado: false.

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


id. de equipo de teamId -
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.


invalidación de signMethod - 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 para 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 - de 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. desbloquear cadena de claves predeterminada es posible que deba seleccionarse.


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

Resuelve no se permite la interacción del usuario errores 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 - de 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).


de archivo de certificado P12 de 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.


de contraseña de p12pwd - 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. Solo compruebe si está ejecutando un agente por usuario.


argumentos de args -
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.


de directorio de trabajo de
string.

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


outputPattern - de 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 - Usar xcpretty
boolean. Valor predeterminado: false.

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


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

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


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte 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
demandas Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas ejecutar trabajos que usen esta tarea: xcode
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente Todas las versiones de agente admitidas.
Categoría de tarea Construir