Xcode@5 — задача Xcode версии 5

Используйте эту задачу для создания, тестирования или архивации рабочей области Xcode в macOS и при необходимости упаковки приложения.

Синтаксис

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

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

actions - Действия
string. Обязательный. Значение по умолчанию: build.

Указывает список действий с разделителями пробелами. Некоторые допустимые параметры: build, clean, test, analyzeи archive. Например,clean build выполняет чистую сборку. См . статью Apple: building from the command line with Xcode Faq(Вопросы и ответы по Xcode).

configuration - Конфигурации
string. Значение по умолчанию: $(Configuration).

Указывает конфигурацию проекта Xcode или рабочей области для сборки. При использовании переменной укажите значение (например, Release) на вкладке Переменные .

sdk - SDK
string. Значение по умолчанию: $(SDK).

Указывает пакет SDK для использования при создании проекта или рабочей области Xcode. В приложении терминала macOS выполните команду xcodebuild -showsdks , чтобы отобразить допустимый список пакетов SDK. При использовании переменной укажите значение (например, iphonesimulator) на вкладке Переменные .

xcWorkspacePath - Путь к рабочей области или проекту
string. Значение по умолчанию: **/*.xcodeproj/project.xcworkspace.

Необязательный элемент. Указывает относительный путь от корня репозитория к рабочей области или проекту Xcode. Например, MyApp/MyApp.xcworkspace или MyApp/MyApp.xcodeproj. Можно использовать подстановочные знаки. Дополнительные сведения о шаблонах сопоставления файлов.

scheme - Схема
string.

Необязательный элемент. Задает имя схемы Xcode. Должна быть общей схемой (общий флажок в разделе Управляемые схемы в Xcode). Если схема не указана, а указанная рабочая область имеет одну общую схему, будет использоваться схема рабочей области.

xcodeVersion - Версия Xcode
string. Допустимые значения: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Укажите путь). Значение по умолчанию: default.

Указывает целевую версию Xcode. Выберите Default , чтобы использовать версию Xcode по умолчанию на компьютере агента. Указание номера версии (например, ) зависит от расположения версии, Xcode 9задаемой переменными среды на компьютере агента (например, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Выберите Specify path , чтобы указать конкретный путь к каталогу разработчика Xcode.

xcodeDeveloperDir - Путь разработчика Xcode
string. Необязательный элемент. Используйте при xcodeVersion == specifyPath.

Указывает путь к определенному каталогу разработчика Xcode (например, /Applications/Xcode_9.0.0.app/Contents/Developer). Эти входные данные полезны, если на компьютере агента установлено несколько версий Xcode.

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

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

archivePath - Путь к архиву
string. Необязательный элемент. Используйте при packageApp == true.

Указывает каталог, в котором размещаются созданные архивы.

exportPath - Путь экспорта
string. Необязательный элемент. Используйте при packageApp == true. Значение по умолчанию: output/$(SDK)/$(Configuration).

Указывает назначение для продукта, экспортированного из архива.

exportOptions - Параметры экспорта
string. Необязательный элемент. Используйте при packageApp == true. Допустимые значения: auto (автоматически), plist, specify. Значение по умолчанию: auto.

Задает параметры экспорта архива. Если выбрано значение Automatic по умолчанию , метод экспорта автоматически обнаруживается из архива. Выберите Plist , чтобы указать PLIST-файл, содержащий параметры экспорта. Выберите Specify , чтобы указать конкретный метод экспорта и идентификатор команды.

exportMethod - Метод export
string. Требуется при .exportOptions == specify Значение по умолчанию: development.

Указывает метод, используемый Xcode для экспорта архива. Например, app-store, package, ad-hoc, enterprise или development.

exportTeamId - Идентификатор команды
string. Необязательный элемент. Используйте при exportOptions == specify.

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

exportOptionsPlist - Список параметров экспорта
string. Требуется при .exportOptions == plist

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

exportArgs - Аргументы экспорта
string. Необязательный элемент. Используйте при packageApp == true.

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

signingOption - Стиль подписывания
string. Допустимые значения: nosign (не подписывать код), default (значения по умолчанию в Project), manual (подписывание вручную), auto (автоматическое подписывание). Значение по умолчанию: nosign.

Указывает метод подписи сборки. Выберите Do not code sign , чтобы отключить подписывание. Выберите Project defaults , чтобы использовать только конфигурацию подписывания проекта. Выберите Manual signing принудительное подписывание вручную и при необходимости укажите удостоверение подписывания и профиль подготовки. Выберите Automatic signing для принудительного автоматического подписывания и при необходимости укажите идентификатор команды разработчиков. Если проект требует подписывания, используйте задачи Установка Apple... для установки сертификатов и профилей подготовки до сборки Xcode.

signingIdentity - Удостоверение подписывания
string. Необязательный элемент. Используйте при signingOption = manual.

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

provisioningProfileUuid - UUID профиля подготовки
string. Необязательный элемент. Используйте при signingOption = manual.

Указывает UUID установленного профиля подготовки, используемого для сборки. Используйте отдельные задачи сборки с разными схемами или целевыми объектами, чтобы указать профили подготовки по целевому объекту в одной рабочей области (iOS, tvOS, watchOS).

provisioningProfileName - Имя профиля подготовки
string. Необязательный элемент. Используйте при signingOption = manual.

Указывает имя установленного профиля подготовки, используемого для сборки. Если этот параметр указан, он имеет приоритет над UUID профиля подготовки. Используйте отдельные задачи сборки с разными схемами или целевыми объектами, чтобы указать профили подготовки по целевому объекту в одной рабочей области (iOS, tvOS, watchOS).

teamId - Идентификатор команды
string. Необязательный элемент. Используйте при signingOption = auto.

Требуется, если вы являетесь членом нескольких команд разработчиков. Указывает идентификатор команды разработки из 10 символов.

destinationPlatformOption - Целевая платформа
string. Допустимые значения: default, iOS (iOS и watchOS), tvOS, macOS, custom. Значение по умолчанию: default.

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

destinationPlatform - Пользовательская целевая платформа
string. Необязательный элемент. Используйте при destinationPlatformOption == custom.

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

destinationTypeOption - Тип назначения
string. Необязательный элемент. Используйте при destinationPlatformOption != default && destinationPlatformOption != macOS. Допустимые значения: simulators (симулятор), devices (подключенное устройство). Значение по умолчанию: simulators.

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

destinationSimulators - Симулятор
string. Необязательный элемент. Используйте при destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Указывает имя симулятора Xcode, используемое для тестирования пользовательского интерфейса. Например, iPhone X (iOS и watchOS) или Apple TV 4K (tvOS). Необязательную целевую версию ОС можно указать в формате OS=<versionNumber>, например iPhone X,OS=11.1. Дополнительные сведения см. в этом списке симуляторов, установленных в размещенном агенте macOS.

destinationDevices - Устройства
string. Необязательный элемент. Используйте при destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Указывает имя устройства, используемого для тестирования пользовательского интерфейса, например Raisa's iPad. В настоящее время поддерживается только одно устройство. Обратите внимание, что Apple не разрешает апострофы (') в именах устройств. Вместо этого можно использовать одинарные кавычки (').

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

Необязательный элемент. Указывает дополнительные аргументы командной строки, с помощью которых выполняется сборка. Эти входные данные полезны для указания -target аргументов или -project вместо рабочей области, проекта и схемы. См . статью Apple: building from the command line with Xcode Faq(Вопросы и ответы по Xcode).

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

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

useXcpretty - Использование xcpretty
boolean. Значение по умолчанию: true.

Указывает, следует ли использовать xcpretty для форматирования xcodebuild выходных данных. xcpretty необходимо установить на компьютере агента (он предварительно установлен на агентах сборки, размещенных в Azure Pipelines). Если xcpretty не установлен, отображаются необработанные xcodebuild выходные данные. Дополнительные сведения см. в разделе xcpretty .

xcprettyArgs - Аргументы Xcpretty
string. Необязательный элемент. Используйте при useXcpretty == true.

Если xcpretty параметр включен, эти входные данные указывают аргументы для xcpretty. Список аргументов xcpretty см. на сайте GitHub.

publishJUnitResults - Публикация результатов теста в Azure Pipelines
boolean. Значение по умолчанию: false.

Указывает, следует ли публиковать результаты теста JUnit в Azure Pipelines. Для этого необходимо xcpretty включить создание результатов теста JUnit.

testRunTitle - Заголовок тестового запуска
string. Необязательный элемент. Используйте при publishJUnitResults == true.

Если xcpretty и publishJUnitResults включены, можно указать заголовок тестового запуска.

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

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

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

Нет.

Remarks

Используйте эту задачу для создания, тестирования или архивации рабочей области Xcode в macOS и при необходимости упаковки приложения.

Использование нескольких профилей подготовки

В настоящее время не поддерживается несколько профилей подготовки для задачи Xcode (например, для расширения приложения iOS).

Примеры

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

Требования

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