更新记录
1.0.1(2022-06-28)
部分细节优化
1.0.0(2022-06-27)
首次发布
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 11.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:支持 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
插件使用说明
-
插件申请权限
- 存储卡读写权限
-
需要在manifest.json文件中开启以下权限
/* android打包配置 */ "android" : { "permissions" : [ "<uses-feature android:name=\"android.hardware.camera\"/>", "<uses-feature android:name=\"android.hardware.camera.autofocus\"/>", "<uses-permission android:name=\"android.permission.CAMERA\"/>", "<uses-permission android:name=\"android.permission.FLASHLIGHT\"/>", "<uses-permission android:name=\"android.permission.GET_ACCOUNTS\"/>", "<uses-permission android:name=\"android.permission.INTERNET\"/>", "<uses-permission android:name=\"android.permission.USE_CREDENTIALS\"/>", "<uses-permission android:name=\"android.permission.VIBRATE\"/>", "<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>", "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>", "<uses-permission android:name=\"android.permission.READ_EXTERNAL_STORAGE\"/>", "<uses-permission android:name=\"android.permission.WRITE_SETTINGS\"/>" ], "abiFilters" : [ "armeabi-v7a", "arm64-v8a" ] },
-
使用方法
1.加载插件
用法如下:
const pictureSelectorModule = uni.requireNativePlugin("leven-pictureSelector-SelectorModule")
2.插件方法
- open方法
参数说明:
- title:选择相册标题,默认:相册与视频
- isShowImage:是否展示图片,默认:true
- isShowVideo:是否展示视频,默认:true
- maxSelectCount:最大选择的数量,默认:9
回调说明:
- size:文件大小
- sizeFormat:文件大小格式化
- path:文件路径
- lastModified:文件最后修改时间
- duration:时长,单位毫秒,图片文件返回0
- mime:文件类型
示例:
let that = this; pictureSelectorModule.open({ // 相册标题 title: "", // 是否展示图片 isShowImage: true, // 是否展示视频 isShowVideo: true, // 选择的最大数量(不能超过10个超过10个默认为10) maxSelectCount: 5 }, res => { that.content = JSON.stringify(res) });
-
页面代码
- index.nvue页面内容如下
<template> <view> <button @click="open">打开选择</button> <view>{{content}}</view> </view> </template> <script> const pictureSelectorModule = uni.requireNativePlugin("leven-pictureSelector-SelectorModule") export default { data() { return { content: "" } }, methods: { // 打开 open() { let that = this; pictureSelectorModule.open({ // 标题 title: "选择文件", // 是否展示图片 isShowImage: true, // 是否展示视频 isShowVideo: true, // 选择的最大数量(不能超过10个超过10个默认为9) maxSelectCount: 5 }, res => { console.log(res) that.content = JSON.stringify(res) }); } } } </script> <style> </style>
-
购买插件前请先试用,试用通过再购买。