包名不一致即视为两个独立App，Android系统以android.package为唯一标识；正式版推荐com.yourcompany.app，测试版用com.yourcompany.app.beta；包名须在manifest.json的“App Plus→Android原生配置→包名”中填写，不可为空。
包名不一致就等于两个独立App
uni-app 打包 Android 时，android.package（即包名）是系统识别 App 唯一性的核心依据。哪怕只改一个字母，比如把 com.myapp 改成 com.myapp.test，安装后就是两个并存的图标、两套独立数据、互不干扰——这正是“同时装正式版和测试版”的底层原理。
常见错误现象：
• 更新测试版后，跳转页面失效、缓存清不掉 → 很可能是新包名没改，旧 APK 被覆盖，但 HBuilderX 缓存或路由状态没重置；
• 手机上只看到一个图标，测试版装不上 → 提示“已存在同名应用”，说明包名重复了。
- 正式版推荐用
com.yourcompany.app，测试版用com.yourcompany.app.beta或com.yourcompany.app.debug - 包名必须在
manifest.json的 “App Plus” → “Android 原生配置” → “包名” 中填写，不是文件名也不是应用名称 - 云打包时若未填包名，HBuilderX 会报错或静默失败，右下角打包按钮无反应 —— 先检查这个字段是否为空
签名证书不能混用，测试版也建议自签
用公共测试证书（如 HBuilderX 默认云打包提供的）打正式包，用户安装时大概率遇到“解析包时出现问题”或“此应用未通过 Google Play 验证”等提示；而反过来，拿正式 keystore 打测试包，虽然能装，但每次更新都得输密码、流程重、不利于快速迭代。
实操建议：
• 测试版也走自签名流程，只是有效期、密码强度可适当放宽；
• 正式版 keystore 必须离线保管，别提交到 Git；
• keystore 文件路径、storepassword、keypassword、keyalias 四者必须和 manifest.json 中配置完全一致，大小写、空格都不能错。
- 生成测试证书命令示例：
keytool -genkeypair -v -keystore test-release-key.jks -keyalg RSA -keysize 2048 -validity 365 -alias testkey - 配置位置：
manifest.json→"app-plus"→"distribute"→"android"下的四个字段 - 如果证书路径含中文或空格，打包会失败 —— 放到
D:/keystore/这类干净路径下最稳
云打包每天限 5 次，本地打包更可控
免费云打包有硬限制：每天最多 5 次（按 dcloud 账号计），超次后需等 24 小时或开通付费服务。一旦中间出错（比如权限没开、图标尺寸不对、启动图没配 .9.png），一次就没了，调试成本很高。
本地打包虽要装 JDK + Android SDK，但好处明显：
• 错误信息直接输出在控制台，能准确定位到哪行 manifest 写错、哪个资源缺失；
• 可反复构建、秒级验证；
• 不依赖网络和 dcloud 服务器稳定性。
- JDK 推荐用
jdk-1.8.0_291或jdk-11.0.20，太高（如 jdk-21）HBuilderX 当前版本可能不兼容 - Android SDK 路径必须在 HBuilderX “设置 → 运行配置 → Android SDK 路径” 中手动指定，不能靠自动探测
- 首次本地打包失败？先运行
adb devices看能否识别模拟器或真机，这是很多“打包成功却找不到 apk”的根源
manifest.json 里几个关键字段容易漏填
很多人只改了应用名称和图标，却忽略几个决定性字段，导致打包后白屏、闪退、权限缺失或无法联网。这些不是“可选项”，而是 Android 平台运行的硬性要求。
-
"name"（应用名称）：显示在手机桌面的名称，不是 apk 文件名 -
"versionName"和"versionCode"：前者是用户看到的1.2.0，后者是纯数字（如10200），每次发版必须递增，否则系统拒绝升级安装 -
"permissions"数组里至少要有"android.permission.INTERNET"，否则所有网络请求 404 - 如果用了 uni.chooseImage、uni.getLocation 等 API，对应权限（如
"android.permission.READ_EXTERNAL_STORAGE"）必须显式声明，Android 11+ 还要加android:requestLegacyExternalStorage="true"兼容
最常被忽略的是 versionCode：它不参与展示，但决定能否覆盖安装。值太小，新包装不上；值重复，系统认为“没更新”。别手填，用脚本自增或记事本管理好。
