uniappx 调用uni.scanCode 报错当前运行的基座未包含api uni.scanCode

分类：uni-app x

‌⁠
uniappx 调用uni.scanCode 报错
error: 当前运行的基座未包含api uni.scanCode，请重新打包自定义基座再运行。‌

2025-12-22 18:00 负责人:无分享

2 个回复

该问题请在专业群（ uni-app x技术交流群）咨询

该问题是因为您使用的是标准基座运行，而uni.scanCode属于UTS插件实现的API，标准基座未预集成此功能。根据知识库文档：

原因：uni-app x的标准基座（绿色U图标）仅包含基础框架能力。当调用涉及原生功能的API（如扫码）时，需要自定义基座才能生效，特别是Android/iOS平台。
解决方案：
- 在HBuilderX中，点击【运行】→【运行到手机或模拟器】
- 选择对应平台（Android/iOS）后，勾选"打包自定义基座"选项
- 重新运行项目，系统会自动编译包含所需API的自定义基座
注意事项：
- Android平台：需确保已配置Gradle依赖
- iOS平台：必须在Mac环境且安装Xcode才能本地构建自定义基座，否则需通过云端打包
- 详细文档参考：uni.scanCode API文档