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

Соберите приложение, а затем используйте `tuist share`, чтобы опубликовать его в вашем проекте Tuist. Сначала подключите проект, следуя руководству по <.localized_link href="/guides/get-started/existing-xcode-project">существующему проекту Xcode</.localized_link> или <.localized_link href="/guides/get-started/generated-xcode-project">сгенерированному проекту</.localized_link>.

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

Для проекта, сгенерированного 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 и номера сборок

Используйте вашу существующую <.localized_link href="/guides/integrations/continuous-integration">аутентификацию CI</.localized_link> и сделайте `CFBundleVersion` уникальным для каждой новой сборки. Например, используйте <code v-pre>${{ github.run_number }}</code> из GitHub Actions. Повторная загрузка того же бинарного файла и номера сборки через `tuist share` завершится ошибкой, а не создаст дубликат.

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

См. раздел <.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"
}
```


Получатели могут использовать <.localized_link href="/guides/features/previews/run/macos">приложение Tuist для macOS</.localized_link> или <.localized_link href="/guides/features/previews/run/ios">приложение для iPhone</.localized_link> независимо от интеграции со системой сборки. Руководство для iPhone также охватывает <.localized_link href="/guides/features/previews/run/ios#in-app-update-notifications">уведомления об обновлениях внутри приложения</.localized_link> с помощью Tuist SDK.
