HarmonyOS鸿蒙Next中怎么安装hap

HarmonyOS鸿蒙Next中怎么安装hap 通过build haps 编译出来的hap包，怎么安装呢？

4 回复

  • 方式一：通过hdc命令安装到测试机。 a. 下载Command Line Tools。该命令行工具集合了HarmonyOS应用开发所用到的系列工具，包括代码检查codelinter、三方库的包管理Ohpm、命令行解析hstack、编译构建hvigorw： b. 配置环境变量：下载后的压缩包放到D盘，解压后获得文件夹“D:\CommandLine-Tools-windows-x64-5.1.0.828SP1\Command-Line-Tools\SDK\default\OpenHarmony\toolchains”，右击此电脑-属性-高级系统设置，把该路径添加到环境变量里，cmd窗口输入where hdc检查是否配置成功： c. 使用hdc命令安装测试包：测试机进入手机系统设置菜单-关于手机，多次点击版本号启用开发者模式，然后进入系统设置菜单-系统-开发者选项，打开USB调试模式，并通过USB将手机连接到电脑，通过cmd使用命令hdc install <测试包路径>来安装hap包：

  • 方式二：通过IDE安装到测试机。 a. 下载新版DevEco Studio，并完成安装。安装过程中，新版本已经集成了Node.js、Ohpm和HarmonyOS SDK，因此不需要单独配置这些组件。 b. 测试机开启开发者模式，采用USB连接方式或者无线调试的连接方式。 c. 在DevEco Studio中选择真机，Project Structure（项目结构）-Signing Configs（签名配置）-勾选Automatically generate signature(自动签名)-点击OK完成自动签名，点击“Run”或“Debug”按钮，DevEco Studio自动将hap文件安装到测试机上。具体请参考【使用本地真机运行应用/元服务】。

  • 方式三：通过DevEco Testing工具安装到测试机。

    测试机开启开发者模式，打开USB调试模式，并通过USB将手机连接到电脑，点击DevEco Testing工具左侧实用工具-设备投屏-开始投屏，点击安装应用，选择安装包路径，点击确定按钮进行安装，安装后可通过执行日志查看安装信息：

  • 方式四：通过邀请测试或公开测试安装到测试机。

    通过AppGallery Connect，在应用正式版本发布之前，可以挑选特定的用户群组来测试HarmonyOS应用/元服务，或向AppGallery用户公开发布测试版本。

更多关于HarmonyOS鸿蒙Next中怎么安装hap的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


场景一：单HAP包或HSP包安装

  • 如果使用的是模拟器，直接把HAP包拖动到模拟器中即可完成安装。
  • 如果使用的是真机，可以使用以下方式进行安装：

  1. 使用hdc应用管理命令命令，例如：

    # 安装一个HAP
hdc install E:\example.hap

    # 安装一个HSP
hdc install E:\example.hsp

  2. 使用bm工具来进行安装，例如：

    # 安装一个HAP
bm install -p /data/app/ohos.app.hap
# 覆盖安装一个HAP
bm install -p /data/app/ohos.app.hap -r
# 安装一个应用间共享库
bm install -s xxx.hsp

使用DevEco Testing工具，连接真机后，选择实用工具，点击开始投屏，点击右侧安装应用即可选择HAP包进行安装。

场景二：多个HAP包或HSP包同时安装

  • 如果包含的HAP和HSP包不多，可以使用命令依次安装，但需要注意先安装HSP包再安装HAP包。

  • 如果包多的情况，可以使用bm install [-p filePath]命令同时安装HAP和应用内共享库。

    # 同时安装HAP和应用内共享库
bm install -p /data/app/

    简化安装步骤，可以将签名后的hap与应用内共享库hsp放在同一目录下，执行脚本安装，脚本实现参考：

    @echo off
setlocal EnableDelayedExpansion
set current_dir=%~dp0
echo %current_dir%
hdc shell rm -rf data/local/tmp/421e6d0e2f3d4c709f77e43e8c57cfb3
hdc shell mkdir data/local/tmp/421e6d0e2f3d4c709f77e43e8c57cfb3
for /r "%current_dir%" %%i in (*.hsp *.hap) do (
    echo %%~nxi
    echo %%i
    hdc file send %%i "data/local/tmp/421e6d0e2f3d4c709f77e43e8c57cfb3/%%~nxi"
)
hdc shell bm install -p data/local/tmp/421e6d0e2f3d4c709f77e43e8c57cfb3
hdc shell rm -rf data/local/tmp/421e6d0e2f3d4c709f77e43e8c57cfb3
echo Install Done!
@pause

  • 如果HSP是应用间共享库，可使用bm install [-p filePath] [-s hspDirPath]命令同时安装HAP和应用间共享库。

    # 同时安装使用方应用和其依赖的应用间共享库
bm install -p aaa.hap -s xxx.hsp yyy.hsp

在HarmonyOS NEXT中安装hap应用，需要通过DevEco Studio生成应用安装包。具体步骤：在项目根目录执行./gradlew assembleHap命令编译生成hap文件。安装时使用hdc工具，连接设备后执行hdc file send xxx.hap /data/传输文件，再执行hdc shell bm install -p /data/xxx.hap完成安装。需确保设备已开启开发者模式并授权调试权限。

可以通过以下方式安装编译生成的hap包：

  1. 使用hdc工具安装（推荐开发调试使用）：
hdc install package.hap
  1. 通过DevEco Studio直接安装：
  • 连接设备后，在Build窗口中找到生成的hap文件
  • 右键选择"Run/Install HAP"
  1. 使用设备上的包管理器：
  • 将hap文件传输到设备存储中
  • 通过文件管理器点击安装（需开启"允许安装未知来源应用"）
  1. 通过命令行批量安装（适用于多hap场景）：
hdc shell bm install -p /path/to/hap/

注意：安装前请确保：

  • 设备已开启开发者模式
  • 已正确签名hap包
  • 设备架构与hap匹配

安装后可在设备上直接运行应用进行测试。

回到顶部