更新记录

1.3.0(2026-11-05)

  • 统一文件选择入口、多选/类型/大小过滤、文件元信息。
  • 大文件分片续传、WebDAV/OSS 云盘导出、客户端加密、智能整理;附 Android/iOS 系统文档选择器 UTS 原生实现(离线队列+自动续传)。

平台兼容性

uni-app(4.0)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× √ - - × × √ √ ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - × × × × × × × × × ×

文件选择·云盘导出增强 Pro(zl-file-picker-pro)

简介

uni-app 文件选择 + 云盘导出一体化增强组件:统一选择入口、多选/类型/大小过滤、文件元信息、大文件分片续传、WebDAV/OSS 云盘导出、权限引导、客户端加密、智能整理,并附 Android/iOS 系统文档选择器 UTS 原生实现(离线队列 + 自动续传)。

功能特性

  • 系统文档选择器(SAF / UIDocumentPicker),不申请全局存储权限
  • 多选、类型/大小过滤、文件元信息读取
  • 大文件分片续传、断点续传(凭证零硬编码)
  • WebDAV / OSS 云盘导出
  • 客户端加密、智能整理

平台兼容

App-Android、App-iOS(系统选择器);上传模块全端可用

快速上手

import { pickFiles, uploadToOss } from '@/uni_modules/zl-file-picker-pro'
const files = await pickFiles({ accept: 'image/*', multiple: true })
await uploadToOss(files, { endpoint: 'https://your-oss', signApi: '/api/oss-sign' })

Android 权限与配置

  • 系统文档选择器(SAF)无需存储权限;Android 13+ 媒体读取走 Photo Picker
  • INTERNET(上传)
  • iOS 使用 UIDocumentPickerViewController,无需权限

合规声明

插件不经手任何数据;所选文件内容由接入方直接上传至其配置的对象存储/服务器(凭证经环境变量/签名接口,不落包内)。

常见问题

  • Q:上传中断? A:已支持分片续传,恢复网络后自动续传。
  • Q:选不了文件? A:确认使用系统选择器并已授权;Android 13+ 走 Photo Picker。

更新说明

1.3.0 首发:文档选择器、分片续传、云盘导出、客户端加密。

隐私、权限声明

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

Android:READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE(仅用于读取用户所选文件并导出/上传,Android 13+ 走系统 Photo Picker 不申请全局权限)。iOS:使用系统 UIDocumentPickerViewController 让用户主动选择文件,不访问相册或文件 App 之外的其他数据。

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

本插件在用户主动选择文件时调用系统文件选择器读取所选文件,仅用于文件导出/上传,不会在后台读取、上传或存储任何用户未主动选择的文件。Android 13+ 使用系统媒体选择器,不申请全局存储权限。所选文件与导出配置仅用于用户发起的导出/上传操作,不另行上传至插件作者服务器。

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

无

暂无用户评论。