RK Android 仓库 Git 分支命名规则

命名结构可视化

主分支：安卓版本:Android11
        └── 版型分支：Androidx-具体版型
                              └── 客户版型定制分支1：
                                  Androidx-具体版型-客户简称1-定制功能简称1-版本号1
                              └── 客户版型定制分支2：
                                  Androidx-具体版型-客户简称2-定制功能简称1-版本号1

---

分支管理及代码提交原则

1. 通用功能和问题修复
   • 如果代码修改适用于多个硬件版型或具有通用性，应提交到 主分支 或 版型分支，根据其适用范围选择合适的分支。
2. 客户定制需求
   • 针对客户的定制需求，应在对应的 版型分支 上派生出 客户版型定制分支，在该分支中进行修改和维护。
3. 已有客户版型定制分支的修改
   • 在修改 客户版型定制分支 的代码之前，应先检查 主分支 和 版型分支 是否有尚未同步的提交。如果有新的提交，应先将这些改动应用到 客户版型定制分支 后，再进行进一步修改。
4. 提交同步的责任划分
   • 主分支 和 版型分支 的提交者不应主动将代码同步到下一级分支（如 客户版型定制分支）。
   • 下一级分支（如 客户版型定制分支）的维护者应主动检查上一级分支的更新，并决定是否同步改动。这种方式可以确保测试的及时性，同时减轻 主分支 和 版型分支 提交者的工作负担。

---

详细说明

1. 主分支

主分支用于存放适用于通用硬件和软件的代码提交，包含整体项目的基础代码。

• 命名格式：

  安卓版本
  

• 示例：
  • Android11：Android 11 主分支。
  • Android13：Android 13 主分支。

---

2. 版型分支

版型分支是从主分支派生的，存放针对具体版型的硬件和软件改动。每个版型分支对应一个具体的硬件版型。

• 命名格式：

  安卓版本-版型-具体版型
  

• 示例：
  • Androidx-HW-T3568I：针对硬件版型 HW-T3568I 的版型分支。

---

3. 客户版型定制分支

客户版型定制分支是从版型分支派生的，存放客户在具体版型分支上不同的定制代码。这些分支用来管理不同客户的个性化需求。

• 命名格式：

  安卓版本-版型-具体版型-客户-客户的定制分支-版本号
  

• 命名规则说明：
  • 版型-具体版型 表示版型名称（如 HW-T3568I）。
  • 客户简称 表示客户的名称缩写。
  • 定制功能简称 表示客户定制的功能的简短描述。
  • 版本号 用数字标识（如 01 表示版本 1）。
• 示例：
  • Androidx-HW-T3568I-lzxy-kgbs-01：针对硬件版型 HW-T3568I，客户lzxy的kgbs客户的定制功能，版本号为 01。

---

Android 设置中版本号命名规则

• 显示位置：系统设置 -> 关于平板电脑 -> 版本号
• 命名规则：客户无特殊要求情况下，按分支名+日期进行命名
• 示例：

  Android11-HW-T3568I-factorytest-LvdsEdp_Dualeth-01-20250117