# uni-app原生插件集成指南

# 准备环境

  1. Android studio
  2. 插件市场
  3. 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 "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"
    implementation "androidx.core:core:1.1.0"
    implementation "androidx.fragment:fragment:1.1.0",
	implementation "androidx.recyclerview:recyclerview:1.1.0",
	implementation "androidx.appcompat:appcompat:1.1.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资源并运行 导出方式请参考:HBuilderX生成本地打包App资源

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