mikezucc / xchammer

XCHammer generates Xcode projects from a Bazel Workspace.

XCHammer

If all you've got is Xcode, your only tool is a 🔨

XCHammer generates Xcode projects from a Bazel Workspace.

Usage

Note: this README is intended to be a minimal, quick start guide. For a comprehensive explanation of XCHammer, see Introducing XCHammer and The XCHammer FAQ

Installation

You can clone the xchammer repository and run the following to build and install on your path.

make install

Configuration

Generate using a XCHammerConfig.

xchammer generate <configPath>

Configuration Format

XCHammer is configured via a yaml representation of XCHammerConfig.

The configuration describes projects that should be generated.

# Generates a project containing the target ios-app
targets:
    - "//ios-app:ios-app"

projects:
    "MyProject":
        paths:
            - "**"

See XCHammerConfig.swift for detailed documentation of the format.

Sample

The sample directory contains a fully functioning iOS app.

Development

Please find more info about developing XCHammer in The XCHammer FAQ. Pull requests welcome 💖.

Connect with the XCHammer team on the #xchammer channel in the xcode.swift slack.