更新记录

1.0.2(2022-10-27)

初始版本


平台兼容性

Android Android CPU类型 iOS
适用版本区间:6.0 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 适用版本区间:9 - 15

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择


BenBen-ChooseFile使用说明

1、选择文件

方法名:chooseFile

传入参数:type(文件类型,多种类型英文逗号隔开,类型示例详见备注)

返回参数:code(code为1时表示成功)、data(文件路径)、msg

2、浏览文件(仅限iOS,安卓使用uni.openDocument)

方法名:browseFile

传入参数:url(文件链接)

返回参数:code(code为1时表示成功)、data、msg

代码示例

const fileModule = uni.requireNativePlugin("BenBen-ChooseFile")
const modal = uni.requireNativePlugin('modal');
    export default {
        onLoad() {
            plus.globalEvent.addEventListener('TestEvent', function(e) {
                modal.toast({
                    message: "TestEvent收到:" + e.msg,
                    duration: 1.5
                });
            });
        },
        methods: {
            chooseFile() {
                // 选择文件
                fileModule.chooseFile({
                        'type': 'com.adobe.pdf,public.image'
                        // @[@"public.content", @"public.text" , @"public.image", @"com.adobe.pdf", @"com.apple.keynote.key", @"com.microsoft.word.doc", @"com.microsoft.excel.xls", @"com.microsoft.powerpoint.ppt"];
                    },
                    (ret) => {
                        modal.toast({
                            message: ret,
                            duration: 1.5
                        });
                    })
            },
            browseFile() {
                // 浏览文件
                fileModule.browseFile({
                    'url': 'http://kouyu1.suisuilian.com/uploads/images/a112ddedba74ebd0cfb06eb992fdc775.docx'
                })
            }
        }    
    }

备注

1、iOS常用类型如下,如需查看更多类型,请参考苹果官方文档 https://developer.apple.com/library/archive/documentation/Miscellaneous/Reference/UTIRef/Articles/System-DeclaredUniformTypeIdentifiers.html

类型 描述
public.text txt文件
com.adobe.pdf pdf文档
com.microsoft.word.doc word文档
com.microsoft.excel.xls excel文档
com.microsoft.powerpoint.ppt ppt文档
public.image 图片
public.movie 视频
public.audio 音乐

2、Android支持的类型符合 MIME 类型即可,参考链接 MIME 类型 | 菜鸟教程

类型 描述
text/plain txt文件
application/pdf pdf文档
application/msword word文档
application/vnd.ms-excel excel文档
application/vnd.ms-powerpoint ppt 文档
image/* 图片
video/* 视频
audio/* 音乐

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android平台文件选择需要访问存储卡权限,iOS如需要访问iCloud云盘内文件,需要打开iCloud云盘权限。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问