xcodeproj-creator

Generate Xcode .xcodeproj bundles from scratch — no macOS required.

Build valid Xcode projects on Linux (or any platform) for iOS/macOS apps, then hand them off to Xcode or CI services like Codemagic for building. Zero dependencies — stdlib only.

Installation

pip install xcodeproj-creator

CLI

# Minimal — creates MyApp.xcodeproj in current directory
xcodeproj-create MyApp --bundle-id com.example.myapp

# Full options
xcodeproj-create MyApp \
    --bundle-id com.example.myapp \
    --output MyApp.xcodeproj \
    --deployment-target 18.0 \
    --swift-version 5.0 \
    --team-id ABCDEF1234 \
    --sources MyApp/ \
    --resources MyApp/Resources/ \
    --asset-catalogs MyApp/Assets.xcassets

# Modern Xcode 16+ project (objectVersion 77, auto-syncs files from disk)
xcodeproj-create MyApp \
    --bundle-id com.example.myapp \
    --object-version 77

CLI Options

Python API

from xproject_creator import ProjectBuilder

# Classic project (objectVersion 56) — list files explicitly
project = ProjectBuilder("MyApp", bundle_id="com.example.myapp")
project.set_deployment_target("18.0")
project.set_swift_version("5.0")
project.set_development_team("ABCDEF1234")
project.add_swift_sources("MyApp/", glob="**/*.swift")
project.add_resources("MyApp/Resources/")
project.add_asset_catalog("MyApp/Assets.xcassets")
project.add_shell_script_phase("Lint", "swiftlint")
project.set_build_setting("ENABLE_BITCODE", "NO")
project.save("MyApp.xcodeproj")

# Modern project (objectVersion 77) — files auto-sync from disk
project = ProjectBuilder("MyApp", bundle_id="com.example.myapp", object_version="77")
project.set_development_team("ABCDEF1234")
project.save("MyApp.xcodeproj")

Builder Methods

All methods return self for chaining (except save).

What Gets Generated

MyApp.xcodeproj/
  project.pbxproj                          # Full ASCII plist
  xcshareddata/
    xcschemes/
      MyApp.xcscheme                       # Build + Run scheme

The generated project includes:

• Debug and Release build configurations with sensible defaults
• Sources, Resources, and Frameworks build phases
• Auto-generated Info.plist (via GENERATE_INFOPLIST_FILE = YES)
• Proper group hierarchy mirroring the filesystem (v56) or file-system-synchronized groups (v77)

objectVersion 56 vs 77

Supported Product Types

Development

make install        # Create venv and install with dev deps
make check          # Format + lint + typecheck + test
make test           # pytest with coverage
make lint           # ruff check
make typecheck      # mypy strict
make format         # ruff format + autofix

License

MIT