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

Статья
03/24/2025

Используйте эту задачу в конвейере для создания приложения 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 в PATH компьютера агента сборки. Чтобы использовать другую версию NuGet или задать дополнительные аргументы, используйте задачу установщика NuGet.

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

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

рабочего каталога workingDirectory -
Псевдоним ввода: cwd. string.

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

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

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

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

Необязательно. Предоставляет путь к xbuild (инструмент сборки Xamarin Studio mono) или 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.

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

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

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

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

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

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

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

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

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

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

Нет.

Требования

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

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