# 編集 {#editing}

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

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

## プロジェクトの編集 {#edit-the-project}

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

```bash
tuist edit
```

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

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


### マニフェストファイルの無視 {#ignoring-manifest-files}

プロジェクトのサブディレクトリに、実際の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マニフェストファイルと同じ命名規則を使用している場合に特に便利です。

## 編集と生成のワークフロー {#edit-and-generate-workflow}

お気づきかもしれませんが、編集は生成されたXcodeプロジェクトからは行えません。これは、生成されたプロジェクトがTuistに依存しないようにするための設計であり、将来的にTuistからの移行を容易にするためです。

プロジェクトを反復開発する際は、ターミナルセッションで`tuist edit`を実行して編集用のXcodeプロジェクトを取得し、別のターミナルセッションで`tuist generate`を実行することを推奨します。