Xcode@4 – задача Xcode v4

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

Синтаксис

Входы

actions – строка действий. Требуется. Значение по умолчанию: build .

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

configuration – Строка конфигурации. Значение по умолчанию: $(Configuration) .

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

sdk – строка SDK . Значение по умолчанию: $(SDK) .

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

xcWorkspacePath – Строка пути к рабочему пространству или проекту. Значение по умолчанию: **/*.xcodeproj/project.xcworkspace .

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

scheme – Строка схемы.

Необязательно. Указывает имя схемы Xcode. Это должна быть общая схема (флажок “Общая” в разделе “Управляемые схемы” в Xcode). Если вы не укажете схему, а указанное рабочее пространство имеет одну общую схему, будет использоваться схема рабочего пространства.

xcodeVersion – строка версии Xcode. Допустимые значения: 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 . Необязательно. Используется, когда xcodeVersion == specifyPath .

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

packageApp – Создать пакет приложений boolean . Требуется. Значение по умолчанию: false .

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

archivePath – Строка пути к архиву . Необязательно. Используется, когда packageApp == true .

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

exportPath – Строка пути экспорта . Необязательно. U

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

exportMethod – строка метода экспорта. Требуется, если exportOptions == specify . Значение по умолчанию: разработка .

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

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

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

exportOptionsPlist – строка plist опций экспорта . Требуется, если exportOptions == plist .

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

exportArgs – Строка аргументов экспорта . Необязательно. Используется, если packageApp == true .

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

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

Указывает метод подписания сборки. Выберите Не подписывать код, чтобы отключить подписание. Выберите Project defaults, чтобы использовать только конфигурацию подписания проекта. Выберите Ручное подписание для принудительного ручного подписания и дополнительно укажите идентификатор подписи и профиль инициализации. Выберите Автоматическое подписание, чтобы включить автоматическое подписание и дополнительно указать идентификатор команды разработчиков. Если ваш проект требует подписания, используйте задачи Install Apple. для установки сертификатов и профилей инициализации перед сборкой Xcode.

signingIdentity – строка идентификатора подписи. Необязательно. Используется, когда signedOption = manual .

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

provisioningProfileUuid – строка UUID профиля обеспечения . Необязательно. Используется, когда signedOption = manual .

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

teamId – строка идентификатора команды. Необязательно. Используется, когда signedOption = auto .

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

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

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

destinationPlatform – пользовательская строка платформы назначения. Необязательно. Используется, когда destinationPlatf

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

destinationSimulators – строка симулятора. Необязательно. Используется, если destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators . Значение по умолчанию: iPhone 7 .

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

destinationDevices – строка устройств. Необязательно. Используется, когда destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices .

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

args – строка аргументов .

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

workingDirectory – Рабочая директория Входной псевдоним: cwd . string .

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

outputPattern – Выходной каталог Строка .

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

useXcpretty – булево значение Use xcpretty . Значение по умолчанию: false .

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

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

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

Опции управления задачами

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