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

news2024/11/28 1:44:58

前言

在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都在APP模块下有,不需要额外的导入。uniapp-v8-release.aar是扩展module主要依赖库,必须导入此依赖库!打包成插件时候不需要打包进入这些依赖库,只需要打包进去你额外添加的依赖库。
在这里插入图片描述
在这里插入图片描述
如图,新的module下,新建两个文件,ReadModule和ReadCard_AppProxy,
如果项目需要导入so包、aar或者jar包,导入放到libs下,

在这里插入图片描述

ReadModule 是暴露于外的核心的类,需要继承于UniModule ,打包插件时候需要配置到package.json的class位置。

public class ReadModule extends UniModule  {

    @UniJSMethod (uiThread = true)
    public void showToastAAA(JSONObject options, UniJSCallback jsCallback) {
        Toast.makeText(mUniSDKInstance.getContext(), "Hello", Toast.LENGTH_SHORT).show();

        JSONObject result = new JSONObject();
        try {
            result.put("cardno", "hello");
            jsCallback.invoke(result);

        } catch (JSONException e) {
            throw new RuntimeException(e);
        }
    }

   @UniJSMethod (uiThread = true)
    public void showTest(UniJSCallback jsCallback) {
        Toast.makeText(mUniSDKInstance.getContext(), "Hello", Toast.LENGTH_SHORT).show();

        JSONObject result = new JSONObject();
        try {
            result.put("cardno", "hello");
            jsCallback.invoke(result);

        } catch (JSONException e) {
            throw new RuntimeException(e);
        }
    }



    @SuppressLint("MissingPermission")
    @UniJSMethod (uiThread = true)
    public void piccrequest(JSONObject options, UniJSCallback jsCallback) {

        TelephonyManager telephonyManager = (TelephonyManager)mUniSDKInstance.getContext().getSystemService(Context.TELEPHONY_SERVICE);
        if (telephonyManager != null) {

            Map<String,String> result = new HashMap<>();
            result.put("imei",  telephonyManager.getDeviceId().toString());
            jsCallback.invoke(result);

        }

    }

注意

1)对外暴露的方法需要添加 @UniJSMethod (uiThread = true),并且设置为public 。
2)JSONObject options可以接收uniapp传过来的数据,也可以为空。
3)jscallback回调的时候,可以用JSONObject 存放数据,回调json数据,但是某些时候回调不到,可以切换成Map。

{
    "name": "ReadCardModule",
    "id": "ReadCardModule", 
    "version": "1.0.0",
    "description": "读卡",
    "_dp_type":"nativeplugin",
    "_dp_nativeplugin":{
        "android": {
			"integrateType":"aar",
            "plugins": [
                {
                    "type": "module",
                    "name": "ReadCardModule", 
                    "class": "uni.dcloud.io.uniplugin_read.ReadModule"
                }
                
            ]
        }
    }
}

注意
1)package.json的class的路径是Module 中ReadModule 的路径
2)name、id、name可以起同一个名字,避免出现错误
3)plugins的name名字用作于uniapp中的引用。

var testModule = uni.requireNativePlugin("ReadCardModule")

3、如果项目中需要进行第三方库初始化,可以新建一个ReadCard_AppProxy 实现UniAppHookProxy并且配置到 ,即可在oncreate中进行初始化。

public class ReadCard_AppProxy implements UniAppHookProxy {
    @Override
    public void onCreate(Application application) {
        //可写初始化触发逻辑
    }

    @Override
    public void onSubProcessCreate(Application application) {
        //子进程初始化回调
    }
}

在UniPlugin-Hello-AS工程下 “app” Module根目录assets/dcloud_uniplugins.json文件,在hooksClass节点添加你创建实现UniAppHookProxy接口的实体类完整名称填入其中即可 (有些需要初始化操作的需求可以在此处添加逻辑,无特殊操作仅使用第一种方式注册即可无需集成UniAppHookProxy接口)

