掌握 Hvigor 命令行构建、搭建 Jenkins/GitLab CI 流水线、落地多环境配置与自动化测试、实现一键签名打包发布一、前置思考从手动发版到流水线交付1.1 手动发版的痛点手动环节风险耗时本地构建环境差异“我这能跑”10 分钟手动测试遗漏回归数小时手动签名密钥泄露/混淆分钟级手动发布版本错乱分钟级核心认知手动流程的每一步都是不确定性的来源——环境差异、漏测、人为失误。CI/CD 的价值不是快而是确定性同样的代码永远产出同样的产物。1.2 CI/CD 的价值维度手动CI/CD构建一致性依赖本地环境统一环境回归保障靠自觉自动化必测发布速度天级分钟级可追溯无全链路记录质量门禁无自动拦截二、核心原理流水线阶段2.1 标准流水线代码提交 → 触发流水线 │ ├─ Stage1 静态检查: Lint / 代码规范 ├─ Stage2 单元测试: 关键模块单测 ├─ Stage3 构建: Hvigor 命令行出包 ├─ Stage4 自动化测试: UI/性能压测 ├─ Stage5 质量门禁: 崩溃率/体积/性能阈值 ├─ Stage6 签名打包: 自动签名 ├─ Stage7 发布: 上传商店/分发平台 └─ Stage8 通知: 结果推送团队2.2 流水线设计的核心原则原则说明快反馈提交 10 分钟内出结果门禁前置便宜的门禁放前面并行化独立阶段并行执行可重放同一提交可重复构建产物不可变构建产物带版本指纹三、源码/API 深度解析核心能力3.1 Hvigor 命令行构建# 命令行构建CI 无 UI 环境hvigorw clean# 清理hvigorw assembleHap# 构建 HAPhvigorw assembleHap--modemodule-pproductdefault hvigorw signHap# 签名hvigorw--sync# 同步工程# 常用参数hvigorw assembleHap--parallel# 并行hvigorw assembleHap--daemon# 守护进程hvigorw assembleHap--modemodule# 模块级hvigorw assembleHap-pbuildModerelease# 构建模式CI 关键命令行构建必须可重复、无交互——所有参数通过命令行/配置文件传入。3.2 多环境配置不同环境debug/test/release需要不同配置// build-profile.json5 多环境 { app: { products: [ { name: dev, signingConfig: dev_sign, compatibleSdkVersion: 5.0.0(12), runtimeOS: HarmonyOS, buildModeSet: [{ name: debug }] }, { name: test, signingConfig: test_sign, buildModeSet: [{ name: release }] }, { name: release, signingConfig: release_sign, buildModeSet: [{ name: release }] } ] } }环境矩阵维度devtestreleaseAPI 地址测试环境测试环境生产环境日志级别debuginfowarn混淆关开开签名dev 证书test 证书release 证书崩溃上报全量全量采样3.3 自动化测试集成// 单元测试ohosTestimport{describe,it,expect}fromohos/hypium;exportdefaultfunctionorderTest(){describe(OrderDomainTest,(){it(calc_total_correct,0,(){consttotalcalcOrderTotal([100,200,300]);expect(total).assertEqual(600);});it(discount_apply,0,(){consttotalcalcOrderTotal([100],0.8);expect(total).assertEqual(80);});});}# 命令行跑测试hvigorwtesthvigorw ohosTestCI 测试分层层级内容速度单测领域逻辑/工具秒级组件测试组件交互分钟级UI 测试页面流程分钟级性能压测启动/内存/卡顿十分钟级3.4 签名管理实践说明证书分环境dev/test/release 独立证书密钥保护证书放 CI 密钥库, 不进代码仓库自动签名流水线内 signHap 自动签名签名校验发布前自动校验签名证书过期监控到期前告警四、企业级实战流水线搭建4.1 Jenkins / GitLab CI 架构Git 提交 (Merge Request) │ 触发 webhook ▼ CI Runner (构建机) ├─ Stage1 lint (静态检查) ├─ Stage2 unit test (单测) ├─ Stage3 assemble (Hvigor 构建) ├─ Stage4 ui test (UI 自动化) ├─ Stage5 perf gate (性能门禁) ├─ Stage6 sign (自动签名) └─ Stage7 publish (发布 通知)4.2 质量门禁矩阵门禁规则拦截级别编译编译失败阻断单测通过率 95%阻断Lint严重告警 0阻断体积超基线 2MB告警性能启动超基线阻断崩溃回归版本对比阻断4.3 多版本并行构建同一时间多个分支同时构建: develop 分支 → dev 包 (每日) release/1.3 分支 → test 包 (提测) master 分支 → release 包 (发布) hotfix 分支 → 热修包 (紧急)并行策略每个 MR 触发独立流水线分支合并前必须门禁全绿发布分支锁定只允许合并经过验证的代码。4.4 持续交付闭环开发 → 提测包(自动) → 测试通过 → 灰度包(自动) → 灰度监控(崩溃/性能) → 全量发布(自动) → 回滚预案环节自动化程度提测包100% 自动灰度发布自动 人工确认全量发布自动 门禁回滚一键回滚版本表五、排查与优化流水线效率5.1 流水线瓶颈定位瓶颈特征对策构建慢Stage3 耗时 60%编译缓存/并行第 38 篇联动测试慢全量测试耗时长分层 并行 增量环境不稳定偶发失败环境容器化门禁误报频繁告警阈值校准排队构建机不足扩容/负载均衡5.2 高频坑点速查构建是否可重复无交互/无本地依赖证书/密钥是否安全存储不进代码库是否按环境分离了配置门禁是否前置便宜的先跑单测是否覆盖关键模块性能门禁是否有基线对比构建产物是否带版本指纹是否支持一键回滚流水线是否并行化通知是否及时失败即提醒六、总结与进阶6.1 收益模型参考实测指标手动CI/CD发版周期3 天4 小时回归缺陷率8%1.2%构建一致性不保证100%发布回滚手动一键团队等待阻塞式异步6.2 工程规范一切可脚本化构建/测试/签名/发布全部脚本化门禁强制质量门禁是发布的唯一通行证环境隔离dev/test/release 严格隔离可追溯每个产物对应代码提交哈希持续演进流水线本身纳入版本管理。6.3 进阶方向流水线即代码Jenkinsfile/GitLab CI 配置入库容器化构建Docker 统一构建环境性能门禁自动化压测脚本接入第 41 篇联动自动发版机器人版本/更新日志自动生成。附Demo 演示说明Tab演示内容 流水线8 阶段流水线可视化 门禁关卡演示️ Hvigor CLI命令行构建命令速查 执行模拟 多环境dev/test/release 环境配置矩阵对比 自动化测试单测/UI/性能测试分层 门禁规则 发布管理签名/灰度/全量/回滚 发布流程演示