为Xcode配置Git和Github

Xcode、Git和Github是三个伟大的编程工具。本文记录一下如何在Xcode中使用Git作为源代码控制工具，以及如何将本地的Git仓库和远程Github上的仓库集成起来。

1. 如何为新建的Xcode项目使用Git

Xcode4开始，就已经将Git作为内置的源代码控制（Source Control）工具了,所以为新建的项目使用git来管理是很方便的。

在新建项目向导中，可以直接选择Git作为源代码控制工具，完成项目新建向导后，就在本地项目目下新建了一个仓库。

2. 如何为已经存在的项目使用Git

如果已经存在了一个Project，想要为它使用Git，可以利用Git的命令行来操作。

假设该项目的根目录是： ~/Documents/Projects/ProjectA

(1) 在终端中先进入该目录：

cd ~/Documents/Projects/ProjectA

(2) 在该目录初始化Git仓库：

git init

(3) 注意，这时一定不要着急将目录下的所有文件都添加进来，先手工设置一些针对Mac OS X上的无用文件的排除(exclude)，在项目根目录(ProjectA)下新建.gitignore文件，在该文件中添加如下排除规则:

# 排除build目录

build/*

# Exclude temp nibs and swap files

# 排除nib临时文件和交换文件

*~.nib

*.swp

# 排除OS X的文件夹显示属性目录

.DS_Store

# 排除xcode3 xcode4的用户自定义设置文件

*.mode1

*.mode1v3

*.mode2v3

*.perspective

*.perspectivev3

*.pbxuser

xcuserdata

上面的规则只是大多数开发者都不需要进行版本控制的文件，还可以根据实际需要添加其它排除规则. 关于.gitignore更多的信息可以google之。

(4) 向git仓库中添加源文件

继续在终端命令行中，进入ProjectA下，

git add .

git commit -m "Initial commit"

然后重启Xcode，就可以在Orgnizer视图中的“Repositories”选项卡界面下看到ProjectA的仓库了，并且已经完成了源代码的初次提交。此后，就可以进行源代码在本地仓库的版本控制了。

3. 如何将Xcode的本地Git仓库与Github的远程仓库集成？

Github的理念源自于Git，但是与Git相比已经有了一些异化的功能特性(比如Pull Request)，所以二者并非完全一致的。但是从版本控制方面来说，差别不大。所以利用Xcode内置的Git管理功能即可与Github连接，而无需额外安装Github客户端。

Github的仓库地址有两种方式：

一种是SSH连接方式，形式为：git@github.com:Hao-Wu/ProjecA.git

一种是HTTP形式，形式为：https://github.com/Hao-Wu/ProjectA.git

这两种仓库地址使用的认证方式也不一样。对于SSH连接，使用非对称公钥认证方法；对于HTTP连接，使用帐号密码认证方式。

3.1 使用SSH方式

# 检查本机是否已经存在ssh公钥

$ cd ~/.ssh

如果以前已经生成过ssh密钥对，那么就存在这个.ssh目录，目录下有id_rsa.pub公钥文件。如果还记得这个密钥对生成的细节(比如passphrase)，就可以直接拿来用；否则就再多花费半分钟时间，生成新的密钥对(记得先备份旧的密钥文件，说不定其它什么项目或程序在使用):

#创建新的SSH密钥对

$ ssh-keygen -t rsa -C "your_email@example.com"

Enter passphrase (empty for no passphrase): [输入密码]

Enter same passphrase again: [再次输入密码]

到这里，SSH密钥对就生成了，接下来将id_rsa.pub文件用文本编辑器打开，将其中的全部字符串拷贝，并粘贴到web版的github.com中SSH公钥设置内。这样Xcode就可以利用SSH认证与github连接。先测试一下：

$ ssh -T git@github.com

本机就会向github发出一个连接请求，随后Mac OS会弹出一些安全认证和请求获取授权的提示框，要选择允许。如果github的服务器返回：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

这就说明本地的git已经能够成功与github服务器通信了。(不用担心上面的访问被拒绝的提示)。在确定能够与github服务器连接后，即可为ProjectA的本地git仓库添加远程地址：

依次点击， Orgnizer –> Repositories –> ProjectA –> Remotes –> Add Remote

输入ProjectA在github上的地址(如果没有就先在github.com的仓库管理页面新建一个名为ProjectA的仓库)：git@github.com:Hao-Wu/ProjecA.git

Username与Password不用输入，关闭Orgnizer视图。在File –> Source Control中即可将本地仓库的代码Push到github上了。

3.2 使用HTTP方式

使用http认证方式省去了生成SSH证书的步骤，但是在每次提交时都需要输入github的帐号和密码。

类似地，依次点击 Orgnizer –> Repositories –> ProjectA –> Remotes –> Add Remote

输入ProjectA在github的http形式的地址：https://github.com/Hao-Wu/ProjectA.git

在UserName和Pasword中分别输入github网站登录的用户名和密码 (用户名不是邮箱形式)。关闭Orgnizer视图，File –> Source Control –> Push, 即可向github中push本地仓库的代码。这个过程可能需要重新输入一遍github的用户名和密码。