編集

従来のXcodeプロジェクトやSwift PackageではXcodeのUIを通じて変更を行いますが、Tuistで管理されるプロジェクトはマニフェストファイルに含まれるSwiftコードで定義されます。Swift PackageとPackage.swiftファイルに慣れている方なら、このアプローチは非常に似ていることがわかるでしょう。

これらのファイルは任意のテキストエディタで編集できますが、Tuistが提供するtuist editワークフローの使用を推奨します。このワークフローはすべてのマニフェストファイルを含むXcodeプロジェクトを作成し、編集とコンパイルを可能にします。Xcodeを使用することで、コード補完、シンタックスハイライト、エラーチェックの恩恵をすべて受けられます。

プロジェクトの編集#

プロジェクトを編集するには、Tuistプロジェクトのディレクトリまたはサブディレクトリで次のコマンドを実行します。

bash

tuist edit

このコマンドはグローバルディレクトリにXcodeプロジェクトを作成し、Xcodeで開きます。プロジェクトにはManifestsディレクトリが含まれており、これをビルドしてすべてのマニフェストが有効であることを確認できます。

Globで解決されるマニフェスト

tuist editは、プロジェクトのルートディレクトリ（Tuist.swiftファイルを含むディレクトリ）から**/{Manifest}.swiftというglobパターンを使用して、含めるべきマニフェストを解決します。プロジェクトのルートに有効なTuist.swiftがあることを確認してください。

マニフェストファイルの無視#

プロジェクトのサブディレクトリに、実際のTuistマニフェストではない同じ名前（例：Project.swift）のSwiftファイルが含まれている場合、プロジェクトのルートに.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を実行することを推奨します。