sgleadow / xcode-pristine

Ruby gem to check Xcode project file for unwanted build settings

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

xcode-pristiene (Work In Progress) Build Status

A gem to help keep your Xcode project file pristine.

When you're using xcconfig files to manage your Xcode build settings, you don't want those build settings being overridded inside the Xcode project files build settings editor. This gem used the xcodeproj gem from cocoapods, to inspect the build settings in the project file and ensure they're empty.


Add this line to your application's Gemfile:

gem 'xcode-pristine'

And then execute:

$ bundle

Or install it yourself as:

$ gem install xcode-pristine


To ensure your project file is free of unwanted build settings, simply run:

$ xcpristine

By default, it finds any .xcodeproj files in the current directory and inspects all build configurations and all targets.

There may be situations where you want to only inspect some project files or not all of the configurations or targets for a project. If that's the case, raise an issue and let's discuss how to add it, I haven't found a need for that yet, as either your project is using xcconfig files or it isn't.


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.


Ruby gem to check Xcode project file for unwanted build settings

License:MIT License


Language:Ruby 58.2%Language:Swift 41.8%