鸿蒙开发入门:快速修复

📅 发布时间:2026/8/27 12:59:46
鸿蒙开发入门:快速修复 快速修复概述快速修复是HarmonyOS系统提供给开发者的一种技术手段支持开发者以远快于应用升级的方式对应用程序包进行缺陷修复。和全量应用升级软件版本相比快速修复的主要优势在小、快和用户体验好。在较短的时间内不中断正在运行的应用的情况下即不需要重启应用修复应用的缺陷。快速修复的使用规则仅支持修复应用的TS和C代码对应的文件为.abc文件TS编译后的文件和.so文件C编译后的文件不支持对资源的修复。不支持新增.abc文件和.so文件。快速修复包部署时要确保对应应用包已安装如果未安装则部署失败。快速修复包中配置的包名和应用版本号必须和已安装的包名和版本号应用相同如果不同则部署失败。如果已经部署过快速修复包新部署的快速修复包的版本号必须大于之前快速修复包的版本号否则部署失败。快速修复包的签名信息和待修复的应用的签名信息必须一致否则会部署失败。新的应用版本发布安装时会清理掉快速修复包。快速修复包结构上图是HarmonyOS应用程序发布的快速修复的包格式从图中可以看出包含两种包格式appqfApplication Quick Fixappqf与应用的app pack包是一一对应关系具体可参考应用程序包结构的介绍。appqf包是HarmonyOS应用用于发布到应用市场的单元不能够直接安装到设备上。它是由一个或多个hqfHarmony Ability Package Quick Fix组成这些hqf包在应用市场会从appqf包中拆分出来再被分发到具体的设备上。appqf包上架到应用市场前要有开发者的签名信息。hqfHarmony Ability Package Quick Fixhqf包是修复HAP中问题的快速修复包用于安装到设备上的快速修复单元。一个hqf可以包含.abc的快速修复文件.so的快速修复文件和描述该包的配置文件。.abc文件应用中修改后的ts代码编译后生成的字节码文件。libs目录存放.so库文件的差分文件以.so.diff为后缀。区分的不同的系统cpu架构例如arm平台、x86平台。patch.json该文件用于描述hqf包版本信息的配置文件由开发者填写具体内容如下{ app : { bundleName : com.ohos.quickfix, versionCode : 1000000, versionName : 1.0.0, patchVersionCode : 1000000, patchVersionName : 1.0.0 }, module : { name : entry, type : patch, deviceTypes : [ default, tablet ], originalModuleHash : 11223344556677889900 }}具体字段说明字段类型说明备注bundleNamestring对应应用的包名。不可缺省versionCodeint对应应用版本号。不可缺省versionNamestring对应应用的版本名称。patch类型不可缺省patchVersionCodeint补丁包的版本号。不可缺省patchVersionNamestring补丁包的版本名称。patch类型不可缺省namestring对应应用的moduleName用来修复该module的。不可缺省typestring对应补丁包的类型当前可选择为patch。不可缺省deviceTypesarray补丁包支持的设备类型。不可缺省originalModuleHashstring原始module Name对应包的哈希值可采用SHA256生成器自行生成。不可缺省快速修复TS编译后的文件上图是通过TS代码编译工具生成快速修复.abc文件的流程原始应用编译时生成.abc文件和.map文件。.abc是TS代码编译后的字节码文件应用运行时使用该文件。.map文件是通过TS代码编译工具编译TS代码时生成的中间文件记录有代码中的函数、类等信息。修复问题后的应用编译时根据上述的.map文件结合当前的TS代码得到差异部分根据差异部分生成快速修复的.abc文件。该.abc文件也既是最终要放到hqf包中的快速修复文件。快速修复C编译后的文件上图是通过差分工具生成快速修复.so文件的流程原始应用C源码通过编译工具生成.so文件该.so文件供应用在运行时使用。修复问题后的C源码通过编译工具生成.so文件该.so文件和原应用的.so文件通过差分工具生成.so快速修复文件该.so快速修复文件也既是最终要放到hqf包中的快速修复文件。快速修复包的发布部署流程上图涉及到的模块如下DevEco Studio用于开发代码的项目工程的集成开发环境。在快速修复的工程中能够给予原应用的代码和修复问题后的代码生成快速修复包并完成快速修复包的签名。应用市场服务器端开发者将开发完成的快速修复包上架到该平台平台会对上架的包进行签名验证、风险扫描和拆包重签名等然后分发到客户端。应用市场客户端用于接收应用市场服务器端分发的快速修复包并触发安装快速修复包。包管理服务设备上用于管理应用包及快速修复包安装和卸载的系统服务程序。快速修复引擎设备上用于管理应用切换使用快速修复包的系统服务程序。如果应用正在运行快速修复引擎接收到有快速修复包部署完成会通知应用切换快速修复包进而使得应用使能快速修复包。文件系统应用及快速修复包部署在设备上的位置。上图是快速修复包的端到端发布部署流程开发者通过DevEco Studio基于原应用的源码和修复后的源码编译打包生成快速修复包并通过DevEco Studio完成快速修复包的签名。将生成的带有签名的快速修复包上架到应用市场应用市场通过验证签名、风险扫描和拆包重签名后进行分发。设备侧的应用市场客户端检测到应用市场服务器端有新上架的快速修复包会下载最新版本的快速修复包接着通过系统中的包管理服务来安装部署快速修复包。快速修复包部署完成后再由快速修复引擎触发应用使用快速修复包进而保证用户使用到问题修复后的功能。快速修复包的调试流程DevEco Studio中暂时还没有集成快速修复的能力。当前阶段HarmonyOS为开发者提供了命令行的调试开发工具可供使用具体的调试开发流程如下基于原应用的源码和修复后的源码通过命令行工具可以编译生成快速修复包并通过命令行签名工具完成对快速修复的包的签名。通过命令行调试开发要对.hqf包签名并通过命令行工具将.hqf包安装到设备上.appqf包不能直接安装到设备上。通过快速修复的命令行工具将.hqf包安装部署到设备上。.hqf包安装部署完成后回调通知快速修复引擎触发应用使用快速修复包进而保证用户使用到问题修复后的功能。最后这里整理了一份《鸿蒙零基础入门学习指南》希望能对那些想要学习鸿蒙但是有没有方向的人提供一点帮助。本文档适用于HarmonyOS应用开发的初学者由于文档内容过多因此为了避免影响到大家的阅读体验在此只以截图展示部分内容详细完整版的看文末有免费的获取方式《鸿蒙零基础入门学习指南》目录一、快速入门适用于HarmonyOS应用开发的初学者。通过构建一个简单的具有页面跳转/返回功能的应用快速了解工程目录的主要文件熟悉HarmonyOS应用开发流程。开发准备基本概念工具准备构建第一个ArkTS应用Stage模型构建第一个ArkTS应用FA模型构建第一个JS应用FA模型二、开发基础知识应用程序包基础知识应用程序包概述应用程序包结构应用程序包多HAP机制应用程序包安装和卸载流程应用程序包更新流程共享包应用程序包快速修复应用配置文件Stage模型应用配置文件概述Stage模型app.json5配置文件module.json5配置文件应用配置文件概述FA模型应用配置文件概述FA模型app对象内部结构deviceConfig内部结构module对象内部结构三、资源分类与访问应用开发过程中经常需要用到颜色、字体、间距、图片等资源在不同的设备或配置中这些资源的值可能不同。资源分类与访问资源分类资源目录资源组目录创建资源目录和资源文件创建资源目录和资源文件创建资源目录创建资源文件资源访问应用资源系统资源资源匹配四、学习ArkTs语言ArkTS是HarmonyOS优选的主力应用开发语言。ArkTS围绕应用开发在TypeScript简称TS生态基础上做了进一步扩展继承了TS的所有特性是TS的超集。因此在学习ArkTS语言之前建议开发者具备TS语言开发能力。初识ArkTS语言基本语法基本语法概述声明式UI描述自定义组件状态管理其他状态管理其他状态管理概述Watch装饰器状态变量更改通知$$语法内置组件双向同步渲染控制渲染控制概述if/else条件渲染ForEach循环渲染LazyForEach数据懒加载扫描下方二维码免费领取《鸿蒙5.0零基础入门学习指南》