XamarinAndroid@1 – Xamarin.Android v1-Aufgabe

XamarinAndroid@1 ist veraltet. Ursprünglich wurde diese Aufgabe verwendet, um eine Android-App mit Xamarin zu erstellen.

Hinweis

Diese Aufgabe ist veraltet und wurde am 1. Mai 2024 eingestellt.

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.

Eingänge

projectFile - Project
Eingabealias: project. string. Erforderlich. Standardwert: **/*.csproj.

Gibt den relativen Pfad vom Repositorystamm Xamarin.Android Projekt(n) zum Erstellen an. Platzhalter können verwendet werden. Weitere Informationen finden Sie im Dateiabgleichsmuster. Beispiel: **/*.csproj für alle csproj-Dateien in allen Unterordnern. Das Projekt muss über ein PackageForAndroid Ziel verfügen, wenn Create App Package ausgewählt ist.

target - Ziel-
string.

Gibt an, welche Ziele in diesem Projekt erstellt werden sollen. Verwenden Sie ein Semikolon, um mehrere Ziele zu trennen.

outputDirectory - Ausgabeverzeichnis
Eingabealias: outputDir. string.

Wahlfrei. Stellt das Ausgabeverzeichnis für den Build bereit. Beispiel: $(build.binariesDirectory)/bin/Release.

configuration - Configuration
string.

Gibt die Konfiguration an, die Sie erstellen möchten. Beispiel: debug oder release.

Tipp

Deklarieren Sie eine Buildvariable, z. B. BuildConfiguration auf der Registerkarte "Variablen" (auswählen Allow bei Warteschlangenzeit), und verweisen Sie hier als $(BuildConfiguration). Sie können die Plattform dann ändern, wenn Sie den Build in die Warteschlange stellen und das Erstellen mehrerer Konfigurationen aktivieren.

createAppPackage - Erstellen eines App-Pakets
boolean. Standardwert: true.

Übergibt das Ziel, (/t:PackageForAndroid), während des Builds, um ein APK zu generieren.

clean - sauberen
boolean. Standardwert: false.

Übergibt das saubere Ziel, (/t:clean), während des Builds.

msbuildLocationOption - MSBuild-
Eingabealias: msbuildLocationMethod. string. Zulässige Werte: version, location (Speicherort angeben). Standardwert: version.

Gibt den Pfad zu MSBuild (unter Windows) oder xbuild (unter macOS) an. Das Standardverhalten besteht darin, nach der neuesten Version zu suchen.

msbuildVersionOption - MSBuild-Version
Eingabealias: msbuildVersion. string. Wahlfrei. Wird verwendet, wenn msbuildLocationMethod = version. Zulässige Werte: 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). Standardwert: 15.0.

Gibt die Verwendung der neuesten Version an, wenn die bevorzugte Version nicht gefunden werden kann. Auf macOS werden xbuild (Mono) oder MSBuild (Visual Studio für Mac) verwendet.

msbuildFile - MSBuild-Speicherort
Eingabealias: msbuildLocation. string. Erforderlich, wenn msbuildLocationMethod = location.

Wahlfrei. Stellt den Pfad zu MSBuild (unter Windows) oder xbuild (unter macOS) bereit.

msbuildArchitectureOption - MSBuild-Architektur
Eingabealias: msbuildArchitecture. string. Wahlfrei. Wird verwendet, wenn msbuildLocationMethod = version. Zulässige Werte: x86 (MSBuild x86), x64 (MSBuild x64). Standardwert: x86.

Stellt die Architektur (x86, x64) des MSBuild bereit, den Sie ausführen möchten.

msbuildArguments - Zusätzliche Argumente
string.

Gibt zusätzliche Argumente an, die an MSBuild (unter Windows) oder xbuild (unter macOS) übergeben werden.

jdkOption - JDK auswählen, das für das Build- verwendet werden soll
Eingabealias: jdkSelection. string. Erforderlich. Zulässige Werte: JDKVersion (JDK Version), Path. Standardwert: JDKVersion.

Gibt die JDK-Version an, die die Aufgabe während des Buildvorgangs verwendet. Der wert JDKVersion gibt eine JDK-Version an, die die Aufgabe während der Builds ermittelt. Der Path Wert gibt einen Dateipfad für eine JDK-Version an.

jdkVersionOption - JDK-Version
Eingabealias: jdkVersion. string. Wahlfrei. Wird verwendet, wenn jdkSelection = JDKVersion. Zulässige Werte: default, 1.11 (JDK 11), 1.10 (JDK 10 (nicht unterstützt)), 1.9 (JDK 9 (nicht unterstützt)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (nicht unterstützt)). Standardwert: default.

Gibt die JDK-Version an, die während des Builds verwendet werden soll.

jdkDirectory - JDK-Pfad
Eingabealias: jdkUserInputPath. string. Erforderlich, wenn jdkSelection = Path.

Gibt die JDK-Version an, die während des Builds im jdkSelection Pfad verwendet werden soll.

jdkArchitectureOption - JDK-Architektur
Eingabealias: jdkArchitecture. string. Wahlfrei. Wird verwendet, wenn jdkVersion != default. Zulässige Werte: x86, x64. Standardwert: x64.

Liefert die Architektur (x86, x64) von JDK.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Android-App mit Xamarin zu erstellen.

Beispiele

• Erstellen Ihrer Xamarin-App

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Läuft auf	Agent, DeploymentGroup
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: MSBuild, Xamarin.Android
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.83.0 oder höher
Vorgangskategorie	Bauen