基于鸿蒙OS开发静脉输液智能监控系统（22）-部署发布与未来迭代规划

目录

• 1. 应用签名与发布
  • 1.1 signingConfigs配置
  • 1.2 HAP/APP打包
  • 1.3 华为应用市场发布流程
• 2. 当前MVP状态总结
  • 2.1 已实现功能清单
  • 2.2 Mock/Stub服务清单
  • 2.3 已知限制
• 3. 降级功能映射表
• 4. 迭代路线图
  • 4.1 V1.1：OpenCV NAPI真实集成
  • 4.2 V1.2：护士站服务端+跨设备推送
  • 4.3 V1.3：云端数据同步
  • 4.4 V1.4：手表端伴生应用
  • 4.5 V2.0：AI深度学习模型
• 5. OpenCV交叉编译
  • 5.1 HarmonyOS NDK环境
  • 5.2 OpenCV库裁剪
  • 5.3 CMake配置
  • 5.4 NAPI绑定
• 6. 服务端架构设计
  • 6.1 WebSocket实时通信
  • 6.2 RESTful API设计
  • 6.3 数据库设计
• 7. 数据合规与医疗认证
  • 7.1 医疗器械软件分类
  • 7.2 数据安全等级
  • 7.3 隐私合规要求
• 8. 商业模式
  • 8.1 贴纸硬件销售
  • 8.2 医院B2B部署
  • 8.3 增值服务订阅
• 9. 开源贡献与社区

1. 应用签名与发布

HarmonyOS应用在安装到真机或发布到应用市场之前，必须经过数字签名。签名机制确保了应用的完整性校验和来源可信度，是HarmonyOS安全体系的核心环节之一。IVGuard作为一款面向医疗场景的应用，签名配置的严谨性不仅关乎技术合规，更直接影响后续医疗器械软件注册的审计链路。本章节将详细讲解HarmonyOS签名体系的工作原理、配置方法以及IVGuard项目特有的签名策略。

1.1 signingConfigs配置

HarmonyOS的签名体系分为debug签名和release签名两种模式，它们在密钥来源、安全级别和适用场景上存在本质区别。理解这两种签名模式对于正确配置构建流水线至关重要。

1.1.1 Debug签名：自动生成

在开发调试阶段，DevEco Studio会自动为项目生成debug签名配置。开发者在首次创建项目或连接真机运行时，IDE会自动生成一个临时的签名证书，其特征如下：

• 自动生成：无需手动操作，DevEco Studio在检测到设备连接时自动完成签名
• 证书类型：自签名证书（Self-signed Certificate）
• 有效期：默认1年，过期后需重新生成
• 适用范围：仅限于开发调试，无法用于应用市场发布
• 安全级别：低，密钥存储在本地开发环境

Debug签名的自动生成流程如下：

DevEco Studio 检测无签名配置 → 自动调用 keytool 生成 .p12 密钥库 → 自动生成 .cer 证书文件 → 自动写入 build-profile.json5 的 signingConfigs → 构建时自动使用 debug 签名

在build-profile.json5中，debug签名配置通常表现为：

{ "app": { "signingConfigs": [ { "name": "default", "type": "HarmonyOS", "material": { "certpath": "C:\\Users\\developer\\.ohos\\config\\auto_debug_IVGuard.cer", "storePassword": "0000001A2B3C4D5E6F", "keyAlias": "debugKey", "keyPassword": "0000001A2B3C4D5E6F", "profile": "C:\\Users\\developer\\.ohos\\config\\auto_debug_IVGuard.p7b", "signAlg": "SHA256withECDSA", "storeFile": "C:\\Users\\developer\\.ohos\\config\\auto_debug_IVGuard.p12" } } ] } }

需要注意的是，debug签名的storePassword和keyPassword在文件中以加密形式存储（0000001A...前缀），这是DevEco Studio的安全措施，避免明文密钥暴露在配置文件中。在实际开发过程中，开发者通常不需要关心这些密码，因为IDE会自动处理签名流程。

Debug签名的适用场景包括：

1. 本地开发调试：在开发机上连接真机或模拟器进行调试
2. 自动化测试：CI/CD流水线中的自动化测试构建
3. 内部体验：团队内部成员的体验测试（不对外发布）
4. 功能验证：新功能开发完成后的快速验证

