HBuildX 打包成apk完整过程

场景

如果要将HBuildX中配置的appID与页面云端一致，可以直接去改文件中的appId配置，然后关了HBuilderX 再打开就能一致了。

https://dev.dcloud.net.cn/pages/app/list

https://dev.dcloud.net.cn/pages/app/list

当前项目文件是 src/manifest.json。

打包

1. 把开发者中心的 appid 回填到 manifest.json

1. 在 HBuilderX 左侧打开 manifest.json
2. 不要停留在可视化页面
3. 切到 源码视图
4. 找到这一行：

"appid": "__UNI__7DFE3xx"

1. 改成：

"appid": "__UNI__9DA47xx"

1. 保存
2. 关闭这个 manifest.json 标签，再重新打开一次
3. 看可视化页面里 DCloud AppID 是否已经变成 __UNI__9DA47xx

如果没变：

• 先确认 HBuilderX 登录的是和开发者中心相同的 DCloud 账号
• 再重启一次 HBuilderX

官方也说明了：appid 可以在 HBuilderX 里生成，也可以在开发者中心创建；如果要换成别的 appid，要直接改 manifest.json 里的 appid 字段。

参考：

• uni-app App 基础说明

2. 填 Android 包名

这一步也在 manifest.json 里做。

你可以用可视化界面找：

• 基础配置
• 旁边的 Android配置
  或者左侧和 Android 相关的配置项里，找到 包名

建议你直接填这个：

com.xianxunji.smartaroma

包名规则：

• 只能小写字母、数字、点
• 不能有中文、空格、下划线
• 首次正式发包后尽量不要再改

你这次如果只是自己测试，这个包名也完全够用。

另外顺手确认这几个值：

• 应用名称：SmartAroma
• 版本名称：1.0.0
• 版本号：100

官方文档里说明了，应用名称、版本号这些都在 manifest.json 基础配置里设置。

参考：

• App 基础配置
• 真机运行 FAQ（说明 uni-cli 项目的 manifest 在 src 下）

3. 在 HBuilderX 里正式点"云打包 APK"

1. 左侧先点中项目根目录：

frontend

1. 点击顶部菜单：

发行 -> 原生App-云打包

1. 在弹出的打包窗口里，选择：
   • 平台：Android
   • 包类型：APK
2. 检查打包信息：
   • appid：应当是 __UNI__9DA47xx
   • 应用名称：SmartAroma
   • Android 包名：com.xianxunji.smartaroma
   • 版本名称：1.0.0
   • 版本号：100

4. 证书怎么选

如果你现在只是先把包打出来安装测试，建议：

• 先选 云端证书

这样最省事。

如果你准备以后一直升级这个 App，或者要发给别人长期安装，建议尽快改成：

• 自有证书(.jks / .keystore)

因为同一个包名如果以后换证书，安装升级会有问题。

参考：

• DCloud 证书/签名说明

5. 开始打包

1. 确认配置都对
2. 点击 打包
3. 等云端完成
4. 点击下载生成的 APK

6. 安装到手机

1. 把 APK 传到手机
2. 点安装
3. 如果提示"未知来源"，给安装权限
4. 安装完成后就能打开

你现在最推荐的实际顺序

1. 先改 manifest.json 里的 appid
2. 再填 Android 包名：com.xianxunji.smartaroma
3. 再去 发行 -> 原生App-云打包
4. 先用 云端证书
5. 输出 APK