i***@wtsui.cn
i***@wtsui.cn
  • 发布:22 分钟前
  • 更新:22 分钟前
  • 阅读:14

uni-app升级uni-app x 后 蒸汽模式云打包打不出自定义基座?我踩的 3 个坑和排查方法

分类:ASK社区

环境:Windows + HBuilderX 5.34(uni-app x 蒸汽模式 / Vapor)+ Android 云打包自定义调试基座
结论先行:不是证书、不是版本、不是原生插件,真正的原因是 manifest.json 里 Android 图标多套了一层 android。

一、症状:三种报错轮着来,看起来毫无关联
同样一个工程,改动一点点,报错就换一副面孔:

报错 出现时机
打包参数配置错误,manifest.json 中的 Android 包名不存在 提交后 4 秒被拒
打包参数无法解析,请关闭电脑上安装的加密软件、杀毒软件… 提交后 4 秒被拒(换自有证书后)
Error code = -5000 Error: empty keystore or aliasname in manifest.json! 提交成功 → 排队 → 构建到一半才失败
服务器异常,请重新提交打包。错误代码:[uni-secure-network] 50000 提交后 2 秒被拒
最关键的一点:这些报错来自云端不同的校验阶段,所以「换一种证书 / 重新打包」会得到不同报错 —— 很容易误以为是随机问题,其实是同一处配置错误在不同阶段暴露。

二、先搞清一件事:云打包读的是编译产物,不是你的 manifest.json
云打包上传的是编译输出:

unpackage/dist/build/app-android/manifest.json
它由编译器 normalizeManifestJson 生成,规则很粗暴:

// @dcloudio/uni-app-uts/dist/plugins/utils.js
const manifest = {
id: userManifestJson.appid, // appid → id
name: userManifestJson.name,
version: { name: versionName, code: versionCode }, // versionName/versionCode → version
'uni-app-x': x,
};
manifest[platform] = userManifestJson[platform]; // 只整棵拷贝 app-android!
由此得到两个反直觉结论:

源码里的 app-plus.* 会被整段丢弃,写在那里等于没写(把包名写进 app-plus.distribute.android.packagename 完全无效)。
产物里 appid 变成 id、versionName/versionCode 变成 version:{name,code} 是正常转换;别拿产物去开 HBuilderX 可视化界面看 —— 面板按源码键名取值,当然显示空白。

三、坑 1:包名 —— x 的 manifest 里没有「包名」这一栏
翻 HBuilderX 自带的 x 版 schema 可以确认:

plugins/hbuilderx-language-services/jsonservice/src/schemas/manifestUniAppx.json
app-android.distribute 的合法字段是:

syncDebug / icons / splashScreens / modules / permissions / excludePermissions /
minSdkVersion / targetSdkVersion / abiFilters / enableResourceOptimizations /
aaptOptions / buildFeatures / packagingOptions
没有 packagename。但云端构建时又必须有包名(updateManifestFile 在提交前会注入,逻辑包在 try{...}catch{return false} 里,且调用处不检查返回值 —— 静默失败时云端就只能报「包名不存在」)。

解法:直接写进源码,编译产物必然带上:

"app-android": {
"distribute": {
"packagename": "com.yourcompany.yourapp"
}
}

四、坑 2(真正的元凶):Android 图标多套了一层 android
最初按经典 uni-app 的习惯这样写:

"icons": {
"android": {
"hdpi": "unpackage/res/icons/72x72.png",
"xhdpi": "unpackage/res/icons/96x96.png"
}
}
而 uni-app x 的 schema 是扁平的:

// schema: app-android.distribute.icons.properties = hdpi / xhdpi / xxhdpi / xxxhdpi
"icons": {
"hdpi": "unpackage/res/icons/72x72.png",
"xhdpi": "unpackage/res/icons/96x96.png",
"xxhdpi": "unpackage/res/icons/144x144.png",
"xxxhdpi": "unpackage/res/icons/192x192.png"
}
多那一层,云端就解析不了,表现为「打包参数无法解析」或「服务器异常 50000」。

补充:app-ios.distribute.icons 只有 appstore 一项,本来就是对的,不用改。

五、坑 3:uni-app x 只能用「自有证书」
CLI 帮助写得很明确(cli pack --help):

--android.androidpacktype Android 打包证书类型,默认值为 0。
可选值:0 使用自有证书,1 使用公共证书,2 使用 DCloud 老版证书,3 使用云端证书
(1、2 仅适用于 uni-app 项目)
也就是说 1 / 2 / 3 三种免文件的证书类型对 x 项目都无效。选「云端证书」时看起来正常(能进队列),但构建到签名阶段就报 -5000 empty keystore or aliasname。

正确做法:自己生成一份 keystore,别名和口令都确定:

keytool 在 HBuilderX 自带的 JDK 里