1.1.2 Release签名：需要申请华为开发者证书

Release签名是应用正式发布的前提条件，其密钥和证书必须通过华为开发者平台正式申请，流程远比debug签名复杂。Release签名采用了更高级别的安全机制，确保证书的不可伪造性和应用来源的可信度。

前置条件：

1. 注册华为开发者账号（需实名认证）
2. 完成开发者资质审核（个人/企业）
3. 在AppGallery Connect中创建应用

证书申请流程：

步骤1：登录华为开发者联盟 (developer.huawei.com) → 步骤2：进入"证书管理"页面 → 步骤3：点击"新增证书" → 步骤4：填写证书信息（应用名称、包名、SHA256指纹） → 步骤5：下载 .cer 证书文件 → 步骤6：下载 .p7b Profile 文件（调试/发布Profile） → 步骤7：将证书文件配置到项目中

密钥对生成：

在申请证书之前，需要先本地生成密钥对和CSR（证书签名请求）：

# 使用 OpenHarmony 提供的 keytool 生成密钥对keytool-genkeypair-keyalgEC-keysize256-sigalgSHA256withECDSA\-dname"CN=IVGuard,O=IVGuardTeam,L=Beijing,ST=Beijing,C=CN"\-aliasivguard_release_key\-keystoreivguard_release.p12\-storetypepkcs12\-validity3650# 生成 CSR 文件keytool-certreq-sigalgSHA256withECDSA\-aliasivguard_release_key\-keystoreivguard_release.p12\-fileivguard_release.csr

密钥对生成过程中需要注意以下要点：

1. 密钥算法选择：推荐使用EC（椭圆曲线）算法，密钥长度256位，签名算法SHA256withECDSA。EC算法相比RSA在相同安全强度下密钥更短、签名速度更快
2. 有效期设置：建议设置为10年（3650天），避免频繁更换证书
3. 密钥库密码：设置强密码，至少16位，包含大小写字母、数字和特殊字符
4. DN信息：CN填写应用名称或组织名称，O填写组织名称，C填写国家代码

.p12证书文件 + .cer配置文件的关系：

build-profile.json5中的signingConfigs完整配置：

{ "app": { "signingConfigs": [ { "name": "default", "type": "HarmonyOS", "material": { "certpath": "sign/IVGuard_release.cer", "storePassword": "0000001AXXXXXXXX", "keyAlias": "ivguard_release_key", "keyPassword": "0000001AXXXXXXXX", "profile": "sign/IVGuard_release.p7b", "signAlg": "SHA256withECDSA", "storeFile": "sign/IVGuard_release.p12" } } ] } }

安全最佳实践：

1. 密钥文件管理：.p12文件和密码绝不能提交到版本控制系统，应在.gitignore中添加sign/目录
2. 密码保护：使用环境变量或加密的密钥管理服务存储storePassword和keyPassword
3. 证书轮换：建议每2-3年轮换一次签名证书，避免长期使用同一密钥对
4. 多环境隔离：开发、测试、生产环境使用不同的签名配置

// 多签名配置示例：区分debug和release { "app": { "signingConfigs": [ { "name": "default", "type": "HarmonyOS", "material": { "certpath": "sign/debug.cer", "storeFile": "sign/debug.p12" } }, { "name": "release", "type": "HarmonyOS", "material": { "certpath": "sign/release.cer", "storeFile": "sign/release.p12" } } ] } }

对于IVGuard项目，由于涉及医疗数据处理，在密钥管理方面还需要遵循以下额外规范：

• 审计日志：所有签名操作需记录审计日志，包括签名时间、操作人员、使用的证书信息
• 双控原则：密钥密码应由多人分别保管，防止单人掌控签名权限
• 离线存储：生产签名密钥应存储在离线的硬件安全模块（HSM）中
• 应急方案：准备密钥丢失或损坏时的应急签名方案

1.2 HAP/APP打包

HarmonyOS的构建产物分为HAP包和APP包两种形态，理解它们的区别和适用场景对于正确的发布流程至关重要。打包过程涉及编译优化、资源压缩、代码混淆等多个环节，每个环节的配置都会直接影响最终产物的质量和性能。

