AGC项目的git管理心得
需要退到Application的上级目录中手动git建立仓库，然后再推送到远程。这样以后CloudProgram模块中的变化也可以推送到远程了，并且直接从远程拉取项目也可以识别出模块，整体项目结构没有问题。DevEco Studio建立的端云一体化项目建立git仓库默认只记录Application目录，不记录CloudProgram目录。以上内容均为个人见解，如有问题欢迎讨论、斧正😄😄。
在使用 DevEco Studio 开发端云一体化项目时，不少开发者会在 Git 版本管理环节踩一个 “隐形坑”—— 项目默认的双模块结构（端侧Application、云侧CloudProgram），很容易因为 Git 仓库的初始化位置不对，导致云侧模块 “消失”。
这类项目的核心结构是 “端云分离但协同”：Application承载 App 的界面、端侧逻辑，CloudProgram则负责云函数、云数据库等后端能力，两者都是项目不可分割的部分。但实际操作中，很多人（包括我最初）会默认跟着 IDE 的提示，直接在Application目录下初始化 Git 仓库 —— 这就会让 Git 的追踪范围被限制在端侧目录内，CloudProgram完全处于版本管理的 “盲区”。
这种操作的隐患不会立刻显现：本地开发时，两个模块都在本地目录里，功能运行不会出问题；可一旦需要推送远程仓库、或者团队成员拉取项目，问题就会爆发 —— 远程仓库里只有Application的代码，CloudProgram根本没被同步，其他人拉取后打开项目，DevEco Studio 会直接弹出 “CloudProgram 模块找不到” 的报错，哪怕手动新建CloudProgram目录，也会因为缺少模块配置文件，导致端云协同逻辑失效（比如端侧调用云函数时提示 “找不到对应云资源”）。我之前就因为这个问题折腾了半天，最后还是在华为开发者论坛翻到类似案例才摸清原因。
解决这个问题的关键，是把 Git 仓库的 “根” 放到项目的最上级目录（也就是同时包含Application和CloudProgram的那个父目录，比如我示例里的just-test目录），具体操作其实很简单：
- 先退出当前的
Application目录，回到项目根目录（可以在文件管理器里定位，或者在 DevEco Studio 的终端里用cd ..命令回退）；
- 删掉
Application目录下已有的.git文件夹（如果之前误初始化过，注意先备份已提交的代码）；
- 在根目录打开终端，执行
git init初始化仓库，再创建.gitignore文件（记得加上idea/、.hvigor/、node_modules/这些 IDE 或依赖的冗余目录，避免提交无关文件）； - 执行
git add .把Application和CloudProgram的所有文件加入暂存，提交并关联远程仓库推送。
这么操作后，不仅CloudProgram的所有修改会被 Git 正常追踪，后续团队成员从远程克隆项目时，能直接拿到完整的端云双模块结构 ——DevEco Studio 会自动识别两个模块的配置，不需要手动调整模块路径，项目打开就能直接运行。更重要的是，端侧和云侧的代码版本能保持统一，后续分支管理、版本回滚时，不会出现 “端侧是新版本，云侧是旧版本” 的协同冲突。
其实这个问题本质是 “仓库范围和项目结构不匹配”，只是 DevEco Studio 的端云一体化项目结构比较特殊，容易让开发者忽略仓库根目录的选择。如果大家在这类项目的版本管理里遇到其他问题，也欢迎一起讨论～
讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。
更多推荐
1
0- 0
已为社区贡献1条内容
所有评论(0)