Mac OS X Server

Xcode Server On OS X Server 5

OS X and iOS developers need a continuous integration system. This automates the build, analysis, and testing solution for software development using Xcode. OS X Server has an Xcode service, capable of integrating your developer account with git, providing many of the options required to build a continuous integration system.

Before you configure the Xcode service that can take committed code and then test and build your software, you’ll need an Apple developer account. The Xcode service then links git to a developer account and runs automations, referred to as bots, in Xcode. Therefore, you’ll also need to have Xcode installed on the computer running the Xcode service. Bots are then managed and reported on using a web app that the Server app runs.

Once the pre-requisites are met, open the Server app and click on the Xcode service.

Screen Shot 2015-09-24 at 10.11.10 PM

Click on the Choose Xcode button.

Screen Shot 2015-09-24 at 10.11.30 PM

When prompted, browse to the version of Xcode you have installed on the server.

Screen Shot 2015-09-24 at 10.11.37 PM

If you haven’t accepted the Xcode licensing agreement, when prompted, click on Agree to do so.

Screen Shot 2015-09-24 at 10.11.46 PM

Xcode will require access to the Accessibility framework to run unit tests. Click on Request Access to provide the rights to Xcode to do so.

Screen Shot 2015-09-24 at 10.19.13 PM

Once access has been granted to Xcode, you’ll see the version indicated in the Build Using field.

Screen Shot 2015-09-24 at 10.19.23 PM

Next, click on Add Team, in order to identify the correct team from your Apple Developer account that will have access to the Xcode service.

Screen Shot 2015-09-24 at 10.19.32 PM

When prompted, select the team from your Apple Developer account that you wish to provide access to the server.

Screen Shot 2015-09-24 at 10.20.27 PM

Click on the Repositories tab. Here, you will define repositories for your Xcode projects. Click on the Repository Access button to define what protocols git should be accessible via.

Screen Shot 2015-09-24 at 10.20.30 PM

At the Repository Access screen, select HTTPS or SSH. Click OK.

Screen Shot 2015-09-24 at 10.20.41 PM

Click the Edit Repository Creators button. At the Repository Access screen, add any groups of users that should have access to create new git repositories. Once all of the appropriate users or groups have been added, click on OK.

Finally, click on the plus sign to add your first repository.

Screen Shot 2015-09-24 at 10.20.55 PM

At the new repository screen, provide a name for the repository. Then, use the Edit button to choose the level of access that logged in users have. Back at the repository screen, click on the HTTPS Access button to provide access via HTTPS. Once saved, double-click on the repository again to see the uri for each type of access. And that’s it.

Screen Shot 2015-09-25 at 7.02.47 PM

Next, you’ll want to add a repository to the Xcode app. To do so, open Xcode and then use the Source Control menu to select Check Out. From there, you’ll get a Check Out screen.

Screen Shot 2015-09-25 at 7.04.42 PM

At the Check Out screen, enter the uniform the repository screen, shown in the previous step of this article and click on the Next button. Next, you’ll need to create bots to automate your build process.