1.2.1 assembleHap：生成单个HAP包

HAP（HarmonyOS Ability Package）是HarmonyOS应用的基本部署单元，类似于Android的APK。每个HAP包对应一个模块（Module），包含该模块的代码、资源和配置信息。HAP包是应用安装和运行的最小单位，用户在设备上安装的就是HAP包。

# 使用 hvigorw 命令行构建单个HAP包hvigorw assembleHap--modemodule-pmodule=entry@default-pproduct=default

HAP包结构：

entry-default-signed.hap ├── entry/ # 模块根目录 │ ├── etp/ # 编译后的ETS代码 │ │ ├── entry.etp │ │ └── ... │ ├── resources/ # 资源文件 │ │ ├── base/ │ │ ├── rawfile/ │ │ └── zh_CN/ │ ├── libs/ # 原生库（.so文件） │ │ ├── arm64-v8a/ │ │ └── x86_64/ │ └── module.json # 模块配置 ├── pack.info # 包信息 └── codec.info # 编码信息

IVGuard项目的模块结构：

IVGuard采用单HAP架构（MVP阶段），所有功能集中在entry模块中：

IVGuard/ ├── entry/ # 主模块（HAP包） │ ├── src/main/ets/ │ │ ├── entryability/ # 入口Ability │ │ ├── pages/ # 页面 │ │ ├── components/ # 组件 │ │ ├── services/ # 服务层 │ │ ├── models/ # 数据模型 │ │ └── utils/ # 工具类 │ └── src/main/resources/ # 资源 └── build-profile.json5 # 构建配置

后续版本中，IVGuard计划拆分为多模块架构：entry模块（主入口）、watch模块（手表伴生应用）、vision模块（OpenCV原生库）和common模块（共享服务）。

1.2.2 assembleApp：生成完整APP包

APP包是包含所有模块的完整应用包，用于发布到华为应用市场。它将多个HAP包打包在一起，并附加上应用级别的签名信息。APP包是应用发布的标准格式，包含了应用运行所需的所有资源。

# 构建完整APP包hvigorw assembleApp--modeproject-pproduct=default

APP包结构：

IVGuard-default-signed.app ├── entry.hap # entry模块HAP ├── pack.info # 包信息（含所有模块列表） └── codec.info # 编码信息

HAP与APP的对比：

1.2.3 构建模式：debug/release

HarmonyOS支持多种构建模式，在build-profile.json5的buildModeSet中定义。构建模式决定了编译优化级别、调试信息保留、混淆策略等关键编译参数。

{ "app": { "buildModeSet": [ { "name": "debug", "arkOptions": { "compilerOptions": { "sourceMap": true } } }, { "name": "release", "arkOptions": { "compilerOptions": { "sourceMap": false } } } ] } }

Debug与Release模式的详细差异：

# Debug模式构建hvigorw assembleHap--modemodule-pmodule=entry@default-pbuildMode=debug# Release模式构建hvigorw assembleApp--modeproject-pbuildMode=release

IVGuard项目的构建策略建议：

1. 日常开发：使用debug模式，快速迭代验证
2. 集成测试：使用debug模式但开启部分混淆，提前发现混淆问题
3. 预发布测试：使用release模式，完整验证生产环境行为
4. 正式发布：使用release模式 + 完整混淆 + release签名

1.2.4 代码混淆：release模式启用

Release模式下启用的代码混淆是保护应用逻辑的重要手段。HarmonyOS使用obfuscation-rules.txt文件配置混淆规则。混淆不仅能保护知识产权，还能有效减小包体积。

# obfuscation-rules.txt # 开启顶层名称混淆 -enable-top-level-property-obfuscation # 开启属性名称混淆 -enable-property-obfuscation # 开启文件名混淆 -enable-filename-obfuscation # 开启导出名称混淆 -enable-export-obfuscation # 保留规则：不混淆的名称 -keep-file-name entryability EntryAbility # 保留属性名（序列化相关） -keep-property-name id name level timestamp patientId # 保留全局名称 -keep-global-name IVGuard DataStore CostService # 保留SourceMap输出（便于崩溃分析） -enable-source-map-retention

