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

Статья
07/02/2024

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

Синтаксис

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  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: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

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

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

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

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. Значение по умолчанию: true.

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

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

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

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

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

buildToolOption - Средство сборки
Входной псевдоним: buildTool. string. Допустимые значения: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio для Mac)). Значение по умолчанию: xbuild.

Указывает средства сборки, которые будут использоваться задачей.

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

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

signingOption - Переопределение с помощью
Входной псевдоним: signMethod. string. Допустимые значения: file (содержимое файла), id (идентификаторы). Значение по умолчанию: file.

Используйте эти входные данные, если в сборке используется метод подписывания или подготовки, отличный от метода по умолчанию. Выберите file использование сертификата P12 и профиля подготовки. Выберите id , чтобы получить параметры подписывания из цепочки ключей по умолчанию и предварительно установленных профилей. Оставьте соответствующие поля пустыми, если вы не хотите переопределять параметры сборки по умолчанию.

signingIdentity - Удостоверение подписывания
Входной псевдоним: iosSigningIdentity. string. Необязательный элемент. Используйте при signMethod = id.

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

signingUnlockDefaultKeychain - Разблокировка цепочки ключей по умолчанию
Входной псевдоним: unlockDefaultKeychain. boolean. Необязательный элемент. Используйте при signMethod = id. Значение по умолчанию: false.

Устраняет ошибки "Взаимодействие с пользователем запрещено" путем разблокировки цепочки ключей по умолчанию.

signingDefaultKeychainPassword - Пароль цепочки ключей по умолчанию
Входной псевдоним: defaultKeychainPassword. string. Необязательный элемент. Используйте при signMethod = id.

Указывает пароль для разблокировки цепочки ключей по умолчанию, если signingUnlockDefaultKeychain задано значение .

signingProvisioningProfileID - UUID профиля подготовки
Входной псевдоним: provProfileUuid. string. Необязательный элемент. Используйте при signMethod = id.

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

signingP12File - Файл сертификата P12
Входной псевдоним: p12. string. Необязательный элемент. Используйте при signMethod = file.

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

signingP12Password - Пароль P12
Входной псевдоним: p12pwd. string. Необязательный элемент. Используйте при signMethod = file.

Указывает пароль для файла сертификата P12. Используйте переменную сборки для шифрования этого значения.

signingProvisioningProfileFile - Файл профиля подготовки
Входной псевдоним: provProfile. string. Необязательный элемент. Используйте при signMethod = file.

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

signingRemoveProfile - Удаление профиля после сборки
Входной псевдоним: removeProfile. boolean. Необязательный элемент. Используйте при signMethod = file. Значение по умолчанию: false.

Указывает, что содержимое файла профиля подготовки должно быть удалено из агента сборки после завершения сборки. Включите этот параметр, только если используется один агент для каждого пользователя.

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

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

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

Нет.

Требования

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

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