域名解析要登入哪个网站做,海盐市网站建设,wordpress图片调用代码,wordpress做商城网站吗前言
在uniapp开发中当HBuilderX中提供的能力无法满足App功能需求#xff0c;需要通过使用Andorid/iOS原生开发实现时#xff0c;或者是第三方公司提供的是Android的库#xff0c;这时候可使用App离线SDK开发原生插件来扩展原生能力。
插件类型有两种#xff0c;Module模…前言
在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.0compileOnly androidx.fragment:fragment:1.1.0compileOnly androidx.appcompat:appcompat:1.1.0compileOnly androidx.recyclerview:recyclerview:1.1.0compileOnly com.alibaba:fastjson:1.2.83compileOnly 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) {MapString,String result new HashMap();result.put(imei, telephonyManager.getDeviceId().toString());jsCallback.invoke(result);}}
注意
1对外暴露的方法需要添加 UniJSMethod (uiThread true)并且设置为public 。 2JSONObject options可以接收uniapp传过来的数据也可以为空。 3jscallback回调的时候可以用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}]}}
}注意 1package.json的class的路径是Module 中ReadModule 的路径 2name、id、name可以起同一个名字避免出现错误 3plugins的name名字用作于uniapp中的引用。
var testModule uni.requireNativePlugin(ReadCardModule)3、如果项目中需要进行第三方库初始化可以新建一个ReadCard_AppProxy 实现UniAppHookProxy并且配置到 即可在oncreate中进行初始化。
public class ReadCard_AppProxy implements UniAppHookProxy {Overridepublic void onCreate(Application application) {//可写初始化触发逻辑}Overridepublic 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的人来说离线打包有时候难度很大。
1hbuilder中打包资源包。
条件准备
申请离线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); });制作自定义基座
代码完成后可以进行自定义基座打包即可完成开发。
