uniapp原生插件开发(Android)

背景

使用uniapp开发完安卓APP之后,想使用腾讯bugly来进行版本管理和运营分析和统计相关功能,但是官方没有提供uniapp版本,而插件市场的基本上都是要收费的,所以这时候就想到了自己来开发安卓原生插件来实现bugly功能。本篇文章并未实现了bugly功能,只是先实现uniapp使用安卓原生插件功能,后面我们再实现bugly功能。

开发环境

开发安卓原生插件需要一定的安卓开发基础,所以这边不赘述AS相关环境配置,默认读者已经做好了安卓开发相关环境配置。

开始开发

下载离线SDK

根据上面提供的离线SDK下载地址下载好离线SDK并解压待用,下载解压后目录如下:

在这里插入图片描述

AS中新建工程

按照如下图示新建安卓壳工程(壳工程实际不需要任何逻辑,为后面新建Module做准备)
在这里插入图片描述

新建Module

按照AS指引新建完成工程,然后再工程上右击新建Module,如下图:
在这里插入图片描述
然后选择Android Library:
在这里插入图片描述
然后配置好Module名称,包名,安卓SDK版本等,如下(注意红框MiniMum SDK最好不要大于19,不然uniapp打包的时候可能出现错误):
在这里插入图片描述

离线SDK拷贝到安卓工程

找到原来下载并解压的离线SDK,进入UniPlugin-Hello-AS\app\libs目录,并拷贝所有aar后缀文件。如下所示:
在这里插入图片描述
然后打开AS新建的安卓工程中,切换Project试图,将拷贝文件放入app/libs目录下,如下所示:
在这里插入图片描述
打开新建Moudle目录下build.gradle文件,添加如下所示代码:
在这里插入图片描述

//导入aar需要的配置
repositories {
    flatDir {
        dirs 'libs'
    }
}

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

将避免混淆代码写入到consumer-rules.pro与proguard-rules.pro中

-keep public class * extends io.dcloud.feature.uniapp.common.UniModule{*;}

在这里插入图片描述

Module中实现逻辑

在Module中新建类并实现相关逻辑,如下:
在这里插入图片描述
这里由于先做原生插件调试,就实现一个最简单的功能,复杂功能等流程打通后再加即可。
这里需要注意的是:新建逻辑类需要继承UniModule类,类修饰符必须是public,方法必须加上@UniJSMethod(uiThread = true/falsa)注解,可以直接返回结果,或者将结果通过callback回调返回。

public class UpdateModule extends UniModule {
    @UniJSMethod(uiThread = true)
    public void showToast(String msg, UniJSCallback callback){
        Log.e("test","toast msg : "+msg);
        Toast.makeText(mWXSDKInstance.getContext(),msg,Toast.LENGTH_SHORT).show();
        callback.invoke(msg);
    }
}

本地注册插件

在安卓工程下 “app” Module根目录assets/dcloud_uniplugins.json文件,如下所示:
在这里插入图片描述
内容如下:

{
    "nativePlugins": [
        {
            "plugins": [
                {
                    "type": "module",
                    "name": "UpdateModule",
                    "class": "com.zouguo.buglymodule.UpdateModule"
                }
            ]
        }
    ]
}
//plugins下的type可选项有module和component,这里我们选module(component主要做native控件插件)
//plugins下的name可以自定义
//plugins下的class则是要精准指定包名+类名
//plugins下可以配置多个module或者component

打aar包

原生插件逻辑写完点击开发工具右侧的gradle,找到对应Module,双击如下所示跑完之后则可生成aar包待用。
在这里插入图片描述

在这里插入图片描述
生成aar文件目录如下所示:
在这里插入图片描述

新建uniapp工程

HbuilderX左上角文件->新建->项目,然后按照指引新建工程,如下所示:
在这里插入图片描述

然后在新建uniapp项目工程根目录新建nativeplugins文件夹,nativeplugins文件夹根据插件名称新建文件夹,再插件文件夹下面新建android目录和package.json文件,最后将前面生成的aar文件拷贝至android目录下。最终目录层级如下:
在这里插入图片描述
package.json文件配置如下:

{
    "name": "UpdateModule",
    "id": "UpdateModule",
    "version": "1.0.0",
    "description": "bugly升级",
    "_dp_type": "nativeplugin",
    "_dp_nativeplugin": {
        "android": {
            "hooksClass": "",
            "plugins": [
                {
                    "type": "module",
                    "name": "UpdateModule",
                    "class": "com.zouguo.buglymodule.UpdateModule"
                }
            ],
            "integrateType": "aar",
            "abis": []
        }
    }
}
//为了防止冲突id尽量带上组织或特有标识,plugins中的配置尽量和【本地注册插件】模块中保持一致

制定基座

双击manifest.json文件,选择App原生插件配置,然后选择本地插件,如下所示:(注意云打包的包名不要和原生插件的包名一样,否则可能出现打包失败问题
在这里插入图片描述
选好本地插件后,HbuilderX选择发行,原生App云打包,打自定义基座,配置好证书等待基座打包完成,打包完成会生成如下所示文件:

在这里插入图片描述

调试

在uniapp页面中引入插件,然后调用原生插件中的方法,如下所示:

<template>
	<view class="content">
		<image class="logo" src="/static/logo.png" @click="handleClick"></image>
		<view class="text-area">
			<text class="title">{{title}}</text>
		</view>
	</view>
</template>

<script>
	//引入插件
	let updateModule= uni.requireNativePlugin('UpdateModule')
	export default {
		data() {
			return {
				title: 'Hello'
			}
		},
		onLoad() {},
		methods: {
			handleClick(){
				updateModule.showToast('toast from native plugins')
			}
		}
	}
</script>
//省略样式

点击图片后结果如下:
在这里插入图片描述

可以看到已经能正确调用原生Toast显示了。

尾巴

到这里我们就打通了整个流程,实现了一个简易版本的uniapp安卓原生插件开发。如果你想实现更加复杂的插件功能,那就再AS Module中实现逻辑就行,理论上来说原生安卓能做的事情,通过原生插件都可以完成。
如果你喜欢我的文章,欢迎给我点赞,评论,关注,谢谢大家!

参考:dcloud官方文档

  • 1
    点赞
  • 3
    收藏
  • 打赏
    打赏
  • 2
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
©️2022 CSDN 皮肤主题:点我我会动 设计师:我叫白小胖 返回首页
评论 2

打赏作者

abs625

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值