Xcake

Gem Twitter: @jcampbell_05 License Build Status Test Coverage

Xcode projects made a piece of cake.

You describe your project in a simple text file: your Cakefile. Xcake creates your project based on this including importing all of your files and creating groups to match the file hiearchy.

This is perfect for working in teams or with cocoapods as it reduces conflicts, makes it easy to modify settings and allows you to create a clean project anytime you need to.

Isn't this just like liftoff or crafter? No these tools are for scafolding a whole project structure to get you started (Creating folder structure, git repo etc.). However xcake is not for this, xcake is just for generating a xcodeproject.

Get in contact with the developer on Twitter: @jcampbell_05

Features • Installation • Need help? • Roadmap • Documentation

Features

Xcode projects were once described as "the closest thing to taboo we have to deal with on a regular basis", but it doesnt have to be this way.

Store a simple description of your project in a text file, your Cakefile, to easily create a xcode project from any computer. Easily see, merge and maintain the structure of your project, say hello to lazy week days.

You define a project like this:

Project.new do |c|
    c.application_for :ios, 8.0 do |t|
        t.name = "MyApp"
    end
end

To generate the xcode project, just run:

xcake
xcake
:sparkles: Flexibly configure and create xcode project from one easy to read Cakefile
:ship: Generate from any computer, including a CI-server
:thought_balloon: Never remember any difficult commands, just xcake
:page_with_curl: Store everything but the project in git. Never again manually fix any corruptions or merge issues with the project.
:rocket: Saves you hours when working with xcode projects
:anchor: Confidence that the project file is exactly the same during Continuous Delivery
:computer: Support for OSX, iOS and watchOS apps

Installation

Install the gem by running:

sudo gem install xcake --verbose

Make sure, you have the latest version of the Xcode command line tools installed:

xcode-select --install

If you experience slow launch times of xcake, try running

gem cleanup

to clean up outdated gems.

System Requirements: xcake requires Mac OS X or Linux with Ruby 2.0.0 or above.

Available commands

Usually you'll use xcake by running the command

xcake

Need help?

Please submit an issue on GitHub and provide information about your setup

Roadmap

:white_check_mark: Create WatchOS applications.

:white_medium_square: Create tvOS applications.

:white_medium_square: Generate library targets.

:white_medium_square: Generate extensions.

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

This project is no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. Xcake runs on your own computer or server, so your sensitive information will never leave your own computer. You are responsible for how you use xcake.