XamarinAndroid@1 - Tarefa Xamarin.Android v1

Artigo
07/02/2024

Utilize esta tarefa para criar uma aplicação Android com o 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.

# 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' | '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 - Projeto
Alias de entrada: project. string. Obrigatório. Valor predefinido: **/*.csproj.

Especifica o caminho relativo da raiz do repositório do Xamarin.Android (s) projeto(s) a compilar. Podem ser utilizados carateres universais. Para obter mais informações, veja a Referência de padrões de correspondência de ficheiros. Por exemplo, **/*.csproj para todos os ficheiros csproj em todas as subpastas. O projeto tem de ter um PackageForAndroid destino se Create App Package estiver selecionado.

target - Destino
string.

Especifica os destinos a criar neste projeto. Utilize um ponto e vírgula para separar vários destinos.

outputDirectory - Diretório de saída
Alias de entrada: outputDir. string.

Opcional. Fornece o diretório de saída da compilação. Exemplo: $(build.binariesDirectory)/bin/Release.

configuration - Configuração
string.

Especifica a configuração que pretende criar. Por exemplo, debug ou release.

Dica

Declare uma variável de compilação, como BuildConfiguration no separador variables (selecionar em Queue Time) e referencie-a Allow aqui como $(BuildConfiguration). Em seguida, pode modificar a plataforma quando colocar em fila a compilação e ativar a criação de várias configurações.

createAppPackage - Criar pacote de aplicações
boolean. Valor predefinido: true.

Passa o destino, (/t:PackageForAndroid), durante a compilação para gerar uma APK.

clean - Limpar
boolean. Valor predefinido: false.

Passa o destino limpo, (/t:clean), durante a compilação.

msbuildLocationOption - MSBuild
Alias de entrada: msbuildLocationMethod. string. Valores permitidos: version, location (Especificar Localização). Valor predefinido: version.

Especifica o caminho para MSBuild (no Windows) ou xbuild (no macOS). O comportamento predefinido é procurar a versão mais recente.

msbuildVersionOption - Versão do MSBuild
Alias de entrada: msbuildVersion. string. Opcional. Utilize quando 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 predefinido: 15.0.

Especifica a utilização da versão mais recente se não for possível encontrar a versão preferencial. No macOS, serão utilizados xbuild (Mono) ou MSBuild (Visual Studio para Mac).

msbuildVersionOption - Versão do MSBuild
Alias de entrada: msbuildVersion. string. Opcional. Utilize quando msbuildLocationMethod = version. Valores permitidos: latest, 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). Valor predefinido: 15.0.

Especifica a utilização da versão mais recente se não for possível encontrar a versão preferencial. No macOS, serão utilizados xbuild (Mono) ou MSBuild (Visual Studio para Mac).

msbuildFile - Localização do MSBuild
Alias de entrada: msbuildLocation. string. Necessário quando msbuildLocationMethod = location.

Opcional. Fornece o caminho para MSBuild (no Windows) ou xbuild (no macOS).

msbuildArchitectureOption - Arquitetura MSBuild
Alias de entrada: msbuildArchitecture. string. Opcional. Utilize quando msbuildLocationMethod = version. Valores permitidos: x86 (MSBuild x86), x64 (MSBuild x64). Valor predefinido: x86.

Fornece a arquitetura (x86, x64) do MSBuild que pretende executar.

msbuildArguments - Argumentos adicionais
string.

Especifica argumentos adicionais transmitidos para MSBuild (no Windows) ou xbuild (no macOS).

jdkOption - Selecione JDK a utilizar para a compilação
Alias de entrada: jdkSelection. string. Obrigatório. Valores permitidos: JDKVersion (Versão JDK), Path. Valor predefinido: JDKVersion.

Especifica a versão do JDK que a tarefa utiliza durante o processo de compilação. O JDKVersion valor especifica uma versão do JDK que a tarefa deteta durante as compilações. O Path valor especifica um caminho de ficheiro para uma versão do JDK.

jdkVersionOption - Versão do JDK
Alias de entrada: jdkVersion. string. Opcional. Utilize quando jdkSelection = JDKVersion. Valores permitidos: default, 1.11 (JDK 11), 1.10 (JDK 10 (sem suporte)), 1.9 (JDK 9 (sem suporte)), 1.8 (JDK 8), 1.7 (JDK 7) 1.6 (JDK 6 (sem suporte)). Valor predefinido: default.

Especifica a versão do JDK a utilizar durante a compilação.

jdkDirectory - Caminho do JDK
Alias de entrada: jdkUserInputPath. string. Necessário quando jdkSelection = Path.

Especifica a versão do JDK a utilizar durante a compilação no jdkSelection caminho.

jdkArchitectureOption - Arquitetura do JDK
Alias de entrada: jdkArchitecture. string. Opcional. Utilize quando jdkVersion != default. Valores permitidos: x86, x64. Valor predefinido: x64.

Fornece a arquitetura (x86, x64) do JDK.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para criar uma aplicação Android com o Xamarin.

Exemplos

Criar a sua aplicação Xamarin

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agent, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: MSBuild, Xamarin.Android
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.83.0 ou superior
Categoria da tarefa	Compilação

Partilhar via