submodule_submodule 指定分支 - CSDN
精华内容
参与话题
  • 背景 项目中经常使用别人维护的模块,在git中使用子模块的功能能够大大提高开发效率。...git submodule add <url> <path> 其中,url为子模块...

    背景

    项目中经常使用别人维护的模块,在git中使用子模块的功能能够大大提高开发效率。

    使用子模块后,不必负责子模块的维护,只需要在必要的时候同步更新子模块即可。

    本文主要讲解子模块相关的基础命令,详细使用请参考man page。

    子模块的添加

    添加子模块非常简单,命令如下:

    git submodule add <url> <path>

    其中,url为子模块的路径,path为该子模块存储的目录路径。

    执行成功后,git status会看到项目中修改了.gitmodules,并增加了一个新文件(为刚刚添加的路径)

    git diff --cached查看修改内容可以看到增加了子模块,并且新文件下为子模块的提交hash摘要

    git commit提交即完成子模块的添加

    子模块的使用

    克隆项目后,默认子模块目录下无任何内容。需要在项目根目录执行如下命令完成子模块的下载:

    git submodule init
    git submodule update
    

    或:

    git submodule update --init --recursive
    

    执行后,子模块目录下就有了源码,再执行相应的makefile即可。

    子模块的更新

    子模块的维护者提交了更新后,使用子模块的项目必须手动更新才能包含最新的提交。

    在项目中,进入到子模块目录下,执行 git pull更新,查看git log查看相应提交。

    完成后返回到项目目录,可以看到子模块有待提交的更新,使用git add,提交即可。

    删除子模块

    有时子模块的项目维护地址发生了变化,或者需要替换子模块,就需要删除原有的子模块。

    删除子模块较复杂,步骤如下:

    1. rm -rf 子模块目录 删除子模块目录及源码
    2. vi .gitmodules 删除项目目录下.gitmodules文件中子模块相关条目
    3. vi .git/config 删除配置项中子模块相关条目
    4. rm .git/module/* 删除模块下的子模块目录,每个子模块对应一个目录,注意只删除对应的子模块目录即可

    执行完成后,再执行添加子模块命令即可,如果仍然报错,执行如下:

    git rm --cached 子模块名称

    完成删除后,提交到仓库即可。

    展开全文
  • git submodule的坑

    2020-10-10 11:03:47
    在使用了git submodule一段时间后,我发现了一些submodule的问题,在此分享给大家。更新submodule的坑 submodule项目和它的父项目本质上是2个独立的git仓库。只是父项目存储了它依赖的submodule

    前言

    对于一些比较大的工程,为了便于复用,常常需要抽取子项目。例如我开发的猿题库客户端现在包括3门考试,客户端涉及的公共UI、公共底层逻辑、公共的第三方库、以及公共的答题卡扫描算法就被我分别抽取成了子项目。这些子项目都以git submodule的形式,增加到工程中。

    在使用了git submodule一段时间后,我发现了一些submodule的问题,在此分享给大家。
    更新submodule的坑

    submodule项目和它的父项目本质上是2个独立的git仓库。只是父项目存储了它依赖的submodule项目的版本号信息而已。如果你的同事更新了submodule,然后更新了父项目中依赖的版本号。你需要在git pull之后,调用 git submodule update来更新submodule信息。

     

    这儿的坑在于,如果你git pull之后,忘记了调用 git submodule update,那么你极有可能再次把旧的submodule依赖信息提交上去。对于那些习惯使用 git commit -a的人来说,这种危险会更大一些。所以建议大家:
    1.git pull之后,立即执行git status, 如果发现submodule有修改,立即执行git submodule update
    2.尽量不要使用 git commit -a, git add命令存在的意义就是让你对加入暂存区的文件做二次确认,而 git commit -a相当于跳过了这个确认过程。

     

    更复杂一些,如果你的submodule又依赖了submodule,那么很可能你需要在git pull 和 git submodule update之后,再分别到每个submodule中再执行一次git submodule update,这里可以使用 git submodule foreach命令来实现: git submodule foreach git submodule update

     

    修改submodule的坑

    有些时候你需要对submodule做一些修改,很常见的做法就是切到submodule的目录,然后做修改,然后commit和push。

     

    这里的坑在于,默认git submodule update并不会将submodule切到任何branch,所以,默认下submodule的HEAD是处于游离状态的(‘detached HEAD’ state)。所以在修改前,记得一定要用git checkout master将当前的submodule分支切换到master,然后才能做修改和提交。

     

    如果你不慎忘记切换到master分支,又做了提交,可以用cherry-pick命令挽救。具体做法如下:
    1.用 git checkout master 将HEAD从游离状态切换到 master 分支, 这时候,git会报Warning说有一个提交没有在branch上,记住这个提交的change-id(假如change-id为 aaaa)
    2.用 git cherry-pick aaaa 来将刚刚的提交作用在master分支上
    3.用 git push 将更新提交到远程版本库中

     

    以下是相关命令的操作示范和命令行输出结果:
    1. ui_common git:(df697f9) git checkout master
    2.Warning: you are leaving 1 commit behind, not connected to
    3.any of your branches:
    4.
    5.  df697f9 forget to check out master
    6.
    7.If you want to keep them by creating a new branch, this may be a good time
    8.to do so with:
    9.
    10. git branch new_branch_name df697f911e5a0f09d883f8f360977e470c53d81e
    11.
    12.Switched to branch 'master'
    13. ui_common git:(master) git cherry-pick df697f9

     

    使用第三方工具

    对于submodule的重度使用者,有几个工具可作推荐:
    1.Repo Google用于管理Android项目的工具。
    2.Gitslave
    3.Git Subtree

    以上工具,我都没有实际用过,所以无法提供更多信息。

     

    Tips

    由于常常使用submodule的相关命令,可以在 ~/.gitconfig文件中将其设置别名,方便操作,我设置的所有相关别名如下:
    1.[alias]
    2.  st = status -s
    3.  ci = commit
    4.  l = log --oneline --decorate -12 --color
    5.  ll = log --oneline --decorate --color
    6.  lc = log --graph --color
    7.  co = checkout
    8.  br = branch
    9.  rb = rebase
    10.  dci = dcommit
    11.  sbi = submodule init
    12.  sbu = submodule update
    13.  sbp = submodule foreach git pull
    14.  sbc = submodule foreach git co master


    参考链接
    1.《why-your-company-shouldnt-use-git-submodules》 (需翻墙)

    2.《Git_submodule_tutorial》

    展开全文
  • Git Submodule简单使用

    万次阅读 2017-06-30 13:32:30
    Git Submodule 添加submodule工程 修改Submodule 更新Submodule 总结 更多参考Git Submodule 近期用到了这个命令,主要是为了实现在一个git仓库中,引入其他git仓库,这种适用于你想在主工程中引入其他library库,...

    Git Submodule

    近期用到了这个命令,主要是为了实现在一个git仓库中,引入其他git仓库,这种适用于你想在主工程中引入其他library库,主工程以submodule的形式包含子工程,子工程可以有自己的git操作,比如commit、push、rebase等。

    这里笔者用一个实际的例子来介绍这个命令的使用,不知道大家有没有在原生工程嵌入React Native?熟悉React Native工程的同学会知道有个一个android工程,如下图:

    android submodule

    你会发现下面还会有一个iOS工程,我们客户端开发一般都会各自维护一个git仓库,为了让Android跟iOS不在同一个工程提交commit,主要是为了方便维护,所以就想着怎么在RN工程中引入Android工程和iOS工程,明白我们的需求之后,我们知道git中有submodule的操作,所以下面直接实操吧。

    添加submodule工程

    git submodule add http://git.code.oa.com/TCW/Crowdsource-android.git android

    执行完这条命令之后,通过git status,可以看到变更信息:

    On branch master
    Your branch is up-to-date with 'origin/master'.
    Changes to be committed:
      (use "git reset HEAD <file>..." to unstage)
    
        new file:   .gitmodules
        new file:   android
    

    然后添加子模块:

    git add .getmodules android
    git commit -m "add android submodule."
    git submodule init

    ok,到这里你成功添加了一个submodule.

    修改Submodule

    进入submodule.

    cd android

    我这里的submodule是android.

    这时我修改了android工程里面的内容,git status一下:

    modify submodule

    提交submodule的内容到远程:

    git add .
    git commit -m "嵌入React Native"
    git push

    提交后,看下Submodule在主工程中的变更:

    cd ..
    git status

    如下图:

    modify submodule

    这时候,提交主工程的变更:

    git add .
    git commit -m "update android submodule"
    git push

    ok,这里已经成功修改了submodule.

    更新Submodule

    这里有个问题,你在自己机器完成了submodule的添加和修改,那其他同学想更新怎么办?

    在主工程根目录运行以下命令:

    git submodule foreach git pull

    还需要更新下submodule:

    cd android
    git pull

    ok,这样其他团队成员就能拉到最新的工程代码啦。

    总结

    关于如何在RN工程中通过submodule方式引入android工程已经大致实操了一遍,还有clone submodule和remove submodule的操作就不演示了,可以参考下面提供的链接。

    更多参考

    使用Git Submodule管理子模块

    展开全文
  • git的submodule功能详解

    千次阅读 2019-04-05 13:19:29
    1.前言 项目的版本库在某些情况下需要...分别把公用的代码库拷贝到各自的项目中会造成冗余,丢弃了公共代码库的维护历史,这些显示不是好的办法,现在要了解的git子模组(gitsubmodule)就解决了这个问题。 Git子模...

    1. 前言

    项目的版本库在某些情况下需要引用其他版本库中的文件,例如有一套公用的代码库,可以被多个项目调用,这个公用代码库能直接放在某个项目的代码中,而是要独立为一个代码库,那么其他要调用公用的代码库该如何处理?分别把公用的代码库拷贝到各自的项目中会造成冗余,丢弃了公共代码库的维护历史,这些显示不是好的办法,现在要了解的git子模组(git submodule)就解决了这个问题。

    Git 子模块功能允许你将一个Git仓库当作另外一个Git仓库的子目录。这允许你克隆另外一个仓库到你的项目中并且保持你的提交相对独立。

    2. 准备工作

    首先需要两个版本库例如:

    1) 一个公共的版本库(例如:libA.git)

    git@gitlab.szreach.com:fengyang/liba.git

    2) 一个引用公共版本库的主版本库(例如:super.git)

    git@gitlab.szreach.com:fengyang/super.git

    3. TortoiseGit上git submodule功能实现

    1. 添加子模组的步骤

    第一步:使用submodule add...添加子模组

    在需要作添加子模组的Git版本库中右击,选择“TortoiseGit->Submodule Add...”,在“Repository:”里面输入需要添加子模组的版本库路径,在“Path:”

    中输入添加子模组存放的目录路径。如下图所示:

    此时查看需要添加子模组的Git工作区的目录结构。在根目录下多了一个.gitmodules文件,并且公共代码库被克隆到lib/lib_a目录下。

    第二步:查看.gitmodules的内容

    .gitmodules的内容记录着含子模组存放的目录路径及子模组版本库的路径

    注:此时工作区尚未提交,完成提交后,子模组才算正式完成在需要作添加子模组的Git版本库中创立。

    注:此主版本库(super.git)就变成了一个包含子模组的版本库。

    2. 克隆带子模组的版本库的步骤

    克隆带子模组的git库,并不能自动将子模组的版本库克隆出来,对于只关心项目本身的数据,而不关心项目引用的外部项目数据的用户,这个功能非常好,数据没有冗余而且克隆的速度也很快。

    第一步:克隆super主版本库

    在工作区中克隆主主版本库后,会发现子模组的版本库并没有克隆,只有将存放子模组版本库的目录克隆下来了。

     

     

     

    ----:存放子模组版本库的目录路径

    第二步:克隆子模组

    如果需要克隆出子模组形式引用的外部库,首先需要执行Submodule Update操作。

    在需要作克隆子模组的Git工作区中右击,选择“TortoiseGit->Submodule Update...”,点击“OK”即可。

     

     

    执行Submodule Update...操作后就会把子模组的版本库克隆下来。

     

     

     

     

     

    3. 对主Git库工作区作commit、checkout、revert、pull、push等更改Git工作区内容的操作时,查看Submodule目录下内容的效果

    1) 对主Git库工作区作commit操作

    当在主Git库工作区中变更到达一个适当状态时,我们需要将这些变更提交到Git库,作版本备份和跟踪。

     

    方法:

    在工作区内右击,选择“ Commit-> "当前分支名称" ”,在Commit窗口中,选择需要提交的变更path,填写提交说明,点击“Ok”。

     

     

     

     

    结论:在主git工作区作commit操作,只是将主Git工作区的变更历史提交到主Git本地库中,对Submodule没有任何影响。

    2) 对主Git库工作区作checkout操作

    当在主Git库工作区中想要切换到其他某个分支、某个tag、某个commit历史记录。

    我们这里举个特殊的例子:

    切换到某个commit历史记录(如在主版本库中提交子版本库的历史记录)

    方法:

    在Git工作区内的某目录上右击,选择“Swicht/Checkout...”在Swicht/Checkout...Checkout窗口中,在Switch to Commmit中列出需要切换的commit历史记录,在此列表中选择需要切换到的commit历史记录,以后点击“Ok”按钮。

     

     

     

     

     

     

     

     

    注:由于切换到的是在主版本库中提交子版本库的那条历史记录,因此子模组中状态也会改换,也需要在子模组中执行切换。

     

    执行Submodule Update操作即可。

     

     

     

     

    3) 对主Git库工作区作revert操作

    当在主Git库工作区中这次变更有错误时,就可以使用revert操作来撤销这次次操作。

     

    方法:

    在工作区内右击,选择“Revert”,在Revert窗口中,选择需要撤销的变更path,点击“Ok”。

     

     

     

     

     

     

     

     

    结论:在主git工作区作revert操作,只是将主Git工作区某次的变更操作给撤销,此次操作之前的commit都会被保留,且对Submodule没有任何影响。

     

    4) 对主Git库工作区作push操作

    当在主Git库工作区中将主Git本地库的数据推送到主Git远程库中。

     

    方法:在工作区的目录上(不要在文件上)右击,选择“Git Sync...”

    "Local Branch","Remote Branch",“Remote URL”这3栏必须正确才能“推”数据。

     

     

    结论:在主git工作区作push操作,只是将主Git本地库的变更历史推送到到主Git远程库中,对Submodule没有任何影响。

     

    5) 对主Git库工作区作pull操作

    当在主Git库工作区中将主Git远程库的拉取到主Git本地库中。

     

    方法:在工作区的目录上(不要在文件上)右击,选择“Git Sync...”

    "Local Branch","Remote Branch",“Remote URL”这3栏必须正确才能“拉”数据。

     

     

     

     

    结论:在主git工作区作pull操作,只是将主Git远程库的变更历史拉取到到主Git本地库中,对Submodule没有任何影响。

    4. 对submodule下的内容进行修改后commit、push,对submodule目录作pull

    在执行Submodule Update...操作更新出子模组后,都以某个具体的提交版本进行检出,进入子模组目录,会发现其处于非跟踪状态。

    显然这种情况下,如果修改lib/lib_a下的文件,提交就会丢失。下面介绍如何在检查的子模组中修改,以及如何更新子模组。

    在子模组中切换到master分支(或者其他想要修改的分支)后在进行修改。

    l 切换到master分支,然后在工作区做一些改动。

     

     

    l 执行commit后,并且推送到子模组库中后。

    l 回到主版本库中。

    在主版本库中查看状态,在主版本库中可以看到子模组已修改,包含了更新的提交。

    l 需要将修改提交在主版本库中进行推送。

    对submodule目录作pull

    当子模组版本库中有新的提交历史记录,就需要做pull操作来更新。

     

     

    注:对子模组库中做了pull操作,同时需要对调用子模组库的主版本库中也要做Pull操作。

    如下图所示:

     

     

     

     

    注意:进入子模组目录,会发现其处于非跟踪状态。显然这种情况下,如果修改lib/lib_a下的文件,提交就会丢失。提示如下:

     

     

    5. 移除Submodule

    第一步:用Delete(keep local) 将目录或文件命令从git的索引库中移除子模块目录

    方法:

    在工作区内目录或文件上右击,选择“Delete(keep local)”,在Delete窗口中,点击“Remove”。

     

    Delete(keep local)把目录lib/从git的索引库中移除,但是对目录lib/本身并不进行任何操作。

    因此需要彻底删除。

    第二步:删除物理文件

    第三步:删除.gitmodule文件

    第四步:删除.git/config的submodule配置源文件

    删除如下图所示红框的部门

     

     

    第五步:删除后,提交更改

    展开全文
  • git submodule 完整用法整理

    万次阅读 2018-09-21 10:21:48
    最近有个项目遇到有子模块,遂整理下。。牛逼的人感觉看官网就行,像我这种菜鸟总是需要反复记忆,git官网链接戳此。 1.先来个官方的API ...git submodule [--quiet] add [&...git submodule [--
  • git submodule

    千次阅读 2018-11-07 09:45:54
    前言submodule 目前对 git 仓库拆分的已有实现之一。环境 git version 2.7.4.windows.1准备工作首先创建主仓库 subrepo-master,随意提交一次文本,接着拉取到本地建立子仓库 subrepo 和 subrepo1,随意提交一次文本...
  • 用 Git submodule 管理子模块

    千次阅读 2018-11-06 17:36:53
    添加Submodule 添加sass子项目到自己的项目中,使用git命令 git submodule add git@xxx.git sass 现在你项目里就存在sass文件夹,进入子目录,你可以进行sass子项目的操作,进行commit,pull,pu...
  • git submodule的使用

    万次阅读 多人点赞 2014-04-24 11:13:52
    今天无意中发现了git的git submodule命令,之前的问题迎刃而解了。 添加 为当前工程添加submodule,命令如下: git submodule add 仓库地址 路径 其中,仓库地址是指子模块仓库地址,路径指将子模块放置...
  • git submodule 使用命令简介

    万次阅读 2016-04-07 11:57:54
    抽取项目公共模块,多用项目公用,必然会使用到git submodule命名。 submodule的管理,无外乎添加,更新,删除等操作。submodule 添加进入到git项目根目录下,输入命令: git submodule add 仓库地址 本地路径 若...
  • git submodule转换分支

    万次阅读 2018-05-13 23:35:48
    git config -f .gitmodules submodule.FFmpeg.branch stu-git[submodule "FFmpeg"] path = FFmpeg url = https://github.com/hongge372/FFmpeg.git branch = stu-git
  • git submodule 删除及更新URL

    万次阅读 2016-03-08 10:27:21
    删除一个submodule 1.删除 .gitsubmodule中对应submodule的条目 2.删除 .git/config 中对应submodule的条目 3.执行 git rm --cached {submodule_path}。注意,路径不要加后面的“/”。例如:你的submodule保存...
  • git submodule update --init --recursive

    万次阅读 2018-10-22 11:40:57
    转自http://webfrogs.me/2013/03/20/git-submodule/ 开发过程中,经常会有一些通用的部分希望抽取出来做成一个公共库来提供给别的工程来使用,而公共代码库的...今天无意中发现了git的git submodule命令,之前的...
  • git submodule update failed

    万次阅读 2012-03-31 10:23:24
    今天试用git submodule, 出现了错误 fatal: Needed a single revision 解决方法如下: http://www.gostai.com/downloads/urbi-sdk-2.0/doc/urbi-sdk.htmldir/faq.html#x22-10400014.1.4 14.1.4...
  • git fatal: Path '' is in submodule '' 错误

    千次阅读 2012-05-24 21:47:21
    git提交代码是出现fatal: Path 'directory/file' is in submodule 'directory''错误。悲催啊,怎么也没找到,后来把说出错的文件夹(directory)删除了。再提交就OK了。哈哈。good。
  • git add出现 “fatal: in unpopulated submodule XXX” 错误: 当前处于: F:\217my_optLogs\001系统相关\系统设计\007\oschina\ydgw2407.github.io\themes 下面有目录2个: hexo-theme-matery landscape 因为hexo...
  • Git submodule 如何删除一个 submodule

    千次阅读 2017-06-09 15:21:12
    这个问题困扰了我很久,经常在下载一些项目使用 Git Submodule 功能的时候遇到 某个 sub module 源不存在的问题,本来是可以在 Github 上面找到类似的源,但却没法删掉当前这个有问题的 Submodule。 用 git ...
  • 使用Git Submodule可能遇到的坑

    万次阅读 2015-01-16 15:31:52
    2013-05-13 10:03 cocoachina cocoachina 字号:T | T ...随着近几年的发展,Git已经成为开源界的标准的版本控制工具。开源界的重量级项目,如Linux, Android, Eclipse, Gnome, KDE, Qt, ROR, Debian,无一...
  • git强制更新所有submodule

    千次阅读 2014-01-27 12:49:07
    git submodule foreach 'git checkout -f'
  • 先执行 git init 再执行命令即可。
  • 在使用sourceTree管理git代码的时候,创建了一个静态库。结果在push的时候,没有...No submodule mapping found in .gitmodules for path 'modules/MsgCenter' 其中一个原因是,在创建静态库的时候,勾选了导致冲突了:
1 2 3 4 5 ... 20
收藏数 11,000
精华内容 4,400
关键字:

submodule