开发完成后,在gradle中进行assembleRelease,即可打包成插件的aar,

在这里插入图片描述

打包给uniapp端或者上传插件市场的文件如下,package.json就是上文所描述的配置文件,Android文件夹中,项目的so包和jar包放到libs下项目所依赖的aar和打包的插件aar放到Android目录下,资源文件放到res或者assets下。

千万不要放错位置!!
千万不要放错位置!!
千万不要放错位置!!

在这里插入图片描述
在这里插入图片描述

如此,一个基础的插件开发就算完成,理论上可以交给uniapp端进行使用。copy上面的文件夹放到nativeplugins下面,mainifest.json中原生插件选择一下,然后制作自定义基座打包,就可以进行使用了。

var myPlugin= uni.requireNativePlugin("ReadCardModule")

myPlugin.piccrequest({  
 }, (res) => {  
    // 处理原生方法返回的结果  
    console.log('读卡结果:', res);  
  
}, (err) => {  
    // 处理调用插件时发生的错误  
    console.error('调用插件失败:', err);  
  
});

但是uniapp端使用插件需要自定义基座和云打包时间特别长,Android模块需要保证自己的插件没有问题,是通顺的,再给uniapp使用比较好。因此,再开发完成后,在Android studio中对uniapp进行离线打包和测试是比较重要的

uniapp插件调试

1、离线打包

对于不熟悉Android的人来说,离线打包有时候难度很大。

1)hbuilder中打包资源包。

条件准备

申请离线appkey
申请离线appkey包括两部分:生成签名证书 和 申请离线appkey

生成签名证书
dcloud官方文档:https://ask.dcloud.net.cn/article/35777

签名证书用jdk自带的工具keytool生成:

keytool -genkey -alias androidPluginKey -keyalg RSA -keysize 2048 -validity 36500 -keystore androidPluginKey.keystore

androidPluginKey是证书别名,可修改为自己想设置的字符,建议使用英文字母和数字
在这里插入图片描述

申请离线appkey

在这里插入图片描述

打包资源

在这里插入图片描述

把资源配置到Android studio项目中

把资源包复制到项目中
在这里插入图片描述

配置证书

确保appid+签名证书+应用包名都一致
在这里插入图片描述

在dcloud_control.xml填写uniappId

在这里插入图片描述

在主app中添加上插件的libary

implementation project(':uniplugin_readcard') 

注册插件
在androidStudio的assets里面新建dcloud_uniplugins.json,并注册插件信息

在这里插入图片描述

如此就完成了uniapp离线打包的配置,即可在此基础上进行调试,

每次调试时在uniapp中进行修改->打包离线资源包->替换掉Android studio中的资源包。

uniapp插件使用

在hbuilder的根目录下新建nativeplugins文件夹,把把上面的文件夹(包含lib aar等资源的)放到内部
f在这里插入图片描述

打开manifest.json进行插件的选择
在这里插入图片描述

使用插件

在项目中所需要用到的地方,引用插件,调用即可,

var myPlugin= uni.requireNativePlugin("ReadCardModule")

myPlugin.piccrequest({  
 }, (res) => {  
    // 处理原生方法返回的结果  
    console.log('读卡结果:', res);  
  
}, (err) => {  
    // 处理调用插件时发生的错误  
    console.error('调用插件失败:', err);  
  
});

制作自定义基座

代码完成后,可以进行自定义基座打包,即可完成开发。
在这里插入图片描述

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2235720.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

网页版五子棋——用户模块(服务器开发)

前一篇文章&#xff1a;网页版五子棋—— WebSocket 协议-CSDN博客 目录 前言 一、编写数据库代码 1.数据库设计 2.配置 MyBatis 3.创建实体类 4.创建 UserMapper 二、前后端交互接口 1.登录接口 2.注册接口 3.获取用户信息 三、服务器开发 1.代码编写 2.测试后端…

Jenkins声明式Pipeline流水线语法示例

