Configuring Xcode Cloud for your team

Start using continuous integration and delivery with Xcode Cloud as a team.

Overview

To adopt continuous integration and delivery (CI/CD) with Xcode Cloud, you’ll need to configure your project or workspace to use Xcode Cloud, create your first workflow, and then start your first build. However, starting to use Xcode Cloud as a team may require additional steps and coordination among team members and administrators — especially in a corporate context.

To successfully configure your team’s project or workspace to use Xcode Cloud, first review required roles and permissions described in Setting up your project to use Xcode Cloud. Depending on your role and permissions, you may need to coordinate with others to:

Allow Xcode Cloud to access your team’s Git repository.
Create an app record in App Store Connect.

If you have the required role and permissions to complete the above tasks or someone else has previously performed them, configure your team’s project or workspace to use Xcode Cloud as described in Configuring your first Xcode Cloud workflow. However, teams may limit the number of people who can administer their Git repositories and their App Store Connect account. In a corporate context, there might even be a dedicated infrastructure team, which means you need to work with them before you start using Xcode Cloud.

For additional information about using Xcode Cloud as a team, see Deep dive into Xcode Cloud for teams.

Connect Xcode Cloud to an admin-managed Git repository

To start using Xcode Cloud, you need the permissions listed in Setting up your project to use Xcode Cloud to grant Xcode Cloud access to your team’s Git repository. If you don’t have the required role or permission, work with your team’s source code management (SCM) administrator and ask them to configure your project to use Xcode Cloud.

You only need to work with your team’s SCM administrator when you onboard your team’s first app or framework to Xcode Cloud. When the SCM administrator configures Xcode Cloud for one project or workspace and connects your team’s SCM provider to Xcode Cloud, other projects you host with the same provider can use the configured connection. For example, say your team hosts its repositories on Bitbucket Cloud and your team’s administrator configures one project to use Xcode Cloud. When you start using Xcode Cloud for subsequent projects that use Bitbucket Cloud, you reuse the connection to Bitbucket Cloud that your administrator configured.

To connect Xcode Cloud to an admin-managed Git Repository:

Add your administrator to your team if they aren’t a member.
Let your administrator configure your project to use Xcode Cloud. If your repository’s administrator doesn’t have expertise developing for Apple platforms, it’s OK to let them configure your project or workspace to use Xcode Cloud and to allow the first build to fail.
Start using Xcode Cloud, as discussed in Connect your personal SCM account to Xcode Cloud below, and fix any build issues as needed.

Create an app record in App Store Connect

Xcode Cloud combines Xcode, TestFlight, and App Store Connect into a powerful CI/CD system. As a result, you need an app record for your app in App Store Connect to use Xcode Cloud. If you haven’t created an app record for your app, Xcode helps you create one when you configure your project or workspace to use Xcode Cloud.

For more information about the requirements for creating an app record, see Set up your App Store Connect account. If you can’t create an app record, let someone who has the required role or permission create an app record in App Store Connect. Then configure your project or workspace to use Xcode Cloud as described in Configuring your first Xcode Cloud workflow.

Connect your personal SCM account to Xcode Cloud

Xcode Cloud uses your personal SCM account to monitor the Git repository for changes. As a result, you need to connect your Xcode Cloud to your SCM account. To do this, open a project or workspace that another team member configured to use Xcode Cloud. If you haven’t connected your personal SCM account to Xcode Cloud, Xcode displays the Cloud Issues button in the toolbar. Click the button, and authorize Xcode Cloud to link your source control account with your Apple Account.