XamarinAndroid@1 – úloha Xamarin.Android v1

Pomocí této úlohy můžete vytvořit aplikaci pro Android pomocí Xamarinu.

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.

Vstupy

projectFile - Projektu
Alias vstupu: project. string. Povinná hodnota. Výchozí hodnota: **/*.csproj.

Určuje relativní cestu z kořenového Xamarin.Android adresáře úložiště projektů k sestavení. Je možné použít zástupné é kóty. Další informace najdete v referenčních informacích o vzorech porovnávání souborů. Například **/*.csproj pro všechny soubory csproj ve všech podsložkách. Projekt musí mít cíl, PackageForAndroid pokud Create App Package je vybrán.


target - Cíl
string.

Určuje, které cíle se mají v tomto projektu sestavit. K oddělení více cílů použijte středník.


outputDirectory - Výstupní adresář
Alias vstupu: outputDir. string.

Nepovinný parametr. Poskytuje výstupní adresář pro sestavení. Příklad: $(build.binariesDirectory)/bin/Release.


configuration - Konfigurace
string.

Určuje konfiguraci, kterou chcete sestavit. Příkladem je debug nebo release.

Tip

Deklarujte Allow proměnnou sestavení, například BuildConfiguration na kartě proměnné (vyberte v čase fronty) a odkazujte na ni jako $(BuildConfiguration). Platformu pak můžete upravit při zatáčet do fronty sestavení a povolit vytváření více konfigurací.


createAppPackage - Vytvoření balíčku aplikace
boolean. Výchozí hodnota: true.

Během sestavení předá cíl (/t:PackageForAndroid), aby se vygeneroval soubor APK.


clean - Čisté
boolean. Výchozí hodnota: false.

Předá čistý cíl (/t:clean)( ) během sestavení.


msbuildLocationOption - Msbuild
Alias vstupu: msbuildLocationMethod. string. Povolené hodnoty: version, location (Zadejte umístění). Výchozí hodnota: version.

Určuje cestu k nástroji MSBuild (ve Windows) nebo xbuild (v macOS). Výchozím chováním je vyhledání nejnovější verze.


msbuildVersionOption - Verze nástroje MSBuild
Alias vstupu: msbuildVersion. string. Nepovinný parametr. Použijte, když msbuildLocationMethod = version. Povolené hodnoty: 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). Výchozí hodnota: 15.0.

Určuje použití nejnovější verze, pokud upřednostňovanou verzi nelze najít. V systému macOS se použije xbuild (Mono) nebo MSBuild (Visual Studio pro Mac).


msbuildVersionOption - Verze nástroje MSBuild
Alias vstupu: msbuildVersion. string. Nepovinný parametr. Použijte, když msbuildLocationMethod = version. Povolené hodnoty: latest, 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). Výchozí hodnota: 15.0.

Určuje použití nejnovější verze, pokud upřednostňovanou verzi nelze najít. V systému macOS se použije xbuild (Mono) nebo MSBuild (Visual Studio pro Mac).


msbuildFile - Umístění nástroje MSBuild
Alias vstupu: msbuildLocation. string. Vyžaduje se, když msbuildLocationMethod = location.

Nepovinný parametr. Poskytuje cestu k nástroji MSBuild (ve Windows) nebo xbuildu (v macOS).


msbuildArchitectureOption - Architektura nástroje MSBuild
Alias vstupu: msbuildArchitecture. string. Nepovinný parametr. Použijte, když msbuildLocationMethod = version. Povolené hodnoty: x86 (MSBuild x86), x64 (MSBuild x64). Výchozí hodnota: x86.

Poskytuje architekturu (x86, x64) msBuildu, který chcete spustit.


msbuildArguments - Další argumenty
string.

Určuje další argumenty předané nástroji MSBuild (ve Windows) nebo xbuild (v macOS).


jdkOption - Vyberte sadu JDK, která se má použít pro sestavení.
Alias vstupu: jdkSelection. string. Povinná hodnota. Povolené hodnoty: JDKVersion (verze sady JDK), Path. Výchozí hodnota: JDKVersion.

Určuje verzi sady JDK, kterou úloha používá během procesu sestavení. Hodnota JDKVersion určuje verzi sady JDK, kterou úloha zjistí během sestavování. Hodnota Path určuje cestu k souboru pro verzi sady JDK.


jdkVersionOption - Verze sady JDK
Alias vstupu: jdkVersion. string. Nepovinný parametr. Použijte, když jdkSelection = JDKVersion. Povolené hodnoty: default, 1.11 (JDK 11), 1.10 (JDK 10 (mimo podporu)), 1.9 (JDK 9 (mimo podporu)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (mimo podporu)). Výchozí hodnota: default.

Určuje verzi sady JDK, která se má použít při sestavování.


jdkDirectory - Cesta sady JDK
Alias vstupu: jdkUserInputPath. string. Vyžaduje se, když jdkSelection = Path.

Určuje verzi sady JDK, která se má použít během sestavování v cestě jdkSelection .


jdkArchitectureOption - Architektura sady JDK
Alias vstupu: jdkArchitecture. string. Nepovinný parametr. Použijte, když jdkVersion != default. Povolené hodnoty: x86, x64. Výchozí hodnota: x64.

Poskytuje architekturu (x86, x64) sady JDK.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Pomocí této úlohy můžete vytvořit aplikaci pro Android pomocí Xamarinu.

Příklady

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build
Běží na Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: MSBuild, Xamarin.Android
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 1.83.0 nebo vyšší
Kategorie úloh Sestavení