鸿蒙开发者必看:如何用一行命令搞定HSP/HAP文件安装?

一键部署鸿蒙HSP与HAP文件 脚本解析

在鸿蒙(HarmonyOS)应用开发与测试过程中,频繁安装和更新测试包是一项常见需求。本文介绍如何通过一个自动化批处理脚本(install_v1.0.1.bat)快速完成鸿蒙应用的卸载、安装与启动,显著提升开发和测试效率。


脚本核心功能

该脚本实现了以下功能:

  1. 动态读取包名 :支持从配置文件(config.txt)自动获取包名,或手动输入。
  2. 自动卸载旧版本 :通过 hdc uninstall 命令清理旧应用。
  3. 批量安装HSP文件 :扫描当前目录下的所有 .hsp 文件(鸿蒙共享包)并依次安装。
  4. 安装主HAP文件 :检测并安装目录中的 .hap 文件(鸿蒙应用包),若所有HSP安装成功则继续。
  5. 自动启动应用 :安装成功后,通过 hdc shell 命令启动应用的入口能力(EntryAbility)。
  6. 完善的错误处理:实时检测安装状态,失败时中断流程并提示详细信息。

文件说明

1. 配置文件 config.txt

  • 作用 :存储鸿蒙应用的包名(如 com.atomicservice.5765880207855877209)。
  • 优势:避免重复输入,适用于固定包名的测试场景。
  • 格式要求:仅需单行内容,无额外语法。

2. 批处理脚本 install_v1.0.1.bat

  • 兼容性:支持Windows环境。
  • 依赖工具 :需提前配置鸿蒙设备连接工具 hdc 并添加到系统路径。

使用步骤

第一步:准备文件

  1. 将脚本文件 install_v1.0.1.bat 和配置文件 config.txt 放置在项目根目录。
  2. 确保当前目录包含待安装的 .hsp(共享包)和 .hap(应用包)文件。

第二步:配置包名(可选)

  • 直接修改 config.txt:写入目标包名(覆盖原有内容)。
  • 不修改配置文件:运行脚本时手动输入包名。

第三步:运行脚本

双击执行 install_v1.0.1.bat,按提示操作:

  1. 若 config.txt 存在且包名有效,自动读取并卸载旧版本。
  2. 若未配置包名,脚本会提示手动输入。
  3. 按顺序安装所有HSP文件,最后安装HAP文件。
  4. 安装成功后,自动启动应用并输出日志。

关键代码解析

1. 包名动态读取

bat 复制代码
if exist config.txt (
    for /f "delims=" %%i in (config.txt) do set PACKAGE_NAME=%%i
)
  • 若存在 config.txt,读取其第一行内容作为包名。

2. 错误中断逻辑

bat 复制代码
if %errorlevel% neq 0 (
    echo Failed to install HSP file: %%~nxf
    set INSTALL_SUCCESS=0
    goto END
)
  • 任一HSP安装失败时,立即终止流程并标记失败。

3. 自动启动应用

bat 复制代码
hdc shell aa start -a EntryAbility -b %PACKAGE_NAME% -m entry
  • 通过鸿蒙的 aa 命令启动应用的入口能力,需确保 EntryAbility 名称与工程配置一致。

常见问题与建议

  1. HSP与HAP的区别

    • HSP(Harmony Shared Package):共享功能模块,可被多个应用复用。
    • HAP(Harmony Application Package):主应用包,包含入口逻辑。
  2. 脚本执行失败排查

    • 检查 hdc 工具是否正常连接设备。
    • 确保HAP文件存在且未损坏。
    • 确认包名与工程配置一致(避免权限冲突)。
  3. 扩展建议

    • 可修改脚本支持多HAP文件安装(需调整循环逻辑)。
    • 添加版本号校验,避免重复安装相同版本。

总结

通过此脚本,开发者可以快速完成鸿蒙测试包的部署,实现"一键安装+启动"的自动化流程。尤其适合需要频繁验证功能或修复BUG的场景。结合配置文件的动态读取和严格的错误处理,既能提升效率,又能减少人工操作失误。

立即下载脚本,体验高效鸿蒙开发吧!


附录:

相关推荐
码间留白3 小时前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农4 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程7 小时前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程7 小时前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去9 小时前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts
二流小码农1 天前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
威哥爱编程1 天前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程1 天前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
Sirius_Ji2 天前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos
贾伟康2 天前
HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测
harmonyos·arkts·navigation·navpathstack·api26