说明:本文主要介绍如何把一个OC项目托管到Github,重操作轻理论。
特别说明:第一步到第到第四都是参考一位大神文顶顶的文章http://www.cnblogs.com/wendingding/p/5584310.html
第一步:先注册一个Github的账号,这是必须的
注册地址:Github官网注册入口
第二步:准备工作
gitHub网站使用Git版本管理工具来对仓库进行管理,注意它们并不等同。
gitHub是全球最大的第三方开源库集散地,Git是一款分布式的版本管理控制工具(除了git之外还有一些其他的版本管理控制工具如SVN等)。
关于Git的基本介绍以及基本使用这里不会做更多介绍,如有需要请参考:Git教程。
关于Git使用的相关书籍:Git版本控制管理(第2版)| Git权威指南(电子版下载地址)
关于Github的介绍和说明可以参考书籍GitHub入门与实践(部分内容已经过时暂无电子版提供下载)或者直接通过官网的帮助页面查看。
第三步:在github上面建立空的仓库(repositories)
我们假设你已经拥有了一个github的账号,并且登录成功,那么你将能够找到下面这样的一个界面。
简单说明下:
其中第1块区域会显示你的个人信息,比如昵称,头像,联系方式等等。
第2块区域展示的相关的一些第三方库。
第3块区域显示你在github网站上面的活跃度,分别以各色的方块来表示,其中一个小格子表示一天(人生说白了就是三万多个小格子,说到这里赶紧算算还剩几个没用的),颜色越深表示活跃度越高。
第4块区域可以做一些配置操作等等的。
看到这个界面之后,点击上图箭头所指的+,选择new repositories选项会跳转到如下界面,简单配置后即可创建一个空的仓库。
上图中使用红色线条框起来的地方是需要注意的,在创建仓库的时候需要对该仓库进行简单的配置,如仓库名称等等的。
其中repositories name处需要填写的是仓库的名称。
Description(optional)处填写对该仓库的简单描述,主要是介绍下仓库的功能等(当然如果比较懒的话可以不写)。
接下来是两个选项(Public|private)表示你创建的仓库是公开的还是私有的。Public和private有什么不同呢?如果仓库是公开的那么意味着任何人都可以无条件的获得你整个仓库的内容,免费。如果仓库是私有的,那么别人无法访问你的私有仓库,条件是需要花钱交保护费,保护费不贵每月7$而已。在这里我仅做演示选择public仓库即可。
Initialize this repository with a README表示在初始化仓库的时候,是否生成一个readMe文件。我们在查看别人框架的时候,在框架主页上会有对该框架版本信息,作用使用方法等等的介绍,这个文件就是readMe文件,在这里选择勾上。
Add .gitignore按钮,点击之后会出现一个下拉框,问你是否要设置仓库的忽略文件。这个看你自己的需要,通常如果你的仓库和代码项目有关系,那么最好选择相应的忽略文件(如OC项目可以选择Object-C,swift项目可以选择Swift),至于为什么请参考GIT的基本使用。
Add a license按钮,点击之后会出现一个下拉框,需要你选择一种开源协议,开源协议有很多种用的比较多的有MIT的或者是Apache的,不同的开源协议对项目的使用方式等有不同的规定,详情可以参考Choose an open source license。
上面的信息都设置好之后,接下来只需要轻轻点击Create respository按钮即可创建一个空的仓库。
第四步:了解仓库主界面
至此,一个空的仓库就已经创建完成了,你将看到如下界面。
这里先简单介绍下这个仓库的页面信息。
其中第1块区域是该仓库的名称,你创建仓库后别人可以通过搜索仓库名的方式找到该仓库。
第2块区域是和仓库相关的一些信息,比如Code选项列出仓库的内容(文件),ISSues选项会列出其他人对该仓库的疑问,Pull Request选项提供其他开发者在对该仓库进行维护时请求合并的入口,Setting选项列出对该仓库可以进行的一些操作如删除等等。
第3块区域列出该仓库的提交次数、tag版本等等。
第4块区域列出该仓库的内容,当前仓库中只有三个文件,分别是.gitignore忽略文件,LICENSE开源协议以及初始化生成的ReadMe文件。在该区域右上角有一个clone or download按钮,点击Download Zip按钮即可把该仓库下载到本地。可以复制远程仓库地址
第5块区域展示ReadMe.md文件的内容。
第6块区域列出有多少人关注该仓库,仓库的受欢迎程度,以及被fork的次数等。我们看一个框架是否受欢迎可以通过查看该仓库Star的个数以及被fork的次数。
上面是对github自动生成空白仓库进行的简单介绍,有了这个空白的仓库之后我们才可以进行后面的操作。
接下来就是
第5步:创建一个空的文件 $ mkdir gitStudy
第6步 gitStudy $ git clone + https://github.com/nieying213/TestApp.git(远程仓库地址) 此时
新建的空文件就把远程的仓库克隆下来了
第7步 把想要上传的文件放进TestApp下面:TestApp $ cp -r +某路径+/* . (把某路径下面所有的文件都copy到本路径下)
比如把myDiary目录里面的文件全部上传
B000000062000B:TestApp nieying03$ cp -r /Users/nieying03/Desktop/icode/myDiary/* .
之后git status查看本路径下的状态
这就提醒有三个文件需要添加,执行git add .(全部添加)
第8步: 提交了 git commit -m '提交说明'
第9步: push 到远程 git push
随即可以在git上面查看上传的文件
如果想删除远程里面的文件
1.先在本地仓库中删除 $rm + 文件名(单文件)/ $rm -r +文件夹名(删除文件夹以及里面的所有文件)
2.添加到git栈中 git add .
3.push到远程 git push