企业官网建设流程全解析

系列工程化收官篇·第38篇。测试篇后，有技术负责人问：“团队有5个人一起开发这个电商Demo，代码老冲突，测试靠吼，怎么做到每天都能自动打包、自动跑测试、自动上架内测？” 这正是DevOps要解决的问题。今天我们将电商Demo接入华为云DevCloud，搭建一套完整的CI/CD流水线：代码提交即触发自动构建、自动测试、自动签名、自动上架AGC内测。我们将解决多分支管理、流水线编排、AGC API鉴权三大工程化难题。全程基于API23，含官方文档未涉及的“流水线YAML配置模板”和“自动化上架脚本”。

一、前言：为什么DevOps是团队开发的“高速公路”？

在单人开发阶段，hdc std install就能搞定一切。但在团队开发中，如果没有DevOps，你会遇到：

1. “在我机器上是好的”：开发环境不一致，导致各种诡异Bug。

2. 集成地狱：到了发版日，大家才合并代码，冲突解决到凌晨。

3. 手工操作失误：手动打包时选错了签名证书，导致上架被拒。

4. 反馈滞后：测试人员拿到包时，已经是三天前写的代码了。

DevOps的核心是自动化和持续反馈。它通过工具链将开发、测试、部署流程串联起来，实现：

• 持续集成（CI）：代码一提交，自动合并、构建、跑测试。

• 持续交付（CD）：测试通过后，自动生成可供发布的包。

• 持续部署（CD）：自动将包部署到测试环境或应用市场。

华为云DevCloud为鸿蒙应用提供了全套的DevOps工具链，与AGC（AppGallery Connect）深度集成，是实现鸿蒙应用自动化的首选。

二、核心概念辨析（CI/CD流程）

一条标准的鸿蒙应用CI/CD流水线包含以下步骤：

三、代码实现：从“手动操作”到“流水线驱动”

3.1 环境准备：DevCloud项目配置

1. 登录华为云控制台，进入DevCloud。

2. 创建项目，选择“鸿蒙应用”模板。

3. 关联代码仓库（如CodeArts Repo或GitHub）。

4. 创建构建任务，选择“空白构建模板”。

3.2 流水线核心：cloudbuild.yaml

这是流水线的灵魂。在项目根目录创建cloudbuild.yaml文件，定义流水线步骤。

