适用对象：会用 uni-app / uni-app x 开发应用的前端 / 全栈同学。
目标：从 项目初始化 → 端能力接入 → 调试与适配 → 打包签名 → 商店上架，一次走通。
1. 环境与账号准备
安装工具
HBuilderX（建议最新，含 uni-app/uni-app x 支持）
DevEco Studio（真机/模拟器调试、日志、证书校验）
Node.js（如使用 Vite 生态）
账号与材料
开发者账号：注册并完成实名认证
应用信息：预创建应用，确定 包名/BundleName；准备上架素材（图标、启动图、截图、隐私协议）
签名文件 & Profile：按平台指引生成，后续打包用
小贴士：包名一旦发版不要改；签名（证书/私钥/Profile）必须与应用信息一致。
2. 选型与项目初始化
创建项目
HBuilderX → 文件 → 新建 → 项目（见下图）
目录要点
├── pages/ # 页面（你的业务代码）
├── static/ # 静态资源（音频/图片/字体）
├── manifest.json # 应用配置、权限、图标、启动图
└── pages.json # 路由与导航栏配置
建议：先用 H5 模式验证交互与路由，再上模拟器/真机，缩短调试回路。
3. DevEco Studio 模拟器（先跑通流程）
如果只是演练流程，可先起模拟器：
在 DevEco Studio 新建空项目 → 打开 设备管理器
选择默认模拟器型号
安装后点击启动
启动完成即有一台“真机”可用
注意（以你当前环境为例）：DevEco 5.1.1 Beta 下，下载 API 19 模拟器即可运行 uni-app 鸿蒙项目与元服务，其它模拟器暂不支持。
4. 调试证书（HBuilderX 一键配置）
进入 AGC：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#
创建 APP ID（包名要与项目一致）
回到 uni-app 项目，打开 manifest.json → 鸿蒙 App 配置 → 调试证书配置 → 配置
填入与 AGC 一致的 包名 → 点击 一键配置 → AGC 授权后自动生成证书 → 保存
5. 本地调试（H5→模拟器/真机）
H5 调试（建议先走一遍，保证功能基本正确）
鸿蒙端调试
HBuilderX 顶部 运行 → 运行到手机或模拟器 → 运行到鸿蒙
选择设备；若无设备，刷新或重启模拟器后再刷新
点击运行，自动打包并安装到模拟器进行调试
通过标准：完成核心流程、权限弹窗、前后台切换、冷启动、异常路径回归后再考虑发布。
6. 发布证书（生成 & 申请）
6.1 在 DevEco Studio 生成私钥与 CSR
DevEco Studio → 随便新建个项目 → 构建 → 生成私钥和证书请求（CSR）文件
弹窗中 New → 选一处目录（文中称 目录 A），密码保持一致
记住 Alias（后续会用）→ 下一步
将 CSR 文件保存到 目录 A
点击 Finish，完成 CSR 生成
6.2 在 AGC 申请发布证书 & Profile
AGC → 证书/APP ID/Profile → APP ID → 证书 → 新增证书
选择 发布证书，上传本地 CSR（目录 A），名称随意
保存并下载证书到 目录 A
进入 Profile → 按引导 新增 Profile → 下载到 目录 A
7. 在 HBuilderX 配置发布证书
打开项目 manifest.json → 鸿蒙 App 配置 → 正式证书配置 → 配置
证书/私钥/Profile 均从 目录 A 选择（同后缀基本不会选错）
私钥别名填写之前记录的 Alias → 保存
8. 本地打包（生成鸿蒙安装包）
HBuilderX → 发行 → HarmonyOS 本地打包（名称以你版本为准）
成功后获得鸿蒙安装产物（包含 HAP 的安装包）
自测清单：冷启动/热启动、横竖屏、网络/离线、权限拒绝后流程、前后台恢复、长列表滚动、音频/图片资源是否打进包
常见坑
包名/证书/Profile 不匹配 → 无法安装或覆盖
静态资源路径不规范 → 音频/图片找不到
权限未声明 → 能力调用失败
9. 上架流程（AGC）
AGC → 证书、APP ID 和 Profile → APP ID → 找到你的 APP ID → 发布
按流程填写：应用信息、分级与分类、权限用途说明、隐私政策、素材（图标/启动图/截图/视频）
上传安装包，完成检查 → 提交审核
10. 提审前强烈建议：
1.云真机回归
AGC → 开发与服务 → 选择项目 → 质量 → 云调试（云真机）
多机型跑用例：首次启动、权限拒绝/允许、深色模式、分辨率适配、音视频设备权限、异常网络
修复兼容性问题后再提交，显著提高过审率
2.图标配置
在manifest.json中记得配置好下面三张图，提高过审几率