系列文章目录 docker搭建Jenkins2.346.3版本及常用工具集成配置(ldap、maven、ansible、npm等) docker安装低版本的jenkins-2.346.3,在线安装对应版本插件失败的解决方法 文章目录 系列文章目录jenkins流水线基础1、pipeline1.1、什么是pipeline&#xff1f;1.2、为什么使用pi…

【NLP】使用 SpaCy、ollama 创建用于命名实体识别的合成数据集

命名实体识别 (NER) 是自然语言处理 (NLP) 中的一项重要任务&#xff0c;用于自动识别和分类文本中的实体&#xff0c;例如人物、位置、组织等。尽管它很重要&#xff0c;但手动注释大型数据集以进行 NER 既耗时又费钱。受本文 ( https://huggingface.co/blog/synthetic-data-s…

【数据集】【YOLO】【目标检测】道路裂缝数据集 5466 张,YOLO/VOC格式标注!

数据集介绍 【数据集】道路裂缝数据集 5466 张&#xff0c;目标检测&#xff0c;包含YOLO/VOC格式标注。数据集中包含一种分类&#xff0c;检测范围城市道路裂缝、高速道路裂缝、乡村道路裂缝。 戳我头像获取数据&#xff0c;或者主页私聊博主哈~ 一、数据概述 道路裂缝检测…

C++用string实现字符串相加

. - 力扣&#xff08;LeetCode&#xff09; -》》》》》题目链接 实现思路&#xff1a;计算数字符串长度并用数组的方式计算出字符位置&#xff0c;用字符的ask码‘0’计算出字符本身。 class Solution { public:string addStrings(string num1, string num2) {string str;int…

easyexcel实现自定义的策略类, 最后追加错误提示列, 自适应列宽,自动合并重复单元格, 美化表头

easyexcel实现自定义的策略类, 最后追加错误提示列, 自适应列宽,自动合并重复单元格, 美化表头 原版表头和表体字体美化自动拼接错误提示列自适应宽度自动合并单元格使用Easyexcel使用poi导出 在后台管理开发的工作中,离不开的就是导出excel了. 如果是简单的导出, 直接easyexce…

brainpy 动力学编程基础

文章参考&#xff1a; 《神经计算建模实战——基于brainpy》 吴思 【brainpy学习笔记】基础知识2(动力学模型的编程基础)-CSDN博客 Brainpy手册 文章目录 积分器&#xff1a;定义ODE函数数值积分方法 更新函数和动力系统计算介绍什么是brainpy.DynamicalSystem&#xff1f;如…

高级图像处理工具

图像处理-高级 1、功能概览 随着社交媒体的普及和个人创作需求的增长&#xff0c;图像处理成为了日常生活中不可或缺的一部分。无论是专业的设计师还是爱好者&#xff0c;都需要一款强大的工具来帮助他们完成各种任务。今天&#xff0c;我们将介绍一款基于Python开发的高级图…

【Zookeeper集群搭建】安装zookeeper、zookeeper集群配置、zookeeper启动与关闭、zookeeper的shell命令操作

目录 一、安装Zookeeper 二、配置Zookeeper集群 三、Zookeeper服务的启动与关闭 四、Zookeeper的shell操作 前情提要&#xff1a;延续上篇【Hadoop和Hbase集群配置】继续配置Zookeeper&#xff0c;开启三台虚拟机Hadoop1、Hadoop2、Hadoop3&#xff0c;进入终端&#xff0c…

Transformer和BERT的区别

Transformer和BERT的区别比较表&#xff1a; 两者的位置编码&#xff1a; 为什么要对位置进行编码&#xff1f; Attention提取特征的时候&#xff0c;可以获取全局每个词对之间的关系&#xff0c;但是并没有显式保留时序信息&#xff0c;或者说位置信息。就算打乱序列中token…

Python爬虫如何处理验证码与登录

