Thinking > guide
iOS CI Guide

Setting up iOS Continuous Integration with CircleCI

By the end of this short guide, CircleCI should be able to test and build your iOS project.

CircleCI setup

  1. Login to CircleCI
  2. Add a new project (must be logged in to CircleCi)
  3. Select GitHub account and find the iOS repo
  4. Press Build project to get started
  5. As of August 2015, you may see the following warning:

Warning: CircleCI has located an Xcode project or workspace in this repository. CircleCI is currently offering beta access to our iOS build system. Please contact support if you would like access. Once you have beta access, you can enable iOS builds in the 'Experimental Settings' section of the 'Project Settings' page.

  • If the GitHub account is already opted-in to CircleCI's iOS beta access program, then simply turn on iOS building for your repo

    • Project Settings > Experimental Settings > Build iOS project: On

Project setup

  1. Ensure that the main target's scheme is shared for CircleCI to build.

    • Xcode > Click scheme button > Manage Schemes...
    • xcode scheme share
  2. CircleCI can make some inferences at this point and test and build simple projects. Most projects will require a customized circle.yml file located at the project root.
  3. Use our circle.yml file as a template to get started.

    • This particular circle.yml will run static analysis via a helper script Place it here in your project — ./scripts/CircleCI/
    • Replace <YOUR_APP> placeholders with your app's name in these template files.


After completing the previous steps, CircleCI should now be able to build and test your project every time a branch is pushed up to GitHub. Try it out!

Other resources

Recent Posts

Let's talk.

Give Us a Call
(800) 352-2292
Business Inquiries