16boke - 一路博客

参与GitHub上的开源项目

上一节讲解如何使用eclipse来将本地项目同步到GitHub上,使更多的开发者有机会参与到这个项目中来,这一节主要讲解具体如何参与一个开源项目。

首先想要参与开源项目得需要查找自己感兴趣的项目,那么如何找到自己感兴趣的项目呢?一种是上Google来找第二种是直接上github的官网来找,由于本人是以java开发为主,所以就以mybatis为例来演示如何参与这个项目、下载到本地资源库中、如何将mybatis导入到eclipse中,修改完后如何反馈给mybatis项目组等过程。

一、查找mybatis开源项目

打开www.github.com站点,输入mybatis进行查找

1.png

然后选择第一个

1458134157343096578.png

二、参与mybatis项目

点击Fork按钮即可

3.png


4.png

参与成功之后会出现下面图中的标志

5.png


三、将mybatis项目克隆到本地

1、使用Git Bash命令行来克隆

打开Git Bash,切换到本地资源库,上节建立的在D盘的git目录下,输入:git clone git@github.com:putiman/mybatis-3.git即可

6.png

下载成功后会在D盘有一个mybatis-3的目录,由于mybatis采用maven来进行项目构建,所以用eclipse来导入则需要导入maven项目。

2、采用eclipse直接克隆GitHub中的项目

打开eclipse,点右键,Import---Git---Projects from Git,打开的界面选择Clone URI

9.png

点击Next即可,再默认全选,选择本地资源库或者工作空间即可。

9.png

有可能使用eclipse导入之后无法正常直接导入到eclipse中,这时就需要先保存到工作空间中,然后再使用第四步再使用eclipse导入mybatis项目。


四、eclipse导入mybatis项目

点右键,import--Maven--Existing Maven Projects,然后找到git目录下mybatis-3这个项目即可。

7.png

五、修改文件之后提交到GitHub

随便修改一下README文件,添加一行内容:“MyBatis是一款轻量级的ORM框架”,然后在README上点右键,team  , commit,将修改后的README文件提交到本地资源库中。

再在项目上点右键team--Remote--Push...,接下来的操作就与第三节讲解的一样,Push完成之后再看GitHub网站会看到刚才修改的readme文件已经被修改了:

10.png


六、创建pull request

当修改完之后,如果需要将修改的内容提交给项目创建者,需要发送Pull Request,直接点击“Pull Request”即可

11.png

可以看到所有修改变动的内容:

12.png

然后点击“Create pull request”链接,输入标题和内容(comment)最后点击“Create pull request”按钮。

14.png

由于是为了讲解pull request才拿mybatis为例子,建议大家不要这样操作,如果的确需要参与开源软件开发,建议还是好好的运行开源程序,并努力发现bug,再认真进行修改并测试,最后再进行提交。


后记

前四章Git的学习笔记也只是讲解了很粗浅的一部分,并没有涉及到很复杂的Git命令、版本提交后的回滚、分支、打标签等更详细的应用,这些知道我会在日后的工作中逐渐补充完善。



Git