Git Submodule管理项目子模块的使用
使用场景
当项目越来越庞大之后,不可避免的要拆分成多个子模块,我们希望各个子模块有独立的版本管理,并且由专门的人去维护,这时候我们就要用到git的submodule功能。
常用命令
gitclone--recursive递归的方式克隆整个项目 gitsubmoduleadd 添加子模块 gitsubmoduleinit初始化子模块 gitsubmoduleupdate更新子模块 gitsubmoduleforeachgitpull拉取所有子模块
如何使用
1.创建带子模块的版本库
例如我们要创建如下结构的项目
project |--moduleA |--readme.txt
创建project版本库,并提交readme.txt文件
gitinit--bareproject.git gitcloneproject.gitproject1 cdproject1 echo"Thisisaproject.">readme.txt gitadd. gitcommit-m"addreadme.txt" gitpushoriginmaster cd..
创建moduleA版本库,并提交a.txt文件
gitinit--baremoduleA.git gitclonemoduleA.gitmoduleA1 cdmoduleA1 echo"Thisisasubmodule.">a.txt gitadd. gitcommit-m"adda.txt" gitpushoriginmaster cd..
在project项目中引入子模块moduleA,并提交子模块信息
cdproject1 gitsubmoduleadd../moduleA.gitmoduleA gitstatus gitdiff gitadd. gitcommit-m"addsubmodule" gitpushoriginmaster cd..
使用gitstatus可以看到多了两个需要提交的文件,其中.gitmodules指定submodule的主要信息,包括子模块的路径和地址信息,moduleA指定了子模块的commitid,使用gitdiff可以看到这两项的内容。这里需要指出父项目的git并不会记录submodule的文件变动,它是按照commitid指定submodule的githeader,所以.gitmodules和moduleA这两项是需要提交到父项目的远程仓库的。
Onbranchmaster Yourbranchisup-to-datewith'origin/master'. Changestobecommitted: (use"gitresetHEAD..."tounstage) newfile:.gitmodules newfile:moduleA
2.克隆带子模块的版本库
方法一,先clone父项目,再初始化submodule,最后更新submodule,初始化只需要做一次,之后每次只需要直接update就可以了,需要注意submodule默认是不在任何分支上的,它指向父项目存储的submodulecommitid。
gitcloneproject.gitproject2 cdproject2 gitsubmoduleinit gitsubmoduleupdate cd..
方法二,采用递归参数--recursive,需要注意同样submodule默认是不在任何分支上的,它指向父项目存储的submodulecommitid。
gitcloneproject.gitproject3--recursive
3.修改子模块
修改子模块之后只对子模块的版本库产生影响,对父项目的版本库不会产生任何影响,如果父项目需要用到最新的子模块代码,我们需要更新父项目中submodulecommitid,默认的我们使用gitstatus就可以看到父项目中submodulecommitid已经改变了,我们只需要再次提交就可以了。
cdproject1/moduleA gitbranch echo"Thisisasubmodule.">b.txt gitadd. gitcommit-m"addb.txt" gitpushoriginmaster cd.. gitstatus gitdiff gitadd. gitcommit-m"updatesubmoduleaddb.txt" gitpushoriginmaster cd..
4.更新子模块
更新子模块的时候要注意子模块的分支默认不是master。
方法一,先pull父项目,然后执行gitsubmoduleupdate,注意moduleA的分支始终不是master。
cdproject2 gitpull gitsubmoduleupdate cd..
方法二,先进入子模块,然后切换到需要的分支,这里是master分支,然后对子模块pull,这种方法会改变子模块的分支。
cdproject3/moduleA gitcheckoutmaster cd.. gitsubmoduleforeachgitpull cd..
5.删除子模块
网上有好多用的是下面这种方法
gitrm--cachedmoduleA rm-rfmoduleA rm.gitmodules vim.git/config
删除submodule相关的内容,例如下面的内容
[submodule"moduleA"] url=/Users/nick/dev/nick-doc/testGitSubmodule/moduleA.git
然后提交到远程服务器
gitadd. gitcommit-m"removesubmodule"
但是我自己本地实验的时候,发现用下面的方式也可以,服务器记录的是.gitmodules和moduleA,本地只要用git的删除命令删除moduleA,再用gitstatus查看状态就会发现.gitmodules和moduleA这两项都已经改变了,至于.git/config,仍会记录submodule信息,但是本地使用也没发现有什么影响,如果重新从服务器克隆则.git/config中不会有submodule信息。
gitrmmoduleA gitstatus gitcommit-m"removesubmodule" gitpushoriginmaster
到此这篇关于GitSubmodule管理项目子模块的使用的文章就介绍到这了,更多相关GitSubmodule子模块内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票!
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。