& 'C:\Program Files\HBuilderX\plugins\amazon-corretto\bin\keytool.exe' -genkeypair -v -alias myapp -keyalg RSA -keysize 2048 -validity 36500
-keystore .\myapp.keystore -storepass <口令> -keypass <口令> `
-dname "CN=myapp,OU=dev,O=myapp,L=Beijing,ST=Beijing,C=CN"

证书永远别进仓库

.keystore
.jks
.keystore/

六、排查手法:两个能省下几个小时的技巧

  1. 用 CLI 打包 + pack status,拿「真实报错」
    GUI 只给一行中文,错误日志链接里才有 Error code。而且 CLI 提交失败是秒回(4 秒),非常适合做对照实验:

cd 'C:\Program Files\HBuilderX'

.\cli.exe pack --project D:/projects/myapp --platform android --android.packagename com.yourcompany.yourapp --android.androidpacktype 0
--android.certfile D:/keystore/myapp.keystore --android.certalias myapp --android.certpassword <口令> --android.storepassword <口令>
--iscustom true

.\cli.exe pack status --project D:/projects/myapp

  1. 建「5 文件最小工程」做二分,隔离工程因素
    另建一个最小 uni-app x 工程(不碰正式工程代码),用同一个 appid 试打包,然后一组一组往里加字段:

probe/
manifest.json ← 必须含 "uni-app-x": { "styleIsolationVersion": "2" };
不写 vapor 就是 VDOM 模式(这也是「非蒸汽版」的验证办法)
pages.json
App.uvue
main.uts
pages/index/index.uvue ← <script> 不写 lang(VDOM 用 uts;lang="ts" 是蒸汽模式才支持的)
二分矩阵(每轮约 1 分钟,因为失败是秒回):

组 加进探针的字段 结果
A 11 条 uses-permission ✅ 提交成功 → 权限数组无罪
B modules + enableResourceOptimizations + icons + splashScreens ❌ 50000
B3 去掉 splashScreens ❌ 仍 50000
B4 再去掉 icons ✅ 成功 → 元凶锁定
C 用扁平 icons 放回去 ✅ 成功 → 写法确认
小提醒:manifest.json 里若缺 uni-app-x 节点,HBuilderX 会把工程当经典 uni-app,去找 main.js,然后报 Entry module not found: Can't resolve '...\main.js'。这个节点是项目类型识别依据。

七、最终可用的 manifest.json(Android 关键片段)
{
"appid": "UNIXXXXXXX",
"versionName": "1.0.0",
"versionCode": "1",
"uni-app-x": {
"styleIsolationVersion": "2",
"vapor": true // 蒸汽模式;去掉即为 VDOM
},
"app-android": {
"distribute": {
"packagename": "com.yourcompany.yourapp", // 坑 1
"icons": { // 坑 2:扁平,别加 android 层
"hdpi": "unpackage/res/icons/72x72.png",
"xhdpi": "unpackage/res/icons/96x96.png",
"xxhdpi": "unpackage/res/icons/144x144.png",
"xxxhdpi": "unpackage/res/icons/192x192.png"
},
"minSdkVersion": 23, // 蒸汽模式硬限制 Android 6.0+
"targetSdkVersion": 36,
"abiFilters": ["arm64-v8a", "armeabi-v7a"],
"permissions": [
"<uses-permission android:name=\"android.permission.CAMERA\"/>",
"<uses-permission android:name=\"android.permission.POST_NOTIFICATIONS\"/>"
]
}
}
}

八、零碎但容易踩的点
同一 appid 同时只能有一个打包任务,否则会弹「检测到本项目已有正在制作的安装包在云端队列中…是否继续提交?」;这个交互确认没法用管道喂 y(会被判为无输入直接退出),只能等前一单结束或在 GUI 点取消。
「正在云端打包」状态下 pack cancel 会失败(不能取消)。
主日志里 [PluginHost] zstd is not executable 是因为缺 plugins/hbuilder.zstd 插件,主要影响 wgt 热更新,与云打包成败无关。
用了 UTS 原生插件的工程,云打包会提示「原生插件…预计 3-30 分钟」,这是正常的云端 Gradle 编译时间,不需要手动下载任何插件。
打包队列高峰期可能要排 100+ 位,20~30 分钟很常见;cli pack status 可随时查位次。

九、结论对照
现象 真正原因 修法
包名不存在 x 的 manifest 无该字段,注入静默失败 源码写 app-android.distribute.packagename
打包参数无法解析 / 50000 icons 多套 android 层 改成扁平 icons.{hdpi,xhdpi,…}
-5000 empty keystore 选了 x 不支持的证书类型(公共/老版/云端) 用自有证书 + 显式传 certfile/alias/口令
产物里 appid 变 id、版本变 version{} 编译期格式转换 正常现象,不要改

0 赞 关注 分享

要回复文章请先登录或注册