鸿蒙生态中rps的工程化脚本治理实践

1. 项目概述：rps 在鸿蒙生态中的定位与价值

在鸿蒙应用开发过程中，我们经常面临这样的困境：一个中等规模的 Flutter for HarmonyOS 项目可能包含数十个构建脚本，散落在工程目录的各个角落。这些脚本往往需要处理：

• 多环境 HAP 包构建（debug/release/profile）
• 自动化签名与设备安装
• 多端资源同步（手机/平板/智慧屏）
• CI/CD 流水线集成

传统做法会导致三个典型问题：

1. 维护黑洞：脚本位置分散，新人难以快速掌握全貌
2. 平台割裂：Windows/macOS/Linux 下的脚本语法差异
3. 执行风险：手动输入长命令易出错，特别是涉及敏感操作时

rps 的解决方案是通过 YAML 声明式编程，将脚本治理提升到工程化层面。其核心创新点在于：

• 配置即文档：pubspec.yaml 中的 scripts 字段自然形成项目自动化任务的权威文档
• 跨平台路由：自动识别宿主操作系统，执行对应的命令变体
• 参数化设计：支持运行时动态注入变量，适应鸿蒙多设备场景

提示：在华为某实际鸿蒙项目中，采用 rps 后脚本维护工时降低 72%，新成员上手速度提升 3 倍

2. 核心原理与架构设计

2.1 任务调度引擎工作原理

rps 的运行时行为可以分解为以下阶段：

dart复制sequenceDiagram
    participant User
    participant rps CLI
    participant pubspec.yaml
    participant Shell

    User->>rps CLI: rps build:harmony
    rps CLI->>pubspec.yaml: 解析 scripts 字段
    pubspec.yaml-->>rps CLI: 返回原始命令(如"flutter build hap")
    rps CLI->>rps CLI: 平台适配处理
    rps CLI->>Shell: 执行最终命令
    Shell-->>User: 返回执行结果

关键技术实现包括：

1. YAML 指纹识别：通过 dart:yaml 库解析 scripts 字段时，会智能处理以下变体：

   • 单行字符串命令
   • 多行命令序列（按定义顺序执行）
   • 平台特定指令（通过 platform: 前缀区分）

2. 环境变量注入：自动加载项目根目录下的 .env 文件，支持 ${VAR} 形式的变量替换，这对鸿蒙签名密钥管理特别重要

3. 错误传播机制：采用 Dart 的 Zone 捕获子进程异常，确保链式命令中任一环节失败都会终止后续执行

2.2 鸿蒙特色适配方案

针对 HarmonyOS 的特殊需求，rps 实现了以下增强：

| 鸿蒙需求 | rps 解决方案