Предпросмотры Gradle
Собирайте и делитесь Android-приложениями и нативными консольными инструментами прямо из Gradle. Начните с руководства по проекту Gradle, чтобы подключить проект и пройти аутентификацию.
Android-приложения#
./gradlew :app:tuistShareDebug
Плагин настроек dev.tuist регистрирует задачу tuistShare<Variant> для каждого варианта приложения из Android Gradle Plugin (версии 8.8.2 или новее). Замените app и Debug на ваш модуль приложения и вариант, например :app:tuistShareDemoDebug для продуктового флейвора. Задача собирает APK через объявленные в Gradle зависимости артефактов перед его публикацией. Она также работает, когда выходные данные сборки актуальны или восстановлены из кэша сборки.
Поддерживается только один подписанный универсальный APK приложения. Отладочный вариант Android обычно использует отладочный ключ подписи; релизные варианты требуют вашей собственной конфигурации подписи. Задача проверяет подпись APK перед аутентификацией или загрузкой. Неподписанные, недействительные, инструментальные и разделённые APK отклоняются. Библиотечные модули, тестовые APK и пакеты Android App Bundles (.aab) не являются целями публикации.
Нативные консольные инструменты#
Проекты, использующие плагин Gradle cpp-application или swift-application, получают задачу публикации для каждого нативного бинарного файла:
./gradlew :app:tuistShareMainDebug
Задача собирает и упаковывает установленную дистрибуцию, включая её лаунчер и библиотеки времени выполнения. Используйте tuistShareMainRelease для релизного бинарного файла. Проекты, ориентированные на несколько машин, имеют задачу для каждого бинарного файла; выполните ./gradlew :app:tasks --all, чтобы найти их имена.
Поддерживаются нативные исполняемые файлы macOS и Linux для arm64 или x86_64. Выполняйте сборку на целевой платформе с набором инструментов, требуемым вашим плагином Gradle. JVM-приложения и их сгенерированные скрипты запуска не поддерживаются этой интеграцией.
Поведение при публикации#
Задачи публикации используют существующие учётные данные Tuist плагина, не вызывая CLI Tuist. Обычные задачи assemble, build и тестирования никогда не публикуют предпросмотры.
После публикации откройте Предпросмотры в вашем проекте, чтобы скопировать ссылку. Повторная публикация той же сборки и трека повторно использует её публикацию, в том числе после попадания в кэш сборки. Неудачные или неподтверждённые загрузки приводят к сбою задачи публикации; они не отображаются как успешные предпросмотры.
CI и треки#
Настройте аутентификацию CI с теми же учётными данными, которые вы используете для других аутентифицированных функций плагина, затем явно запросите публикацию:
./gradlew :app:tuistShareDebug --track nightly
Добавьте --track nightly к задаче публикации нативного приложения аналогичным образом. Задачи используют настроенный проект Tuist, URL сервера и настройки прокси. Публикация предпросмотров всегда требует аутентификации. Метаданные ревизии Git, примечания к выпуску и автоматические комментарии к pull-запросам не прикрепляются этими задачами.
Публикации артефактов истекают через 30 дней на хостинге Tuist. Самостоятельно размещаемые экземпляры используют TUIST_APP_PREVIEW_RETENTION_DAYS; если оставить параметр неустановленным, истечение срока для этого семейства отключается. Истекшие публикации нельзя восстановить, повторив ту же операцию.
Опубликовать существующий APK#
Для APK, собранного вне этого рабочего процесса, или чтобы включить примечания к выпуску в устаревший поток загрузки, CLI остаётся доступным:
tuist share app/build/outputs/apk/debug/app-debug.apk \
--track nightly --release-notes "Improve checkout"
См. Запуск предпросмотра для информации о запуске опубликованных сборок, доступе, треках и бейджах README.
Треки с tuist share#
Для рабочих процессов, которые публикуются с помощью tuist share, используйте --track для выбора трека:
tuist share App --track beta
tuist share App --track nightly
Примечания к выпуску#
Используйте треки для групп окружений и примечания к выпуску для отдельной сборки:
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-запросам#
Чтобы получать автоматические комментарии к pull/merge-запросам, интегрируйте ваш удалённый проект с Git-форжем: GitHub, Cursor Origin или Entire.
После подключения вашего проекта Tuist к вашей Git-платформе добавьте tuist share после успешной сборки приложения в CI. Tuist опубликует ссылку на превью прямо в ваших pull/merge-запросах, чтобы рецензенты могли тестировать без локальной сборки:

Автоматизации#
Используйте --json, чтобы получить вывод в формате JSON из tuist share:
tuist share --json
Используйте результат для пользовательских автоматизаций, например для отправки сообщения в Slack из CI. Ключ url содержит полную ссылку на превью; qrCodeURL указывает на изображение QR-кода для открытия превью на устройстве:
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}