Share your code in Git using Xcode

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

This guide shows you how to share your Xcode projects using Azure Repos.

Prerequisites

Category	Requirements
Project access	Member of a project.
Permissions	- View code in private projects: At least Basic access. - Clone or contribute to code in private projects: Member of the Contributors security group or corresponding permissions in the project. - Set branch or repository permissions: Manage permissions permissions for the branch or repository. - Change default branch: Edit policies permissions for the repository. - Import a repository: Member of the Project Administrators security group or Git project-level Create repository permission set to Allow. For more information, see Set Git repository permissions.
Services	Repos enabled.
Tools	Optional. Use az repos commands: Azure DevOps CLI.

Piezīme

In public projects, users with Stakeholder access have full access to Azure Repos, including viewing, cloning, and contributing to code.

Create a local Git repo for your Xcode project

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

• New projects
• Existing projects

If your project is already in a local Git repo, you can skip ahead to Create a new Git repo in Azure Repos.

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.

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.

Create a new Git repo in Azure Repos

Create a new Git repo in Azure Repos for your Xcode project.

If you have already created a repo for your Xcode project in Azure DevOps Services, you can skip ahead to Push your project.

1. Browse to your Project in your Azure DevOps organization and select the drop-down next to the name of the current Git repo. Select New Repository..
   

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 VSTS.

   

   Piezīme

   If you want to use SSH to connect to your Azure Repos/TFS Git repo, Set up SSH credentials and use the SSH clone URL when adding the remote for your local Git repo.

Push your project

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

   

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

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

   

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

   

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

   

Xcode will push your project to your Azure Repos/TFS Git repo so you can share it with your team.

Next steps

Learn more about using Git in the Git tutorial