yonaskolb/XcodeGen

これは何？

主な機能

• 01YAMLまたはJSONの仕様からXcodeプロジェクトを生成し、フォルダ構成に合わせてグループを同期します。
• 02マージコンフリクトを避けるため、.xcodeprojをgitの管理対象から外せます。
• 03ビルド設定グループを使って、複数のターゲット間でビルド設定を共有できます。
• 04環境ごとのスキームを自動作成します。
• 05仕様を複数のファイルに分割し、共有や上書きに対応できます。
• 06Swiftパッケージ、Carthageフレームワーク、SDKの依存関係をサポートします。

ユースケース

• iOSまたはmacOSのチームで、マージコンフリクトを避けるために.xcodeprojファイルをバージョン管理の対象外にする。
• 単一の仕様から、CIマシン上でXcodeプロジェクトを生成する。
• 多数のターゲットと共有ビルド設定を持つ大規模プロジェクトを管理する。
• テンプレート仕様を使って、統一された設定で新しいプロジェクトを作成する。

クイックスタート

1. 1

   最新の安定版 Xcode がインストールされていることを確認してください

2. 2

   Homebrew で XcodeGen をインストールします

   brew install xcodegen
3. 3

   現在のディレクトリにあるプロジェクト仕様から Xcode プロジェクトを生成します

   xcodegen generate

使う前に知っておきたいこと

• !Xcode が必要なため、macOS での Apple プラットフォーム開発にのみ対応しています。

収録されている特集

トピック

よくある質問

XcodeGen とは？

YAMLまたはJSONのプロジェクト仕様とフォルダ構成からXcodeプロジェクトを生成するSwift製CLIツール。 XcodeGenは、ターゲット、構成、スキーム、ビルド設定、依存関係を定義した、人が読みやすい仕様ファイルからXcodeプロジェクトを生成します。ソースディレクトリは自動的に解析され、Xcode内のグループに反映されるため、ディスク上でファイルを追加または移動すると、Xcodeで手動編集しなくてもプロジェクトに反映されます。

XcodeGen は無料で使えますか？ライセンスは？

XcodeGen は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

XcodeGen は今もメンテナンスされていますか？

活発にメンテナンス中。XcodeGen の最終コミットは 2026年10月13日 です。

XcodeGen は何に使えますか？

iOSまたはmacOSのチームで、マージコンフリクトを避けるために.xcodeprojファイルをバージョン管理の対象外にする。 単一の仕様から、CIマシン上でXcodeプロジェクトを生成する。 多数のターゲットと共有ビルド設定を持つ大規模プロジェクトを管理する。 テンプレート仕様を使って、統一された設定で新しいプロジェクトを作成する。

XcodeGen のインストール方法は？

最新の安定版 Xcode がインストールされていることを確認してください Homebrew で XcodeGen をインストールします: brew install xcodegen 現在のディレクトリにあるプロジェクト仕様から Xcode プロジェクトを生成します: xcodegen generate

XcodeGen はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/yonaskolb/XcodeGen