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 или более поздней версии
Категория задач Сборка