XamariniOS@2 — задача Xamarin.iOS версии 2

Статья
07/02/2024

Используйте эту задачу в конвейере для создания приложения iOS с помощью Xamarin в macOS. Дополнительные сведения см. в руководстве по Xamarin и в разделе Подпись приложения во время CI.

Синтаксис

# Xamarin.iOS v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

Входные данные

solutionFile - Решение
Входной псевдоним: solution. string. Обязательный. Значение по умолчанию: **/*.sln.

Указывает относительный путь от корня репозитория Xamarin.iOS решения или проекта csproj к сборке. Может содержать подстановочные знаки.

configuration - Конфигурации
string. Обязательный. Значение по умолчанию: Release.

Указывает конфигурацию. Стандартные конфигурации: Ad-Hoc, AppStore, Debug и Release.

clean - Чистый
boolean. Значение по умолчанию: false.

Необязательный элемент. Выполняет чистую сборку (/t:clean) перед сборкой.

packageApp - Создание пакета приложения
boolean. Значение по умолчанию: true.

Если задано значение true, создается IPA как часть сборки.

buildForSimulator - Сборка для симулятора iOS
Входной псевдоним: forSimulator. boolean. Значение по умолчанию: false.

Необязательный элемент. Сборки для симулятора iOS вместо физических устройств iOS.

runNugetRestore - Запуск восстановления NuGet
boolean. Значение по умолчанию: false.

Выполняется nuget restore в решении Xamarin iOS для установки всех пакетов, на которые есть ссылки, перед сборкой. Используется nuget средство в path на компьютере агента сборки. Чтобы использовать другую версию NuGet или задать дополнительные аргументы, используйте задачу установщика NuGet.

args - Аргументы
string.

Необязательный элемент. Указывает дополнительные аргументы командной строки, используемые для сборки.

workingDirectory - Рабочий каталог
Входной псевдоним: cwd. string.

Необязательный элемент. Указывает рабочий каталог, в котором будут выполняться сборки. Если значение пустое, используется корень репозитория.

mdtoolFile - Путь к инструменту сборки
Входной псевдоним: buildToolLocation | mdtoolLocation. string.

Необязательный элемент. Предоставляет путь к xbuild (инструмент сборки Xamarin Studio mono) или MSBuild (средство сборки Visual Studio для Mac). Если значение пусто, используется путь xbuild или MSBuild по умолчанию.

signingIdentity - Удостоверение подписывания
Входной псевдоним: iosSigningIdentity. string.

Необязательный элемент. Переопределяет удостоверение подписывания, которое будет использоваться для подписывания сборки. Если значение пустое, будет использоваться параметр в проекте Xcode. Возможно, потребуется выбрать signingUnlockDefaultKeychain , используется ли этот параметр.

signingProvisioningProfileID - UUID профиля подготовки
Входной псевдоним: provProfileUuid. string.

Необязательный элемент. Указывает UUID переопределения установленного профиля подготовки, который будет использоваться для этой сборки.

Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Новые возможности этой версии задачи

Настройка подписи iOS была удалена из задачи. Используйте Secure Files со вспомогательными задачами Install Apple Certificate и Install Apple Provisioning Profile для настройки подписывания. Обновлены параметры для улучшения работы с Visual Studio for Mac.

Примеры

Создание приложения Xamarin

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка
Выполняется в	Агент, DeploymentGroup
Требования	Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: Xamarin.iOS
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Сборка

Поделиться через