uni-app原生插件集成指南
准备
- Android studio
- 插件市场
- HBuilderX
集成
-
打开Android Studio,创建一个新项目
-
下载最新版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文件夹,如果文件夹不存在,需要手动创建
-
插件市场下载uni-app插件(此处以RichAlert为例)
-
插件资源配置
将下载的插件解压,将插件中android目录下的aar/jar文件放入libs下,其余文件参考插件文档放入指定文件夹中
-
在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" } ] } ] }
-
配置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离线打包集成要领及注意事项
-
运行
在HBuilderX中创建uni-app项目并按照插件文档编写相应测试代码- 自定义基座方式运行
打包自定义基座请参考:什么是自定义基座及使用说明 - 导出uni-app资源并运行
导出方式请参考:HBilderX生成本地打包App资源
- 自定义基座方式运行
示例Github地址:https://github.com/dcloudio/UniPluginPackage