源仓库
在项目的开始,项目的发起者构建起一个项目的最原始的仓库,我们把它称为origin,例如我们的Una项目,origin就是这个项目的源仓库了。
源仓库的有两个作用:
1、汇总参与该项目的各个开发者的代码
2、存放趋于稳定和可发布的代码
源仓库应该是受保护的,开发者不应该直接对其进行开发工作。只有项目管理者(通常是项目发起人)能对其进行较高权限的操作。
开发者仓库
上面说过,任何开发者都不会对源仓库进行直接的操作,源仓库建立以后,每个开发者需要做的事情就是fork一份源仓库,作为自己日常开发的仓库。
每个开发者所fork的仓库是完全独立的,互不干扰,甚至与源仓库都无关。每个开发者仓库相当于一个源仓库实体的影像,开发者在这个影像中进行编码,提交到自己的仓库中,这样就可以轻易地实现团队成员之间的并行开发工作。而开发工作完成以后,开发者可以向源仓库发送pull request,请求管理员把自己的代码合并到源仓库中,这样就实现了分布式开发工作,和最后的集中式的管理。
Git鼓励大量使用分支:
查看分支:git branch
创建分支:git branch
切换分支:git checkout
创建+切换分支:git checkout -b
合并某分支到当前分支:git merge
删除分支:git branch -d
分支(Branch)
分支是git中非常重要的一个概念,也是git这一个工具中的大杀器,必杀技。在其他集中式版本管理工具(SVN/CVS)把分支定位为高级技巧,而在git中,分支操作则是每个开发人员日常工作流。利用git的分支,可以非常方便地进行开发和测试,如果使用git没有让你感到轻松和愉悦,那是因为你还没有学会使用分支。不把分支用出一点翔来,不要轻易跟别人说你用过git。
在文章开头的那张图中,每一个矩形内部纷繁的枝蔓便是git的分支模型。可以看出,每个开发者的仓库都有自己的分支路线,而这些分支路线会通过代码汇总映射到源仓库中去。
我们为git定下一种分支模型,在这种模型中,分支有两类,五种
永久性分支
master branch:主分支
develop branch:开发分支
临时性分支
feature branch:功能分支
release branch:预发布分支
hotfix branch:bug修复分支
永久性分支
永久性分支是寿命无限的分支,存在于整个项目的开始、开发、迭代、终止过程中。永久性分支只有两个master和develop。
master:主分支从项目一开始便存在,它用于存放经过测试,已经完全稳定代码;在项目开发以后的任何时刻当中,master存放的代码应该是可作为产品供用户使用的代码。所以,应该随时保持master仓库代码的清洁和稳定,确保入库之前是通过完全测试和代码reivew的。master分支是所有分支中最不活跃的,大概每个月或每两个月更新一次,每一次master更新的时候都应该用git打上tag,说明你的产品有新版本发布了。
develop:开发分支,一开始从master分支中分离出来,用于开发者存放基本稳定代码。之前说过,每个开发者的仓库相当于源仓库的一个镜像,每个开发者自己的仓库上也有master和develop。开发者把功能做好以后,是存放到自己的develop中,当测试完以后,可以向管理者发起一个pull request,请求把自己仓库的develop分支合并到源仓库的develop中。
所有开发者开发好的功能会在源仓库的develop分支中进行汇总,当develop中的代码经过不断的测试,已经逐渐趋于稳定了,接近产品目标了。这时候,我们就可以把develop分支合并到master分支中,发布一个新版本。所以,一个产品不断完善和发布过程就正如下图:
注意,任何人不应该向master直接进行无意义的合并、提交操作。正常情况下,master只应该接受develop的合并,也就是说,master所有代码更新应该源于合并develop的代码。
暂时性分支
暂时性分支和永久性分支不同,暂时性分支在开发过程中是一定会被删除的。所有暂时性分支,一般源于develop,最终也一定会回归合并到develop。
feature:功能性分支,是用于开发项目的功能的分支,是开发者主要战斗阵地。开发者在本地仓库从develop分支分出功能分支,在该分支上进行功能的开发,开发完成以后再合并到develop分支上,这时候功能性分支已经完成任务,可以删除。功能性分支的命名一般为feature-,为需要开发的功能的名称。
举一个例子,假设我是一名PingHackers网站的开发者,已经把源仓库fork了,并且clone到了本地。现在要开发PingHackers网站的“讨论”功能。我在本地仓库中可以这样做:
step 1: 切换到develop分支
>>> git checkout develop
step 2: 分出一个功能性分支
>>> git checkout -b feature-discuss
step 3: 在功能性分支上进行开发工作,多次commit,测试以后...
step 4: 把做好的功能合并到develop中
>>> git checkout develop
# 回到develop分支
>>> git merge --no-ff feature-discuss
# 把做好的功能合并到develop中
>>> git branch -d feature-discuss
# 删除功能性分支
>>> git push origin develop
# 把develop提交到自己的远程仓库中
这样,就完成一次功能的开发和提交。
release:预发布分支,当产品即将发布的时候,要进行最后的调整和测试,这时候就可以分出一个预发布分支,进行最后的bug fix。测试完全以后,发布新版本,就可以把预发布分支删除。预发布分支一般命名为release-*。
hotfix:修复bug分支,当产品已经发布了,突然出现了重大的bug。这时候就要新建一个hotfix分支,继续紧急的bug修复工作,当bug修复完以后,把该分支合并到master和develop以后,就可以把该分支删除。修复bug分支命名一般为hotfix-*
release和hotfix分支离我们还比较遥远。。
上面大体介绍了git多人合作的思路,下面是具体步骤
一、基本设置
1、github相关
注册github,创建仓库,配置SSH Key
<1>注册github(不必多说)
<2>创建仓库
可以创建public和private仓库,当然private需要掏钱。
一般我们只需要创建public 仓库,需要配置README和忽略文件,以及开源协议
<3>配置SSH Key,只有配置他之后,你的电脑才能和github相关联。以下为具体步骤:
(1)使用ssh-keygen命令生成key pair:
$ssh-keygen -t rsa -C "${YourEmail}" # "-t rsa"表示使用密钥的加密类型,还可以为dsa;-C设置注释文字,比如你的邮箱“YourEmail”,不一定要是github注册邮箱
Enter file in which to save the key (/Users/faner/.ssh/id_rsa): # 直接回车
Enter passphrase (empty for no passphrase): # 输入密钥文件授权密码
Enter same passphrase again: # 确认密钥文件授权密码
Your identification has been saved in /Users/faner/.ssh/id_rsa.
Your public key has been saved in /Users/faner/.ssh/id_rsa.pub.
(2)此时,敲入ls命令可以看到ssh-keygen在~/.ssh目录下生成的public/private key pair,其中id_rsa为密钥对中的私钥,需妥善保管;id_rsa.pub为密钥对中的公钥,可任意公开。
RSA是一种支持变长密钥的公共密钥算法,需要加密的文件块的长度也是可变的。DSA(Digital Signature Algorithm,数字签名算法)是一种标准的DSS(数字签名标准)。
id_rsa私钥类似keychain进行CSR时生成的private key;id_rsa.pub公钥则类似CSR申请下来的开发证书(在Apple Member Center中有在线备案)。
通过cat命令可以查看id_rsa.pub内容。
*git checkout develop
只有这样你的xcode和终端的命令才保持一致
(3)github上,进入setting,打开SSH key进行设置就OK了
2、Xcode相关
(1)clone远程源仓库
终端进入存放代码的目录,使用以下命令clone。注意此时你clone下来的是github上整个文件夹
git clone "remote address"
(2)创建新项目,放到clone下来的文件夹下
进入本地仓库目录
cd 项目同级目录
切换到develop分支,此时已经从远程拉取develop分支
git checkout develop
将本地新项目提交到本地develop分支
git add .
git commit -m "初始化项目"
此时本地develop分支已经有你新建的项目,上传到远程develop分支。
这里可以使用Xcode自带的push功能,push到远程develop分支
至此,项目已经初始化完成。。
至于实际开发中如何正确操作,可以参考实例演练
3、实例演练
举一个例子,假设我是一名网站的开发者,已经把源仓库fork了,并且clone到了本地。现在要开发网站的“讨论”功能。我在本地仓库中可以这样做:
step 1: 切换到develop分支
>>> git checkout develop
step 2: 分出一个功能性分支
>>> git checkout -b feature-discuss
step 3: 在功能性分支上进行开发工作,多次commit,测试以后...
step 4: 把做好的功能合并到develop中
>>> git checkout develop
# 回到develop分支
>>> git merge --no-ff feature-discuss
# 把做好的功能合并到develop中
>>> git branch -d feature-discuss
# 删除功能性分支
>>> git push origin develop
# 把develop提交到自己的远程仓库中
这样,就完成一次功能的开发和提交。
这是用终端操作,使用xcode自带功能会更方便。
4、合并远程master和develop分支
前提条件是本地代码已经全部提交到远程develop分支;
首先在本地的develop分支pull远程develop代码;
切换到master分支,从远程pull代码,将develop分支合并到本地master分支(此时本地master分支是与远程同步的),有冲突解决,没有则罢。
最后push到远程master仓库。