XamarinAndroid@1 – Xamarin.Android v1 feladat

Ezzel a feladattal androidos alkalmazást hozhat létre a Xamarin használatával.

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.

Bevitelek

projectFile - Projekt
Bemeneti alias: project. string. Kötelező. Alapértelmezett érték: **/*.csproj.

Megadja a projekt(ek) adattárgyökerétől a Xamarin.Android buildelésig vezető relatív útvonalat. Helyettesítő karaktereket is használhat. További információ: Fájlegyeztetési minták referenciája. Például **/*.csproj az összes almappában lévő összes csproj-fájl esetében. A projektnek rendelkeznie kell egy PackageForAndroid célval, ha Create App Package be van jelölve.

target - Cél
string.

Meghatározza, hogy mely célokat kell létrehozni ebben a projektben. Pontosvesszővel válassza el egymástól a célokat.

outputDirectory - Kimeneti könyvtár
Bemeneti alias: outputDir. string.

Választható. Megadja a build kimeneti könyvtárát. Példa: $(build.binariesDirectory)/bin/Release.

configuration - Konfigurációs
string.

Megadja a létrehozni kívánt konfigurációt. Például debug vagy release.

Tipp

Deklaráljon egy buildváltozót, például BuildConfiguration a változók lapon (a Várakozási idő beállításnál kiválasztva Allow ), és hivatkozzon rá itt a következőként: $(BuildConfiguration). Ezután módosíthatja a platformot, amikor várólistára állítja a buildet, és lehetővé teszi több konfiguráció összeállítását.

createAppPackage - Alkalmazáscsomag létrehozása
boolean. Alapértelmezett érték: true.

A buildelés során átadja a célnak az (/t:PackageForAndroid)APK-t.

clean - Tiszta
boolean. Alapértelmezett érték: false.

A buildelés során átadja a tiszta célt( (/t:clean), ).

msbuildLocationOption - Msbuild
Bemeneti alias: msbuildLocationMethod. string. Engedélyezett értékek: version, location (Hely megadása). Alapértelmezett érték: version.

Megadja az MSBuild (Windows rendszeren) vagy az xbuild (macOS rendszeren) elérési útját. Az alapértelmezett viselkedés a legújabb verzió keresése.

msbuildVersionOption - MSBuild verzió
Bemeneti alias: msbuildVersion. string. Választható. Használja a következőt: msbuildLocationMethod = version. Engedélyezett értékek: 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). Alapértelmezett érték: 15.0.

A legújabb verzió használatát adja meg, ha az előnyben részesített verzió nem található. MacOS rendszeren xbuild (Mono) vagy MSBuild (Visual Studio for Mac) lesz használva.

msbuildFile - MSBuild hely
Bemeneti alias: msbuildLocation. string. Akkor szükséges, ha msbuildLocationMethod = location.

Választható. Megadja az MSBuild (Windows rendszeren) vagy az xbuild (macOS rendszeren) elérési útját.

msbuildArchitectureOption - MSBuild architektúra
Bemeneti alias: msbuildArchitecture. string. Választható. Használja a következőt: msbuildLocationMethod = version. Engedélyezett értékek: x86 (MSBuild x86), x64 (MSBuild x64). Alapértelmezett érték: x86.

A futtatni kívánt MSBuild architektúráját (x86, x64) biztosítja.

msbuildArguments - További argumentumok
string.

Az MSBuild (Windows rendszeren) vagy az xbuild (macOS rendszeren) számára átadott további argumentumokat adja meg.

jdkOption - Válassza ki a buildhez használni kívánt JDK-t
Bemeneti alias: jdkSelection. string. Kötelező. Engedélyezett értékek: JDKVersion (JDK-verzió), Path. Alapértelmezett érték: JDKVersion.

Meghatározza, hogy a feladat melyik JDK-verziót használja a buildelési folyamat során. Az JDKVersion érték egy JDK-verziót határoz meg, amelyet a feladat felderít a buildek során. Az Path érték egy JDK-verzió fájlelérési útját adja meg.

jdkVersionOption - JDK-verzió
Bemeneti alias: jdkVersion. string. Választható. Használja a következőt: jdkSelection = JDKVersion. Engedélyezett értékek: default, 1.11 (JDK 11), 1.10 (JDK 10 (támogatáson kívül)), 1.9 (JDK 9 (támogatáson kívül)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (támogatáson kívül)). Alapértelmezett érték: default.

A buildelés során használandó JDK-verziót adja meg.

jdkDirectory - JDK elérési útja
Bemeneti alias: jdkUserInputPath. string. Akkor szükséges, ha jdkSelection = Path.

Megadja a buildelés során az útvonalon használni kívánt JDK-verziót jdkSelection .

jdkArchitectureOption - JDK-architektúra
Bemeneti alias: jdkArchitecture. string. Választható. Használja a következőt: jdkVersion != default. Engedélyezett értékek: x86, x64. Alapértelmezett érték: x64.

A JDK architektúráját (x86, x64) biztosítja.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal androidos alkalmazást hozhat létre a Xamarin használatával.

Példák

• A Xamarin-alkalmazás létrehozása

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás:	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek a következő követelményeknek a feladatot használó feladatok futtatásához: MSBuild, Xamarin.Android
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.83.0 vagy újabb
Feladatkategória	Build