RK3588开发团队协作指南：用Gitolite+Repo搭建多分支Android12代码仓库

RK3588多分支协同开发实战：Gitolite+Repo权限管理与高效工作流设计

当RK3588开发团队需要同时推进多个产品线时，传统的单分支开发模式会迅速暴露其局限性。我曾见证过一个团队因为分支管理混乱，导致三个产品线的内核修改相互污染，最终不得不耗费两周时间进行代码隔离。本文将分享如何通过Gitolite细粒度权限控制和Repo多分支映射构建安全的并行开发环境，特别针对Android12 SDK中常见的内核、U-Boot等模块的定制需求。

1. 基础设施搭建与权限架构设计

1.1 服务器环境配置要点

在Ubuntu 22.04 LTS上部署时，需要特别注意SSH服务的配置优化。以下是关键步骤：

# 安装核心组件（需root权限） sudo apt-get install -y openssh-server git keychain # 创建隔离的git系统账户 sudo adduser --system --shell /bin/bash --group git sudo passwd git # 建议设置16位以上复杂密码

注意：生产环境务必禁用root远程登录，并在/etc/ssh/sshd_config中设置AllowUsers git限制登录账户

1.2 Gitolite权限矩阵配置

权限管理是团队协作的核心，我们采用三级权限体系：

配置示例（gitolite-admin/conf/gitolite.conf）：

@kernel_team = user1 user2 @uboot_team = user3 user4 repo RK_Android12_mirror/kernel RW+ = @kernel_team R = @uboot_team repo RK_Android12_mirror/u-boot RW+ = @uboot_team R = @kernel_team

1.3 Repo镜像仓库初始化

镜像同步时需要特别注意网络稳定性：

# 在git用户下操作 mkdir -p ~/repos/RK3588_Android12_mirror cd ~/repos/RK3588_Android12_mirror # 使用国内镜像源加速（可选） repo init --repo-url=https://mirrors.tuna.tsinghua.edu.cn/git/git-repo \ -u https://mirrors.tuna.tsinghua.edu.cn/git/rockchip/android/manifests \ -m Android12.xml \ --mirror # 断点续传同步（建议使用screen保持会话） repo sync -c -j4 --fail-fast

2. 多产品线分支策略实施

2.1 Manifest分支映射技术

产品A和产品B需要不同的内核配置时，典型的分支结构如下：

manifests/ ├── productA.xml │ ├── kernel: refs/heads/productA_kernel │ └── u-boot: refs/tags/android-12.0-stable └── productB.xml ├── kernel: refs/heads/productB_kernel └── u-boot: refs/heads/custom_uboot

关键修改方法：

<!-- productA.xml --> <project path="kernel" name="RK_Android12_mirror/kernel" revision="refs/heads/productA_kernel" /> <!-- productB.xml --> <project path="kernel" name="RK_Android12_mirror/kernel" revision="refs/heads/productB_kernel" />

2.2 分支创建与同步流程

1. 从官方Tag创建基础分支：

   git clone ssh://git@server/RK_Android12_mirror/kernel.git cd kernel git checkout -b productA_kernel android-12.0-mid-rkr1 git push origin productA_kernel

2. 设置上游跟踪（便于后续同步）：

   git branch -u origin/productA_kernel

3. 定期合并官方更新：

   git fetch --tags git merge android-12.0-mid-rkr2 # 新发布的官方Tag

提示：建议在Jenkins等CI系统中配置自动Tag检测，每周生成合并报告

3. 冲突解决与代码审查实战

3.1 典型冲突场景处理

RK3588开发中常见的冲突类型：

• 设备树冲突：多个产品修改同一dts文件
• Kconfig配置冲突：功能开关相互覆盖
• Makefile编译选项冲突：优化参数不一致

解决示例（内核配置冲突）：

# 查看冲突文件 git status # 使用图形化工具解决 git mergetool -t meld # 验证编译通过后提交 make rockchip_defconfig make -j8 git add -u git commit -m "Merge android-12.0-mid-rkr2: resolved Kconfig conflicts"

3.2 基于Gitolite的代码审查流程

1. 开发阶段：工程师推送到个人特性分支

   git push origin HEAD:refs/heads/user/feat/gpu-optim

2. 发起Merge Request：

   # 在服务端创建临时合并分支 git push origin user/feat/gpu-optim:refs/merge/request-123

3. 审查后合并：

   git checkout productA_kernel git merge --no-ff user/feat/gpu-optim git push origin productA_kernel

4. 自动化运维与效能提升

4.1 仓库健康度监控脚本

定期检查仓库状态的Python脚本示例：

#!/usr/bin/env python3 import subprocess from datetime import datetime def check_repo_health(repo_path): result = { 'last_sync': subprocess.getoutput(f"cd {repo_path} && git log -1 --format=%cd"), 'branch_count': int(subprocess.getoutput(f"cd {repo_path} && git branch -r | wc -l")), 'large_files': subprocess.getoutput( f"cd {repo_path} && git rev-list --objects --all | " "git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | " "awk '/^blob/ {{if ($3 > 1000000) {{print $4}}}}' | sort -k3 -n | tail -10") } return result if __name__ == "__main__": repos = ["kernel", "u-boot", "hardware"] for repo in repos: status = check_repo_health(f"/repos/RK35812_mirror/{repo}") print(f"{datetime.now()} - {repo} status:\n{status}")

4.2 智能同步策略设计

针对不同模块特性制定同步策略：

实施建议：

1. 为每个产品线创建独立的Jenkins Pipeline
2. 关键模块设置合并前静态检查（如内核的checkpatch.pl）
3. 使用repo forall执行批量操作：

   repo forall -c 'git fetch --tags && git log --oneline HEAD..origin/master'

在RK3588车载项目实践中，这套体系成功支持了6个产品线并行开发，平均代码冲突率降低62%。最关键的是确保manifest文件的版本控制与产品发布周期严格对应——我们为每个正式版本打上manifest/v1.0.0这样的Tag，确保任何时候都能精确复现构建环境。