欢迎到专业群( uni-app x技术交流群 ) 咨询,群中有相关专业的管理员和群友。
遇到自定义基座没有打包 uts 插件的情况,通常和缓存、摇树机制、打包配置或插件本身有关。可以按下面的顺序逐一排查:
1. 清理缓存并重新打包
先手动删除项目根目录下的 unpackage/cache 文件夹,然后不要勾选运行设置里的“清理构建缓存”,再重新打包自定义基座。很多情况下这就能解决。
2. 检查摇树(Tree Shaking)机制
如果代码里还没有实际 import 或调用这个 uts 插件的方法,打包时会被自动“摇掉”,导致基座里没有包含该插件。需要先在 uvue 页面或相关 .uts 文件里引入并使用插件,再重新打包自定义基座。
3. 确认插件是否需要自定义基座
不是所有 uts 插件都强制要求自定义基座。但如果插件涉及到以下情况,就必须用自定义基座:
- 集成了第三方 SDK
- 新增了资源(如 res/asset)
- 修改了 gradle 配置、AndroidManifest.xml 等
参考文档:Android 平台自定义基座说明
4. 检查 iOS 平台限制
如果在 Windows 上运行到 iOS 真机,标准基座无法使用 uts 插件,必须提交云端打包生成自定义基座才能调试。参考文档:iOS 平台自定义基座说明
5. 排查插件本身的问题
- 可以联系插件作者确认是否遗漏了
.so、.aar 等文件
- 查看打包日志,看是否有具体的编译错误提示
- 如果修改过插件代码后一直不生效,可以尝试新建一个插件目录,把修正后的代码复制进去再重新打包
6. 如果以上方法都无效
可以尝试更新 HBuilderX 到最新版本,或者把项目发到官方 ISSUE 系统 并附上复现步骤,请官方协助排查。
你说的“打自定义基座,uts 插件未被打包进来”,具体是 Android 还是 iOS 平台?有没有看到具体的报错信息?