仓库的创建与维护
Fork与pull request
小结
GitHub简介GitHub是一个Git的远程代码托管平台,它除了提供代码托管外,还提供了如问题发布、pull request、报表统计等功能,下图为EFCore项目的贡献者统计信息:
GitHub提供了一整套远程协作的解决方案,所以是开源项目的首选平台,许多知名项目都托管在GitHub上。
GitHub可以免费的创建自己的开源代码仓库,同时有付费服务,如私有仓库、GitHub的企业解决方案等。
GitHub中提供了个人仓库和组织仓库,分别适合个人开源项目以及组织开源项目。
个人仓库主页:
组织仓库首页:
创建组织:
填写组织信息:
仓库的创建与维护
1.创建一个仓库(个人和团队仓库创建类似,下图是团队仓库)
2. 仓库的维护:
针对每一个仓库,GitHub提供了代码管理(Code)、问题管理(Issues)、拉请求(Pull Request)、项目管理(Projects)、百科(Wiki)、统计(Insights)、仓库设置(Settings)功能,通过这些功能可以对代码仓库进行维护:
Fork与Pull request
Fork和Pull request是GitHub上完成代码共享的核心功能,下面就介绍如何使用Fork和Pull Request完成代码贡献:
1. 将贡献目标仓库Fork到自己的仓库中:
2. 获取Fork后的仓库,获取并对代码进行修改最后推送到远程分支(直接使用master分支):
修改代码后将修改的内容推到远程仓库:
注:更多使用Git的内容参考:《好代码是管出来的——使用Git来管理源代码》以及《好代码是管出来的——Git的分支工作流与Pull Request》。
3. 发起Pull Request:
创建新的pull request将会显示以下信息(代码由SelimTeam仓库合并到yqszt的仓库、代码是可合并的以及代码差异信息):
当点击“Create Pull Request”按钮后,该请求将会被创建。
4. 处理Pull Request:
yqszt/MyBlog库拥有者,可以在pull request选项卡中看到相应的信息并进行合并:
文件差异:
合并Pull Request:
合并结果:
小结
本文介绍了如何使用GitHub来个人/团队代码仓库,对于一个GitHub仓库来说除了提供基础的代码版本管理功能以外还提供了问题管理、项目管理、百科、拉请求、数据统计等功能,仓库的拥有者(开发者)可以使用GitHub进行项目管理、代码管理,还可以将相关知识通过百科进行发布,以便于项目的受益者、贡献者能够快速获得项目信息,而贡献者除了可以通过Wiki获取信息外,还可以Issue、Pull Request对项目提出疑问或进行贡献,拥有者和贡献者所有的沟通都可以通过Github来完成。
另外Github的fork与pull request实际上就是上一篇文章中提到的“集成管理者工作流”的实现,其中在对pull request的代码进行合并时,实际上还强制进行了代码审查,这种工作流模式即适合本地的开发团队,也适合开发人员来自世界各地的开源项目。
从这些方面看来Github不再是一个简单的Git远程仓库托管平台,而是一个分布式的软件开发管理解决方案。