Compartilhar via


tarefa XamarinAndroid@1 - Xamarin.Android v1

Use essa tarefa para criar um aplicativo 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órios. Valor padrão: **/*.csproj.

Especifica o caminho relativo da raiz do repositório de Xamarin.Android projetos a serem compilados. Caracteres curinga podem ser usados. Para obter mais informações, consulte a referência Padrões de correspondência de arquivos. Por exemplo, **/*.csproj para todos os arquivos csproj em todas as subpastas. O projeto deverá ter um PackageForAndroid destino se Create App Package estiver selecionado.


target - Alvo
string.

Especifica quais destinos criar neste projeto. Use 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 para o build. Exemplo: $(build.binariesDirectory)/bin/Release.


configuration - Configuração
string.

Especifica a configuração que você deseja criar. Por exemplo, debug ou release.

Dica

Declare uma variável de build, como BuildConfiguration na guia variáveis (selecionando Allow em Tempo de Fila) e faça referência aqui como $(BuildConfiguration). Em seguida, você pode modificar a plataforma quando enfileirar o build e habilitar a criação de várias configurações.


createAppPackage - Criar pacote de aplicativos
boolean. Valor padrão: true.

Passa o destino, (/t:PackageForAndroid), durante o build para gerar um APK.


clean - Limpo
boolean. Valor padrão: false.

Passa o limpo destino, (/t:clean), durante o build.


msbuildLocationOption - Msbuild
Alias de entrada: msbuildLocationMethod. string. Valores permitidos: version, location (Especificar Local). Valor padrão: version.

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


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

Especifica o uso da versão mais recente se a versão preferencial não puder ser encontrada. No macOS, xbuild (Mono) ou MSBuild (Visual Studio para Mac) serão usados.


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

Especifica o uso da versão mais recente se a versão preferencial não puder ser encontrada. No macOS, xbuild (Mono) ou MSBuild (Visual Studio para Mac) serão usados.


msbuildFile - Local do MSBuild
Alias de entrada: msbuildLocation. string. Obrigatório quando msbuildLocationMethod = location.

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


msbuildArchitectureOption - Arquitetura do MSBuild
Alias de entrada: msbuildArchitecture. string. Opcional. Use quando msbuildLocationMethod = version. Valores permitidos: x86 (MSBuild x86) x64 (MSBuild x64). Valor padrão: x86.

Fornece a arquitetura (x86, x64) do MSBuild que você deseja executar.


msbuildArguments - Argumentos adicionais
string.

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


jdkOption - Selecione JDK a ser usado para o build
Alias de entrada: jdkSelection. string. Obrigatórios. Valores permitidos: JDKVersion (Versão do JDK), Path. Valor padrão: JDKVersion.

Especifica a versão do JDK que a tarefa usa durante o processo de build. O JDKVersion valor especifica uma versão do JDK que a tarefa descobre durante builds. O Path valor especifica um caminho de arquivo para uma versão do JDK.


jdkVersionOption - Versão do JDK
Alias de entrada: jdkVersion. string. Opcional. Use 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 padrão: default.

Especifica a versão do JDK a ser usada durante o build.


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

Especifica a versão do JDK a ser usada durante o build no jdkSelection caminho.


jdkArchitectureOption - Arquitetura do JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use quando jdkVersion != default. Valores Permitidos: x86 e x64. Valor padrão: x64.

Fornece a arquitetura (x86, x64) do JDK.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa para criar um aplicativo Android com o Xamarin.

Exemplos

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
Executa em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: MSBuild, Xamarin.Android
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.83.0 ou superior
Categoria da tarefa Build