孵化仓开发者使用指导

本指南旨在帮助孵化仓开发者使用自动化补丁合入方案，将临时修改的补丁应用到主线仓库中。

准备工作

在开始之前，请确保满足以下准备工作：

1. 确保已安装 Python 3.x，并且可以在命令行中执行 Python 脚本。

2. 确保拥有以下文件：

   • repositories.json：配置文件，包含主线仓库和孵化仓库的信息。
   • patches.json：补丁描述文件，指定补丁文件与主线仓库的对应关系。
   • apply_patches.py：补丁应用脚本，门禁统一维护，孵化仓开发者无需关注。

3. 确保在 repositories.json 文件中正确配置主线仓库和孵化仓库的信息。确保每个项目都有正确的名称和路径。

使用步骤

按照以下步骤使用自动化补丁合入方案：

1. 在主线仓库中制作补丁文件：

   • 在主线仓库工作目录中进行所需的修改和调整。
   • 使用适当的工具（如 git diff 或 git format-patch）生成主线仓库的补丁文件。
   • 将生成的补丁文件保存到一个临时目录。

2. 将补丁文件归档到首个孵化仓（例如incubator_repo1）的 patches 目录：

   • 将制作的补丁文件复制到首个孵化仓的 patches 目录中。
   • 确保将每个补丁文件放置在正确的孵化仓库目录下。

   ➜  incubator_repo1 tree                     
   .
   ├── BUILD.gn
   ├── main.cpp
   └── patches
       ├── ability_lite.patch     # 主线仓 ability_lite 补丁
       ├── ace_engine_lite.patch  # 主线仓 ace_engine_lite 补丁
       ├── inputmethod_imf.patch  # 主线仓 inputmethod_imf 补丁
       ├── ui_appearance.patch    # 主线仓 ui_appearance 补丁           
       ├── repositories.json      # 主线仓库和孵化仓库的信息描述文件
       └── patches.json           # 主线仓库的补丁配置描述文件    

3. 运行以下命令来应用补丁，门禁统一处理，孵化仓开发者无需关注：

   python apply_patches.py

   执行此命令将自动解析 repositories.json 和 patches.json 文件，并将补丁应用到相应的主线仓库中。

4. 完成补丁应用后，可以继续进行整体编译构建和孵化仓功能验证的步骤，门禁统一处理，孵化仓开发者无需关注。

注意事项

• 在使用自动化补丁合入方案时，请确保 repositories.json 和 patches.json 文件的格式正确，并且路径信息与实际项目配置一致。

• 在制作主线仓库的补丁文件时，请仅包含您所需的修改。确保补丁文件不包含与孵化仓库无关的更改或敏感信息。

• 在归档补丁文件到首个孵化仓（例如incubator_repo1）的 patches 目录时，请确保将每个补丁文件放置在正确的孵化仓库目录下。这样在应用补丁时才能找到对应的文件。

• 如果有多个补丁文件需要应用，可以重复制作补丁文件和归档操作，将所有补丁文件都放置在 patches 目录下。