Git 多项目管理之奇淫技巧

Git 多项目管理之奇淫技巧

随着项目业务的丰富，结构层次的复杂，单一的项目管理手段已经显得越来越力不从心。尤其是插件化开发、热修复盛行的今天。以下介绍两种我个人比较推荐的 git 多项目管理的方式。

Repo

Android 使用Git作为代码管理工具，开发了Gerrit进行代码审核以便更好的对代码进行集中式管理，还开发了Repo命令行工具，它是一个Python脚本，对Git部分命令进行封装，简化了对多个Git版本库的管理，将百多个Git库有效的进行组织。

简单点说：Repo是基于git的仓库管理工具,是一个python脚本 ，它可以支持对多个Git厂库进行管理。

创建清单

<?xml version="1.0" encoding="utf-8"?>

<manifest>
  <remote  name="origin"
           fetch="https://github.com/cc347504377/" />

  <default revision="master"
           remote="origin"
           sync-j="4" />

  <project path="kotlinLibrary" name="kotlinLibrary" revision="master">
    <copyfile src="BuildScript/build.gradle" dest="build.gradle" />
  </project>
  
  <project .....></project>

</manifest>

清单创建好命名为default.xml，然后上传到git仓库，后续步骤会用到该仓库的地址。可以单独上传也支持和项目一起打包上传，总之需要保证该地址的仓库中根目录下存在该清单文件即可。

下载

curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

chmod a+x ~/bin/repo

初始化

cd <workspace>

mkdir <projectname>

repo init –u <URL> [<OPTIONS>]

URL:指定manifest仓库地址

选项：

-u: 指定连接到的manifest仓库地址

-m: 选择仓库中某个manifest文件，如果没有设置，就使用default.xml

-b: 选择一个maniest仓库中的一个特殊的分支或修正版本

拉代码

repo sync

选项:

-j ： 多任务，一般8核心可以开到16任务,过多会起反作用

-c： 只下载当前分支代码

-d： 让工程回退到manifest指定的版本

-f： 如果某个工程同步失败，继续同步

切本地分支

repo start <localbranch> --all

常用命令

repo命令还有很多，可以通过命令 repo help 显示所有的命令，有兴趣的同学可以自行查阅。在这就不一一列举了。

另外 repo help 来获取有关某个命令的信息，例如,以下命令会生成 repo init 参数的说明和选项列表。

repo help init

Submodule

当一个 git 项目需要包含其他支持 git 项目源码时使用的功能，作用是让多个项目独立存在，且主项目可以使用另一个支持项目。

添加子项目

git submodule add <submodule_url>

添加子项目后会出现.gitmodules的文件，这是一个配置文件，记录 mapping between the project’s URL and the local subdirectory。且该文件在 git 版本控制中，这样其他参与项目的人才能知道 submodule projects 的情况。

初始化及拉取代码

git submodule init  # 初始化本地.gitmodules文件
git submodule update  # 同步远端submodule源码

在获取包含submodule主项目时，pull 和 clone 操作的时候不会同时获取 submodule 的源码，需要执行本地.gitmodules初始化的命令，再同步远端submodule源码。如果希望 clone main project 的时候包含所有submodules，可以使用下面的命令：

git clone --recurse-submodules <main_project_url>  # 获取主项目和所有子项目源码

.gitmodule

[submodule <submodule_name>]
    path = <local_directory>
    url = <remote_url>
    branch = <remote_update_branch_name>

常用命令

# 更新submodule源码，默认更新的branch是master，如果要修改branch，在.gitmodule中设置
git submodule update --remote <submodule_name>      
# 更新所有submodule源码，默认更新.gitmodule中设置的跟踪分支，未设置则跟踪master
git submodule update --remote  
# 当submodule commits提交有问题的时候放弃整个push
git push --recurse-submodules=check
# 分开提交submodule和main project
git push --recurse-submodules=on-demand

# submodules的命令很长，为提升效率，可以创建alias，记录在.git/config路径下
git config alias.spush 'push --recurse-submodules=on-demand'
git config alias.supdate 'submodule update --remote --merge'

总结

• Repo：多项目所属关系为平级且数量较多，需要更加灵活的管理，并且需要一些特殊的功能，例如：控制某个项目中文件位置。

• Submodule：一个项目中依赖某个小项目且数量较少，不需要非常灵活的管理。