最近要和同学一起做一个Android项目,由于需要多人协作开发,所以被推荐使用Git和GitHub进行项目管理,由于之前都没接触过,所以初次使用走弯路什么的也花费了我许多时间,故写篇教程总结下我的使用经验。
Git的基本使用教程可以看我之前的一篇文章:Git的安装与基本使用
1 GitHub是什么?
gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。
gitHub于2008年4月10日正式上线,除了git代码仓库托管及基本的 Web管理界面以外,还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱(报表)、代码片段分享(Gist)等功能。目前,其注册用户已经超过350万,托管版本数量也是非常之多,其中不乏知名开源项目 Rubyon Rails、jQuery、python 等。
2018年6月4日,微软宣布,通过75亿美元的股票交易收购代码托管平台GitHub。
在GitHub,用户可以十分轻易地找到海量的开源代码,随着越来越多的应用程序转移到了云上,Github已经成为了管理软件开发以及发现已有代码的首选方法。
2 GitHub的注册登录
首先进入GitHub的官网:GitHub官网
在首页输入用户名、邮箱、密码进行注册,具体的流程和其他网站注册差不多,我就不多说了,邮箱验证成功后会让你选择是否充值为付费用户,如果你不需要代码保密的话点击free就可以了,对于个人来说free已经完全够用了。
3 建立一个新的仓库
登录后找到new repository按钮点击,新建一个仓库。
在Repository name那里为你的远程仓库起个名字,下面的Description可填可不填,为你的项目写上一两句描述,然后选择Public开源(Private是不开源,别人不可见,仅付费用户可选),就可以点击Create repository创建你的远程仓库了。
点击创建成功后会进入这个界面,你可以直接在网上新建项目文件,也可以直接将一个已经写好的项目上传到该仓库中,甚至也能将网上别的代码复制过来初始化你的仓库。为了方便后面的讲述,我选择上传已存在的项目。
4 在你的GitHub账号上添加你电脑的SSH秘钥
生成SSH秘钥
在用户主目录下,看看有没有.ssh目录,如果有,再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件,如果已经有了,可直接跳到下一步。如果没有,打开Git Bash,创建SSH Key:
ssh-keygen -t rsa -C "[email protected]"
把命令里的邮箱地址换成你自己的邮箱,然后便一路回车键按下去,不需要修改什么,用默认值便可以了。
如果没有出什么问题的话,你现在应该可以在你的用户主目录里找到.ssh目录,里面有id_rsa和id_rsa.pub两个文件,这两个就是SSH Key的秘钥对,id_rsa是私钥,不能泄露出去,id_rsa.pub是公钥,告诉其他人也无所谓。
添加SSH秘钥,选择
接下里回到你的GitHub界面,点击右上角头像进入setttings设置界面,选择SSH and GPG keys,然后右上角点击new SSH key,给自己的秘钥起个Title,然后在key文本框里粘贴上id_rsa.pub文件里的内容,点击Add key确认添加即可。
5 从本地上传已存在的项目
在上篇文章中,我在本地建立了一个只有一个readme.txt的本地仓库,同样起名为TestForGit。
readme.txt里面写了两句话,“hello world!”和“I am a man”。
现在在TestForGit文件夹上右键点击Git bash打开Git的命令行界面,输入:
git remote add origin https://github.com/lonelywilliam/TestForGit.git
git push -u origin master
然后push成功会显示:
你再点开你GitHub上的仓库,会发现里面已经有啦一个readme.txt,那就说明上传成功了。
第一次push时可能会收到一个warning警告,那只是SSH秘钥的确认警告,可以不用理会。
6 本地修改再次提交
我们现在在本地的readme.txt文档上做一个修改,把两句话都删掉,改成“there is nothing!”然后输入指令,在本地提交并查看版本:
git add .
git commit -m "readme.txt is changed"
git log
从图中我们可以看出在本地我们的最新版本已经到了9e02ff1那个了,而origin/master也就是远程仓库的master还停留在上一个4124dbd那个版本。
接下来我们可以将本地的修改push到GitHub上的远程仓库,但我们先不这样做,我们在GitHub上也将这个文件修改一下,看看再push会发生什么情况:
我将GitHub上readme.txt文档新加了一句“I miss her!”。而本地的readme.txt里面已经只剩“there is nothing!”了。
接下来把本地仓库push 上去:
然后Git会报错,报错信息告诉我们这通常是由于另一半仓库已经改变引起的,而且提示我们可以用pull指令先更新下,我们再用git status查看下状态:
git status
它提示我们远程仓库已经有了一次新的commit提交,所以我们还是先用pull指令让远程仓库与本地仓库合并一下吧:
git pull
信息显示自动融合(auto-merge)进程在readme.txt这里出现了冲突(conflict),导致融合失败,你需要先修复冲突在提交后才能继续合并。
我们可以输入diff指令查看具体报错信息:
git diff
从这里可以看到这文件在本地与远程仓库有差异,所以需要我们先解决冲突后才能push上去。
行,那我们打开readme.txt文件:
Git已经帮我们把冲突的地方标记出来了,我们把他标记的语句都删掉,然后把语句改成“there is nothing!”和“I miss her!”,这样双方就没有冲突了。接下来继续push三连:
git add .
git commit -m "fix the conflict"
git push
现在我们已经push成功了,再去GitHub上看看有没有修改成功吧!
可以看到,远程仓库也跟本地同步了。
这里要提一下,push三连其实应该改成push四连,因为一般来说上传前让远程与本地同步是必要的步骤。所以正确的提交步骤是:
git add .(添加文件)
git commit -m "your message"(提交)
git pull (拉取远程仓库更新)
git push (推送到远程仓库)
7 如何从远程仓库下载代码
如果我一不小心把本地项目丢失了,或者损坏了,怎么从远程仓库下载呢?
很简单,或许是本篇文章操作最简单的一步了,只需要一个git clone 命令即可。
我先将本地TestForGit项目删除,然后在GitHub远程仓库主页,找到仓库地址复制:
然后找个空位置鼠标右键进入git bash 界面:
git clone https://github.com/lonelywilliam/TestForGit.git(此处填你的远程仓库地址)
然后你指定的位置就已经有了远程仓库的拷贝,是不是超级简单?
而且只要这一条命令,你就可以前往GitHub的开源项程序海洋里寻找你感兴趣的项目,把他们下载到本地调试开发。