混淆注意事项：

1. 序列化字段：所有需要JSON序列化/反序列化的字段名必须保留，否则数据解析会失败
2. 反射调用：通过字符串名称动态访问的属性必须保留
3. 跨模块接口：HSP/HAR对外暴露的API名称必须保留
4. 数据库字段：与Preferences或数据库交互的字段名必须保留

IVGuard项目中需要特别注意保留以下字段：

# IVGuard 特有保留规则 -keep-property-name patientId patientName bedNo wardNo ivLevel ivRate drugName drugList interactionPairs totalCost reimburseRate reimburseAmount alertLevel alertType handled timestamp sessionId

混淆后崩溃堆栈的反解是release版本调试的关键技能。HarmonyOS提供了hstack工具用于反解混淆堆栈：

# 使用SourceMap反解混淆堆栈hstack --source-map entry/build/default/outputs/default/entry-default-signed.map\--stack-file crash_stack.txt

1.3 华为应用市场发布流程

华为应用市场（AppGallery）是HarmonyOS应用的官方分发渠道，发布流程涉及开发者账号、应用信息、审核等多个环节。IVGuard作为医疗健康类应用，在发布流程中需要满足额外的合规要求。

1.3.1 开发者账号注册

账号类型选择：

企业开发者所需材料：

1. 营业执照扫描件
2. 组织机构代码证
3. 法人身份证正反面
4. 开发者授权书（非法人申请时）
5. 对公账户信息（用于验证）

IVGuard作为医疗应用的额外要求：

由于IVGuard涉及医疗数据处理，在开发者账号审核时可能需要额外提供：

• 医疗器械软件备案凭证
• 医疗数据安全合规承诺书
• 隐私政策声明文档
• 数据处理流程说明

1.3.2 应用信息填写

在AppGallery Connect中创建应用后，需要填写详细的应用信息：

基础信息：

应用名称：IVGuard - 静脉输液智能监护 应用包名：com.ivguard.app 应用类型：HarmonyOS应用 应用类别：医疗健康 应用标签：医疗监护、输液管理、智能护理 目标API版本：12 最低API版本：12 支持设备：Phone, Tablet 应用图标：512x512 PNG 应用截图：至少3张，推荐5张（1920x1080或1080x1920） 应用描述： IVGuard是一款基于HarmonyOS的静脉输液智能监护系统， 面向患者、护士和家属三端用户。通过视觉识别技术实时 监测输液液位，提供药物相互作用检测、费用预估、远程 监控等功能，助力临床输液安全管理。

版本信息：

版本号：1.0.0 版本描述： - 首个公开发布版本 - 支持患者端、护士端、家属端三角色切换 - 集成50种静脉药物数据库 - 支持医保报销计算（6城市参考数据） - 药物相互作用检测（12组常见配伍禁忌） - 数据本地持久化存储

隐私与权限声明：

IVGuard需要声明的权限及其用途说明：

1.3.3 上传HAP包

# Step 1: 构建release模式的APP包hvigorw assembleApp--modeproject-pbuildMode=release# Step 2: 定位构建产物# 构建产物路径：# entry/build/default/outputs/default/entry-default-signed.hap# 或者完整的APP包：# build/outputs/defaults/IVGuard-default-signed.app# Step 3: 验证包完整性hdc shell bm dump-ncom.ivguard.app# Step 4: 在AppGallery Connect后台上传# 登录 developer.huawei.com -> AppGallery Connect# -> 选择应用 -> 版本信息 -> 上传软件包

包大小优化建议：

1.3.4 审核流程：1-3个工作日

华为应用市场的审核流程分为自动审核和人工审核两个阶段：

提交应用 → 自动审核（即时） ├── 病毒扫描 ├── 安全检测 ├── 兼容性检测 └── 隐私合规检测 → 人工审核（1-3个工作日） ├── 功能完整性验证 ├── 内容合规检查 ├── 权限合理性审核 └── 医疗类应用专项审核 → 审核结果 ├── 通过 → 上架发布 ├── 驳回 → 修改后重新提交 └── 待补充 → 提交额外材料

医疗类应用的审核要点：

