Редактирование

В отличие от традиционных проектов Xcode или пакетов Swift, где изменения вносятся через интерфейс Xcode, проекты под управлением Tuist описываются кодом на Swift в файлах манифестов. Если вы знакомы с пакетами Swift и файлом Package.swift, подход очень похож.

Вы можете редактировать эти файлы в любом текстовом редакторе, но мы рекомендуем использовать предоставляемый Tuist рабочий процесс — tuist edit. Он создаёт проект Xcode, содержащий все файлы манифестов, и позволяет их редактировать и компилировать. Благодаря использованию Xcode вы получаете все преимущества: автодополнение кода, подсветку синтаксиса и проверку ошибок.

Редактирование проекта#

Чтобы отредактировать проект, выполните следующую команду в каталоге проекта Tuist или в его подкаталоге:

bash

tuist edit

Команда создаёт проект Xcode в глобальном каталоге и открывает его в Xcode. Проект включает каталог Manifests, который можно собрать, чтобы убедиться, что все манифесты корректны.

Манифесты, разрешаемые по шаблону glob

tuist edit определяет включаемые манифесты, используя шаблон glob **/{Manifest}.swift от корневого каталога проекта (того, который содержит файл Tuist.swift). Убедитесь, что в корне проекта есть корректный файл Tuist.swift.

Игнорирование файлов манифестов#

Если ваш проект содержит файлы Swift с такими же именами, как у файлов манифестов (например, Project.swift), в подкаталогах, которые не являются настоящими манифестами Tuist, вы можете создать файл .tuistignore в корне проекта, чтобы исключить их из проекта для редактирования.

Файл .tuistignore использует шаблоны glob, чтобы указать, какие файлы следует игнорировать:

gitignore

# Ignore all Project.swift files in the Sources directory
Sources/**/Project.swift

# Ignore specific subdirectories
Tests/Fixtures/**/Workspace.swift

Это особенно полезно, когда у вас есть тестовые фикстуры или примеры кода, которые случайно используют те же соглашения об именах, что и файлы манифестов Tuist.

Рабочий процесс редактирования и генерации#

Как вы могли заметить, редактирование нельзя выполнять из сгенерированного проекта Xcode. Это сделано намеренно, чтобы сгенерированный проект не зависел от Tuist, что позволит вам в будущем легко перейти от Tuist с минимальными усилиями.

При работе над проектом мы рекомендуем запускать tuist edit в одном сеансе терминала, чтобы получить проект Xcode для редактирования, а в другом сеансе терминала выполнять tuist generate.