r***@sina.com
r***@sina.com
  • 发布:2026-01-22 17:50
  • 更新:2026-01-22 18:42
  • 阅读:33

在uts插件中引入第三方sdk,运行时报错;使用 Hello uts实例项目也报错,请问是哪里的问题

分类:uts


报错内容如上图,项目中的是下图

2026-01-22 17:50 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

根据您提供的截图和描述,“在 uts 插件中引入第三方 SDK 后运行报错,连 Hello UTS 示例项目也报错”,结合官方文档,问题根因是:您当前使用的是标准运行基座,而 uts 插件中引入了第三方原生 SDK,必须使用自定义基座才能运行


✅ 官方依据

引用官方文档:uts-component-compatible > 运行和测试
“在当前例子中,因为配置了额外的第三方依赖,需要自定义基座方能使用。”


✅ 具体原因

  • 标准运行基座不包含您引入的第三方 SDK(如 .aar.framework.jar 等),因此运行时会直接崩溃或报错。
  • Hello UTS 示例项目本身也依赖了某些第三方 SDK(如 Lottie、腾讯定位等),同样需要自定义基座才能运行。

✅ 解决方案(分步操作)

步骤一:制作自定义运行基座

  1. 打开 HBuilderX
  2. 点击菜单栏:运行运行到手机或模拟器制作自定义运行基座
  3. 在弹出的窗口中,勾选您项目中用到的所有原生插件(包括 uts 插件)。
  4. 等待云端打包完成后,再选择 运行到自定义基座

步骤二:确保第三方 SDK 已正确集成

  • Android
    • .aar.jar 文件放入 uni_modules/xxx-plugin/utssdk/app-android/libs/ 目录。
    • config.json 中配置依赖,例如:
      "dependencies": [  
      "com.xxx:xxx-sdk:1.0.0"  
      ]  
  • iOS
    • .framework 文件放入 uni_modules/xxx-plugin/utssdk/app-ios/Frameworks/ 目录。
    • config.json 中配置依赖,例如:
      "dependencies": [  
      "xxx-sdk"  
      ]  

✅ 验证方式

  • 使用自定义基座重新运行项目。
  • 如果 Hello UTS 示例也报错,同样需要用自定义基座运行,因为它也依赖了第三方 SDK(如 Lottie)。

❗ 注意事项

  • H5 平台:uts 插件不支持 H5,必须运行到 App(Android/iOS)鸿蒙
  • 鸿蒙平台:需使用鸿蒙专用基座,鸿蒙不支持 app-plus 相关内容。

✅ 总结

只要 uts 插件中引入了第三方原生 SDK,就必须使用自定义基座运行,标准基座无法识别这些依赖,必然报错。

如果您已使用自定义基座仍报错,请贴出具体报错日志,我可以继续帮您定位。

内容为 AI 生成,仅供参考
r***@sina.com

r***@sina.com (作者)

制作本地基座报错,


报错代码

要回复问题请先登录注册