uni-app原生插件集成指南

准备环境

  1. Android studio
  2. 插件市场
  3. HBuilderX

集成示例

1. 打开Android Studio,创建一个新项目

Android 离线打包使用插件 - 图1

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文件夹,如果文件夹不存在,需要手动创建

Android 离线打包使用插件 - 图2

3. 插件市场下载uni-app插件(此处以RichAlert为例)

4. 插件资源配置

将下载的插件解压,将插件中android目录下的aar/jar文件放入libs下,其余文件参考插件文档放入指定文件夹中 Android 离线打包使用插件 - 图3

5. 在assets目录下创建dcloud_uniplugins.json文件

插件配置信息请参考插件配置文档或插件配置文件package.json 关于package.json请参考:Android uni-app原生插件开发文档

  1. {
  2. "nativePlugins": [
  3. {
  4. "plugins": [
  5. {
  6. "type": "module",
  7. "name": "DCloud-RichAlert",
  8. "class": "uni.dcloud.io.uniplugin_richalert.RichAlertWXModule"
  9. }
  10. ]
  11. }
  12. ]
  13. }

6. 配置gradle文件

添加指定依赖

  1. dependencies {
  2. implementation fileTree(dir: 'libs', include: ['*.jar'])
  3. implementation fileTree(dir: 'libs', include: ['*.aar'])
  4. implementation "com.android.support:recyclerview-v7:28.0.0"
  5. implementation "com.android.support:support-v4:28.0.0"
  6. implementation "com.android.support:appcompat-v7:28.0.0"
  7. implementation 'com.alibaba.android:bindingx-core:1.0.3'
  8. implementation 'com.alibaba.android:bindingx_weex_plugin:1.0.3'
  9. implementation 'com.squareup.okhttp:okhttp:2.3.0'
  10. implementation 'com.squareup.okhttp:okhttp-ws:2.3.0'
  11. // 基座需要,必须添加
  12. implementation 'com.github.bumptech.glide:glide:4.9.0'
  13. }

其余uni-app离线集成事项请参考:Android平台,uni-app离线打包集成要领及注意事项

7. 运行

在HBuilderX中创建uni-app项目并按照插件文档编写相应测试代码

  1. 1. 自定义基座方式运行

打包自定义基座请参考:什么是自定义基座及使用说明

  1. 2. 导出uni-app资源并运行

导出方式请参考:HBilderX生成本地打包App资源

示例Github地址:https://github.com/dcloudio/UniPluginPackage


发现错误?想参与编辑?在 GitHub 上编辑此页面!