XamariniOS@1: tarea de Xamarin.iOS v1

Artículo
07/02/2024

Use esta tarea en una canalización para compilar una aplicación de iOS con Xamarin en macOS. Para obtener más información, consulte la guía de Xamarin y Firmar la aplicación durante la integración continua.

Sintaxis

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Entradas

solutionFile - Solución
Alias de entrada: solution. string. Obligatorio. Valor predeterminado: **/*.sln.

Especifica la ruta de acceso relativa de la raíz del repositorio de la Xamarin.iOS solución a la compilación. Puede contener caracteres comodín.

configuration - Configuración
string. Obligatorio. Valor predeterminado: Release.

Especifica la configuración. Las configuraciones estándar son Ad-Hoc, AppStore, Debug y Release.

clean - Limpio
boolean. Valor predeterminado: false.

Opcional. Ejecuta una compilación limpia (/t:clean) antes de la compilación.

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

Si se establece trueen , genera un IPA como parte de la compilación.

buildForSimulator - Compilación para el simulador de iOS
Alias de entrada: forSimulator. boolean. Valor predeterminado: false.

Opcional. Compila para el simulador de iOS en lugar de para dispositivos iOS físicos.

runNugetRestore - Ejecución de la restauración de NuGet
boolean. Valor predeterminado: true.

Se ejecuta nuget restore en la solución de Xamarin iOS para instalar todos los paquetes a los que se hace referencia antes de la compilación. Se nuget usa la herramienta de la ruta de acceso de la máquina del agente de compilación. Para usar una versión diferente de NuGet o establecer argumentos adicionales, use la tarea instalador de NuGet.

args - Argumentos
string.

Opcional. Especifica argumentos de línea de comandos adicionales que se usan para la compilación.

workingDirectory - Directorio de trabajo
Alias de entrada: cwd. string.

Opcional. Especifica el directorio de trabajo en el que se ejecutarán las compilaciones. Si el valor está vacío, se usa la raíz del repositorio.

buildToolOption - Herramienta de compilación
Alias de entrada: buildTool. string. Valores permitidos: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio para Mac)). Valor predeterminado: xbuild.

Especifica las herramientas de compilación que usará la tarea.

mdtoolFile - Ruta de acceso de la herramienta de compilación
Alias de entrada: mdtoolLocation. string.

Opcional. Proporciona la ruta de acceso a xbuild (la herramienta de compilación mono de Xamarin Studio) o MSBuild (la herramienta de compilación Visual Studio para Mac). Si el valor está vacío, se usa la ruta de acceso predeterminada de xbuild o MSBuild.

signingOption - Invalidación mediante
Alias de entrada: signMethod. 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 usar un certificado P12 y un perfil de aprovisionamiento. Elija id 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.

signingIdentity - Identidad de firma
Alias de entrada: iosSigningIdentity. string. Opcional. Use cuando signMethod = id.

Invalida la identidad de firma que se usará para firmar la compilación. Si el valor está vacío, se usará la configuración del proyecto de Xcode. Es posible que tenga que seleccionar signingUnlockDefaultKeychain si usa esta opción.

signingUnlockDefaultKeychain - Desbloqueo de la cadena de claves predeterminada
Alias de entrada: unlockDefaultKeychain. boolean. Opcional. Use cuando signMethod = id. Valor predeterminado: false.

Resuelve los errores de "No se permite la interacción del usuario" desbloqueando la cadena de claves predeterminada.

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

Especifica la contraseña para desbloquear la cadena de claves predeterminada cuando signingUnlockDefaultKeychain se establece.

signingProvisioningProfileID - UUID del perfil de aprovisionamiento
Alias de entrada: provProfileUuid. string. Opcional. Use cuando signMethod = id.

Especifica el UUID de un perfil de aprovisionamiento instalado que se usará para esta compilación.

signingP12File - Archivo de certificado P12
Alias de entrada: 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 esta compilación.

signingP12Password - Contraseña P12
Alias de entrada: p12pwd. string. Opcional. Use cuando signMethod = file.

Especifica la contraseña para el archivo de certificado P12. Use una variable de compilación para cifrar este valor.

signingProvisioningProfileFile - Archivo de perfil de aprovisionamiento
Alias de entrada: provProfile. string. Opcional. Use cuando signMethod = file.

Especifica el UUID de una invalidación de perfil de aprovisionamiento instalado que se usará para esta compilación.

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

Especifica que el contenido del archivo de perfil de aprovisionamiento debe quitarse del agente de compilación una vez completada la compilación. Habilite esto solo si ejecuta un agente por usuario.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus 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: Xamarin.iOS
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

Compartir vía