# Предпросмотры Gradle

Собирайте и делитесь Android-приложениями и нативными консольными инструментами прямо из Gradle. Начните с <.localized_link href="/guides/get-started/gradle-project">руководства по проекту Gradle</.localized_link>, чтобы подключить проект и пройти аутентификацию.

## Android-приложения

```bash
./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`, получают задачу публикации для каждого нативного бинарного файла:

```bash
./gradlew :app:tuistShareMainDebug
```

Задача собирает и упаковывает установленную дистрибуцию, включая её лаунчер и библиотеки времени выполнения. Используйте `tuistShareMainRelease` для релизного бинарного файла. Проекты, ориентированные на несколько машин, имеют задачу для каждого бинарного файла; выполните `./gradlew :app:tasks --all`, чтобы найти их имена.

Поддерживаются нативные исполняемые файлы macOS и Linux для arm64 или x86_64. Выполняйте сборку на целевой платформе с набором инструментов, требуемым вашим плагином Gradle. JVM-приложения и их сгенерированные скрипты запуска не поддерживаются этой интеграцией.

## Поведение при публикации

Задачи публикации используют существующие учётные данные Tuist плагина, не вызывая CLI Tuist. Обычные задачи `assemble`, `build` и тестирования никогда не публикуют предпросмотры.

После публикации откройте **Предпросмотры** в вашем проекте, чтобы скопировать ссылку. Повторная публикация той же сборки и трека повторно использует её публикацию, в том числе после попадания в кэш сборки. Неудачные или неподтверждённые загрузки приводят к сбою задачи публикации; они не отображаются как успешные предпросмотры.

## CI и треки

Настройте <.localized_link href="/guides/integrations/continuous-integration">аутентификацию CI</.localized_link> с теми же учётными данными, которые вы используете для других аутентифицированных функций плагина, затем явно запросите публикацию:

```bash
./gradlew :app:tuistShareDebug --track nightly
```

Добавьте `--track nightly` к задаче публикации нативного приложения аналогичным образом. Задачи используют настроенный проект Tuist, URL сервера и настройки прокси. Публикация предпросмотров всегда требует аутентификации. Метаданные ревизии Git, примечания к выпуску и автоматические комментарии к pull-запросам не прикрепляются этими задачами.

Публикации артефактов истекают через 30 дней на хостинге Tuist. Самостоятельно размещаемые экземпляры используют `TUIST_APP_PREVIEW_RETENTION_DAYS`; если оставить параметр неустановленным, истечение срока для этого семейства отключается. Истекшие публикации нельзя восстановить, повторив ту же операцию.

## Опубликовать существующий APK

Для APK, собранного вне этого рабочего процесса, или чтобы включить примечания к выпуску в устаревший поток загрузки, CLI остаётся доступным:

```bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
  --track nightly --release-notes "Improve checkout"
```

См. <.localized_link href="/guides/features/previews#run-a-preview">Запуск предпросмотра</.localized_link> для информации о запуске опубликованных сборок, доступе, треках и бейджах README.

## Треки с tuist share {#share-tracks}

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

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

## Примечания к выпуску {#release-notes}

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

```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)"`. Они не изменяют отображаемое имя приложения или его трек.

### Совместимость {#preview-metadata-compatibility}

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

Развёртывания на собственных серверах требуют версии сервера, поддерживающей примечания к выпуску и фильтрацию по трекам, а также обновлённого клиента. Старые серверы игнорируют примечания. Информацию о фильтрах треков и поиска для конечных точек списков см. в [справочнике API](https://tuist.dev/api/docs).

## Комментарии к pull/merge-запросам {#pullmerge-request-comments}

> [!WARNING]
> **Требуется интеграция с Git-форжем**
>
> Чтобы получать автоматические комментарии к pull/merge-запросам, интегрируйте ваш <.localized_link href="/guides/server/accounts-and-projects">удалённый проект</.localized_link> с Git-форжем: <.localized_link href="/guides/integrations/gitforge/github">GitHub</.localized_link>, <.localized_link href="/guides/integrations/gitforge/origin">Cursor Origin</.localized_link> или <.localized_link href="/guides/integrations/gitforge/entire">Entire</.localized_link>.

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

![Комментарий приложения GitHub со ссылкой на Tuist Preview](/images/guides/features/github-app-with-preview.png)

## Автоматизации {#automations}

Используйте `--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"
}
```

