XamarinAndroid@1 — задача Xamarin.Android версии 1
Используйте эту задачу для создания приложения Android с помощью Xamarin.
Синтаксис
# 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.
Входные данные
projectFile
- Проекта
Входной псевдоним: project
. string
. Обязательный. Значение по умолчанию: **/*.csproj
.
Указывает относительный путь от корня репозитория проектов Xamarin.Android
к сборке. Можно использовать подстановочные знаки. Дополнительные сведения см. в справочнике по шаблонам сопоставления файлов. Например, **/*.csproj
для всех csproj-файлов во всех вложенных папках. Если выбрано, проект должен иметь целевой PackageForAndroid
объект Create App Package
.
target
- Целевой
string
.
Указывает целевые объекты для сборки в этом проекте. Используйте точку с запятой для разделения нескольких целевых объектов.
outputDirectory
- Выходной каталог
Входной псевдоним: outputDir
. string
.
Необязательный элемент. Предоставляет выходной каталог для сборки. Пример: $(build.binariesDirectory)/bin/Release.
configuration
- Конфигурации
string
.
Указывает конфигурацию, которую требуется выполнить сборку. Например, debug
или release
.
Совет
Объявите переменную сборки, BuildConfiguration
например, на вкладке переменных (выбрав Allow
параметр Время очереди) и сослаться на нее здесь как $(BuildConfiguration)
. Затем вы можете изменить платформу при постановке сборки в очередь и включить сборку нескольких конфигураций.
createAppPackage
- Создание пакета приложения
boolean
. Значение по умолчанию: true
.
Передает целевой объект (/t:PackageForAndroid)
во время сборки, чтобы создать APK.
clean
- Чистый
boolean
. Значение по умолчанию: false
.
Передает чистый целевой (/t:clean)
объект , во время сборки.
msbuildLocationOption
- Msbuild
Входной псевдоним: msbuildLocationMethod
. string
. Допустимые значения: version
, location
(укажите расположение). Значение по умолчанию: version
.
Указывает путь к MSBuild (в Windows) или xbuild (в macOS). По умолчанию выполняется поиск последней версии.
msbuildVersionOption
- Версия MSBuild
Входной псевдоним: msbuildVersion
. string
. Необязательный элемент. Используйте при msbuildLocationMethod = version
. Допустимые значения: 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). Значение по умолчанию: 15.0
.
Указывает использование последней версии, если предпочтительную версию не удается найти. В macOS будет использоваться xbuild (Mono) или MSBuild (Visual Studio для Mac).
msbuildVersionOption
- Версия MSBuild
Входной псевдоним: msbuildVersion
. string
. Необязательный элемент. Используйте при msbuildLocationMethod = version
. Допустимые значения: latest
, 15.0
(MSBuild 15.0), 14.0
(MSBuild 14.0), 12.0
(MSBuild 12.0), 4.0
(MSBuild 4.0). Значение по умолчанию: 15.0
.
Указывает использование последней версии, если предпочтительную версию не удается найти. В macOS будет использоваться xbuild (Mono) или MSBuild (Visual Studio для Mac).
msbuildFile
- Расположение MSBuild
Входной псевдоним: msbuildLocation
. string
. Требуется при .msbuildLocationMethod = location
Необязательный элемент. Предоставляет путь к MSBuild (в Windows) или xbuild (в macOS).
msbuildArchitectureOption
- Архитектура MSBuild
Входной псевдоним: msbuildArchitecture
. string
. Необязательный элемент. Используйте при msbuildLocationMethod = version
. Допустимые значения: x86
(MSBuild x86), x64
(MSBuild x64). Значение по умолчанию: x86
.
Предоставляет архитектуру (x86, x64) msBuild, которую вы хотите запустить.
msbuildArguments
- Дополнительные аргументы
string
.
Указывает дополнительные аргументы, передаваемые в MSBuild (в Windows) или xbuild (в macOS).
jdkOption
- Выберите JDK, чтобы использовать для сборки.
Входной псевдоним: jdkSelection
. string
. Обязательный. Допустимые значения: JDKVersion
(версия JDK), Path
. Значение по умолчанию: JDKVersion
.
Указывает версию JDK, которую задача использует в процессе сборки. Значение JDKVersion
указывает версию JDK, которую задача обнаруживает во время сборки. Значение Path
указывает путь к файлу для версии JDK.
jdkVersionOption
- Версия JDK
Входной псевдоним: jdkVersion
. string
. Необязательный элемент. Используйте при jdkSelection = JDKVersion
. Допустимые значения: default
, 1.11
(JDK 11), 1.10
(JDK 10 (не поддерживается)), 1.9
(JDK 9 (не поддерживается)), 1.8
(JDK 8), 1.7
(JDK 7), 1.6
(JDK 6 (не поддерживается)). Значение по умолчанию: default
.
Указывает версию JDK, используемую во время сборки.
jdkDirectory
- Путь JDK
Входной псевдоним: jdkUserInputPath
. string
. Требуется при .jdkSelection = Path
Указывает версию JDK, используемую во время сборки по jdkSelection
пути.
jdkArchitectureOption
- Архитектура JDK
Входной псевдоним: jdkArchitecture
. string
. Необязательный элемент. Используйте при jdkVersion != default
. Допустимые значения: x86
, x64
. Значение по умолчанию: x64
.
Предоставляет архитектуру JDK (x86, x64).
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.
Выходные переменные
Нет.
Remarks
Используйте эту задачу для создания приложения Android с помощью Xamarin.
Примеры
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
Требования | Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: MSBuild, Xamarin.Android |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | 1.83.0 или более поздней версии |
Категория задач | Сборка |