一、.app 安装失败（路径不存在）
原因：hdc 命令不支持直接安装 .app 文件（.app 是开发中间产物，非最终安装包）。
解决方案：
仅使用 .hap 包安装：HarmonyOS 正式安装包为已签名的 .hap，.app 需通过 hbuilder 或 DevEco Studio 打包为 .hap 后使用。
若必须安装 .app（如调试场景）：
使用 hpack 工具（需手动安装：npm install -g hpack）：hpack i your.app # 需确保 .app 已签名，否则提示“无签名文件”
注意：非本地打包的 .app 可能因签名不匹配失败，建议联系开发者获取 .hap。
二、.hap 安装失败（权限拒绝，code:9568266）
原因：权限问题通常由未签名、设备未绑定、或工具版本过旧导致。
分步排查：
检查 .hap 签名：
正式包需通过华为开发者后台签名，测试包需使用调试证书（本地打包时自动生成）。
若下载的 .hap 无签名，用 hap sign 工具签名（需私钥，普通用户难操作），或联系开发者获取已签名包。
绑定设备并开启调试：
手机开启 USB 调试 + 允许通过 HDB 调试（设置 > 关于手机 > 多次点击“版本号”开启开发者模式）。
电脑端使用 hdb 命令（HarmonyOS 新工具，替代 hdc）：hdb connect your_device_ip:5555 # 首次需手机确认授权
hdb install your.hap # 权限问题可能因 hdc 版本旧，换 hdb 更稳定
权限修复（华为设备专属）：
若提示 permission denied，检查设备是否在华为开发者后台“真机调试”绑定（需实名认证）。
临时方案：手机端进入开发人员选项 > 撤销 USB 调试授权，重新连接并授权。
路径与工具问题：
确保命令中路径正确（如 ./xxx.hap），避免空格或中文路径。
升级 DevEco Device Tool 或手动安装最新 hdb（华为开发者联盟工具下载）。
三、替代方案：命令行安装通用技巧
使用 hpack 批量安装（支持 .hap/.hsp）：
hpack i /path/to/your.hap # 单文件安装
hpack i /dir/ # 安装目录下所有合法包
adb 兼容模式（适用于旧设备）：
部分设备仍支持 adb 安装（需开启“允许通过 ADB 安装”）：
adb install -r your.hap # -r 表示覆盖安装
检查设备日志定位问题：
安装时手机端打开开发人员选项 > 日志记录级别 > 详细，通过 hdb logcat 抓取日志，确认是否签名冲突或系统限制。
四、注意事项
文件来源：从官网或可信渠道下载安装包，避免第三方未签名包。
设备限制：部分华为机型（如鸿蒙原生设备）严格校验签名，非官方包可能永久拒绝安装。
工具版本：hdc 已逐步被 hdb 替代，优先使用华为最新调试工具。
若仍失败，建议在华为开发者论坛上传日志文件和包信息，官方团队会针对性排查（需脱敏处理）。