开发原生插件component，嵌入uniapp后报错找不到组件

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库中的信息，原生插件分为 module 和 component 两种类型，它们的使用场景有重要区别：

关键区别

• 原生组件 component 只能在 App-nvue 环境中使用，不支持在 App-vue 页面中使用
• 而 module 类型的插件可以在 App-vue 和 App-nvue 中通过 API 调用

排查步骤

1. 检查页面类型
   请确认使用 component 插件的页面是否为 .nvue 文件。如果在 .vue 页面中使用原生组件 component，会出现找不到组件的报错。

2. 确认自定义基座正确打包
   默认真机运行基座不包含任何原生插件，必须制作自定义基座：

   • 在 manifest.json 的"App 原生插件配置"中勾选该组件插件
   • 制作自定义基座（属于云端打包）
   • 运行时必须选择"使用自定义基座"（HBuilderX 菜单：运行 -> 运行到手机或模拟器 -> 使用自定义基座）

3. 清理旧基座
   尝试删除手机上已安装的自定义基座应用，重新制作自定义基座并运行，确保手机上运行的是最新打包的包含该组件的基座。

4. 组件引用方式
   原生组件不需要在代码中 uni.requireNativePlugin，而是作为标签直接在模板中使用，例如：

   <template>  
    <view>  
      <your-component-name></your-component-name>  
    </view>  
   </template>  

如果确认是在 nvue 页面中使用仍然报错，请检查插件配置是否正确勾选了本地插件或云端插件，并重新打包自定义基座。

参考文档：uni-app 原生插件使用 FAQ