uniapp Android 原生插件开发(Module 扩展为例·2022)(一)

简介: uniapp Android 原生插件开发(Module 扩展为例·2022)

前言


本文只介绍uniapp原生插件开发流程,Android studio(后面称编辑器) 以及 java 环境的安装请自行查找相关文档解决;阅读本文者须具备基本的java、android以及uniapp相关知识及开发能力。

准备


SDK 文件


下载


首先下载uniapp原生插件开发SDK,下载地址见App离线SDK下载

image.png

解压


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

image.png

示例工程导入


  • 打开Android Studio,新建工程导入

image.png

  • 选择UniPlugin-Hello-AS项目,点击OK完成工程导入

image.png

插件开发


Module 创建


选择新建 Module


image.png

Module 类型选择


选择Android Library,然后下一步

image.png

Module 信息配置


配置模块名以及模块最低支持的Android SDK版本等信息,然后点击Finish完成Module创建。

image.png

文件配置


build.gradle文件打开


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

image.png

build.gradle文件配置


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

//导入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')
}

e3e114e00e034e208e773f812de852f6.png

配置混淆文件


打开Module根目录下的proguard-rules.pro文件,在最后一行末尾加入以下代码

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

image.png

创建Module类


新建类文件


在Module的项目文件夹下创建Module类test

image.png

继承UniModule 类


uniapp的Module扩展必须继承UniModule类

image.png

功能开发


方法定义


定义一个sayHi方法,传入姓名时自动返回Hi + 姓名;编写扩展方法必须遵循以下两点原则:

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

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

image.png

数据返回


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

image.png

源码


至此,一个简单的原生插件就已经开发完成,源码如下:

package com.ss.test;
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 test extends UniModule {
    @UniJSMethod(uiThread = true)
    public void sayHi (String name, UniJSCallback callback) {
        if (callback != null) {
            JSONObject data = new JSONObject();
            data.put("re", "Hi " + name);
            callback.invoke(data);
        }
    }
}

插件调试


证书申请


获取 appid


打开uniapp项目,在根目录下找到manifest.json文件,在基础配置中获取到appid

image.png

证书生成


image.png

  • 选择证书管理,点击创建证书,等待生成成功就好

image.png

  • 生成成功后,刷新页面,下载证书,放入原生插件项目的app目录下

f8345803aa6e4912abbbc61f68ed2794.png

证书配置


证书详情


在后台证书管理页面,点击证书详情获取证书信息以及证书密码

image.png

配置


在插件项目app目录下的build.gradle文件中,将信息依次填入文件中的signingConfigs.config配置项,然后点击右上角同步完成配置,具体如图

77394873e6414e82b7790d3e0d7d92d8.png

插件配置


注册插件


在插件项目的app\src\main\assets目录下打开dcloud_uniplugins.json,在nativePlugins配置项中添加一项插件配置,type必须为module,因为我们的插件是module类型;name统一跟随插件名;具体如图所示:

4e5a310c82ba48e7aa888fa070e35dc0.png

引入插件


在插件项目app目录下的build.gradle文件中,引入刚刚注册的插件,名字与注册名字相同,然后点击同步

78a0561d3c2e45bcb6683d83049a939c.png

离线打包Key


sha1值获取


在证书管理页面,证书详情里面获取证书sha1值,如图

a6701689241c417f882dda4f8f1e31d8.png

获取Android包名


在插件项目app目录下的build.gradle文件中,获取Android包名,如图

image.png

获取离线打包key


  • 在uniapp应用后台离线打包Key管理页面,将上两步获取的值填入对应输入框,然后点击保存,如图:

c55e707bb11d4408aa761c27e99087b1.png

  • 保存后会生成离线打包Key如下:

058ba5acd56148f3861bcf3a09106f3d.png

配置离线打包Key


在插件项目app\src\main目录下的AndroidManifest.xml文件中,将上一步生成的离线打包key配置到相应位置,如图

93d26f764afa40f7908af3532c19ea71.png

目录
相关文章
|
7天前
|
开发工具 Android开发
|
19天前
|
设计模式 开发框架 前端开发
基于SqlSugar的开发框架循序渐进介绍(20)-- 在基于UniApp+Vue的移动端实现多条件查询的处理
基于SqlSugar的开发框架循序渐进介绍(20)-- 在基于UniApp+Vue的移动端实现多条件查询的处理
|
19天前
|
开发框架 移动开发 前端开发
基于SqlSugar的开发框架循序渐进介绍(19)-- 基于UniApp+Vue的移动前端的功能介绍
基于SqlSugar的开发框架循序渐进介绍(19)-- 基于UniApp+Vue的移动前端的功能介绍
|
1月前
|
小程序 开发者
uniapp实战 —— 开发微信小程序的调试技巧
uniapp实战 —— 开发微信小程序的调试技巧
73 1
|
2月前
|
监控 数据管理 Java
智慧城管源码,基于微服务+java+springboot+vue+uniapp开发的城管综合执法系统源码
智慧城管执法系统利用微服务和Java技术提升城市管理水平,涵盖事件处理、投诉、处罚等功能,包含PC和APP源码。系统支持执法APP,便于领导随时随地审批,具备文书模板、地图定位、法规查询等功能。此外,执法办案系统通过监控视频分析事件,实现案件全程闭环管理,包括组织、案件、信用和执法队伍管理,以及法规库等基础支撑。系统旨在优化流程,提高数据管理和效率。
智慧城管源码,基于微服务+java+springboot+vue+uniapp开发的城管综合执法系统源码
|
1月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的高校后勤网上报修系统安卓app附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的高校后勤网上报修系统安卓app附带文章源码部署视频讲解等
29 0
|
1月前
|
小程序 定位技术 API
uniapp 开发微信小程序 --【地图】打开地图选择位置,打开地图显示位置(可开启导航)
uniapp 开发微信小程序 --【地图】打开地图选择位置,打开地图显示位置(可开启导航)
190 0
|
1月前
uniapp 安装插件 uView (多平台快速开发的UI框架)
uniapp 安装插件 uView (多平台快速开发的UI框架)
55 0
|
2月前
|
小程序 JavaScript Java
基于SpringBoot+Vue+uniapp微信小程序的智慧旅游平台开发微信小程序的详细设计和实现
基于SpringBoot+Vue+uniapp微信小程序的智慧旅游平台开发微信小程序的详细设计和实现
49 8