Here I am, finally got access to Xcode Cloud, so let’s give it a shot and see how it works. I’ll be writing this post as I go, and learn how to use it. More than words, this is probably going to be a bunch of screenshots, will see 😄

The email

Here is a screenshot from the email I got yesterday from Apple: IMG_0816

Let’s go

First of all, I went to App Store Connect to see what was on the Xcode Cloud tab under one of my applications, here is what I found:

Screen Shot 2021-10-26 at 20 55 08

Not much. From there, the link sent me to the Apple Developer documentation:

Configuring Your First Xcode Cloud Workflow

Screen Shot 2021-10-26 at 21 16 13

On that page, the most important thing was where to go on Xcode:

- Reports Navigator (⌘8) -> Cloud tab -> Create Workflow

And then we get to this screen: Screen Shot 2021-10-26 at 21 02 14

From there, I selected my application and tapped Next Screen Shot 2021-10-26 at 21 02 31

I decided to configure the workflow to send me an email for both succeeded and failed builds.

Screen Shot 2021-10-26 at 21 03 40

Connecting your GitHub account

I had my GitHub account already set up on Xcode, so everything was set up well. However, now we get to the point where we need to grant access to Xcode Cloud servers to pull code from our GitHub repos. This took a few steps, but was pretty straightforward.

Screen Shot 2021-10-26 at 21 04 21

Screen Shot 2021-10-26 at 21 04 35

Screen Shot 2021-10-26 at 21 05 37

Screen Shot 2021-10-26 at 21 05 47

Completing the Workflow Setup

Once connected to GitHub, the rest was easy peasy.

Screen Shot 2021-10-26 at 21 06 00 Screen Shot 2021-10-26 at 21 06 19

First build in progress 👏

Screen Shot 2021-10-26 at 21 08 06

And done ✅

Screen Shot 2021-10-26 at 21 25 33

Updating the Workflow

There is a handy contextual menu option in the workflow to open in App Store Connect, I used that and then proceeded to add a Test step before archiving the app.

Screen Shot 2021-10-26 at 21 32 29 Screen Shot 2021-10-26 at 21 30 27

I was impressed by the workflow being pretty much instantly updated in Xcode, after saving the changes on the web.

Screen Shot 2021-10-26 at 21 30 55

The Output

The build logs are formatted like standard local logs, so it’s pretty easy to navigate through them within Xcode

Screen Shot 2021-10-26 at 21 30 36

Tests are not working for me, though, not sure if it being a macOS app has anything to do.

Screen Shot 2021-10-26 at 22 02 39

Will try again tomorrow :)

Update Oct 30

@aikoniv suggested on Twitter I should disable Hardened Runtime. I tried that and it worked flawlessly. Here is a screenshot of the result of Xcode Cloud with my unit test passing.

Screen Shot 2021-10-30 at 15 30 24


This article was written as an issue on my Blog repository on GitHub (see Issue #30)

First draft: 2021-10-26

Published on: 2021-10-26

Last update: 2021-10-30