离线打包前必须核对的三个ID是否一致：HBuilderX资源文件夹名、dcloud_control.xml中的节点值、manifest.json中的"appid"字段，三者必须完全相同，不可大小写混用或增删下划线。
离线打包前必须核对的三个ID是否一致
白屏、启动闪退、资源加载失败——八成是这三个id没对齐。不是“差不多就行”，而是必须完全相同：__uni__123456 这串id在三个地方强制绑定：hbuilderx生成的资源文件夹名、assets/data/dcloud_control.xml 里的 manifest.json 中的 "appid" 字段。
- 操作时别手动改ID，直接从 HBuilderX 的“发行 > 原生App-本地打包”控制台输出里复制完整路径中的 ID（例如
D:\project\unpackage\resources\__UNI__123456） - 替换
assets/apps/下原有文件夹时，整个文件夹名必须是apps.__UNI__123456.www，不能多空格、不能少下划线、不能大小写混用 -
dcloud_control.xml文件里只改__UNI__123456
build.gradle 中最易填错的 signingConfigs 和 applicationId
签名配置写错，打包能过，安装后一打开就崩溃；applicationId 写错，应用装不上或被系统识别为另一个APP——这两处不是“配个名字”，而是安卓系统级校验依据。
-
applicationId必须和你在 DCloud 开发者中心“各平台信息”里填写的 Android 包名完全一致，比如填的是com.myapp.prod，那build.gradle里 defaultConfig 下的applicationId "com.myapp.prod"就不能写成"com.myapp"或漏掉引号 -
signingConfigs里keyAlias不是随便起的，它必须等于你证书生成时指定的 alias（比如keytool -genkeypair -alias myapp_release ...），也必须和 DCloud 后台“Android 云端证书”页显示的“别名”一致 -
storeFile file('myapp.jks')的路径是相对app/目录的，证书文件得真正在app/myapp.jks，而不是放在桌面或项目根目录
AndroidManifest.xml 和 dcloud_appkey 的硬编码位置
这个 meta-data 标签不填对，App 启动时连 WebView 都拉不起来，报错日志里通常只有 E/WebViewFactory: Chromium WebView package does not exist 这类误导信息，实际根源在这里。
- 找到
app/src/main/AndroidManifest.xml，定位到 - value 值必须是从 DCloud 后台“离线打包Key管理”页面复制的 Android 对应 key，不是 AppID，也不是云端证书的 SHA256
- 别手抖多空格或换行，XML 对空白敏感；也不要用中文引号，必须是英文双引号
- 该标签不能放在
Gradle 和 JDK 版本不匹配导致构建卡死或报错
AS 提示 “Could not resolve com.android.tools.build:gradle:x.x.x” 或 “Unsupported class file major version 65”，基本就是 Gradle 和 JDK 版本打架了——这不是网络问题，是工具链断层。
- 查 SDK 包里
gradle/wrapper/gradle-wrapper.properties的distributionUrl，比如是gradle-8.11.1-bin.zip，那就必须配 JDK 17（JDK 17 → class file major version 61；JDK 21 → 65；Gradle 8.11 官方要求 JDK 17–21） - 在 AS 中：File → Settings → Build → Gradle → Gradle JDK，选中已安装的 JDK 17，不要用 AS 自带的 embedded JDK（它版本常滞后）
- 如果用了腾讯镜像加速，确认
distributionUrl=https://mirrors.tencent.com/gradle/gradle-8.11.1-bin.zip这个地址能直接浏览器打开并下载成功，否则会静默超时
真正卡住人的从来不是步骤多，而是某处 ID 多了个下划线、某行引号用了中文、或者证书 alias 和后台填的不一致——这些地方没有错误提示，只有沉默的白屏。
