Uniapp使用大疆SDK打包离线原生插件

前言：本文只介绍uniapp原生插件开发流程，阅读本文者需具备基本的java，android，以及uniapp开发知识。

准备：

Uniapp原生插件开发SDK文件

一、解压

解压后相关文件如下图，我们只需要用到里面的示例工程HBuilder-HelloUniApp来进行插件开发就好

二、示例工程导入

打开Android Studio，导入上边标出的工程

1.插件开发--Module 创建--选择新建 Module

2.文件配置：

build.gradle文件打开

将编辑器文件视图切换到Project，选择我们刚创建的Module目录，然后打开其根目录下的build.gradle文件

注意，后边会显示是哪个的，这里选我们刚才新建的rfid的build.gradle

build.gradle文件配置

加入以下配置，dependencies里面的初始配置可以删除或注释掉，然后点击同步

android {
    sourceSets {
        main(){
            jniLibs.srcDirs = ["libs"]
        }
    }
}
 
//导入aar需要的配置
repositories {
    flatDir {
        dirs 'libs'
    }
}
 
dependencies {
    //必须添加的依赖
    compileOnly 'androidx.recyclerview:recyclerview:1.0.0'
    compileOnly 'androidx.legacy:legacy-support-v4:1.0.0'
    compileOnly 'androidx.appcompat:appcompat:1.0.0'
    compileOnly 'com.alibaba:fastjson:1.1.46.android'
 
    compileOnly fileTree(include: ['uniapp-v8-release.aar'], dir: '../app/libs')
}

3.创建Module类

新建类文件

在Module的项目文件夹下创建我们需要的类这里我新建了RFIDTool，必须继承UniModule

扩展方法必须加上@UniJSMethod (uiThread = false or true) 注解。UniApp 会根据注解来判断当前方法是否要运行在 UI 线程，和当前方法是否是扩展方法。

UniApp是根据反射来进行调用 Module 扩展方法，所以Module中的扩展方法必须是 public 类型

import io.dcloud.feature.uniapp.annotation.UniJSMethod;
import io.dcloud.feature.uniapp.bridge.UniJSCallback;
import io.dcloud.feature.uniapp.common.UniModule;
 
public class RFIDTool extends UniModule {
 
 
    @UniJSMethod(uiThread = true)
    public void doTest(UniJSCallback callback){
        try {
            String result = "doTest success" ;
            callback.invoke(result);
        }catch (Exception e){
            e.printStackTrace();
        }
    }
}

4.数据返回

数据使用UniJSCallback结果回调，具体是使用invoke调用JavaScript的回调方法返回数据。更多可以参考官方文档，invoke需要传入一个Object类型的返回数据，：

引入插件

在插件项目app目录下的build.gradle文件中，引入刚刚注册的module

5.离线打包Key

sha1值获取

在证书管理页面，证书详情里面获取证书sha1值

从Android项目中获取包名

获取离线打包key

在uniapp应用后台各平台信息页面，将上两步获取的值填入对应输入框，然后点击保存

三、开始编译

打开Android Studio，在插件项目中，打开右上角Gradle栏目，选择插件开发项目，选择插件打开，依次点开Tasks-other，然后双击assembleRelease即可进行插件编译。

1.获取插件

编译成功后，就可以在插件目录的build/outputs/arr目录下找到编译好的插件

2.引入插件--创建目录

在uniapp项目中创建nativeplugins目录，然后根据插件名创建插件目录，再在其下一级创建插件相应系统目录，然后将插件复制到该目录

四、引入插件

在uniapp项目的manifest.json文件中添加配置好的插件，至此引入完成