HarmonyOS实战开发：快速修复命令行调试开发

最新推荐文章于 2024-09-08 22:14:49 发布

蜀道衫QAQ

最新推荐文章于 2024-09-08 22:14:49 发布

阅读量749

点赞数 14

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙鸿蒙系统 android

本文链接：https://blog.csdn.net/2401_84194030/article/details/137928563

版权

鸿蒙专栏收录该内容

449 篇文章 9 订阅

订阅专栏

本文介绍了在OpenHarmony系统中，开发者如何利用命令行工具和patch.json配置文件来修复应用问题，包括生成快速修复文件、so文件的差异处理和打包.hqf包的过程，以及如何进行签名和安装。同时，文章强调了学习鸿蒙开发技术的重要性及其所需掌握的关键点。

摘要由CSDN通过智能技术生成

当前阶段，系统为开发者提供了命令行的调试开发工具可供使用。比如，包名为com.ohos.quickfix的示例应用，版本号为1000000。该应用的当前版本运行中有某问题需要修复，此时，开发者可参考如下指导使用快速修复能力解决应用问题。

编写配置文件patch.json

目前DevEco Studio中还不支持patch.json的配置，因此开发者可根据项目需要编写好该文件后，放到的项目任意目录，方便后续打包工具能够找到该文件即可。在本地新建一个patch.json文件，配置编写示例如下：

{
    "app" : {
        "bundleName" : "com.ohos.quickfix",
        "versionCode" : 1000000, // 应用版本号
        "versionName" : "1.0.0.1",
        "patchVersionCode" : 1000000, // 补丁版本号
        "patchVersionName" : "1.0.0.1"
    },
    "module" : {
        "name" : "entry",
        "type" : "patch",
        "deviceTypes" : [
            "default",
            "tablet"
        ],
        "originalModuleHash" : "11223344556677889900" // 待修复HAP包的SHA256值，可采用SHA256生成器自行生成
    }
}

生成快速修复文件

快速修复ArkTS文件的代码

在DevEco Studio中修改ArkTS文件后，编译HAP，可以在工程目录下找到对应的abc文件，如。build\default\cache\default\LegacyCompileETS\jsbundle\temporary\pages\index.abc

快速修复C++中的代码

在DevEco Studio中编译原C++的代码生成.so文件;修复原C++的代码，编译生成新的.so文件。可以在工程目录中找到该so，如。build\default\intermediates\libs\default\arm64-v8a\libentry.so
在本地OpenHarmony SDK路径的文件夹下查看。通过该工具，基于新.so文件和旧的.so文件，生成.so的快速修复文件，命令如下：命令行参数含义：toolchainsdiff.exe
```
$ diff.exe -s Example.z.so -d Example.z.so -p Example.z.so.diff
```

-s：旧so的路径
-d：新SO的路径
-p：生成的差分文件的路径

生成.hqf的快速修复包

基于上述的patch.json、.abc快速修复文件和.so快速修复文件，可以通过本地OpenHarmony SDK路径的文件夹下的生成.hqf包，执行打包命令如下：toolchainsapp_packing_tool.jar

$ java -jar app_packing_tool.jar --mode hqf --json-path patch.json --lib-path libs --ets-path patchs --out-path entry-default-unsigned.hqf --force true

命令行参数介绍： |命令 |说明 |备注| |--- |--- |---| |mode |模式 |必选| |json-path|patch.json路径|必选| |lib-path|。so快速修复文件路径，该路径可参考快速修复包结构|可选| |ets-path|。abc快速修复文件路径|可选|

快速修复包的签名

签名与HAP签名相同，将上述生成的entry-default-unsigned.hqf包，通过签名工具进行签名。可以使用本地OpenHarmony SDK路径的文件夹下的，命令如下：toolchainshap-sign-tool.jar

$ java -jar hap-sign-tool.jar sign-app -keyAlias "OpenHarmony Application Release" -signAlg "SHA256withECDSA" -mode "localSign" -appCertFile "OpenHarmonyApplication.pem" -profileFile "ohos_provision_release.p7b" -inFile "entry-default-unsigned.hqf" -keystoreFile "OpenHarmony.p12" -outFile "entry-signed-release.hqf" -keyPwd "123456" -keystorePwd "123456"

安装快速修复包

将上述entry-signed-release.hqf包推送到设备上

hdc.exe file send .\entry-signed-release.hqf /data/

在设备上通过下述命令行安装补丁包

$ bm quickfix -a -f /data/entry-signed-release.hqf

快速修复相关完整命令行参考如下：

$ bm quickfix -h
usage: bm quickfix <options>
options list:
-h, --help                                   list available commands
-q, --query                                  indicates query quickfix, used with -b or --bundle-name
-b, --bundle-name <bundle-name>              query quickfix status and information by a specified bundle name
-a, --apply                                  indicates apply quickfix, used with -f or --file-path
-f, --file-path <file-path>                  apply a quickfix file by a specified path
-f, --file-path <file-path> <file-path> ...  apply some quickfix files of one bundle
-f, --file-path <bundle-direction>           apply quickfix files by direction, under which are quickfix files

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料