XamarinAndroid@1 - Xamarin.Android v1-taak

Gebruik deze taak om een Android-app te bouwen met 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.

Invoerwaarden

projectFile - Project
Invoeralias: project. string. Vereist. Standaardwaarde: **/*.csproj.

Hiermee geeft u het relatieve pad van de opslagplaatshoofdmap van Xamarin.Android project(en) naar build. Jokertekens kunnen worden gebruikt. Zie de naslaginformatie over bestandskoppelingspatronen voor meer informatie. Bijvoorbeeld **/*.csproj voor alle csproj-bestanden in alle submappen. Het project moet een PackageForAndroid doel hebben als Create App Package dit is geselecteerd.

target - Doel
string.

Hiermee geeft u op welke doelen in dit project moeten worden gebouwd. Gebruik een puntkomma om meerdere doelen van elkaar te scheiden.

outputDirectory - Uitvoermap
Invoeralias: outputDir. string.

Optioneel. Biedt de uitvoermap voor de build. Voorbeeld: $(build.binariesDirectory)/bin/Release.

configuration - Configuratie
string.

Hiermee geeft u de configuratie die u wilt bouwen. Bijvoorbeeld debug of release.

Tip

Declareer een buildvariabele, zoals BuildConfiguration op het tabblad Variabelen (selecteer Allow op Wachtrijtijd) en verwijs hier naar $(BuildConfiguration). U kunt het platform vervolgens wijzigen wanneer u de build in de wachtrij zet en het bouwen van meerdere configuraties inschakelt.

createAppPackage - App-pakket maken
boolean. Standaardwaarde: true.

Geeft het doel, (/t:PackageForAndroid), tijdens de build door om een APK te genereren.

clean - Schoon
boolean. Standaardwaarde: false.

Geeft het schone doel, (/t:clean), door tijdens de build.

msbuildLocationOption - MSBuild
Invoeralias: msbuildLocationMethod. string. Toegestane waarden: version, location (Locatie opgeven). Standaardwaarde: version.

Hiermee geeft u het pad naar MSBuild (in Windows) of xbuild (op macOS). Het standaardgedrag is om te zoeken naar de nieuwste versie.

msbuildVersionOption - MSBuild-versie
Invoeralias: msbuildVersion. string. Optioneel. Gebruik wanneer msbuildLocationMethod = version. Toegestane waarden: 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). Standaardwaarde: 15.0.

Hiermee geeft u het gebruik van de nieuwste versie als de voorkeursversie niet kan worden gevonden. In macOS wordt xbuild (Mono) of MSBuild (Visual Studio voor Mac) gebruikt.

msbuildFile - MSBuild-locatie
Invoeralias: msbuildLocation. string. Vereist wanneer msbuildLocationMethod = location.

Optioneel. Levert het pad naar MSBuild (in Windows) of xbuild (op macOS).

msbuildArchitectureOption - MSBuild-architectuur
Invoeralias: msbuildArchitecture. string. Optioneel. Gebruik wanneer msbuildLocationMethod = version. Toegestane waarden: x86 (MSBuild x86), x64 (MSBuild x64). Standaardwaarde: x86.

Levert de architectuur (x86, x64) van de MSBuild die u wilt uitvoeren.

msbuildArguments - Aanvullende argumenten
string.

Hiermee geeft u aanvullende argumenten doorgegeven aan MSBuild (op Windows) of xbuild (op macOS).

jdkOption - Selecteer JDK om te gebruiken voor de build
Invoeralias: jdkSelection. string. Vereist. Toegestane waarden: JDKVersion (JDK-versie), Path. Standaardwaarde: JDKVersion.

Hiermee geeft u de JDK-versie op die de taak gebruikt tijdens het buildproces. De JDKVersion waarde geeft een JDK-versie op die de taak tijdens builds detecteert. De Path waarde geeft een bestandspad op voor een JDK-versie.

jdkVersionOption - JDK-versie
Invoeralias: jdkVersion. string. Optioneel. Gebruik wanneer jdkSelection = JDKVersion. Toegestane waarden: default, 1.11 (JDK 11), 1.10 (JDK 10 (niet ondersteund)), 1.9 (JDK 9 (niet ondersteund)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (niet ondersteund)). Standaardwaarde: default.

Hiermee geeft u de JDK-versie op die tijdens de build moet worden gebruikt.

jdkDirectory - JDK-pad
Invoeralias: jdkUserInputPath. string. Vereist wanneer jdkSelection = Path.

Hiermee geeft u de JDK-versie te gebruiken tijdens de build op het jdkSelection pad.

jdkArchitectureOption - JDK-architectuur
Invoeralias: jdkArchitecture. string. Optioneel. Gebruik wanneer jdkVersion != default. Toegestane waarden: x86, x64. Standaardwaarde: x64.

Levert de architectuur (x86, x64) van JDK.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Android-app te bouwen met Xamarin.

Voorbeelden

• Uw Xamarin-app bouwen

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: MSBuild, Xamarin.Android
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.83.0 of hoger
Taakcategorie	Build