统一管理 Git 多仓库，使用上比 Google Repo 更加便利

• repo 繁琐问题，需要单独管理 Manifest 分支
• repo 不能跨多个 remote
• Google repo 的 status 命令输出信息过多
• 简化迭代时新建分支流程，提高效率

将需要管理的 git 仓库 url 放在 repos_manifest.xml 中，如：

<manifest>
    <project name="Repos3" git="[email protected]:chiclaim/Repos.git" />
    <project name="Repos2" git="[email protected]:chiclaim/Repos.git" />
    <project name="Repos1" git="[email protected]:chiclaim/Repos.git" />
</manifest>

一般 iOS、Android 都是模块化开发，可以将脚本文件 repos.py 和 repos_manifest.xml 拷贝到主工程 根目录，然后提交。

第一次同步代码时，其他仓库默认会使用当前仓库所在的分支：repos sync

例如，你的项目名字叫做 GitHubClient，这个是你的主工程，你的代码是多模块组成的（非单工程）的。GitHubClient 这个主工程依赖其他模块。

所有的仓库在 repos_manifest.xml 中配置：

<manifest>
    <!--主工程-->
    <project name="Repos1" git="[email protected]:chiclaim/GitHubClient.git" />
    <!--趋势模块-->
    <project name="Repos3" git="[email protected]:chiclaim/Trending.git" />
    <!--用户模块-->
    <project name="Repos2" git="[email protected]:chiclaim/User.git" />
    <!--省略其他模块-->
</manifest>

假设文件 repos.py 和 repos_manifest.xml 已经在你的 GitHubClient 根目录 了

如果是第一次拉代码，首先克隆主工程：

git clone -b your_branch [email protected]:chiclaim/GitHubClient.git GitHubClient

然后进入 GitHubClient 目录，执行如下命令：

repos sync

此时，你需要查看所有模块的分支情况，可以使用命令：

repos branch

然后你想创建一个 feature 分支，可以使用：

repos cfb new_branch_name -p

然后你可能做了一些修改，添加了一些文件，你可以使用 status 命令，看看你都修改了哪些模块，status命令会清晰的展示，哪些模块需要push，哪些模块没有提交：

repos status

当你提交了所有代码后，你可以通过如下命令，将代码统一 push 带远端：

repos push

同步代码，可以自定义代码输出路径例如：repos sync -d "C:\xxx" 路径为绝对路径

与此同时，还可以指定 branch 例如：repos sync -d "C:\Program Files (x86)" -b master

需要安装 python3，不支持 python2

如果你机器上共存了 python2 和 python3 ，你可能需要修改 shell 脚本 repos 或 bat 脚本 repos.bat

• repos cfb new_branch_name -p

  新的需求，我们需要统一创建 feature 分支（cfb 是 create feature branch 简称），-p 表示推送到远程，没有该选项表示创建本地分支

• repos sync

  同步所有模块代码

• repos pull

  同 repos sync

• repos branch

  聚合展示所有模块的当前分支（一般开发前，要确保所有的模块都在统一的分支上）

• repos status

  聚合展示所有模块的当前状态（哪些模块需要程序员处理）

• repos push

  对所有模块执行 git push

• repos push -u

  如果没有指定跟踪的分支，加上 -u 即可。执行 git push -u remote branch

• repos checkout your_branch_name

  统一切换分支。对所有模块执行 git checkout

• repos merge source_branch

  合并代码，对所有模块执行 git merge

• repos -h

  帮助文档

• repos -c git_command

  对所有模块执行自定义 git 命令，例如: -c git cherry.

• repos -d

  删除本地分支

• repos -r

  删除远程分支

• Windows 系统下命令输出日志没有颜色高亮（可以使用 git bash），Mac 和 Linux 会有颜色高亮展示
• 分组展示当前所有模块的分支详细情况
• 聚合展示当前所有模块的分支情况，快速查看所有模块是否在统一的分支上
• 精确展示 status 日志
• 统一创建 feature 分支
• pull
• push
• 执行自定义 git 命令
• 删除远程、本地分支
• 合并分支