插件接入
本节说明如何将网易七鱼 Uniapp 原生插件导入项目,并完成 AppKey 配置和调试基座制作。原生插件的通用导入流程也可以参考 Uniapp 官方文档。
导入原生插件
将插件包导入到 Uniapp 工程的 nativeplugins 目录中。如果项目中没有该目录,可以在项目根目录手动创建。
目录示例:
your-uniapp-project/
nativeplugins/
Netease-QiyuModule/配置 AppKey
在 manifest.json 中配置原生插件:
- 打开
manifest.json。 - 进入「App 原生插件配置」。
- 选择「本地插件」。
- 导入七鱼插件包。
- 填入七鱼管理后台申请到的
appKey。
如果没有配置 appKey,运行时会提示“请在原生插件配置里面填入网易七鱼appKey”。

制作自定义调试基座
因为七鱼 Uniapp 插件是原生 SDK 插件,普通基座无法直接运行插件能力。调试前需要在 HBuilderX 中制作自定义调试基座:
运行 -> 运行到手机或模拟器 -> 制作自定义调试基座制作时选择对应平台和打包证书。
安装应用
自定义调试基座制作完成后,在 HBuilderX 中运行到对应 App 基座:
运行 -> 运行到手机或模拟器 -> 运行到 Android App 基座
运行 -> 运行到手机或模拟器 -> 运行到 iOS App 基座安装的是带有七鱼原生插件的 App 包。安装完成后,再按使用流程调用插件 API。
这篇文档有帮助吗?