version: 2.0 params: # 定义流水线参数，可在DevCloud界面上修改 - name: APP_NAME value: "HarmonyShop" - name: BUILD_TYPE value: "release" # debug或release - name: AGC_API_KEY value: "${AGC_API_KEY}" # 从DevCloud密钥管理服务获取 - name: SIGN_CERT_PATH value: "/opt/certs/release.p12" steps: # 步骤1：拉取代码 - name: checkout kind: git params: url: "https://codearts.repo.com/your-group/harmony-shop.git" branch: "${BRANCH_NAME}" # 动态获取分支名 # 步骤2：准备构建环境 - name: prepare_env kind: shell params: command: | echo "=== 准备构建环境 ===" # 安装Node.js依赖 npm install # 验证DevEco环境 hvigor -v # 清理旧构建产物 rm -rf entry/build entry_test/build # 步骤3：执行代码构建 - name: build_app kind: shell params: command: | echo "=== 开始构建应用 ===" # 使用hvigorw构建APP包 ./hvigorw assembleApp --mode ${BUILD_TYPE} --no-daemon # 验证产物是否存在 ls -lh entry/build/outputs/app/${BUILD_TYPE}/ # 步骤4：运行自动化测试 - name: run_tests kind: shell params: command: | echo "=== 运行自动化测试 ===" # 运行单元测试 ./hvigorw test --mode ${BUILD_TYPE} --no-daemon # 运行UI测试（需要连接模拟器或真机，此处略） # ./hvigorw uiTest --mode ${BUILD_TYPE} --no-daemon allowFailure: true # 允许测试失败，不阻断流水线（生产环境不建议） # 步骤5：签名打包 - name: sign_package kind: shell params: command: | echo "=== 签名应用包 ===" # 使用jarsigner或apksigner对APP进行签名 # 注意：实际签名命令需根据鸿蒙官方工具调整 # 此处仅为示例逻辑 java -jar apksigner.jar sign \ --ks ${SIGN_CERT_PATH} \ --ks-pass pass:${KEYSTORE_PASSWORD} \ --key-pass pass:${KEY_PASSWORD} \ --out ${APP_NAME}_signed.app \ entry/build/outputs/app/${BUILD_TYPE}/${APP_NAME}.app echo "签名完成：${APP_NAME}_signed.app" # 步骤6：上传测试报告 - name: upload_reports kind: shell params: command: | echo "=== 上传测试报告 ===" # 将测试报告上传到DevCloud制品库 # 方便后续查看 cp -r entry/build/reports/* /opt/devcloud/artifacts/ # 步骤7：自动化上架AGC内测 - name: publish_to_agc kind: shell params: command: | echo "=== 开始自动化上架 ===" # 调用AGC OpenAPI上传APP包 curl -X POST "https://connect-api.cloud.huawei.com/api/publish/v2/app-package/upload" \ -H "Authorization: Bearer ${AGC_API_KEY}" \ -F "file=@${APP_NAME}_signed.app" \ -F "appId=${AGC_APP_ID}" \ -F "releaseType=1" # 1表示内测 # 提交内测审核 curl -X POST "https://connect-api.cloud.huawei.com/api/publish/v2/app-release/submit" \ -H "Authorization: Bearer ${AGC_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "appId": "${AGC_APP_ID}", "releaseType": 1, "testAccounts": ["test1@example.com", "test2@example.com"] }' echo "上架请求已提交，请前往AGC查看内测状态" # 步骤8：通知 - name: notify kind: notification params: type: email # 或wechat, sms receivers: ["team@example.com"] subject: "【CI/CD】${APP_NAME} 构建成功" content: | 构建版本：${BUILD_NUMBER} 分支：${BRANCH_NAME} 状态：成功 下载链接：${ARTIFACT_URL} 内测链接：${AGC_BETA_URL}

3.3 AGC API鉴权与配置

要实现自动化上架，需要获取AGC的API Key：

1. 登录AGC控制台，进入“用户与权限” -> “API Key管理”。

2. 创建API Key，下载私钥文件（JSON格式）。

3. 在DevCloud的密钥管理服务中，导入该JSON文件，命名为AGC_API_KEY。

4. 在流水线中通过${AGC_API_KEY}引用。

注意：API Key具有极高权限，务必妥善保管，不要硬编码在代码中。

3.4 分支管理策略

推荐使用Git Flow或GitHub Flow：

• main/master：生产分支，仅包含已发布代码。

• develop：开发主干，日常开发在此分支。

• feature/*：功能分支，从develop拉取，开发完成后合并回develop。

• release/*：发布分支，从develop拉取，用于测试和修复Bug，完成后合并回main和develop。

• hotfix/*：热修复分支，从main拉取，用于紧急修复线上Bug。

流水线触发规则：

• Push触发：任何代码推送到develop或feature/*分支时，触发CI流水线（构建+测试）。

• Merge Request触发：向main分支发起合并请求时，触发完整的CD流水线（构建+测试+签名+上架内测）。

• 定时触发：每天凌晨2点，触发全量构建和测试，确保代码健康。

四、踩坑记录（官方文档没写的DevOps细节）

1. 构建环境差异：DevCloud的构建环境可能与本地环境不同（如Node.js版本、SDK路径）。务必在流水线中显式指定环境变量，并使用hvigorw clean清理缓存。

2. 签名证书管理：签名证书（.p12）和密码不能提交到代码仓库。必须使用DevCloud的密钥管理服务或凭据管理功能，在流水线运行时动态注入。

3. AGC API限流：AGC OpenAPI有调用频率限制（QPS）。在流水线中批量上传文件或提交审核时，需要添加适当的延时（sleep 2），避免被限流。

4. 测试设备依赖：UI测试和分布式测试需要真实的物理设备。DevCloud提供了云测服务，可以租用云端设备池。但成本较高，建议仅在关键节点（如发布前）使用，日常开发使用模拟器或本地设备。

5. 流水线权限：确保DevCloud项目的服务账号有足够的权限访问AGC、代码仓库和制品库。权限不足会导致流水线在最后一步失败，非常令人沮丧。