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, testanalyzeи 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 -
string. Требуется, если exportOptions == specify. Значение по умолчанию: development.

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

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

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

exportOptionsPlist - параметры экспорта plist
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 Preview.

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.

Нет.