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.

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

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

• Sestavení aplikace Xamarin

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í