uniapp 模块集成
uniapp 模块集成方法
uniapp 支持通过原生插件或 npm 模块扩展功能,以下是常见集成方式:
原生插件集成
开发原生插件需分别实现 Android(Java/Kotlin)和 iOS(Objective-C/Swift)代码,打包后放入 uni-app 项目的 nativeplugins 目录。配置 pages.json 引入插件:
"plugins": {
"myPlugin": {
"version": "1.0.0",
"provider": "org.example.uniplugin"
}
}
npm 模块集成
支持 Vue 生态的 npm 包,通过命令行安装后直接引入使用:
npm install lodash-es
在代码中调用:
import _ from 'lodash-es'
uni_modules 规范
符合 uni_modules 规范的模块可直接从插件市场导入,模块需包含 package.json 和 uni_modules 目录结构。通过 HBuilderX 右键菜单快速安装。
条件编译处理平台差异
使用预处理指令区分不同平台逻辑:
// #ifdef APP-PLUS
const module = require('native-module')
// #endif
注意事项
- 原生插件需测试真机运行效果,模拟器可能无法调用
- 第三方 SDK 需检查是否支持跨平台
- 安卓插件需配置
AndroidManifest.xml权限 - iOS 插件需处理 Podfile 依赖和权限声明







