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

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

# Xcode v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
  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' | '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. 
    #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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #outputPattern: # string. Output directory. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish test results to VSTS/TFS. Default: false.

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

Указывает список действий с разделителями пробелами. Допустимые параметры: build, clean, test, analyzeи archive. Например,clean build выполняет чистую сборку. См. статью Apple: Сборка из командной строки с часто задаваемыми вопросами по Xcode.

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

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

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

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

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

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

scheme - Схема
string.

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

xcodeVersion - Версия Xcode
string. Допустимые значения: 8 (Xcode 8), 9 (Xcode 9), 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).

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

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

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

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

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

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

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

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

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

Указывает имя симулятора 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.

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

Необязательный элемент. Указывает дополнительные аргументы командной строки, с помощью которых выполняется сборка. Эти входные данные полезны для указания -target аргументов или -project вместо рабочей области или проекта и схемы. См. статью Apple: Сборка из командной строки с часто задаваемыми вопросами по Xcode.

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

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

outputPattern - Выходной каталог
string.

Необязательный элемент. Указывает относительный путь к рабочему каталогу, в котором размещаются выходные данные сборки (двоичные файлы). Пример: output/$(SDK)/$(Configuration) или output/$(TestSDK)/$(TestConfiguration). Пути архивации и экспорта настраиваются отдельно. Укажите значения на вкладке Переменные.

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

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

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

Если xcpretty параметр включен, этот вход указывает, следует ли публиковать результаты теста JUnit в VSTS/TFS.

Нет.