Python爬虫如何处理验证码与登录 Python 爬虫在抓取需要登录的网站数据时&#xff0c;通常会遇到两个主要问题&#xff1a;登录验证和验证码处理。这些机制是网站用来防止自动化程序过度抓取数据的主要手段。本文将详细讲解如何使用 Python 处理登录与验证码&#xff0c;以便进…

《深入浅出Apache Spark》系列②:Spark SQL原理精髓全解析

导读&#xff1a;SQL 诞生于 20 世纪 70 年代&#xff0c;至今已有半个世纪。SQL 语言具有语法简单&#xff0c;低学习门槛等特点&#xff0c;诞生之后迅速普及与流行开来。由于 SQL 具有易学易用的特点&#xff0c;使得开发人员容易掌握&#xff0c;企业若能在其计算机软件中支…

JS实现,防抖节流 + 闭包

防抖&#xff08;Debounce&#xff09; 防抖是指短时间内大量触发同一事件&#xff0c;只会在最后一次事件完成后延迟执行一次函数。 防抖的典型应用场景是输入框的搜索建议功能&#xff0c;用户输入时不需要每次输入都去查询&#xff0c;而是在用户停止输入一段时间后才进行…

安卓编程最方便的读写资料类SharedPreferences,多个APP共享

本文介绍Android平台进行数据存储的五大方式,分别如下: 1 使用SharedPreferences存储数据 2 文件存储数据 3 SQLite数据库存储数据 4 使用ContentProvider存储数据 5 网络存储数据 下面详细讲解这五种方式的特点 第一种&#xff1a; 使用SharedPreferences存储数据 …

数据分析:转录组差异fgsea富集分析

文章目录 介绍加载R包数据链接导入数据数据预处理DE testing: 2BP vs no-BP比较limma-voomLoad steroid dataIn No-BP patientsIn 2BP patientsCompare gene expression vs bacterial mass其他系统信息介绍 转录组差异fgsea富集分析是一种基于基因集的富集分析方法,它关注的是…

Day13杨辉三角

给定一个非负整数 numRows&#xff0c;生成「杨辉三角」的前 numRows 行。 在「杨辉三角」中&#xff0c;每个数是它左上方和右上方的数的和。 class Solution {public List<List<Integer>> generate(int numRows) {List<List<Integer>> res new Arra…

Avalonia11如何优雅的跨组件通信

背景&#xff1a; 官网只介绍了推荐适用ReactiveUI&#xff0c;没有过多的案例介绍&#xff0c;对于初入桌面应用开发的小白极其不友好。 本文介绍在Avalonia应用中通过ReactiveUI中的MessageBus进行跨组件通信. 假设需求案例&#xff1a; MainWindowViewModel中发送消息&a…

【开发实战】彻底了解 ThreadLocal

👉博主介绍: 博主从事应用安全和大数据领域,有8年研发经验,5年面试官经验,Java技术专家,WEB架构师,阿里云专家博主,华为云云享专家,51CTO 专家博主 ⛪️ 个人社区:个人社区 💞 个人主页:个人主页 🙉 专栏地址: ✅ Java 中级 🙉八股文专题:剑指大厂,手撕 J…

基于开源 AI 智能名片、S2B2C 商城小程序的用户获取成本优化分析

摘要&#xff1a;本文围绕用户获取成本&#xff08;CAC&#xff09;这一关键指标展开深入剖析&#xff0c;详细阐述其计算方式&#xff0c;并紧密结合开源 AI 智能名片与 S2B2C 商城小程序的独特性质&#xff0c;从多个维度探讨如何通过挖掘新的获客渠道、巧妙运用私域流量池等…

KV260 - PYNQ 主目录 - U盘挂载

目录 1. 简介 2. 具体操作 2.1 查看 USB 设备 2.2 查看 U 盘设备节点 2.3 挂载 U 盘到指定目录 2.4 查看挂载状态 2.5 卸载 U 盘 3. 总结 1. 简介 在 KV260 使用 Jupyter Lab 可以非常方便开发各种应用。有时不方便在 PC 端连接 U 盘&#xff0c;那么可以把 U 盘连在 …