Freigeben über


XamarinAndroid@1 – Xamarin.Android v1-Aufgabe

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

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.

Eingaben

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

Gibt den relativen Pfad vom Repositorystamm der Xamarin.Android Projekte zum Erstellen an. Platzhalter können verwendet werden. Weitere Informationen finden Sie in der Referenz zu Dateiabgleichsmustern. Beispiel: **/*.csproj für alle CSPROJ-Dateien in sämtlichen Unterordnern. Das Projekt muss ein PackageForAndroid Ziel haben, wenn Create App Package ausgewählt ist.


target - Ziel
string.

Gibt an, welche Ziele in diesem Projekt erstellt werden sollen. Trennen Sie mehrere Ziele mit einem Semikolon.


outputDirectory - Ausgabeverzeichnis
Eingabealias: outputDir. string.

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


configuration - Konfiguration
string.

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

Tipp

Deklarieren Sie eine Buildvariable, z BuildConfiguration . B. auf der Registerkarte Variablen (auswählen unter Allow Warteschlangenzeit), und verweisen Sie hier auf sie als $(BuildConfiguration). Sie können dann die Plattform ä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 - Sauber
boolean. Standardwert. false.

Übergibt das sauber-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. Optional. Verwenden Sie , 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. Unter macOS wird xbuild (Mono) oder MSBuild (Visual Studio für Mac) verwendet.


msbuildVersionOption - MSBuild-Version
Eingabealias: msbuildVersion. string. Optional. Verwenden Sie , wenn msbuildLocationMethod = version. Zulässige Werte: latest, 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. Unter macOS wird xbuild (Mono) oder MSBuild (Visual Studio für Mac) verwendet.


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

Optional. Gibt den Pfad zu MSBuild (unter Windows) oder xbuild (unter macOS) an.


msbuildArchitectureOption - MSBuild-Architektur
Eingabealias: msbuildArchitecture. string. Optional. Verwenden Sie , 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 - Auswählen von JDK, das für den Build verwendet werden soll
Eingabealias: jdkSelection. string. Erforderlich. Zulässige Werte: JDKVersion (JDK-Version), Path. Standardwert. JDKVersion.

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


jdkVersionOption - JDK-Version
Eingabealias: jdkVersion. string. Optional. Verwenden Sie , 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. Optional. Verwenden Sie , wenn jdkVersion != default. Zulässige Werte: x86, x64. Standardwert. x64.

Stellt die Architektur (x86, x64) von JDK bereit.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

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

Beispiele

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, klassischer Build
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: MSBuild, Xamarin.Android
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Setzbare Variablen Any
Agent-Version 1.83.0 oder höher
Aufgabenkategorie Entwickeln