Перейти к содержимому

Предпросмотры Xcode

Соберите приложение, а затем используйте tuist share, чтобы опубликовать его в вашем проекте Tuist. Сначала подключите проект, следуя руководству по существующему проекту Xcode или сгенерированному проекту.

Сборка и публикация#

Для проекта, сгенерированного Tuist:

bash
tuist generate App
tuist xcodebuild build -scheme App -workspace App.xcworkspace \
-configuration Debug -sdk iphonesimulator
tuist share App

Для существующего проекта Xcode:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -sdk iphonesimulator
tuist share App --configuration Debug --platforms iOS

Замените названия схемы, проекта и рабочего пространства на свои. Чтобы поделиться сборкой Release, используйте -configuration Release при сборке и --configuration Release при публикации.

Физические устройства#

Вы несете ответственность за подписание сборок для устройств профилем обеспечения, который разрешает установку на устройство получателя. Выполняйте сборку с назначением на устройство вместо SDK симулятора:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -destination 'generic/platform=iOS'
tuist share App --configuration Debug --platforms iOS

Вы также можете поделиться уже экспортированным IPA:

bash
tuist share App.ipa

Получатели могут открыть ссылку на предпросмотр IPA на своем мобильном устройстве, чтобы установить приложение. Аутентификация и настройки видимости предпросмотра проекта по-прежнему применяются.

CI и номера сборок#

Используйте вашу существующую аутентификацию CI и сделайте CFBundleVersion уникальным для каждой новой сборки. Например, используйте ${{ github.run_number }} из GitHub Actions. Повторная загрузка того же бинарного файла и номера сборки через tuist share завершится ошибкой, а не создаст дубликат.

bash
tuist share App --track beta --release-notes "Fix sign-in"

См. раздел Запуск предпросмотра для информации о запуске опубликованных сборок, доступе, треках и бейджах для README.

Треки с tuist share#

Для рабочих процессов, которые публикуются с помощью tuist share, используйте --track для выбора трека:

bash
tuist share App --track beta
tuist share App --track nightly

Примечания к выпуску#

Используйте треки для групп окружений и примечания к выпуску для отдельной сборки:

bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"

Замените App именем вашего приложения, путём к файлу приложения или исполняемому дистрибутиву и его опцией --executable. Примечания к выпуску — это необязательный простой текст длиной до 10 000 символов. Первая непустая строка отображается как однострочный фрагмент в списках превью, поэтому номера сборок и другая идентифицирующая информация видны сразу. Длинные строки обрезаются; полные примечания отображаются на страницах с подробностями. Поиск сопоставляет отображаемые имена и полные примечания к выпуску, включая строки, не показанные во фрагменте. Поддерживаются многострочные примечания, например --release-notes "$(< release-notes.txt)". Они не изменяют отображаемое имя приложения или его трек.

Совместимость#

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

Развёртывания на собственных серверах требуют версии сервера, поддерживающей примечания к выпуску и фильтрацию по трекам, а также обновлённого клиента. Старые серверы игнорируют примечания. Информацию о фильтрах треков и поиска для конечных точек списков см. в справочнике API.

Комментарии к pull/merge-запросам#

Требуется интеграция с Git-форжем

Чтобы получать автоматические комментарии к pull/merge-запросам, интегрируйте ваш удалённый проект с Git-форжем: GitHub, Cursor Origin или Entire.

После подключения вашего проекта Tuist к вашей Git-платформе добавьте tuist share после успешной сборки приложения в CI. Tuist опубликует ссылку на превью прямо в ваших pull/merge-запросах, чтобы рецензенты могли тестировать без локальной сборки:

Комментарий приложения GitHub со ссылкой на Tuist Preview

Автоматизации#

Используйте --json, чтобы получить вывод в формате JSON из tuist share:

bash
tuist share --json

Используйте результат для пользовательских автоматизаций, например для отправки сообщения в Slack из CI. Ключ url содержит полную ссылку на превью; qrCodeURL указывает на изображение QR-кода для открытия превью на устройстве:

json
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}

Получатели могут использовать приложение Tuist для macOS или приложение для iPhone независимо от интеграции со системой сборки. Руководство для iPhone также охватывает уведомления об обновлениях внутри приложения с помощью Tuist SDK.