Интеграция с Origin
Tuist может публиковать отчёты о сборках, тестах, превью и бандлах в пул-реквестах в нативных репозиториях Cursor Origin. Он обновляет существующий отчёт Tuist Run Report вместо того, чтобы создавать новый комментарий для каждой загрузки.
Установка приложения не запускает сборки или тесты. Ваши текущие рабочие процессы продолжают загружать результаты в Tuist, а интеграция добавляет эти результаты в ваши пул-реквесты.
Настройка#
Администратор аккаунта Tuist должен открыть Settings → Integrations, выбрать Install Origin App в карточке Origin и подтвердить доступ в Cursor. Выберите аккаунт или пространство имён Origin и репозитории, к которым Tuist должен получить доступ, затем вернитесь в Tuist. Подключение относится к аккаунту Tuist, а не к отдельному проекту.
Вы также можете установить приложение напрямую из Origin. После подтверждения доступа войдите в Tuist, если это необходимо, и выберите организацию для подключения. Доступны только организации, которыми вы управляете, и ваш личный аккаунт. Если доступен только один аккаунт, Tuist подключает его автоматически, не показывая выбор. Если вы начинаете процесс из Tuist, организация уже выбрана, и этот шаг пропускается.
Выберите Add new project connection, чтобы открыть модальное окно выбора репозитория. Выберите неподключённый проект Tuist и один из репозиториев, обнаруженных в подключённом аккаунте Origin, затем выберите Create Connection. Если подключено несколько аккаунтов Origin, сначала выберите аккаунт. Для подключения доступны только нативные репозитории Origin. Перед подключением проекта Tuist повторно проверяет доступ к пул-реквестам и использует ветку по умолчанию репозитория.
Используйте Manage integration, чтобы открыть поток согласия Cursor в новой вкладке и настроить доступ к репозиториям или подключить другой аккаунт Origin. При ошибках загрузки репозиториев отображается кнопка Retry, отдельно от успешного пустого списка репозиториев.
Используйте токен аккаунта для аутентификации загрузок результатов.
Отчёты и разрешения#
При одобрении приложения вы предоставляете разрешения, необходимые для подключения репозиториев и публикации отчётов:
| Разрешение | Используется для |
|---|---|
| Пул-реквесты: чтение | Поиск открытого пул-реквеста для указанного коммита. |
| Обзоры пул-реквестов: чтение и запись | Чтение, публикация и обновление комментария Tuist Run Report. |
| Метаданные репозитория: чтение | Обнаружение репозиториев и их веток по умолчанию. Включается автоматически Origin. |
Tuist не нуждается в доступе к вашему исходному коду или разрешении на слияние пул-реквестов.
Чтобы связать результаты с пул-реквестом, загрузки должны включать URL клонирования Origin репозитория, Git-ссылку и полный SHA коммита. Tuist публикует отчёт только тогда, когда эти данные однозначно определяют один открытый пул-реквест на его текущем головном коммите. Результаты для заменённых коммитов не перезаписывают текущий отчёт.
В карточке Origin перечислены подключения проектов к репозиториям. Выберите Manage → Remove connection для подключения проекта, чтобы остановить его отчётность без удаления приложения. Удалите приложение в Cursor, чтобы отозвать его доступ; Tuist удалит установку и её подключения проектов при обработке уведомления об установке.
Самостоятельно размещаемые серверы#
Если вы размещаете собственный сервер Tuist, сначала зарегистрируйте и настройте приложение Origin для вашего развёртывания. Следуйте инструкциям по самостоятельному размещению Origin, затем вернитесь к шагам настройки выше, чтобы подключить аккаунты и проекты.