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í |