Skip to content
(Back under new management!) 🍰 Describe Xcode projects in a human readable format and (re)generate one on demand.
Branch: master
Clone or download
igor-makarov Disable Xcodeproj diffing in integration tests as it doesn't work (#199)
This PR fixes nightly builds failing on Xcodeproj egde version, as it changes some base constants to new version.

As I can't actually account for that, I had to disable Xcodeproj diffing.
Latest commit 4a16d5c Apr 21, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Modernize the repo and fix CI + PR flow (#189) Dec 22, 2018
docs Fix markdown syntax errors (#184) Jan 25, 2018
example Adds missing dependencies to default project generator. (#147) Mar 12, 2017
fastlane-plugin-xcake Modernize the repo and fix CI + PR flow (#189) Dec 22, 2018
gemfiles Modernize the repo and fix CI + PR flow (#189) Dec 22, 2018
lib bump version Jan 13, 2019
spec Disable Xcodeproj diffing in integration tests as it doesn't work (#199) Apr 21, 2019
.gitattributes Set Cakefile to be correct language. Nov 10, 2015
.gitignore Fix duplication of Info.plist copying that was causing Xcode errors (#… Dec 30, 2018
.hound.yml Modernize the repo and fix CI + PR flow (#189) Dec 22, 2018
.rspec Adds cakefile class and spec. Oct 10, 2015
.rubocop.yml add Rakefile to linter Dec 23, 2018
.travis.yml fix bundler-gate build error Jan 13, 2019
.yardopts Updates yardoptions. Jan 11, 2016
CHANGELOG.md Change. Feb 10, 2018
CODE_OF_CONDUCT.md Adds cakefile class and spec. Oct 10, 2015
Gemfile Modernize the repo and fix CI + PR flow (#189) Dec 22, 2018
LICENSE.txt
README.md update author in Readme Dec 30, 2018
Rakefile Fix duplication of Info.plist copying that was causing Xcode errors (#… Dec 30, 2018
xcake.gemspec Disable Xcodeproj diffing in integration tests as it doesn't work (#199) Apr 21, 2019

README.md

Xcake

Gem Twitter: @igormaka License Build Status Test Coverage Gem

Back under new management!

The original author of Xcake, James Campbell has decided to move on to other endeavors.
Igor Makarov has volunteered to step in as the main maintainer, both because of his reliance on the gem for work, and because of general aversion to .pbxproj files.

Cakefile — A Podfile for your main project!

Describe your project in a simple text file: your Cakefile. Xcake generates your project based on this file including importing all of your files and creating groups and targets to match the file hierarchy.

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

Isn't this just like Generamba or Crafter?
No, these tools are for scafolding an initial project structure to get you started (creating folder structure, git repo etc.).
Xcake will not create a folder structure, but will generate a project from it, and will continue to generate it each time you want it. Added some files? Generate! Renamed a folder? Generate!
Sick of seeing .pbxproj diffs in git? Add your project to .gitignore and generate it on checkout.

Get in contact with the developer on Twitter: @igormaka.

PBX delendare est.


FeaturesInstallationNeed help?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, It’s time to add *.xcodeproj into .gitignore!.

You define a project like this:

application_for :ios, 8.0 do |target|
  target.name = "MyApp"
end

To generate the xcode project, just run:

xcake make

If you would like an example Cakefile for guidence, just run:

xcake init
xcake
Flexibly configure and create xcode project from one easy to read Cakefile
🚢 Generate from any computer, including a CI-server
💭 Never remember any difficult commands, just xcake make
📃 Store everything but the project in git. Never again manually fix any corruptions or merge issues with the project.
🚀 Saves you hours when working with xcode projects
⚓️ Confidence that the project file is exactly the same during Continuous Delivery
💻 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

Xcake can create an example cakefile when you run:

xcake init

Usually you'll use xcake by running the command

xcake make

Xcake will then generate a Xcode project based on your Cakefile

Sample Cakefile

To get better understanding of how to start using Xcake in a real project, see examples under example folder.

There is a sample app project (the project file has been generated using Xcake v.0.7.1 based on the Cakefile) as well as sample Cakefile for an iOS framework project.

Need help?

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

People who use Xcake

  • Bending Spoons
  • Moovit

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.

You can’t perform that action at this time.