Mac OS X Server,  Programming

Configure Xcode Server On macOS Server 5.2

Apple developers in growing development teams invariably need a continuous integration system. This automates the build, analysis, and testing solution for software development using Xcode. macOS 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-2016-09-25-at-11-50-35-pm

Click on the Choose Xcode button.

screen-shot-2016-09-25-at-11-50-54-pm

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

Screen Shot 2015-09-24 at 10.11.46 PM

Configure the user account to use for the service.

screen-shot-2016-09-25-at-11-52-00-pm

The service will then require you to login. Do so when prompted.

screen-shot-2016-09-25-at-11-53-30-pm

This enables the user account, which you will then need to login as.

screen-shot-2016-09-25-at-11-54-24-pm

You’ll see a new user environment. Use fast user switching to then switch back to your other account. 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. Once access has been granted to Xcode, you’ll see the version indicated in the Build Using field.

screen-shot-2016-09-25-at-11-59-59-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-2016-09-26-at-12-00-28-am

When prompted, select the team from your Apple Developer account that you wish to provide access to the server, note that you need to be a team agent or an administrator of the developer organization.

screen-shot-2016-09-26-at-12-02-15-am

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-2016-09-26-at-12-02-45-am

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

screen-shot-2016-09-26-at-12-04-11-am

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.

screen-shot-2016-09-26-at-12-04-30-am

 

Select your repository again, and 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-2016-09-26-at-12-05-21-am

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.