Share your code in Git using Xcode

Last Update: 1/23/2017

Team Services | TFS 2015 & 2017

Share your Xcode projects in a Team Services Git repo.

Create a local Git repo for your Xcode project

Create a local Git repo for your code to manage your project in version control.

If your project is already in a local Git repo, you can skip this step.

New projects

Create a local Git repo when you create a new project. Choose Create Git repository on My Mac when creating a new project.

Create a Git repo at the time of Xcode project creation

Existing projects

Create a local Git repo for your existing projects not in version control by going to Source Control, Create Working Copy... . Select the projects to add to the local Git repo and select Create. Xcode creates a Git repo for your code and adds a commit with your project files.

Add a local Git repo to an existing Xcode project

Create a new Team Services repo

Create a new Git repo in Team Servies for your Xcode project.

If you have already created a repo for your Xcode project in Team Services, you can skip this step.

  1. Browse to your Team Project in your Team Services account and select the drop-down Team Services drop-down picker next to the name of the current Git repo. Select New Repository..
    Create a new Git repo in Team Services

  2. Enter a name for your new Git repo and select Create. Your browser will navigate to your new empty Git repo for your Xcode project. Copy the clone URL to the clipboard so that you can use it in Xcode to connect to Team Services.

    Copy the clone URL for your new Git repo

Push your project

  1. Go to Source Control in Xcode and select Projectname -- master, then Configure...

    Configure your Xcode Git project settings

  2. Select Remotes, then select the plus icon and choose Add Remote...

  3. In the Address field, paste the Git clone URL for your Team Services repo copied in the previous step. Select Add Remote, then select Done to finish creating the origin remote for your local Git repo.

    Add a remote to the local Git repo for your Xcode project to connect to Team Services

  4. Go to Source Control, Push..., enter the branchname on origin to push to, and select Push.

    Push your Xcode project to Team Services

  5. If prompted, enter your Team Services credentials. For Username, enter your Team Services username. For Password, enter a Personal Access Token created for your user in Team Services. Select OK.

    Authenticate using personal access tokens to Team Services

Xcode will push your project to your Team Services Git repo so you can share it with your team.

Try this next

Learn more about using Git in the Git tutorial and create a build for your project code.

Q&A

Q: Can I use SSH to connect to my Team Services Git repo?

A: Yes. Set up SSH credentials and use the SSH clone URL when adding the remote for your local Git repo.