写在前面:
1、使用Git Submodule可能遇到的坑(http://blog.devtang.com/2013/05/08/git-submodule-issues/)
1、添加
为当前工程添加submodule,命令如下:
git submodule add 仓库地址 路径
其中,仓库地址是指子模块仓库地址,路径指将子模块放置在当前工程下的路径。 注意:路径不能以 / 结尾(会造成修改不生效)、不能是现有工程已有的目录(不能順利 Clone)
2、更新子模块
1、修改Submodule
进入Submodule目录里面:
git push
然后再回到父目录,提交Submodule在父项目中的变动:
2、拉取更新后的Submodule
git submodule foreach git pull
git submodule update
或者:git submodule foreach git submodule update
或者在Submodule的目录下面更新
cd 子submodule
git pull
git submodule update
你需要在 git pull 之后,调用 git submodule update 来更新 submodule 信息。
可以看到在Submodule的目录中,使用git和单独的一个项目是一样的,注意更新Submodule的时候如果有新的commit id产生,需要在父项目产生一个新的提交,pod-libray文件中的 Subproject commit会变为最新的commit id。
3、 删除子模块
git 并不支持直接删除Submodule需要手动删除对应的文件:
cd 到存放Submodule的文件
git rm --cached Submodule_path
rm -rf pod-library
rm .gitmodules
更改git的配置文件config:
vim .git/config
可以看到Submodule的配置信息:
[submodule "pod-library"]
url = git@github.com:jjz/pod-library.git
删除submodule相关的内容,然后提交到远程服务器
4、clone Submodule
clone Submodule有两种方式 一种是采用递归的方式clone整个项目,一种是clone父项目,再更新子项目。
采用递归参数 --recursive
git clone git@github.com:jjz/pod-project.git --recursive
输出结果:
loning into 'pod-project'...
remote: Counting objects: 57, done.
remote: Compressing objects: 100% (45/45), done.
remote: Total 57 (delta 13), reused 49 (delta 8), pack-reused 0
Receiving objects: 100% (57/57), 18.79 KiB | 0 bytes/s, done.
Resolving deltas: 100% (13/13), done.
Checking connectivity... done.
Submodule 'pod-library' (git@github.com:jjz/pod-library.git) registered for path 'pod-library'
Cloning into 'pod-library'...
remote: Counting objects: 34, done.
remote: Compressing objects: 100% (25/25), done.
remote: Total 34 (delta 8), reused 30 (delta 7), pack-reused 0
Receiving objects: 100% (34/34), 12.95 KiB | 0 bytes/s, done.
Resolving deltas: 100% (8/8), done.
Checking connectivity... done.
Submodule path 'pod-library': checked out '330417cf3fc1d2c
42092b20506b0d296d90d0b5f'
可以看到init Submodule 会自动被clone下来
第二种方法先clone父项目,再初始化Submodule
git clone git@github.com:jjz/pod-project.git
cd pod-project
git submodule init
输出:
Submodule 'pod-library' (git@github.com:jjz/pod-library.git)
registered for path 'pod-library'
更新Submodule:
git submodule update
运行结果:
Cloning into 'pod-library'...
remote: Counting objects: 34, done.
remote: Compressing objects: 100% (25/25), done.
remote: Total 34 (delta 8), reused 30 (delta 7), pack-reused 0
Receiving objects: 100% (34/34), 12.95 KiB | 0 bytes/s, done.
Resolving deltas: 100% (8/8), done.
Checking connectivity... done.
Submodule path 'pod-library': checked out '330417cf3fc1d2c42092b20506b0d296d90d0b5f'