1121 字
6 分钟
鸿蒙原生应用侧载指南(Windows 篇)

背景:鸿蒙为什么不能像 Android 一样侧载?#

华为在 HarmonyOS NEXT(纯血鸿蒙)中全面引入了类似 Apple 的封闭生态策略:严格的权限管理 + 自有应用商店审核制度。这意味着绝大部分原生鸿蒙应用(.hap 格式)只能从华为应用商店安装,不再像旧版鸿蒙或 Android 那样可以随意双击 APK 直接安装。

注:APK 文件仍然可以通过「卓易通」容器兼容运行,但那是跑在 Android 模拟层里的,性能和体验都不如原生 HAP。

如果你想安装不在应用商店内的原生鸿蒙应用(比如内测版、开源工具、未过审的应用),唯一的官方途径就是——开发者调试模式侧载。

本文记录我在 Windows 平台上的完整折腾经历,供有同样需求的朋友参考。


前置条件#

开始之前,请确认以下条件已满足:

  • 拥有一台运行 HarmonyOS NEXT 的华为设备(手机或平板)
  • 华为账号已完成实名认证(申请开发者证书的必要条件)
  • 一台 Windows 电脑,与鸿蒙设备连接同一 Wi-Fi

第一步:下载小白调试助手#

小白调试助手是一个开源工具,通过无线 ADB 协议让 PC 可以为鸿蒙设备推送并安装 HAP 安装包。项目托管在 GitHub:

👉 github.com/likuai2010/auto-installer/releases

在 Releases 页面需要下载两个文件:

文件用途
hap_installer_xxx.zip(Windows 压缩包)在电脑上运行的控制端
xxx.hap(鸿蒙安装包)安装到手机上的鸿蒙版助手,用于后续脱离电脑自签名

第二步:配置 PC 端环境#

  1. 将下载的 zip 压缩包解压到一个方便的位置(比如桌面或 D 盘根目录)
  2. 进入解压后的文件夹,双击 hap_installer.exe 启动小白调试助手
  3. 如果此前没有安装过 Java 运行环境,程序会提示下载 —— 按指引安装即可(建议使用 Azul Zulu 或 Adoptium 的 JDK)

第三步:登录并申请开发者证书#

  1. 在 PC 端的小白调试助手中登录你的华为账号
  2. 按工具内的指引跳转到 华为开发者联盟 申请调试证书
    • 证书申请免费,实名认证后几分钟即可完成
    • 证书用于为 HAP 安装包签名,没有签名的包鸿蒙系统会拒绝安装

第四步:开启鸿蒙设备的开发者模式#

  1. 打开鸿蒙手机 → 设置 → 关于手机
  2. 连续快速点击 「HarmonyOS 版本」(或「软件版本」)5~7 次
  3. 输入锁屏密码,提示「您已处于开发者模式」即成功

第五步:开启无线调试#

  1. 返回 设置 → 系统 → 开发者选项
  2. 找到 「无线调试」,打开开关
  3. 点击「无线调试」文字本身(不是只点开关),进入二级菜单
  4. 记录下界面显示的 IP 地址 和 端口号

    格式类似 192.168.1.100:5555


第六步:连接并安装#

  1. 回到 PC 端小白调试助手
  2. 将手机上无线调试页面显示的 IP 地址 和 端口号 填入对应输入框
  3. 点击连接 —— 成功后设备列表会出现你的手机
  4. 点击「选择安装包」,找到第一步下载的那个 .hap 文件(鸿蒙版小白调试助手)
  5. 点击「安装」,等待进度条完成

搞定!以后不用电脑了 🎉#

安装完成后,你的鸿蒙手机上就有了鸿蒙版的小白调试助手。从此以后:

  • 直接在手机上打开小白调试助手
  • 自行下载 HAP 安装包到手机
  • 在手机端完成自签名 + 安装,完全无需再连接电脑

这就是一次配置、一劳永逸的玩法。


常见问题#

连接失败?#

  • 确认电脑和手机连的是同一个 Wi-Fi(公共 Wi-Fi 可能有设备隔离,建议手机开热点给电脑连)
  • 检查 IP 地址和端口号是否填写正确(注意端口号是无线调试二级页面里的,不是 WiFi 设置里的)

安装失败,提示签名错误?#

鸿蒙 NEXT 对应用签名校验非常严格。请确保:

  • HAP 包本身带有有效签名
  • 你的调试证书申请成功且未过期

提示版本已存在?#

说明手机里已有该应用的更高版本,需要先卸载再安装低版本 HAP。

鸿蒙原生应用侧载指南(Windows 篇)
https://blog.heyunxi.top/posts/鸿蒙侧载指南/
作者
Yunxi
发布于
2026-08-05
许可协议
CC BY-NC-SA 4.0