android环境准备
l java环境 jdk1.8
l android studio 下载地址:android studio官网 or android studio中文社区
l app离线sdk下载:请下载2.9.8+版本的android平台sdk
导入uni插件原生项目
l uniplugin-hello-as工程请在app离线sdk中查找
l 点击android studio菜单选项file--->new--->import projectapp离线sdk下
插件开发
uni-app插件目前仅支持module扩展和component扩展,暂时不支持adapter扩展,下面介绍的是module扩展(非ui的功能扩展)
1、新建module,file->new->new module,选择android library,填写信息,点击finish
2、编辑新建module的build.gradle文件,添加依赖,使module具有开发uniapp插件能力
移除默认依赖,修改为 compileonly filetree(dir: 'libs', include: ['*.jar'])\ compileonly filetree(dir: '../app/libs', include: ['uniapp-v8-release.aar'])\ compileonly "com.android.support:recyclerview-v7:28.0.0"\ compileonly "com.android.support:support-v4:28.0.0"\ compileonly "com.android.support:appcompat-v7:28.0.0"\ compileonly 'com.alibaba:fastjson:1.1.46.android'\ implementation 'com.facebook.fresco:fresco:1.13.0'
3、编写逻辑,在自己的module中新建一个java类,用于编写自己的代码逻辑
4、代码实现
我们实现的是一个module,需要继承uni的unimodule
扩展方法必须加上@unijsmethod (uithread = false or true) 注解,判断是否需要运行在ui线程,默认true,扩展方法必须public,便于通过uni内部调用
第一个参数为传入的参数,结构为json,通过key获取需要的参数,第二个是回调函数,用于返回给前台页面需要的结果
如果需要用到其他权限,需要进行在androidmanifest.xml文件进行申请,例如日历的读取和写入
编辑uniplugin-hello-as工程下 “app” module根目录assets/dcloud_uniplugins.json文件,在nativeplugins节点下进行注册,type:module,name填写自己需要暴露的组件名称,class填写方法的具体路径,包名+类名
dcloud_uniplugins.json说明:
nativeplugins: 插件根节点,可存放多个插件hooksclass: 生命周期代理(实现apphookproxy接口类)格式(完整包名加类名)type : module 或 component类型name : 注册名称class : module 或 component 实体类完整名称
在app的build.gradle注册自己的组件,名字就是新建的module的名称,注册时候,就可以在android studio中使用了
到此为止代码开发就结束了,接下来就是用android studio进行打离线包的验证,传送门nativesupport.dcloud.net.cn/appdocs/use…
打包验证hbuildx新建一个项目,通过uni.requirenativeplugin进行插件调用
当前uniapp的相关打包资料需要准备好,这边就不在赘述,appkey,appid和安卓包名都需要在android studio中进行对应的配置,还有安卓证书别名以及秘钥等
点击发行->本地打包->生成本地打包的app资源
将生成的文件复制粘贴到uniplugin-hello-as\app\src\main\assets\apps下,并且修改dcloud_control.xml文件的appid
安卓打包参数配置,包名,证书别名等(图1),证书文件需要放在app下(图2)androidmanifest.xml配置包名和appkey,就是上面第二步的appkey
连接手机,打开usb调试,点击运行
uniapp 打包插件生成编译生成module的aar文件:选择gradle--->插件module--->tasks--->other--->assemblerelease(运行生成module的aar文件)
hbuildx引入该插件项目根目录新建nativeplugins-->插件名称->android->插件aar文件,android下面同步存放package.json(详细介绍)tips:插件id必须和文件夹的名称一致
打开manifest.json,配置原生插件
云打包进行插件功能验证
ios第一步先买个mac
更多编程相关知识,请访问:编程入门!!
以上就是浅谈uniapp中怎么开发安卓原生插件的详细内容。