一、前言
以 Coding iOS 客户端 为例讲解如何在github下载开源项目到本地
github地址:https://github.com/Coding/Coding-iOS
二、分析
根据项目的Git仓库是否引用其他版本库中的文件Git仓库,就是是否用到git submodule子模组,分为两种方式下载开源项目到本地。
git submodule:项目的版本库在某些情况下需要引用其他版本库中的文件,例如有一套公用的代码库,可以被多个项目调用,这个公用代码库能直接放在某个项目的代码中,而是要独立为一个代码库。好处是不用分别把公用的代码库拷贝到各自的项目中会造成冗余,丢弃了公共代码库的维护历史。
所以,用到git submodule的项目Git仓库必需要把公用代码库也一起下载到本地,否则会找不到指定的文件和目录而报错。
download项目的Git仓库不会连同公用代码库一起下载,clone项目的Git仓库会连同公用代码库一起下载。
1.download项目的Git仓库
对于可以直接以zip压缩包形式download到本地
2.clone项目的Git仓库
用到了git submodule,必需要把 Git仓库 clone 到本地。当然如果项目没有用到git submodule,也可以通过clone下载到本地
由于Coding iOS 客户端用到git submodule,必需要把 Git仓库 clone 到本地,否则直接以zip压缩包形式download到本地,运行(在运行bootstrap
脚本下载相应依赖后)会报错找不到指定的文件和目录:error: No such file or directory。
三、clone项目过程
在本地运行终端,切换路径为项目保存路径
在 Coding官方客户端 拷贝Coding的git仓库:https://github.com/Coding/Coding-iOS.git
然后clone到本地
完成clone
四、下载依赖过程
主要是下载第三方框架。
双击运行根目录下的bootstrap
脚本
下载相应的依赖
下载依赖后目录情况
至此,项目源码完整下载下来了。