UniApp APP 鸿蒙发布全流程实操(最新！)

前端赵哈哈
128 阅读5分钟

本文基于 UniApp 官方文档与华为开发者指南，详细讲解 Vue3 版本 UniApp 项目从调试到发布上架鸿蒙系统的完整流程，适配 HBuilderX 4.87、DevEco Studio 6.0.0 最新版本。

参考文档

前置准备

核心前提：仅支持 Vue3 项目编译到鸿蒙平台，以下工具版本为实操验证过的最新稳定版

  • 注册鸿蒙开发者账号，地址
  • HBuilderX 4.24+ 下载地址，我目前用的是4.87（最新）
  • DevEco Studio 下载地址，用的是6.0.0（最新）

核心流程

发布分为两个阶段（建议先调试后发布）：

  1. 调试阶段：确保应用能在鸿蒙模拟器正常运行
  2. 发布阶段：完成签名、打包、上架全流程

第一步：DevEco Studio 新建项目

  1. 打开 DevEco Studio，按以下截图步骤创建项目：

image.png

image.png

  1. 完成以上两步，鸿蒙项目创建成功

1.1 证书认证（生成.P12 密钥库 + .csr 文件）

密钥和证书是应用签名的核心，需妥善保存密码和文件

步骤 1：选择密钥生成方式

image.png

image.png

  • 已有密钥：点击Choose Existing
  • 无密钥（新建）：点击New

步骤 2：新建密钥库（New）

image.png

填写关键信息（密码需牢记）：

  • Key Store File：设置.p12 文件存储路径 + 文件名
  • Password：密钥库密码（要求：8 位以上，含 2 种以上字符：大写 / 小写 / 数字 / 特殊符号）
  • Confirm Password：重复密码

步骤 3：填写密钥详情（Generate Key and CSR）

image.png 在Generate Key and CSR界面中，继续填写密钥信息后，单击Next。

  • Alias：必填，别名，用于标识密钥名称。请记住该别名，后续签名配置需要使用。
  • Password：必填，密码，与密钥库密码保持一致，无需手动输入。
  • Validity(years)： 选填，证书有效期，建议设置为25年及以上，覆盖应用/元服务的完整生命周期。
  • First and last name： 选填，通用名称，可填写应用名称或开发者姓名等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\、（反引号）`。
  • Organizational unit：选填，组织单位，可填写部门名称或个人开发等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\、（反引号）`。
  • Organization： 选填，组织名称，可填写公司全称或开发者姓名等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\、（反引号）`。
  • City or locality： 选填，城市或地区。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\、（反引号）`。
  • State or province： 选填，州或省。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\、（反引号）`。
  • Country code(XX)： 选填，国家码。

image.png

image.png

image.png

image.png

成功了！！！（以上功能也可以通过在该编辑器的终端通过指令操作）

image.png

第二步：华为开发者官网创建应用 & 证书

2.1 登录 AGC 平台

访问华为 AGC 官网，登录已注册的鸿蒙开发者账号：

image.png

  • 创建证书（调试和发布根据自己的来。调试证书，uni-app 是可以自动生成的）

image.png

证书申请成功后，展示证书名称、证书类型和失效日期。点击“下载”，保存证书至本地

image.png App包名也建立成功了

申请发布Profile

官方文档指南
在左侧导航栏选择“证书、APP ID和Profile > Profile”，进入“Profile”页面，点击右上角“添加”。 image.png

发布成功，点击“下载”，将生成的Profile保存至本地，供后续发布签名使用

第三步：配置鸿蒙模拟器

3.1 选择设备 & 下载镜像

  1. 回到 DevEco Studio 项目，选择设备：

image.png

  1. 下载镜像（关键要求）：
  • 镜像版本需与新建项目的 SDK 版本一致
  • SDK 版本≥19（否则应用无法运行） image.png
  1. 下载完成后启动模拟器：

image.png

第四步：UniApp 鸿蒙调试

调试前确保：模拟器已启动 + 包名与项目包名一致

  1. 打开 HBuilderX，进入 UniApp 项目配置页，选择「调试证书」： image.png

  2. 点击「检测」，HBuilderX 会自动识别已启动的模拟器：

image.png

  1. 点击「自动申请调试证书」，完成后即可在模拟器运行项目：

image.png

第五步：UniApp 鸿蒙发布

5.1 配置发布证书

在 HBuilderX 项目配置页，选择「发布证书配置」，上传第二步生成的密钥文件（.p12、Profile 等）：

image.png

5.2 执行发行

点击 HBuilderX 的「发行」按钮，开始打包发布：

image.png

5.3 上架发布（两种方式）

方式 A：自主发布（推荐，完全可控）

image.png

步骤 1：AGC 创建应用
  1. 登录AGC 官网 → 我的应用 → 新建应用 → 选择 HarmonyOS 应用
  2. 填写应用信息（名称、包名、分类），包名必须与打包时一致
步骤 2：上传.app 安装包
  1. 应用详情页 → 版本信息 → 创建版本
  2. 填写版本信息（与打包的versionName/versionCode一致）
  3. 上传已签名的.app文件 → 等待校验完成（AGC 自动检查签名 / 包名 / 版本号）
步骤 3：完善应用信息
  • 基础信息：简介、描述、关键词（突出 UniApp + 鸿蒙特性）
  • 合规信息：分级分类、权限用途说明、隐私政策 URL
  • 素材上传：图标、启动图、截图、视频（符合华为尺寸要求）
步骤 4：提交审核 & 发布

  1. 确认信息完整后点击「提交审核」（审核周期 1-7 个工作日）

  2. 审核通过后：

    • 立即发布：应用直接上架华为应用市场
    • 指定时间发布：设置上架时间，自动发布
    • 手动发布：版本信息页右上角点击「手动发布」

方式 B：授权 DCloud 发布（便捷，快速上架）

  1. 绑定账号：HBuilderX → 发行 → App-Harmony - 授权 DCloud 完成上架 → 绑定 AGC 账号
  2. 打包上传：发行 → App-Harmony - 本地打包 → 生成.app 文件并自动上传至 DCloud 开发者中心
  3. 提审发布：在 DCloud 开发者中心完善应用信息，由 DCloud 协助完成 AGC 提审流程

总结

  1. 核心前提：仅支持 Vue3 项目，需准备 HBuilderX 4.24+、DevEco Studio 6.0.0+、鸿蒙开发者账号；
  2. 核心流程：DevEco 创建项目→生成证书 / Profile→配置模拟器→UniApp 调试→配置发布证书→打包上架；
  3. 上架方式：自主发布（可控）或授权 DCloud 发布（便捷），核心是保证包名、证书、版本号三者一致。
avatar
文章
阅读
粉丝