Using Git with an existing Xcode project

GitHub has some very good git tutorials at help.github.com.

to do the initial setup of a repository, open up a terminal window, and CD to the project directory. once there, type 

git init
git add .
git commit -m "Initial commit"

Restart Xcode. The repository should now be set up, and you will be able to manage it in xcode 4.


Xcode 7 (and 8)

If you were starting a new project you would just check Create Git repository during the setup. (Then skip down to the Commit part below.)

enter image description here

But it you are working with an existing project, go to Xcode > Preferences... > Source Control and check the Enable Source Control box.

enter image description here

Then in the main Source Control menu choose Create Working Copy....

enter image description here

(If you get a "Please tell me who you are" error the see this question/answer or one of the other linked questions there.)

When that has finished, make any change to one of your Xcode project files. Then go back to the Source Control menu and choose Commit.

enter image description here

And write a commit message and click the Commit button. (If the commit button is disabled, then make any minor change to your project and try again.)

enter image description here

In Github sign in and create a new repository.

enter image description here

Call it whatever you want, but don't add a README or .gitignore or license yet. You can add those things later. Doing so now will make the syncing more difficult.

enter image description here

Copy the link to your repository.

enter image description here

Go to Source Control > your branch name > Configure.

enter image description here

Click the Remotes tab > "+" button > Add remote....

enter image description here

Enter the github repository name and paste in the address.

enter image description here

After adding the remote, click Push in the Source Control menu. Enter your github user name and password. That's it. You project should be copied to github now.

(I had some trouble getting my username and password accepted at first. If that happens to you go to Xcode > Preferences... > Accounts > your new repository. Enter your user name and password there and then try the Push again.)

enter image description here

You can add a README and other files, but if you do it from the web, you will have to do Source Control > Pull in Xcode before you con commit other changes.

Now any time you make changes in Xcode, all you have to do is Commit and Push.

I learned this method mostly from here.

See also

  • The Basics of Git and GitHub
  • How to add a .gitignore file for Swift in Xcode

Tags:

Git

Xcode

Recent Posts