Udostępnij za pośrednictwem


XamarinAndroid@1 — zadanie Xamarin.Android w wersji 1

To zadanie służy do kompilowania aplikacji systemu Android za pomocą platformy Xamarin.

Składnia

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

Dane wejściowe

projectFile - Projektu
Alias wejściowy: project. string. Wymagane. Wartość domyślna: **/*.csproj.

Określa ścieżkę względną z katalogu głównego Xamarin.Android repozytorium projektów do kompilacji. Symbole wieloznaczne mogą być używane. Aby uzyskać więcej informacji, zobacz Dokumentację wzorców dopasowywania plików. Na przykład **/*.csproj dla wszystkich plików csproj we wszystkich podfolderach. Jeśli wybrano element docelowy, projekt musi mieć wartość docelową PackageForAndroidCreate App Package .


target - Docelowego
string.

Określa, które elementy docelowe mają być kompilowanie w tym projekcie. Użyj średnika, aby oddzielić wiele obiektów docelowych.


outputDirectory - Katalog wyjściowy
Alias wejściowy: outputDir. string.

Opcjonalny. Udostępnia katalog wyjściowy kompilacji. Przykład: $(build.binariesDirectory)/bin/Release.


configuration - Konfiguracji
string.

Określa konfigurację, którą chcesz skompilować. Na przykład: debug lub release.

Porada

Zadeklaruj zmienną kompilacji, taką jak BuildConfiguration na karcie zmienne (wybierając Allow pozycję Czas kolejki) i odwołuje się do niej tutaj jako $(BuildConfiguration). Następnie można zmodyfikować platformę podczas kolejkowania kompilacji i włączania tworzenia wielu konfiguracji.


createAppPackage - Tworzenie pakietu aplikacji
boolean. Wartość domyślna: true.

Przekazuje element docelowy , (/t:PackageForAndroid)podczas kompilacji w celu wygenerowania pliku APK.


clean - Czyste
boolean. Wartość domyślna: false.

Przekazuje czysty element docelowy , (/t:clean)podczas kompilacji.


msbuildLocationOption - Msbuild
Alias wejściowy: msbuildLocationMethod. string. Dozwolone wartości: version, location (Określ lokalizację). Wartość domyślna: version.

Określa ścieżkę do programu MSBuild (w systemie Windows) lub xbuild (w systemie macOS). Domyślne zachowanie polega na wyszukiwaniu najnowszej wersji.


msbuildVersionOption - Wersja programu MSBuild
Alias wejściowy: msbuildVersion. string. Opcjonalny. Użyj polecenia , gdy msbuildLocationMethod = version. Dozwolone wartości: latest, 17.0 (MSBuild 17.0), 16.0 (MSBuild 16.0), (MSBuild 15.0), 15.0 (MSBuild 14.0), 14.012.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). Wartość domyślna: 15.0.

Określa użycie najnowszej wersji, jeśli nie można odnaleźć preferowanej wersji. W systemie macOS zostanie użyty program xbuild (Mono) lub MSBuild (Visual Studio dla komputerów Mac).


msbuildVersionOption - Wersja programu MSBuild
Alias wejściowy: msbuildVersion. string. Opcjonalny. Użyj polecenia , gdy msbuildLocationMethod = version. Dozwolone wartości: latest, 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), (MSBuild 12.0), 12.04.0 (MSBuild 4.0). Wartość domyślna: 15.0.

Określa użycie najnowszej wersji, jeśli nie można odnaleźć preferowanej wersji. W systemie macOS zostanie użyty program xbuild (Mono) lub MSBuild (Visual Studio dla komputerów Mac).


msbuildFile - Lokalizacja programu MSBuild
Alias wejściowy: msbuildLocation. string. Wymagane, gdy msbuildLocationMethod = location.

Opcjonalny. Dostarcza ścieżkę do programu MSBuild (w systemie Windows) lub xbuild (w systemie macOS).


msbuildArchitectureOption - Architektura programu MSBuild
Alias wejściowy: msbuildArchitecture. string. Opcjonalny. Użyj polecenia , gdy msbuildLocationMethod = version. Dozwolone wartości: x86 (MSBuild x86), x64 (MSBuild x64). Wartość domyślna: x86.

Dostarcza architekturę (x86, x64) programu MSBuild, który chcesz uruchomić.


msbuildArguments - Dodatkowe argumenty
string.

Określa dodatkowe argumenty przekazywane do programu MSBuild (w systemie Windows) lub xbuild (w systemie macOS).


jdkOption - Wybierz zestaw JDK do użycia dla kompilacji
Alias wejściowy: jdkSelection. string. Wymagane. Dozwolone wartości: JDKVersion (wersja zestawu JDK), Path. Wartość domyślna: JDKVersion.

Określa wersję zestawu JDK używaną przez zadanie podczas procesu kompilacji. Wartość JDKVersion określa wersję zestawu JDK, którą zadanie odnajduje podczas kompilacji. Wartość Path określa ścieżkę pliku dla wersji zestawu JDK.


jdkVersionOption - Wersja zestawu JDK
Alias wejściowy: jdkVersion. string. Opcjonalny. Użyj polecenia , gdy jdkSelection = JDKVersion. Dozwolone wartości: default, 1.11 (JDK 11), 1.10 (JDK 10 (brak obsługi)), (JDK 9 (brak obsługi) 1.8 ), 1.9 (JDK 8), (JDK 7), 1.71.6 (JDK 6 (brak obsługi)). Wartość domyślna: default.

Określa wersję zestawu JDK do użycia podczas kompilacji.


jdkDirectory - Ścieżka zestawu JDK
Alias wejściowy: jdkUserInputPath. string. Wymagane, gdy jdkSelection = Path.

Określa wersję zestawu JDK do użycia podczas kompilacji w ścieżce jdkSelection .


jdkArchitectureOption - Architektura zestawu JDK
Alias wejściowy: jdkArchitecture. string. Opcjonalny. Użyj polecenia , gdy jdkVersion != default. Dozwolone wartości: x86, x64. Wartość domyślna: x64.

Dostarcza architekturę (x86, x64) zestawu JDK.


Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do kompilowania aplikacji systemu Android za pomocą platformy Xamarin.

Przykłady

Wymagania

Wymaganie Opis
Typy potoków YAML, kompilacja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: MSBuild, Xamarin.Android
Możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń Dowolne
Zmienne w formie tabeli settable Dowolne
Wersja agenta 1.83.0 lub nowsza
Kategoria zadania Kompilacja