基于鸿蒙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.1OpenCV NAPI真实集成4.2 V1.2护士站服务端跨设备推送4.3 V1.3云端数据同步4.4 V1.4手表端伴生应用4.5 V2.0AI深度学习模型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签名的适用场景包括本地开发调试在开发机上连接真机或模拟器进行调试自动化测试CI/CD流水线中的自动化测试构建内部体验团队内部成员的体验测试不对外发布功能验证新功能开发完成后的快速验证1.1.2 Release签名需要申请华为开发者证书Release签名是应用正式发布的前提条件其密钥和证书必须通过华为开发者平台正式申请流程远比debug签名复杂。Release签名采用了更高级别的安全机制确保证书的不可伪造性和应用来源的可信度。前置条件注册华为开发者账号需实名认证完成开发者资质审核个人/企业在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\-dnameCNIVGuard,OIVGuardTeam,LBeijing,STBeijing,CCN\-aliasivguard_release_key\-keystoreivguard_release.p12\-storetypepkcs12\-validity3650# 生成 CSR 文件keytool-certreq-sigalgSHA256withECDSA\-aliasivguard_release_key\-keystoreivguard_release.p12\-fileivguard_release.csr密钥对生成过程中需要注意以下要点密钥算法选择推荐使用EC椭圆曲线算法密钥长度256位签名算法SHA256withECDSA。EC算法相比RSA在相同安全强度下密钥更短、签名速度更快有效期设置建议设置为10年3650天避免频繁更换证书密钥库密码设置强密码至少16位包含大小写字母、数字和特殊字符DN信息CN填写应用名称或组织名称O填写组织名称C填写国家代码.p12证书文件 .cer配置文件的关系文件类型说明用途.p12PKCS#12密钥库文件存储私钥和证书链构建时用于签名.cerX.509数字证书包含公钥和证书信息由华为CA签发.p7bProfile文件包含应用签名权限声明和设备授权信息.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 } } ] } }安全最佳实践密钥文件管理.p12文件和密码绝不能提交到版本控制系统应在.gitignore中添加sign/目录密码保护使用环境变量或加密的密钥管理服务存储storePassword和keyPassword证书轮换建议每2-3年轮换一次签名证书避免长期使用同一密钥对多环境隔离开发、测试、生产环境使用不同的签名配置// 多签名配置示例区分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包HAPHarmonyOS Ability Package是HarmonyOS应用的基本部署单元类似于Android的APK。每个HAP包对应一个模块Module包含该模块的代码、资源和配置信息。HAP包是应用安装和运行的最小单位用户在设备上安装的就是HAP包。# 使用 hvigorw 命令行构建单个HAP包hvigorw assembleHap--modemodule-pmoduleentrydefault-pproductdefaultHAP包结构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-pproductdefaultAPP包结构IVGuard-default-signed.app ├── entry.hap # entry模块HAP ├── pack.info # 包信息含所有模块列表 └── codec.info # 编码信息HAP与APP的对比特性HAP包APP包包含内容单个模块所有模块签名要求可选debug签名必须release签名适用场景开发调试、单模块测试应用市场发布构建命令assembleHapassembleApp文件扩展名.hap.app安装方式hdc install应用市场/全量安装1.2.3 构建模式debug/releaseHarmonyOS支持多种构建模式在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--modemodule-pmoduleentrydefault-pbuildModedebug# Release模式构建hvigorw assembleApp--modeproject-pbuildModereleaseIVGuard项目的构建策略建议日常开发使用debug模式快速迭代验证集成测试使用debug模式但开启部分混淆提前发现混淆问题预发布测试使用release模式完整验证生产环境行为正式发布使用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混淆注意事项序列化字段所有需要JSON序列化/反序列化的字段名必须保留否则数据解析会失败反射调用通过字符串名称动态访问的属性必须保留跨模块接口HSP/HAR对外暴露的API名称必须保留数据库字段与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.txt1.3 华为应用市场发布流程华为应用市场AppGallery是HarmonyOS应用的官方分发渠道发布流程涉及开发者账号、应用信息、审核等多个环节。IVGuard作为医疗健康类应用在发布流程中需要满足额外的合规要求。1.3.1 开发者账号注册账号类型选择类型适用对象费用审核周期个人开发者个人开发者免费1-3个工作日企业开发者公司/组织免费需企业资质3-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--modeproject-pbuildModerelease# 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# - 选择应用 - 版本信息 - 上传软件包包大小优化建议优化项方法预期效果资源压缩使用WebP替代PNG减少30-50%资源体积代码混淆启用release混淆减少20-40%代码体积SO库裁剪仅保留arm64-v8a减少50%原生库体积动态加载非核心功能按需下载减少首包体积Tree Shaking移除未引用代码减少10-20%代码体积1.3.4 审核流程1-3个工作日华为应用市场的审核流程分为自动审核和人工审核两个阶段提交应用 → 自动审核即时 ├── 病毒扫描 ├── 安全检测 ├── 兼容性检测 └── 隐私合规检测 → 人工审核1-3个工作日 ├── 功能完整性验证 ├── 内容合规检查 ├── 权限合理性审核 └── 医疗类应用专项审核 → 审核结果 ├── 通过 → 上架发布 ├── 驳回 → 修改后重新提交 └── 待补充 → 提交额外材料医疗类应用的审核要点功能真实性声明的医疗功能必须可验证地实现数据安全医疗数据的采集、存储、传输必须符合法规要求用户知情隐私政策必须清晰告知数据使用方式风险提示应用内须声明本应用仅供辅助参考不能替代专业医疗判断权限最小化仅申请必要权限不得过度收集用户信息常见审核驳回原因及应对驳回原因说明应对措施功能与描述不符实际功能与市场描述不一致确保MVP中Mock功能明确标注权限过度申请申请了不必要的权限精简权限列表延迟授权隐私政策缺失未提供隐私政策链接添加隐私政策页面和URL崩溃/ANR测试期间出现崩溃提交前进行充分的兼容性测试UI适配问题特定分辨率下布局异常在多设备上验证布局1.3.5 版本更新增量更新HarmonyOS支持多种更新方式选择合适的更新策略对用户体验至关重要。全量更新// module.json5 中配置版本信息 { module: { name: entry, type: entry, versionCode: 1000000, versionName: 1.0.0 } }增量更新Hot FixHarmonyOS支持通过动态加载方式实现热修复无需重新发布完整包热修复流程 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集成 PATCHBug修复如V1.0.0 → V1.0.1 versionCode整数编码每版本递增 1.0.0 → 1000000 1.1.0 → 1010000 1.1.1 → 1010001 2.0.0 → 20000002. 当前MVP状态总结MVPMinimum 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) → 路由到对应主页角色系统的技术实现要点路由守卫在页面跳转时检查当前角色是否有权限访问目标页面状态同步角色切换后所有依赖角色的服务如NotificationService的通知目标需要同步更新数据隔离不同角色的本地数据存储使用不同的Preferences键前缀避免数据混淆界面适配三角色使用不同的配色方案和布局风格通过主题系统统一管理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组已知配伍禁忌 │ ├── 红色高亮警告 │ └── 禁忌原因说明 ├── 添加新药物 │ ├── 药物搜索 │ ├── 剂量输入 │ └── 冲突自动检测 └
基于鸿蒙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.1OpenCV NAPI真实集成4.2 V1.2护士站服务端跨设备推送4.3 V1.3云端数据同步4.4 V1.4手表端伴生应用4.5 V2.0AI深度学习模型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签名的适用场景包括本地开发调试在开发机上连接真机或模拟器进行调试自动化测试CI/CD流水线中的自动化测试构建内部体验团队内部成员的体验测试不对外发布功能验证新功能开发完成后的快速验证1.1.2 Release签名需要申请华为开发者证书Release签名是应用正式发布的前提条件其密钥和证书必须通过华为开发者平台正式申请流程远比debug签名复杂。Release签名采用了更高级别的安全机制确保证书的不可伪造性和应用来源的可信度。前置条件注册华为开发者账号需实名认证完成开发者资质审核个人/企业在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\-dnameCNIVGuard,OIVGuardTeam,LBeijing,STBeijing,CCN\-aliasivguard_release_key\-keystoreivguard_release.p12\-storetypepkcs12\-validity3650# 生成 CSR 文件keytool-certreq-sigalgSHA256withECDSA\-aliasivguard_release_key\-keystoreivguard_release.p12\-fileivguard_release.csr密钥对生成过程中需要注意以下要点密钥算法选择推荐使用EC椭圆曲线算法密钥长度256位签名算法SHA256withECDSA。EC算法相比RSA在相同安全强度下密钥更短、签名速度更快有效期设置建议设置为10年3650天避免频繁更换证书密钥库密码设置强密码至少16位包含大小写字母、数字和特殊字符DN信息CN填写应用名称或组织名称O填写组织名称C填写国家代码.p12证书文件 .cer配置文件的关系文件类型说明用途.p12PKCS#12密钥库文件存储私钥和证书链构建时用于签名.cerX.509数字证书包含公钥和证书信息由华为CA签发.p7bProfile文件包含应用签名权限声明和设备授权信息.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 } } ] } }安全最佳实践密钥文件管理.p12文件和密码绝不能提交到版本控制系统应在.gitignore中添加sign/目录密码保护使用环境变量或加密的密钥管理服务存储storePassword和keyPassword证书轮换建议每2-3年轮换一次签名证书避免长期使用同一密钥对多环境隔离开发、测试、生产环境使用不同的签名配置// 多签名配置示例区分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包HAPHarmonyOS Ability Package是HarmonyOS应用的基本部署单元类似于Android的APK。每个HAP包对应一个模块Module包含该模块的代码、资源和配置信息。HAP包是应用安装和运行的最小单位用户在设备上安装的就是HAP包。# 使用 hvigorw 命令行构建单个HAP包hvigorw assembleHap--modemodule-pmoduleentrydefault-pproductdefaultHAP包结构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-pproductdefaultAPP包结构IVGuard-default-signed.app ├── entry.hap # entry模块HAP ├── pack.info # 包信息含所有模块列表 └── codec.info # 编码信息HAP与APP的对比特性HAP包APP包包含内容单个模块所有模块签名要求可选debug签名必须release签名适用场景开发调试、单模块测试应用市场发布构建命令assembleHapassembleApp文件扩展名.hap.app安装方式hdc install应用市场/全量安装1.2.3 构建模式debug/releaseHarmonyOS支持多种构建模式在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--modemodule-pmoduleentrydefault-pbuildModedebug# Release模式构建hvigorw assembleApp--modeproject-pbuildModereleaseIVGuard项目的构建策略建议日常开发使用debug模式快速迭代验证集成测试使用debug模式但开启部分混淆提前发现混淆问题预发布测试使用release模式完整验证生产环境行为正式发布使用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混淆注意事项序列化字段所有需要JSON序列化/反序列化的字段名必须保留否则数据解析会失败反射调用通过字符串名称动态访问的属性必须保留跨模块接口HSP/HAR对外暴露的API名称必须保留数据库字段与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.txt1.3 华为应用市场发布流程华为应用市场AppGallery是HarmonyOS应用的官方分发渠道发布流程涉及开发者账号、应用信息、审核等多个环节。IVGuard作为医疗健康类应用在发布流程中需要满足额外的合规要求。1.3.1 开发者账号注册账号类型选择类型适用对象费用审核周期个人开发者个人开发者免费1-3个工作日企业开发者公司/组织免费需企业资质3-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--modeproject-pbuildModerelease# 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# - 选择应用 - 版本信息 - 上传软件包包大小优化建议优化项方法预期效果资源压缩使用WebP替代PNG减少30-50%资源体积代码混淆启用release混淆减少20-40%代码体积SO库裁剪仅保留arm64-v8a减少50%原生库体积动态加载非核心功能按需下载减少首包体积Tree Shaking移除未引用代码减少10-20%代码体积1.3.4 审核流程1-3个工作日华为应用市场的审核流程分为自动审核和人工审核两个阶段提交应用 → 自动审核即时 ├── 病毒扫描 ├── 安全检测 ├── 兼容性检测 └── 隐私合规检测 → 人工审核1-3个工作日 ├── 功能完整性验证 ├── 内容合规检查 ├── 权限合理性审核 └── 医疗类应用专项审核 → 审核结果 ├── 通过 → 上架发布 ├── 驳回 → 修改后重新提交 └── 待补充 → 提交额外材料医疗类应用的审核要点功能真实性声明的医疗功能必须可验证地实现数据安全医疗数据的采集、存储、传输必须符合法规要求用户知情隐私政策必须清晰告知数据使用方式风险提示应用内须声明本应用仅供辅助参考不能替代专业医疗判断权限最小化仅申请必要权限不得过度收集用户信息常见审核驳回原因及应对驳回原因说明应对措施功能与描述不符实际功能与市场描述不一致确保MVP中Mock功能明确标注权限过度申请申请了不必要的权限精简权限列表延迟授权隐私政策缺失未提供隐私政策链接添加隐私政策页面和URL崩溃/ANR测试期间出现崩溃提交前进行充分的兼容性测试UI适配问题特定分辨率下布局异常在多设备上验证布局1.3.5 版本更新增量更新HarmonyOS支持多种更新方式选择合适的更新策略对用户体验至关重要。全量更新// module.json5 中配置版本信息 { module: { name: entry, type: entry, versionCode: 1000000, versionName: 1.0.0 } }增量更新Hot FixHarmonyOS支持通过动态加载方式实现热修复无需重新发布完整包热修复流程 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集成 PATCHBug修复如V1.0.0 → V1.0.1 versionCode整数编码每版本递增 1.0.0 → 1000000 1.1.0 → 1010000 1.1.1 → 1010001 2.0.0 → 20000002. 当前MVP状态总结MVPMinimum 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) → 路由到对应主页角色系统的技术实现要点路由守卫在页面跳转时检查当前角色是否有权限访问目标页面状态同步角色切换后所有依赖角色的服务如NotificationService的通知目标需要同步更新数据隔离不同角色的本地数据存储使用不同的Preferences键前缀避免数据混淆界面适配三角色使用不同的配色方案和布局风格通过主题系统统一管理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组已知配伍禁忌 │ ├── 红色高亮警告 │ └── 禁忌原因说明 ├── 添加新药物 │ ├── 药物搜索 │ ├── 剂量输入 │ └── 冲突自动检测 └
)
)
