09- V13 自定义 Apk 插件使用说明 - OrDroid APP 相关

# 一、背景与目的
现实项目中，有些特殊的项目需求可能移动事务对象插件已经无法满足了，比如一些特殊硬件的接入(如蓝牙电子秤)，或者其它一些特殊的需求，这时候可能需要用户开发自定义的插件，本手册主要侧重于介绍自定义插件的开发过程中的注意事项。
# 二、dependencies依赖库注意事项
2.1 主程序dependencies依赖库

![](/media//202011/2020-11-25_165258.png)
2.2 插件dependencies依赖库

![](/media//202011/2020-11-25_165339.png)
2.3 插件dependencies依赖库注意事项
如果插件依赖库使用了和主程序相同的依赖包，则必须使用compileOnly修饰依赖包，则只参与编译，不参与打包的方式，否则会出现异常导致插件无法打开。
# 三、主程序与插件的数据传递
3.1 主程序与插件的数据传递方式
主程序与插件的数据传递主要依靠广播的方式传递数据。
3.2 主程序向插件传递数据的广播

![](/media//202011/2020-11-25_165556.png)
3.3 插件往主程序传递数据的广播

![](/media//202011/2020-11-25_165628.png)
3.4 插件接收主程序数据广播

![](/media//202011/2020-11-25_165703.png)
3.5 插件接收主程序传递数据接口(用户可自定义此接口)

![](/media//202011/2020-11-25_165739.png)

3.6 插件调用数据库存储过程方式
插件调用数据库存储过程前需要将SQLString字段通过广播发送至主程序加密，主程序SQLString字段加密完成后将通过广播方式回传数据至插件，插件在调用主程序WebService接口前还需要调用URLEncoder.encode函数对SQLString字段编码即可，调用成功后，数据库将数据返回至插件，此时程序需要将返回数据通过广播发送至主程序解密，主程序解密完成后将通过广播方式回传至插件，插件还需将此数据解压后才可使用，具体如下:

![](/media//202011/2020-11-25_165858.png)

![](/media//202011/2020-11-25_165913.png)
# 四、自定义插件生成
4.1 “OrDroid插件”配置
自定义插件开发完成后，需要将插件存放至OrBit插件库目录，然后在”OrDroid插件”中生成一个插件。

![](/media//202011/2020-11-25_170026.png)
# 五、其它注意事项
5.1 Actvity上下文的调用
Actvity上下文Context调用需要使用that，不能使用this。
5.2 Intent调用
Intent跳转应使用dl-lib.jar包下的DLIntent，不能直接使用Intent。
5.3 dl-lib.jar包是系统插件包，添加依赖时不能删除此包