GitHub 使用

git / GitHub / gitlab

简介

Git - 版本控制工具
Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。
Git 是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。
</br>
Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper，后者之前一直是 Linux 内核开发人员在全球使用的主要源代码工具。
开放源码社区中的有些人觉得 BitKeeper 的许可证并不适合开放源码社区的工作，因此 Torvalds 决定着手研究许可证更为灵活的版本控制系统。
尽管最初 Git 的开发是为了辅助 Linux 内核开发的过程，但是我们已经发现在很多其他自由软件项目中也使用了 Git。例如 最近就迁移到 Git 上来了，很多 Freedesktop 的项目也迁移到了 Git 上。
</br>
Github - 一个网站，提供给用户空间创建git仓储，保存用户的一些数据文档或者代码等
作为开源代码库以及版本控制系统，Github目前拥有140多万开发者用户。
随着越来越多的应用程序转移到了云上，Github已经成为了管理软件开发以及发现已有代码的首选方法。
如前所述，作为一个分布式的版本控制系统，在Git中并不存在主库这样的概念，每一份复制出的库都可以独立使用，任何两个库之间的不一致之处都可以进行合并。
GitHub可以托管各种git库，并提供一个web界面，但与其它像 SourceForge或Google Code这样的服务不同，GitHub的独特卖点在于从另外一个项目进行分支的简易性。
为一个项目贡献代码非常简单：首先点击项目站点的“fork”的按钮，然后将代码检出并将修改加入到刚才分出的代码库中，最后通过内建的“pull request”机制向项目负责人申请代码合并。已经有人将GitHub称为代码玩家的MySpace。
</br>
GitLab - 基于Git的项目管理软件
GitLab 是一个用于仓库管理系统的开源项目。使用Git作为代码管理工具，并在此基础上搭建起来的web服务。

三者都是基于git的，可以说是git的衍生品。

什么是GitHub?

GitHub是一个版本控制和协作的代码管理平台。它可以让你和他人在任何地点一起进行项目工作。

步骤 1. 创建一个储存库
一个储存库通常被用来组织一个单独的项目。存储库可以包含文件夹和文件，图片，视频，电子表格，和数据集合——你的项目的任何东西。我们建议包含一个README(说明档案)，或者包含关于你项目信息的文件。同时GitHub使得你创建你的新储存库变得容易。它也提供其它普通的选项例如一个授权文件。

去创建一个新的储存库

