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

目录

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 -keyalg EC -keysize 256 -sigalg SHA256withECDSA \
  -dname "CN=IVGuard,O=IVGuardTeam,L=Beijing,ST=Beijing,C=CN" \
  -alias ivguard_release_key \
  -keystore ivguard_release.p12 \
  -storetype pkcs12 \
  -validity 3650

# 生成 CSR 文件
keytool -certreq -sigalg SHA256withECDSA \
  -alias ivguard_release_key \
  -keystore ivguard_release.p12 \
  -file ivguard_release.csr

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

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

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

文件类型 说明 用途
.p12 PKCS#12密钥库文件 存储私钥和证书链，构建时用于签名
.cer X.509数字证书 包含公钥和证书信息，由华为CA签发
.p7b Profile文件 包含应用签名权限声明和设备授权信息
.csr 证书签名请求 提交给华为CA的公钥信息（中间文件）

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 --mode module -p module=entry@default -p product=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 --mode project -p product=default

APP包结构：

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

HAP与APP的对比：

特性 HAP包 APP包
包含内容 单个模块 所有模块
签名要求 可选debug签名 必须release签名
适用场景 开发调试、单模块测试 应用市场发布
构建命令 assembleHap assembleApp
文件扩展名 .hap .app
安装方式 hdc install 应用市场/全量安装
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模式 Release模式
代码优化 无优化，保留调试信息 全量优化，剔除调试符号
SourceMap 生成，便于源码调试 不生成
代码混淆 不启用 启用（可配置）
签名 自动debug签名 必须release签名
日志输出 全量hilog 仅Error/Fatal级别
包体积 较大（含调试信息） 较小（优化压缩后）
启动速度 较慢（JIT解释执行） 较快（AOT编译）
崩溃堆栈 可映射到源码行号 混淆后需反解 
# Debug模式构建
hvigorw assembleHap --mode module -p module=entry@default -p buildMode=debug

# Release模式构建
hvigorw assembleApp --mode project -p buildMode=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-3个工作日
企业开发者 公司/组织 免费（需企业资质） 3-5个工作日

企业开发者所需材料：

  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需要声明的权限及其用途说明：

权限 类型 用途说明
ohos.permission.CAMERA 用户授权 相机预览，用于液位视觉识别
ohos.permission.INTERNET 系统授权 网络通信，用于远程监控推送
ohos.permission.VIBRATE 系统授权 振动提醒，用于预警通知
ohos.permission.NOTIFICATION 系统授权 通知栏推送，用于预警消息
ohos.permission.NFC 用户授权 NFC标签读取，用于输液袋配对
1.3.3 上传HAP包
# Step 1: 构建release模式的APP包
hvigorw assembleApp --mode project -p buildMode=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 -n com.ivguard.app

# Step 4: 在AppGallery Connect后台上传
# 登录 developer.huawei.com -> AppGallery Connect
# -> 选择应用 -> 版本信息 -> 上传软件包

包大小优化建议：

优化项 方法 预期效果
资源压缩 使用WebP替代PNG 减少30-50%资源体积
代码混淆 启用release混淆 减少20-40%代码体积
SO库裁剪 仅保留arm64-v8a 减少50%原生库体积
动态加载 非核心功能按需下载 减少首包体积
Tree Shaking 移除未引用代码 减少10-20%代码体积
1.3.4 审核流程：1-3个工作日

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

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

医疗类应用的审核要点：

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

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

驳回原因 说明 应对措施
功能与描述不符 实际功能与市场描述不一致 确保MVP中Mock功能明确标注
权限过度申请 申请了不必要的权限 精简权限列表，延迟授权
隐私政策缺失 未提供隐私政策链接 添加隐私政策页面和URL
崩溃/ANR 测试期间出现崩溃 提交前进行充分的兼容性测试
UI适配问题 特定分辨率下布局异常 在多设备上验证布局
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 液位显示、流速、预计完成时间 VisionService(Mock)
药物管理 MedicationPage 用药列表、相互作用检测 DrugDatabase(50种)
历史记录 HistoryPage 输液历史、趋势图 DataStore(Preferences)
智能分析 AnalysisPage 异常检测、风险评估 AIService(统计阈值)
费用预估 CostPage 费用计算、医保报销 CostService(6城市)

实时监控页面详细功能：

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

药物管理页面详细功能：

MedicationPage
├── 当前用药列表
│   ├── 药物名称
│   ├── 剂量/浓度
│   ├── 给药途径
│   └── 用药时间
├── 药物相互作用检测
│   ├── 12组已知配伍禁忌
│   ├── 红色高亮警告
│   └── 禁忌原因说明
├── 添加新药物
│   ├── 药物搜索
│   ├── 剂量输入
│   └── 冲突自动检测
└
# harmonyos # 华为
Logo
人工智能6S服务平台

作为“人工智能6S店”的官方数字引擎，为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐

鸿蒙应用开发实战（三）：ets文件与方舟语言

3、窗口管理：在这里设置应用启动页、窗口尺寸、状态栏、导航栏样式、页面路由；4、全局初始化：全局状态、数据库、网络、埋点、推送 SDK 统一初始化位置。.json:配置文件（module.json5、app.json5）该文件，为ArkTS文件，是鸿蒙自研的TypeScript超集。.ets:ArkTS（应用业务代码、Ability、页面组件）1、程序入口：应用冷启动时系统优先实例化这个。.h/.

avatar 人工智能6S服务平台

Unity获取鸿蒙系统的键盘高度与导航高度

文件，只可以直接编译调用鸿蒙系统的。代码返回的类型，如果。赋值后，强转必须用与。

avatar 人工智能6S服务平台
cover

DeepSeek‑V4‑Flash 公测落地@ACP#昇腾 950 Agent 整机，国产 DP MST 多屏芯片 GSV2221 可视化链路机会解析

avatar 人工智能6S服务平台