- 发布:2026-03-17 18:10
- 更新:2026-03-17 18:14
- 阅读:23
欢迎到专业群( HBuilderX技术交流群 ) 咨询,群中有相关专业的管理员和群友。
已经购买插件但无法打包,通常由以下几种情况导致,请逐一排查:
1. 插件授权类型限制(离线打包场景)
插件市场购买的插件分为普通授权和源码授权两种。如果你购买的是普通授权版,目前不支持离线打包,只能使用云端打包。只有购买源码授权版的插件才支持离线打包。自己编写的原生插件可以任意打包。
2. AppID 或包名不一致
插件市场的原生插件(含付费插件)在下单时将「AppID + Android包名」一起写进了授权记录。如果打包时的 AppID 或包名与购买时绑定的不一致,云端打包校验会失败并提示"未购买"。
请检查:HBuilderX项目中的 manifest.json 里的 AppID 和包名,是否与插件市场购买时绑定的完全一致(区分大小写)。一旦绑定包名后无法修改,如果包名变更需要重新购买插件。
3. 未正确配置云端插件
即使已购买,也需要在项目中显式启用插件。操作路径:打开项目 manifest.json → 找到"App原生插件配置" → 在"云端插件"列表中勾选已购买的插件。如果列表中没有显示,尝试删除该插件重新选择。
4. 未正确导入插件
如果购买的是源码授权版,在购买前有导入过试用版,请删除HBuilderX中导入的试用版插件重新导入源码授权版。
5. 试用插件限制
如果购买的是试用插件,只能在自定义基座中使用,不能用于正式云打包。需要购买正式授权后才能打包正式版。
6. 版本兼容问题(旧版本HBuilderX)
如果使用 HBuilderX 2.7.14 以下版本,且同一插件在同一 AppID 下绑定了多个包名,可能会出现包名绑定不一致的提示。需要在 manifest.json → "App原生插件配置" → "云端插件"列表中删除该插件后重新选择。
建议排查步骤:
- 确认打包方式:普通授权插件必须使用云端打包,不能离线打包
- 核对 manifest.json 中的 AppID 和包名与插件市场购买记录完全一致
- 重新选择云端插件:manifest.json → App原生插件配置 → 删除该插件后重新勾选
- 确认不是试用插件(试用插件只能打自定义基座)
如果以上检查均无误仍无法打包,且你使用的是 HBuilderX 3.0 以上版本,建议到 uni-app 官方技术交流群 咨询,或发送邮件到 service@dcloud.io 提供订单号、AppID、包名等信息进行核查。