XamarinAndroid@1: tarea de Xamarin.Android v1

Use esta tarea para compilar una aplicación Android con Xamarin.

Syntax

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

Entradas

projectFile - Proyecto
Alias de entrada: project. string. Obligatorio. Valor predeterminado: **/*.csproj.

Especifica la ruta de acceso relativa de la raíz del repositorio de Xamarin.Android proyectos que se va a compilar. Se pueden usar caracteres comodín. Para obtener más información, vea referencia de patrones de coincidencia de archivos. Por ejemplo, **/*.csproj para todos los archivos csproj en todas las subcarpetas. El proyecto debe tener un PackageForAndroid destino si Create App Package está seleccionado.

target - Objetivo
string.

Especifica los destinos que se van a compilar en este proyecto. Use punto y coma para separar varios destinos.

outputDirectory - Directorio de salida
Alias de entrada: outputDir. string.

Opcional. Proporciona el directorio de salida para la compilación. Ejemplo: $(build.binariesDirectory)/bin/Release.

configuration - Configuración
string.

Especifica la configuración que desea compilar. Por ejemplo, debug o release.

Sugerencia

Declare una variable de compilación, como BuildConfiguration en la pestaña variables (seleccionando Allow en tiempo de cola) y haga referencia a ella aquí como $(BuildConfiguration). Después, puede modificar la plataforma al poner en cola la compilación y habilitar la creación de varias configuraciones.

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

Pasa el destino, (/t:PackageForAndroid), durante la compilación para generar un APK.

clean - Limpio
boolean. Valor predeterminado: false.

Pasa el destino limpio, (/t:clean), durante la compilación.

msbuildLocationOption - Msbuild
Alias de entrada: msbuildLocationMethod. string. Valores permitidos: version, location (Especificar ubicación). Valor predeterminado: version.

Especifica la ruta de acceso a MSBuild (en Windows) o xbuild (en macOS). El comportamiento predeterminado es buscar la versión más reciente.

msbuildVersionOption - Versión de MSBuild
Alias de entrada: msbuildVersion. string. Opcional. Use cuando msbuildLocationMethod = version. Valores permitidos: latest, 17.0 (MSBuild 17.0), 16.0 (MSBuild 16.0), 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). Valor predeterminado: 15.0.

Especifica el uso de la versión más reciente si no se encuentra la versión preferida. En macOS, se usarán xbuild (Mono) o MSBuild (Visual Studio para Mac).

msbuildFile - Ubicación de MSBuild
Alias de entrada: msbuildLocation. string. Necesario cuando msbuildLocationMethod = location.

Opcional. Proporciona la ruta de acceso a MSBuild (en Windows) o xbuild (en macOS).

msbuildArchitectureOption - Arquitectura de MSBuild
Alias de entrada: msbuildArchitecture. string. Opcional. Use cuando msbuildLocationMethod = version. Valores permitidos: x86 (MSBuild x86), x64 (MSBuild x64). Valor predeterminado: x86.

Proporciona la arquitectura (x86, x64) de MSBuild que desea ejecutar.

msbuildArguments - Argumentos adicionales
string.

Especifica argumentos adicionales pasados a MSBuild (en Windows) o xbuild (en macOS).

jdkOption - Seleccione JDK para usar para la compilación.
Alias de entrada: jdkSelection. string. Obligatorio. Valores permitidos: JDKVersion (versión de JDK), Path. Valor predeterminado: JDKVersion.

Especifica la versión de JDK que la tarea usa durante el proceso de compilación. El JDKVersion valor especifica una versión de JDK que la tarea detecta durante las compilaciones. El Path valor especifica una ruta de acceso de archivo para una versión de JDK.

jdkVersionOption - Versión de JDK
Alias de entrada: jdkVersion. string. Opcional. Use cuando jdkSelection = JDKVersion. Valores permitidos: default, 1.11 (JDK 11), 1.10 (JDK 10 (fuera de soporte)), 1.9 (JDK 9 (fuera de soporte)), (JDK 8), 1.81.7 (JDK 7), 1.6 (JDK 6 (fuera de soporte)). Valor predeterminado: default.

Especifica la versión de JDK que se va a usar durante la compilación.

jdkDirectory - Ruta de acceso de JDK
Alias de entrada: jdkUserInputPath. string. Necesario cuando jdkSelection = Path.

Especifica la versión de JDK que se va a usar durante la compilación en la ruta de jdkSelection acceso.

jdkArchitectureOption - Arquitectura de JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use cuando jdkVersion != default. Valores permitidos: x86, x64. Valor predeterminado: x64.

Proporciona la arquitectura (x86, x64) de JDK.

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.

Comentarios

Use esta tarea para compilar una aplicación Android con Xamarin.

Ejemplos

• Compilación de una aplicación Xamarin

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: MSBuild, Xamarin.Android
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	1.83.0 o superior
Categoría de la tarea:	Build