uni-app与原生插件混合开发调试3-安卓原生插件开发调试和打包

安卓原生插件开发调试和打包

上面已经介绍了怎么安装开发和调试环境，接下来就是安卓原生插件的具体开发和调试步骤：

将uniapp前端项目的index.vue文件新增代码。代码如图所示：

<template>
    <view>
        <view>
            <text>{{title}}</text>
        </view>
        
        <button @click="test">测试</button>
    </view>
</template>

<script>
    const ceshiMethodPlugin = uni.requireNativePlugin('ceshi-method');
    export default {
    data() {
            return {
        title: 'Hello'
            }
    },
    onLoad() {
            console.log('ceshiMethodPlugin', ceshiMethodPlugin);
    },
    methods: {
            /**
             * 测试原生插件
            */
            test() {
                ceshiMethodPlugin.ceshiStart('搞起来', (res) => {
                    console.log('res', res);
                    this.title = res.msg;
        })
            }
    }
    }
</script>

重新打包，重新放到Android studio项目app/src/main/assps/目录下。重新启动run，项目启动成功。

第二步创建自己的插件项目

这步主要参考# uniapp开发安卓原生插件，不能说一模一样，只能说一毛一样，谢谢大佬文章@fly_dream。

操作：File =》 New =》 New Module =》 Android Library

新建完毕后，开始移花接木，把官方示例uniplugin_module的配置复制过去。在当前ceshi目录下，打开proguard-rules.pro文件，加入以下代码

scala复制代码-keep public class * extends io.dcloud.feature.uniapp.common.UniModule{*;}

先将java文件进行转换为 Sources Root（如果已经是了，就不用转了），操作如下图

创建Module类

填写插件代码

uniapp的Module拓展，必须继承UniModule类。
扩展方法必须加上@UniJSMethod (uiThread = false or true) 注解。UniApp 会根据注解来判断当前方法是否要运行在 UI 线程，和当前方法是否是扩展方法。
UniApp是根据反射来进行调用 Module 扩展方法，所以Module中的扩展方法必须是 public 类型例子：

scala复制代码package com.example.ceshi; import com.alibaba.fastjson.JSONObject; import io.dcloud.feature.uniapp.annotation.UniJSMethod; import io.dcloud.feature.uniapp.bridge.UniJSCallback; import io.dcloud.feature.uniapp.common.UniModule; public class CeshiMethod extends UniModule { @UniJSMethod(uiThread = true) public void ceshiStart (String name, UniJSCallback callback) { if (callback != null) { JSONObject data = new JSONObject(); data.put("msg", name + "：你小子，真棒"); callback.invoke(data); } } }

在AndroidManifest.xml填写包入口，package="uni.dcloud.io.ceshi"

测试插件代码完毕。

第三步将插件导入到项目中

在APP目录的burild.gradle中引入插件包。跟着官方示例照葫芦画瓢。

java复制代码implementation project(':插件包名')

在src/main/assets/dcloud_uniplugins.json文件中声明类名称。也是跟着官方示例照葫芦画瓢。

配置完成，Sync now 同步完后重新启动。插件流程自此结束。

备注：插件的开发与调试建议在Android studio中进行，若前端项目代码需要改动重新本地打包一下，再进入到Android studio即可。这个过程是很快的。而若是将插件进行打包，放到uniapp上进行调试，当插件需要更改，需要重新制作自定义调试基座，这个是需要云打包的，是非常慢的。总代来说，就是在Android studio中调试，uniapp前端项目可以本地打包，而在uniapp中调试，需要云打包，速度是很慢的，贼耽误时间。

第四步打包插件，在uniapp中启动

打包插件

备注：有些 Android Studio 中右侧的 gradle 只有dependens，没有tasks任务栏。此时点击左上角 File =》 Settings，再同步一下配置即可，按下图操作即可

此步骤引用至# uniapp开发安卓原生插件，再次感谢@fly_dream。此文中表示打包可能出会出版本问题，由于个人并非出现，并不了解，有此问题的小伙伴可参考大佬的文章。

将插件包配置到前端项目

在uniapp项目中新建unipluginDemo文件夹=》新建插件包ceshi文件夹=》新建android文件夹与package.js配置文件。将插件压缩包放到android文件夹中。uniapp会加载android文件夹中的插件，你只需在package.js中配置好文件参数即可。

注意别把package.js放到android文件夹中。

配置package.js文件，更多配置可参考uniapp官网插件参数配置进行配置。

{ "name": "ceshi",
  "id": "ceShi",
  "version": "1.0.0",
  "description": "测试用",
  "_dp_type": "nativeplugin",
  "_dp_nativeplugin": {
    "android": {
      "plugins": [
        {
          "type": "module",
          "name": "ceshi-method",
          "class": "com.example.ceshi.CeshiMethod"
        }
      ],
      "integrateType": "aar",
      "parameters": {},
      "dependencies": [
            "io.mx51:spi-client-java:2.9.5"
      ]
    }
  }
}

前端项目调用API的时候，调用的是就是配置里的name