阅读GitHub源码的正确打开方式
BraveWg 人气:1前言
近来发现阅读开源项目上手就整最新的代码不合适,缺少项目迭代的具体实现过程,想着若是可以看到针对问题的提交代码就好了,所以就有了本篇博客。
以文主要涉及:如何fork开源项目,如何保证本地仓库代码更新到最新版本。
本文以开源项目Flink为例进行说明。
1、整体流程
fork项目 =====> 下载本地 ======> 导入IDEA , 配置git获取代码提交过程 =====>更新代码
2、fork项目
为了fork GitHub上的开源项目,首先需要一个GitHub的账号,注册过程可以百度,这里不详细展开。
在GitHub上找到所需的开源项目,点击右上角的fork,会自动地在自己的GitHub上创建一个repository,具体如下:
3、下载代码
为了获取contributer的提交过程,这里使用建议使用git在自己的仓库里获取源码。
直接在git clone 原项目的URL也是可以,但是若是你想贡献代码到原项目了?直接提代码到原开源项目上去提肯定不行的(当然也不是一定不行,仅说一般情况)。提交代码到原项目上的流程一般是:提交代码到个人的GitHub仓库,然后new pull request到原项目仓库,到时候原项目的作者就会根据情况是否合并你的代码。
获取URL的过程如下图:
小技巧:若是你直接从GitHub上下载源码速度慢,恰巧你是用的笔记本,你可以使用热点下载,速度惊人,就是不知道是为什么。
4、导入IDEA,配置git获取提交过程
因为Flink是maven项目,所以导入过程只需要在IDEA中选择“导入已存在项目”,选中pom.xml文件即可。
该过程涉及以下几点:
1)Java版本的选择
正规的开源项目都会说明所适合的JDK版本,一般在GitHub项目下面的README.md文件或项目的wiki上;
所需的scala版本、maven同理;
2)配置git
配置过程可百度。
效果图如下:
5、更新代码
以便了解项目的进展,可以采取如下步骤更新本地代码:
1)配置原项目地址
git remote add upstream <原仓库github地址> //如:https://github.com/apache/flink.git
2)查看当前仓库的远程仓库地址和原仓库地址
git remote -v
3)获取原仓库的更新
git fetch upstream
4)合并到本地分支
git merge upstream/master
5)查看本地更新
git log
6)更新自己fork 的GitHub仓库
git push origin/master
本地代码更新的还可以先更新GitHub上的仓库,然后在使用git pull更新本地仓库,但是这种方法我在使用过程遇到了无法获取最新的版本分支的情况,具体过程可以参考Ref[1]。
个人建议使用本文提及的以git命令方式更新。
此外,在使用git从GitHub上拉代码的过程,可能遇到RPC failed问题,可以参考Ref[2]。
Ref:
[1] https://www.cnblogs.com/eyunhua/p/8463200.html
[2]https://www.cnblogs.com/zjfjava/p/10392150.html
加载全部内容