1.在右上角，临近你的名字，点击 + 号并且然后点击New Repository.
2.把你的仓库命名为hello world.
3.撰写一个简短的介绍。
4.挑选Intialize this repository with a README(用一个说明档案初始化这个存储库）----此处若不选中，则不初始化，创建完成后，页面上出现提示说明，有具体做法。

01.png

这里建的就是origin的远端仓库，下面说一下，把本地代码上传到origin:
方式一：

1.仓库克隆到本地：git clone +远端地址； （进到准备存储代码的目录中，再克隆）
2.创建ignore文件： touch .gitignore
3.提交.gitignore文件到远端
4.用sourcetree查看提交等日志
5.把代码放到本地仓库中，添加git add + 点；提交到本地：git commit （后面加-m “提交的日志”）
6.把本地代码推送到远端：git push origin master
7.如果：代码工程放到本地后，发现有问题，git发现不了这个工程，可能是：工程本身里面有个.git的跟踪，删除即可。

方式二：

1. 一般此时，本地已经创建了一个项目，而且xcode创建项目的时候自带了隐藏文件夹.git， 此时本地项目和gitHub上面并没有任何的联系。
2. 创建ignore文件，放入本地项目中。
3. cd命令进入到本地项目中，然后 git add . 。
4. 命令：git commit -m"提交项目工程"  ,这是提交到本地。
5. 命令：git remote add origin http://*****/iOS_group/***.git。
6. 命令： push -u origin master，或者push origin master。
（如果当前分支与多个主机存在追踪关系，那么这个时候-u选项会指定一个默认主机，这样后面就可以不加任何参数使用git push， push -u origin master是：本地的master分支推送到origin主机，同时指定origin为默认主机，后面就可以不加任何参数使用git push）
此时，github里面的project里面就有了项目代码。

其实，在gitlab中创建项目后，里面未初始情况下，会提示各种情况的操作：

111.png

操作过程中，可能出现错误：fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
解决：

出现这个问题是很可能是因为没有在github账号添加SSH key，或者是没有把专用密钥添加到 ssh-agent 的高速缓存中;
具体参考：我的另一篇文章 “iOS ssh keys 和 mac下使用github 上传代码”中的“ ssh -T git@github.com”检测过程的步骤，则可以解决。

步骤 2.创建一个分支
分支是在同一时间内能工作在一个储存库中的不同版本上的方法。
你的储存库中有一个名字为master的分支，此分支默认为决定性的分支。在提给master之前，我们使用分支来试验和编辑。

当你创建一个分支与master分支分开时，你正在进行拷贝或者说是复制master在那个时间点。当你正工作在你的分支时，别人对master分支进行改动，你可以提取这些更新。

在GitHub的储存库中，分支完成相似的任务。

在GitHub，我们的发明者，作者和设计师都在用分支来进行bug修复和重要的工作，这些分支从我们的master分支中分离出来。当一项改动准备好时，他们把分支合并到master中。

来创建一个新的分支

1.来到你的新的hello world储存库。
2.点击顶端文件（master）的下拉菜单
3.敲写分支的名字，readme-edits,进入新的分支文件盒子。
4.选择蓝色的Create branch盒子 或者在你的键盘上点击“Enter”。

现在你拥有了两条分支，master和readme-edits.它们看起来完全一样。

步骤3.作出改动并且提交
你的readme-edit分支（master的副本）。让我们来做些编辑工作吧。
在GitHub，保存改动被称为提交。每项提交都有一个相关联的信息。这个信息是一个说明，用来阐述为什么要进行特殊的改动。提交信息捕获你的改动历史，以便其他的合作者可以明白你改动的东西和目的。

作出改动并且提交

点击README.md文件。
在文件视野的右上角点击铅笔图标进行编辑。
在编辑器中，写一点关于你自己的东西。
点击Commit changes 按钮。

这些改动将仅仅会在你的readme-edits分支中的文件中出现，因此现在这个分支中的内容不同于master。

步骤 4.开启一个提取请求
现在你在master的分离的分支上作出改动了，你可以开启一个提取请求。

在HitHub中提取请求是合作的核心。当你开启一个提取请求，表明你正在提议你的更改并且请求某人审查并提取你的贡献内容，同时把你的贡献内容合并到他们的分支上。这些改动，添加和删除会被用绿色和红色显示。

一旦你做出提交，你就可以开启一个提取请求和开始一场讨论，甚至可以在代码完成之前。

通过使用在你的提取请求GitHub的[@mention system](http://help.github.com/articles/about-writing-and-formatting-on-github/#text-formatting-toolbar 通知栏，你可以要求某个具体的人或者团队的反馈，无论他们是在大厅还是相隔10个时区的地方。

你甚至可以在你的个人储存库开启提取请求，并且亲自把它们合并。在学习更大的项目之前，下面是一种很棒的学习GitHub的方法。

为了修改README文件而开启一个提取请求

当你完成你的信息表时，点击Create pull request!

步骤 5.合并你的提交请求
1.在最后一步，是时候把你的改动整合起来——把你的readme edits分支合并到master分支中。
2.点击Confirm merge。
3.继续， 因为改动已经被合并了，所以可以用在紫色框中的Delete branch按钮删除分支。

在GitHub 的页面上，先定义两个角色：原著A用户的工程a，和想要针对a做些操作的B用户。

02.png

例如，针对这个afnet, 想要做些操作，进到此处，点击里面的某个文件--”README“, 然后进行编辑--修改，这个过程是创建了一个fork（针对外来人员可编辑的一个分支）。

03.png

编辑过后，下面的显示，填写编写日志，点击后：

04.png

此处的base fork 是原著A的，head fork是B的已复制的一个可编写的分支，点击：create pull request，就是提出让A拉取B修改内容的请求，若A拉取合并则，A中的a项目就合并了B的修改。
注意：AFNetworking/AFNetworking 和 wgj0808/AFNetworking, AFNetworking/AFNetworking指的是原著，而 wgj0808/AFNetworking指的是fork的分支，是属于wgj0808的一份可编辑并可保存修改内容的一个复制品。不管怎样，想要A在a项目中看到Pull requests 的申请，B必须要在自己账号中提出pull的请求。

code: 代码，修改，编辑，切换分之；
Issues: 错误，在原著中的a里面可以编辑提交，让A看到。
Pull reaquests: 拉取请求，外来人员的一些修改代码，请求合并的申请。