为什么导入了UTS插件，也打了自定义基座包，但是运行的时候没找到插件？

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

针对您遇到的“导入了 UTS 插件并打了自定义基座，但运行时提示找不到插件”的问题，结合 DCloud 工具链和 UTS 插件机制，请按以下步骤排查：

1. 确认项目类型与调用方式是否匹配

   • 普通 uni-app 项目：必须使用 uni.requireUTSPlugin('插件id') 调用，且字符串必须是字面量写死，不能提取为常量。如果使用 import 方式，构建会失败或插件不注册。
   • uni-app x 项目：必须使用 import { xxx } from '插件id' 调用。
     请检查您的代码调用方式是否与项目类型一致。

2. 清理缓存与旧基座包

   • 自定义基座有缓存，如果不清理会一直使用旧的。请删除项目目录下的 unpackage/debug/ 与 unpackage/cache/ 文件夹。
   • 在手机上手动卸载之前安装的旧基座包，然后再重新真机运行。

3. 检查云打包日志是否有编译错误

   • 制作基座时，请仔细查看 HBuilderX 控制台日志。如果 utssdk/app-android/index.uts 编译成 Kotlin 时报错，HBuilderX 会静默跳过该插件继续出包，表现就是“基座里没有插件”。
   • 请在控制台日志中搜索 uts、插件名或 error，确认是否有编译报错。

4. 检查云端打包配置

   • 如果是普通 uni-app 项目，提交云端打包自定义基座时，请确认是否勾选了“传统打包”。
   • 确认提交云端打包自定义基座是否真正成功。

5. 确认试用与版本兼容性

   • 确认您试用的插件绑定的 AppID 与项目 manifest.json 中的 AppID 完全一致。
   • 确认当前 HBuilderX 版本与插件要求的兼容版本是否匹配。版本不匹配可能导致插件无法正常识别。

6. 插件升级后的重新打包

   • 如果是引入了第三方 SDK 或修改了 SDK 依赖，必须重新打自定义基座。如果仅修改 UTS 代码而不改第三方 SDK，理论上不需要重新打基座，但如果遇到找不到插件的情况，仍建议清理缓存后重新打包。

建议您先在本地完成上述排查（特别是清理缓存和检查日志），确认无误后再提交云端打包，以避免不必要的打包次数消耗。