转载自博客:http://blog.csdn.net/icyfox_bupt/article/details/22966629
使用github下载项目
git作为目前比较流行的版本控制系统,被各个互联网公司广泛使用着。目前国外的网站有GitHub,国内的有CSDN和OSCHINA的git。
使用git可以很方便地进行多人协作和版本控制。作为一个入门小白,我先从我的角度来和大家一起看看如何使用github,我注重操作,不注重原理。
如果想深入学习git,建议看类似git入门这样的文档
这篇讲如何使用其它人的代码,最初,github被我当作一个下载开源库的好地方。当我做android需要一个actionbar、chart、menu的时候,git上总是能找到。这里不乏有世界上最好的程序员们在工作。为了让我们的开发更快,需要使用他们做好的项目
1、打开github,最上方会有一个搜索框,在里面输入我们可能用到的库,比如chart
2、会搜索出github中所有公开的chart项目:
3、由于我是做安卓的,在这里我选择JAVA
我们看到这里给出了让我们满意的筛选,而且有472个项目之多,选择第一个:
4、Android-charts
打开Android-Charts后我们看到了一个项目的界面:主界面是项目的名称和代码树,右侧是项目的一些属性(话题、提交次数、人数等等),下方是作者对项目的介绍:
在代码结构的区域,可以通过点击文件直接查看当前的文件内容。
项目介绍区域,作者会对项目的功能,使用方法进行介绍。
如果想直接下载这个项目的压缩包,点击右下角的DownLoad ZIP;
如果想直接把项目导入到Eclipse里(因为我做android嘛),打开Eclipse,选择File-->Import-->Projects from git --> URI ,输入HTTPS网址--next
选择一个分支:如Master -- > next -->选择保存目录,eclipse会自动帮我们下载内容
最后我们把项目导入就大功告成了!~
这样的好处是会有git的地址,如果作者某天更新了程序,我们可以很方便地更新我们的本地git库。
参与一个项目编写
接上文:大多数时候我们也需要把别人的代码进行整合和修改,而不是简单的修改,这时就需要对一个项目进行修改。
注意,本系列文章主要说明在github网站上的操作,更多高级操作请使用git控制台
一、fork一个项目
打开一个项目,点击界面右上角的的“fork”,就会在你自己的项目库里创建一个代码的拷贝。
这份代码的主人就是你,你可以对代码进行任何修改。比如在此我fork了一个比特币的项目 https://github.com/bitcoin/bitcoin
进入自己的主页后看到有了一份项目的拷贝,而且和原来的项目一模一样。
画线部分体现了这个项目的源头,底部是项目的文件。接下来就可以对这个项目进行一系列的操作。
二、修改项目
git重要的功能就协作开发。当我们觉得代码有必要进行修改的时候,可以修改,并把更改提交给代码原始的主人,这样就完成了一次代码的协作。
点击我们项目中的某一个文件。可以看到这个文件的内容
其中上面的 contributor是这个文件的贡献者,他们为这个文件的编写做出了贡献。
如果你也想做贡献,就点击EDIT,进入编辑状态
添加一些文字
然后把我们的更改进行提交(commit),提交时要填写这次修改的内容,让其它人清楚修改了什么内容。填写完毕后点击commit changes,这时代码进行了更新,contributor里也看到了我的ID~!
三、提交修改申请
注意:刚才我们所做的内容都是在 自己的项目下进行的,举个例子,是在 icyfox-bupt/bitcoin 下进行的, 原始的项目 bitcoin/bitcoin 并没有发生变化。毕竟如果这样就可以修改代码的话也太不安全了!
如果想把我们的代码同步到原项目中,需要向原项目主提交申请:
回到项目首页,点击Pull Request,新建一个PR(Pull Request),在接下来的页面中会显示这次提交对代码所做的改动。
确认无误后点击上方的Create Pull Request,然后进行代码说明,再点击Send Pull Request,完成这次PR的申请。
这样在原项目的Pull Request列表里,就会出现我们的这一条。
原项目的作者可以判断我们的代码是否有用,来决定是否合并。当然由于我们的代码完全是无效的,所以一定会进入close中。
以上是在github网站上对项目进行git操作的一些步骤,注意这些操作都是网页操作,如果要正经的使用,还是要使用git bash这样的控制台。