【Uniapp】Uniapp Android原生插件开发指北

前言

在uniapp开发中当HBuilderX中提供的能力无法满足App功能需求，需要通过使用Andorid/iOS原生开发实现时，或者是第三方公司提供的是Android的库，这时候可使用App离线SDK开发原生插件来扩展原生能力。

插件类型有两种，Module模式和Component模式

Module模式：能力扩展，无嵌入窗体的UI控件。大部分插件都是属于此类，比如调用计步器API。代码写法为通过js进行require，然后调用该插件对象的方法。如涉及一些弹出框、全屏ui，也仍然属于Module模式。类似于前端里的js sdk。
Component模式：在窗体中内嵌显示某个原生ui组件。比如窗体局部内嵌某个地图厂商的map组件，上下混排其他前端内容，就需要把这个原生地图sdk封装为Component模式。代码写法与vue组件相同，在template里写组件标签。类似于前端里的vue组件。

本文主要讨论的是Module模式的开发。

开发环境准备

开发环境：JAVA环境 jdk1.8 和Android X
Android studio，最新的Hbuilderx，最新的离线uniSdk

插件必须在uni-sdk的基础上进行开发，可以快速的下载离线uni-sdk，导入UniPlugin-Hello-AS示例工程，也可以自己新建一个原生android项目，拷贝不要的包和资源进行开发。

开发原生插件

1、导入uni插件原生项目（离线uni-sdk中解压），并且成功编译。打开后目录如下：

Module插件的开发，是一个Module构建成一个插件aar，因为需要新建一个插件实现新的功能。

2、创建Module

在现有Android项目中创建library的Module。例如uniplugin_readcard，配置刚创建的Module的build.gradle信息。

//导入aar需要的配置
repositories {
	flatDir {
		dirs 'libs'
	}
}
dependencies {
	//必须添加的依赖
	compileOnly 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0',
	compileOnly 'androidx.core:core:1.1.0'
	compileOnly 'androidx.fragment:fragment:1.1.0'
	compileOnly 'androidx.appcompat:appcompat:1.1.0'
	compileOnly 'androidx.recyclerview:recyclerview:1.1.0'
	compileOnly 'com.alibaba:fastjson:1.2.83'

	compileOnly fileTree(include: ['uniapp-v8-release.aar'], dir: '../app/libs')
}

此处的lib aar都在A