一、通过安装命令安装

1. 打包Hap包

通过build->Build Hap(s)/APP(s) -> Build Hap(s)生成安装包
安装包路径：/build/default/outputs/default/

2. 通过命令安装

hdc install <hap路径>

二、通过蒲公英安装

1. 配置签名文件

1. 登录华为 AGC → 证书、APP ID、Profile，下载：
2. 发布证书 .p12 + 证书密码
3. 发布 Profile（指定设备发布类型）
4. DevEco Studio → File → Project Structure → Signing Configs
5. 新建 Release 签名配置，填入 p12 文件、密码、Profile 文件

2. 编译打包已签名 HAP

打包完成后路径：
项目目录/模块/build/default/outputs/default/xxx-signed.hap

3. 发布到蒲公英网页上

1. 登录蒲公英官网 pgyer.com，顶部点击发布应用
2. 上传区域拖拽 / 选中本地 xxx-signed.hap 文件
3. 包解析完成，填写版本信息：
   版本更新日志（必填，方便测试）
   应用截图、内测说明（可选）
4. 关键步骤：上传配套 .p12 证书
   选择 AGC 下载的同一份 p12 文件
   输入 p12 证书密码（和打包签名密码一致）

作用：蒲公英用该证书签名安装元数据 manifest.json5，鸿蒙设备才能识别安装

5. 点击发布应用，生成专属下载链接 + 二维码

4. 测试人员安装方式

1. 鸿蒙设备浏览器打开蒲公英分发链接
2. 页面点击下载，系统自动识别 hap 安装包

三、获取设备的UDID

1. 开启开发者选项 & 无线调试

1. 设置 → 关于本机，连续点击 HarmonyOS 版本 7 次，开启开发者模式
2. 设置 → 系统和更新 → 开发人员选项
3. 打开 无线调试，记下：IP 地址 + 端口（如 192.168.1.100:5555）

2. 执行指令获取

hdc shell bm get --udid

四、蒲公英安装失败问题解决

1. 点击安装没有响应

1. 浏览器UA标识需要选择HarmonyOS，
2. 广告过滤关闭
3. 网页元素打开Cookie和JavaScript