非Android环境下Git Repo入门及常见实操问题咨询

针对你在非Android场景下使用Repo工具遇到的疑问，逐一解答如下：

1. 是否应将manifest.xml文件放置在MOM项目中？ #

建议单独创建一个manifest仓库来存放default.xml（或manifest.xml），而非放在MOM项目内。Repo的设计逻辑是通过独立的manifest仓库统一管理所有子项目（包括MOM）的配置，避免“先克隆MOM才能拿到manifest”的循环依赖问题。

如果特殊场景下必须将manifest放在MOM中，也可以通过repo init -u <MOM_SSH_URL> -m <manifest相对路径>指定，但这种方式会增加团队协作的复杂度，不推荐。

2. .repo目录应位于何处？是否需要提交到MOM仓库？它是否属于MOM的一部分？ #

• .repo是Repo生成的本地元数据目录，必须放在所有项目的顶层父目录下（即MOM、ALICE、BOB、CHARLIE所在的同级根目录）。
• 绝对不能提交到任何Git仓库，它不属于MOM或任何子项目，仅用于本地Repo工具管理多仓库的状态，包含manifest缓存、Repo核心代码、子仓库的Git裸库等内容。

3. MOM是否必须与REPO项目分离？ #

不需要。可以将MOM作为Repo管理的子项目之一，在manifest文件里定义MOM的条目，指定其克隆URL和本地路径为.（即顶层目录），这样整个工作区的所有项目（MOM+三个子项目）都由Repo统一管理。

示例manifest片段：

<manifest>
  <project name="MOM" path="." remote="origin" revision="PRODUCT_NAME" />
  <project name="ALICE" path="ALICE" remote="origin" revision="PRODUCT_NAME" />
  <project name="BOB" path="BOB" remote="origin" revision="PRODUCT_NAME" />
  <project name="CHARLIE" path="CHARLIE" remote="origin" revision="PRODUCT_NAME" />
</manifest>

4. 已知MOM的SSH Git克隆URL，团队新成员应如何使用REPO检出项目？ #

假设manifest已放在独立的仓库（推荐方式），新成员操作步骤如下：

1. 创建并进入工作区目录：

   mkdir mom-workspace && cd mom-workspace
   

2. 初始化Repo，指定manifest仓库的SSH地址：

   repo init -u <MANIFEST_REPO_SSH_URL>
   

3. 同步所有项目：

   repo sync
   

如果manifest放在MOM仓库根目录（名为default.xml），则初始化命令改为：

repo init -u <MOM_SSH_URL> -m default.xml

同步完成后，顶层目录会包含MOM的内容，以及ALICE、BOB、CHARLIE三个子目录。

5. 我们希望使用标准Git特性分支工作流，至少在子项目中创建特性分支，是否也需要在MOM中创建特性分支？ #

是否在MOM创建特性分支取决于开发需求：

• 如果特性开发不需要修改MOM的构建脚本或顶层内容，仅需在对应子项目（如ALICE）中创建特性分支即可，无需操作MOM。
• 如果特性开发涉及MOM的代码变更，则需要在MOM中创建对应的特性分支，可通过repo start <分支名> MOM快速创建，本质是调用Git的checkout -b命令。

Repo支持批量创建特性分支，比如给ALICE和BOB创建feature/payment分支：

repo start feature/payment ALICE BOB

开发阶段的Git特性分支操作完全可以在子仓库中按标准流程执行，Repo只是提供多仓库批量管理的便利。

6. 我了解到REPO通常与GERRIT配合使用，但我们使用其他Git web解决方案，这会有问题吗？ #

完全没问题。Repo只是多仓库管理工具，与代码评审平台无强绑定。你可以使用GitLab、GitHub、Bitbucket等任意Git托管平台，提交代码时直接在子仓库执行git push即可；若需批量推送，可调整repo push的参数适配你的平台（不过直接用Git命令更直观）。

7. 开发阶段我们计划将产品代码放在PRODUCT_NAME分支上，从该分支创建特性分支，最终合并回PRODUCT_NAME分支；后续创建RELEASE分支并完成收尾工作，最后需要将manifest中的分支改为sha-hash提交（我们称此步骤为“固定提交版本”）。但我了解到REPO更倾向于使用SHAs而非分支，或会将分支转换为SHAs，这是否会影响我们的特性分支工作流？ #

不会影响，两者可以互补使用：

• 开发阶段：在manifest中指定子项目的revision为PRODUCT_NAME分支，repo sync会拉取各子项目该分支的最新代码。你可以正常基于该分支创建特性分支开发，合并回PRODUCT_NAME后，其他成员执行repo sync即可获取最新代码。
• 发布阶段：需要固定版本时，将manifest中每个子项目的revision从分支名替换为对应的提交SHA值，后续repo sync会精确拉取这些固定提交，不会随分支更新而变化。

Repo同步时会将分支名解析为SHA缓存，这只是内部机制，不会干扰你在开发阶段使用分支进行常规Git操作。

内容的提问来源于stack exchange，提问作者user3696153