uni-app原生插件集成指南
准备环境
- Android studio
- 插件市场
- HBuilderX
集成示例
1. 打开Android Studio,创建一个新项目
2. 下载最新版SDK,最新版SDK下载地址
将下载目录/SDK/libs下的lib.5plus.base-release.aar和uniapp-release.aar放入到libs文件夹下(如果需要使用其他功能,可参考SDK中的Feature-Android.xls进行配置)。
将下载目录/SDK/assets下的data文件放入项目assets目录下。
注意:Android studio默认显示的模式是Android模式,需将模式切换到project下才能看见libs文件夹,如果文件夹不存在,需要手动创建
3. 插件市场下载uni-app插件(此处以RichAlert为例)
4. 插件资源配置
将下载的插件解压,将插件中android目录下的aar/jar文件放入libs下,其余文件参考插件文档放入指定文件夹中
5. 在assets目录下创建dcloud_uniplugins.json文件
插件配置信息请参考插件配置文档或插件配置文件package.json 关于package.json请参考:Android uni-app原生插件开发文档
{
"nativePlugins": [
{
"plugins": [
{
"type": "module",
"name": "DCloud-RichAlert",
"class": "uni.dcloud.io.uniplugin_richalert.RichAlertWXModule"
}
]
}
]
}
6. 配置gradle文件
添加指定依赖
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation fileTree(dir: 'libs', include: ['*.aar'])
implementation "com.android.support:recyclerview-v7:28.0.0"
implementation "com.android.support:support-v4:28.0.0"
implementation "com.android.support:appcompat-v7:28.0.0"
implementation 'com.alibaba.android:bindingx-core:1.0.3'
implementation 'com.alibaba.android:bindingx_weex_plugin:1.0.3'
implementation 'com.squareup.okhttp:okhttp:2.3.0'
implementation 'com.squareup.okhttp:okhttp-ws:2.3.0'
// 基座需要,必须添加
implementation 'com.github.bumptech.glide:glide:4.9.0'
}
其余uni-app离线集成事项请参考:Android平台,uni-app离线打包集成要领及注意事项
7. 运行
在HBuilderX中创建uni-app项目并按照插件文档编写相应测试代码
1. 自定义基座方式运行
打包自定义基座请参考:什么是自定义基座及使用说明
2. 导出uni-app资源并运行
导出方式请参考:HBilderX生成本地打包App资源
示例Github地址:https://github.com/dcloudio/UniPluginPackage
发现错误?想参与编辑?在 GitHub 上编辑此页面!