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

目录
相关文章
|
26天前
|
开发框架 前端开发 Android开发
Flutter 与原生模块(Android 和 iOS)之间的通信机制,包括方法调用、事件传递等,分析了通信的必要性、主要方式、数据传递、性能优化及错误处理,并通过实际案例展示了其应用效果,展望了未来的发展趋势
本文深入探讨了 Flutter 与原生模块(Android 和 iOS)之间的通信机制,包括方法调用、事件传递等,分析了通信的必要性、主要方式、数据传递、性能优化及错误处理,并通过实际案例展示了其应用效果,展望了未来的发展趋势。这对于实现高效的跨平台移动应用开发具有重要指导意义。
105 4
|
1月前
|
设计模式 开发框架 JavaScript
基于.NET8 + Vue/UniApp前后端分离的快速开发框架,开箱即用!
基于.NET8 + Vue/UniApp前后端分离的快速开发框架,开箱即用!
|
4月前
|
Android开发
错误记录:调用原生TvSettings 的 com.android.tv.settings.device.storage.ResetActivity 无法启动
本文记录了一个Android TV设置中由于未设置`android:exported="true"`导致`com.android.tv.settings.device.storage.ResetActivity`无法被第三方app启动的错误,并通过添加该属性成功解决了问题。
65 1
|
25天前
|
人工智能 小程序 搜索推荐
uni app下开发AI运动小程序解决方案
本文介绍了在小程序中实现AI运动识别的解决方案。该方案依托于UNI平台,通过高效便捷的插件形式,实现包括相机抽帧控制、人体识别、姿态识别等在内的多项功能,无需依赖后台服务器,大幅提高识别效率和用户体验。方案内置多种运动模式,支持自定义扩展,适用于AI健身、云上赛事、AI体测等多场景,适合新开发和存量改造项目。
|
2月前
|
JavaScript 前端开发 小程序
uniapp一个人开发APP关键步骤和考虑因素
uniapp一个人开发APP关键步骤和考虑因素
142 1
uniapp一个人开发APP关键步骤和考虑因素
|
2月前
|
数据挖掘
uniapp uview扩展u-picker支持日历期间 年期间 月期间 时分期间组件
uniapp uview扩展u-picker支持日历期间 年期间 月期间 时分期间组件
138 10
|
2月前
|
存储 移动开发 小程序
uniapp富文本editor输入二次扩展兼容微信小程序
uniapp富文本editor输入二次扩展兼容微信小程序
90 0
|
2月前
|
前端开发 JavaScript PHP
Thinkphp在线客服系统源码多语言外贸版_PHP客服系统源码Uniapp开发搭建+论文设计
Thinkphp在线客服系统源码多语言外贸版_PHP客服系统源码Uniapp开发搭建+论文设计
|
4月前
|
开发工具 Android开发