fork 就是复制一个代码仓库。fork 一个代码仓库之后,你就可以任意的尝试去修改代码,而不会影响到源项目。
fork 通常用在你打算修改别人的项目,或者使用别人的项目作为实现自己想法的开端。
修改别人的项目
修改别人项目的一个很好的例子就是修复 bug。当你发现一个 bug 时可以通过 issue 来记录,但是更好的方式是:
- 拷贝那个项目
- 将发现的 bug 进行修复
- 提交一个 pull request 给项目的拥有者
如果项目的拥有者认同你做出的修改,他们可能会将你修复的内容加入原来的项目。
fork一个实例仓库
fork 一个仓库仅仅需要两步操作。你可以通过我们创建了一个仓库来练习:
- 在 GitHub 上,跳转到 dzenbot/DZNEmptyDataSet 仓库
- 在页面的右上角,点击
Fork
就这样,现在你已经 fork 了一份原来dzenbot/DZNEmptyDataSet
的仓库。
当你 fork 一个项目时,可能是想在上游或原仓库的基础上做修改。如果是这种情况,那么定期的将你的 fork 和上游的仓库进行同步将是一个好习惯。你可以通过在命令行上使用 Git 来进行同步。你可以通过刚刚将 dzenbot/DZNEmptyDataSet
仓库的 fork 来练习设置上游的仓库。
一、设置Git
如果你从来没有设置过 Git,首先你需要设置 Git。同时不要忘记设置 Git 到 GitHub 的身份验证。
二、在本地克隆你创建的fork
现在,你已经对 DZNEmptyDataSet
仓库进行了 fork,但是在你的电脑上还没有仓库中的文件。现在,在你的电脑上克隆一份你 fork 的仓库。
- 在 GitHub 上,跳转到你 fork 的
DZNEmptyDataSet
的仓库 - 在仓库的名称下,点击 Clone or download
- 使用 HTTPs 方式下的克隆,点击图标来拷贝克隆仓库的 URL。
- 打开终端
- 输入
git clone
,然后粘贴你在第 3 步拷贝的 URL。将下面的YOUR-USERNAME
替换成你的 GitHub 的用户名之后,看起来就一样了:
git clone https://github.com/YOUR-USERNAME/DZNEmptyDataSet.git
- 按下 Enter,将会创建你本地的克隆
Cloning into 'DZNEmptyDataSet'...
remote: Enumerating objects: 5789, done.
remote: Total 5789 (delta 0), reused 0 (delta 0), pack-reused 5789
Receiving objects: 100% (5789/5789), 13.87 MiB | 74.00 KiB/s, done.
Resolving deltas: 100% (3135/3135), done.
现在,你有了一份对 DZNEmptyDataSet
仓库 fork 后的本地拷贝。
三、配置 Git 来同步你 fork 的源 DZNEmptyDataSet 仓库
当你为修改源仓库而 fork 一个项目时,你可以通过配置 Git 来将上游仓库或者源仓库中修改的内容合并到你 fork 的仓库的本地克隆上。
- 在 GitHub 上,跳转到
wangxuewen/DZNEmptyDataSet
仓库。 - 在仓库的名称下面,点击 Clone or download。
- 使用 HTTPs 方式下的克隆,点击图标来拷贝克隆仓库的 URL。
- 打开终端
- 改变路径到你在第二步克隆的 fork 的项目文件
- 跳转到你的 home 目录,仅需要输入 cd,而无需输入更多文字。
- 输入 ls 来列出当前目录下的文件和文件夹。
- 输入 cd your_listed_directory 进入列出的目录当中的一个。
- 输入 cd .. 跳转到上一个目录
- 输入
git remote -v
后点击 Enter,你就会看见你 fork 的仓库配置的远程仓库。
wangxuewen@Davin-MacBookPro ~$ git remote -v ✭master
origin https://github.com/wangxuewen/ZJYStarRateView.git (fetch)
origin https://github.com/wangxuewen/ZJYStarRateView.git (push)
- 输入
git remote add upstream
,然后粘贴你在第二步拷贝的 URL,按 Enter。就像下面一样:
git remote add upstream https://github.com/wangxuewen/DZNEmptyDataSet.git
- 为了验证为你的 fork 设置的新的上游仓库,再输入一次
git remote -v
。你将会看见你的 fork 的 URL 作为origin
,源仓库的 URL 作为upstream
。
wangxuewen@Davin-MacBookPro ~$ git remote -v ✭master
origin https://github.com/wangxuewen/ZJYStarRateView.git (fetch)
origin https://github.com/wangxuewen/ZJYStarRateView.git (push)
upstream https://github.com/wangxuewen/DZNEmptyDataSet.git (fetch)
upstream https://github.com/wangxuewen/DZNEmptyDataSet.git (push)
- 将要修改的代码push到新的仓库中,有需要的可以添加新的tag。
- 修改pod文件中对应库的依赖
pod 'DZNEmptyDataSet', :git => 'https://github.com/wangxuewen/DZNEmptyDataSet'
网友评论