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

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

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

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

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

tuist edit

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

ГЛОБ-РЕЗОЛЮЦИОННЫЕ МАНИФЕСТЫ

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

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

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

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

# 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.