1. 功能真实性：声明的医疗功能必须可验证地实现
2. 数据安全：医疗数据的采集、存储、传输必须符合法规要求
3. 用户知情：隐私政策必须清晰告知数据使用方式
4. 风险提示：应用内须声明"本应用仅供辅助参考，不能替代专业医疗判断"
5. 权限最小化：仅申请必要权限，不得过度收集用户信息

常见审核驳回原因及应对：

1.3.5 版本更新：增量更新

HarmonyOS支持多种更新方式，选择合适的更新策略对用户体验至关重要。

全量更新：

// module.json5 中配置版本信息 { "module": { "name": "entry", "type": "entry", "versionCode": 1000000, "versionName": "1.0.0" } }

增量更新（Hot Fix）：

HarmonyOS支持通过动态加载方式实现热修复，无需重新发布完整包：

热修复流程： 1. 发现线上Bug 2. 修改受影响的ETS文件 3. 编译生成补丁包（.pp文件） 4. 上传补丁到分发平台 5. 客户端检测并下载补丁 6. 下次启动时加载补丁代码

版本号管理策略：

IVGuard采用语义化版本号（Semantic Versioning）：

版本号格式：MAJOR.MINOR.PATCH MAJOR：重大架构变更（如V1.x → V2.0） MINOR：新增功能（如V1.0 → V1.1 OpenCV集成） PATCH：Bug修复（如V1.0.0 → V1.0.1） versionCode：整数编码，每版本递增 1.0.0 → 1000000 1.1.0 → 1010000 1.1.1 → 1010001 2.0.0 → 2000000

2. 当前MVP状态总结

MVP（Minimum Viable Product，最小可行产品）阶段的目标是验证IVGuard的核心产品假设：三角色协同监护模型是否具有临床价值。本章节对MVP的交付状态进行全面审计，明确已实现功能、模拟服务和已知限制，为后续迭代提供清晰的基线。MVP不是最终产品，而是一个经过精心设计的技术验证平台，它在功能完整性和技术可行性之间取得了平衡，使得团队能够在最小的投入下获取最大的用户反馈。

2.1 已实现功能清单

2.1.1 三角色入口与切换

IVGuard的核心交互模型基于"患者-护士-家属"三角色协同监护。MVP中实现了完整的角色入口和无缝切换机制：

• 角色选择页：RoleSelectPage提供三角色视觉卡片入口
• 角色状态持久化：通过DataStore保存上次选择的角色，下次启动自动进入
• 角色切换：各角色主页均提供角色切换入口，支持随时切换
• 角色权限隔离：不同角色只能访问对应的功能页面，防止越权

角色选择的交互流程：

应用启动 → EntryAbility.onCreate() → DataStore.getPreference('role') → if (savedRole) → 直接进入对应角色主页 → else → 显示RoleSelectPage → 用户选择角色 → DataStore.putPreference('role', selectedRole) → 路由到对应主页

角色系统的技术实现要点：

1. 路由守卫：在页面跳转时检查当前角色是否有权限访问目标页面
2. 状态同步：角色切换后，所有依赖角色的服务（如NotificationService的通知目标）需要同步更新
3. 数据隔离：不同角色的本地数据存储使用不同的Preferences键前缀，避免数据混淆
4. 界面适配：三角色使用不同的配色方案和布局风格，通过主题系统统一管理

2.1.2 患者端5大功能

实时监控页面详细功能：

MonitorPage ├── 液位仪表盘（圆形进度条，0-100%） ├── 流速显示（ml/h，基于模拟衰减计算） ├── 预计完成时间（倒计时） ├── 药物信息卡片（药名、浓度、剂量） ├── 预警状态指示灯（绿/黄/红三级） ├── 手动刷新按钮 └── 角色切换入口

药物管理页面详细功能：

MedicationPage ├── 当前用药列表 │ ├── 药物名称 │ ├── 剂量/浓度 │ ├── 给药途径 │ └── 用药时间 ├── 药物相互作用检测 │ ├── 12组已知配伍禁忌 │ ├── 红色高亮警告 │ └── 禁忌原因说明 ├── 添加新药物 │ ├── 药物搜索 │ ├── 剂量输入 │ └── 冲突自动检测 └