ohos 侧载

鸿蒙 5.0 及以上删除了系统中的 AOSP 兼容层，无法通过直接打开 .hap 文件进行安装。尽管可以通过卓易通安装 .apk，但体验不如原生应用。本文档提供如何使用小白调试助手进行侧载安装。

准备工作

没有其他设备？

可以下载 .apk 文件安装在卓易通中使用。

从 GitHub 仓库 Release 中下载两个平台的安装包，其中一个需要为 .hap 安装包，用于后续软件更新使用；另一个可以为任意平台。

注意事项

Windows: 首次打开会提示安装 Java，下载安装即可。

macOS: 首次运行需要在终端运行 xattr -d com.apple.quarantine /Applications/小白调试助手.app。需要 Java 环境。

Linux: 不能使用 root 权限，依赖 zenity。

卓易通: 账号登录不会提示登录成功，需要手动返回调试助手；安装时容易断连，重新连接即可。

打开设置 - 设备名称，进入关于本机页面。快速点击 5 下 软件版本 打开开发者模式。

转到设置 - 系统 - 开发者选项页面，找到并点击无线调试，在二级页面中开启无线调试，获取设备的 IP 地址和端口。

侧载中需要使用开发者账号进行签名。开发者账号未实名时侧载后的应用仅有 14 天有效期，实名后会延长至 180 天，因此首先需要进行实名认证。

点击登录账号，在浏览器中登录华为账号，点击允许访问，等待出现登录成功！请返回！。

点击连接设备，在弹出窗口中输入上面获取的 IP 地址和端口，点击按钮进行连接。

点击选择，选择下载好的 Kazumi hap 包，完成后会在软件内显示软件包名及支持安装的设备。

点击开始调试，等待全部操作成功完成侧载。若出现错误可根据错误信息进行操作解决，并重新开始调试。

使用相同方法侧载小白调试助手的 hap 包，后续软件内更新时会下载 hap 包并发送到小白调试助手，只需要登录华为账号并连接设备就可以便捷侧载。