DEV Community

Khoa Pham
Khoa Pham

Posted on • Updated on

Using CircleCI 2.0 for iOS

Original post

We 've been using CircleCI for many of our open source projects. Since the end of last year 2017, version 2.0 began to come out, and we think it's good time to try it now together with Swift 4.1 and Xcode 9.3

The problem with version 2.0 is it's so powerful and has lots of cool new features like jobs and workflows, but that requires going to documentation for how to migrate configuration file.

Creating config.yml

The first thing is to create a new config.yml inside folder .circleci

Copy your existing circle.yml file into a new directory called .circleci at the root of your project repository.

Next is to declare version and jobs

Add version: 2 to the top of the .circleci/config.yml file.

Checking xcodebuild

For simple cases, we just use xcodebuild to build and test the project, so it's good to try it locally to avoid lots of trial commits to trigger CircleCI. You can take a look at this PR

Before our configuration file for version 1.0 looks like this

- set -o pipefail && xcodebuild -project Cheers.xcodeproj -scheme "Cheers-iOS" -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 8,OS=11.0' -enableCodeCoverage YES test
Enter fullscreen mode Exit fullscreen mode

Now we should put pipefail inside shell, follow

shell: /bin/bash --login -o pipefail

Now is the actual trying xcodebuild, after many failures due to destination param

xcodebuild: error: Unable to find a destination matching the provided destination specifier:
        { platform:iOS Simulator, OS:11.3 }

    Missing required device specifier option.
    The device type “iOS Simulator” requires that either “name” or “id” be specified.
    Please supply either “name” or “id”.
Enter fullscreen mode Exit fullscreen mode
xcodebuild: error: option 'Destination' requires at least one parameter of the form 'key=value'
Enter fullscreen mode Exit fullscreen mode

I found this to work, run this in the same folder as your xcodeproj

xcodebuild -project Cheers.xcodeproj -scheme "Cheers-iOS" -sdk iphonesimulator -destination "platform=iOS Simulator,OS=11.3,name=iPhone X" -enableCodeCoverage YES test
Enter fullscreen mode Exit fullscreen mode

Adding workflow

Version 2.0 introduces workflow which helps organising jobs

A workflow is a set of rules for defining a collection of jobs and their run order. Workflows support complex job orchestration using a simple set of configuration keys to help you resolve failures sooner.

For our simple use cases, we add this workflow

  version: 2
      - build-and-test
Enter fullscreen mode Exit fullscreen mode

Discussion (1)

jakebman profile image

Why are we using pipefail? What does that prevent or allow?