Compartir vía

XamariniOS@2: tarea de Xamarin.iOS v2

  • Artículo

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 v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

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 del Xamarin.iOS proyecto de solución o csproj 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: false.

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


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.


mdtoolFile - Ruta de acceso de la herramienta de compilación
Alias de entrada: buildToolLocation | 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.


signingIdentity - Identidad de firma
Alias de entrada: iosSigningIdentity. string.

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


signingProvisioningProfileID - UUID del perfil de aprovisionamiento
Alias de entrada: provProfileUuid. string.

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


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.

Comentarios

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.

Novedades de esta versión de tarea

  • La configuración de registro de iOS se ha quitado de la tarea. Úselo Secure Files con tareas auxiliares Install Apple Certificate y Install Apple Provisioning Profile para configurar la firma. Se han actualizado las opciones para trabajar mejor con Visual Studio for Mac.

Ejemplos

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