更新记录

1.0.0（2026-08-04）

• 首版：Android SAF 文件选择（作者 Thor）
• 支持单选 / 多选、MIME 与扩展名过滤
• 支持复制到缓存目录，返回可上传路径
• 定价：普通授权 ¥9.90 / 源码授权 ¥49.00

平台兼容性

uni-app

uni-app x

Thor-file-picker

Thor 安卓增强文件选择 UTS 插件（第一版仅 Android）。

基于系统 SAF（ACTION_OPEN_DOCUMENT），适配分区存储，一般无需申请读写外部存储权限。

功能

• 单选 / 多选
• MIME 过滤（如 image/*、application/pdf）
• 扩展名过滤（结果侧二次校验）
• 可选复制到应用缓存目录，返回可直接用于 uni.uploadFile 的 path

安装

将本插件放入项目的 uni_modules/Thor-file-picker，使用 自定义调试基座 运行到 Android。

用法

import { chooseFile } from '@/uni_modules/Thor-file-picker'

chooseFile({
  multiple: true,
  count: 5,
  mimeTypes: ['image/*', 'application/pdf'],
  // extensions: ['pdf', 'png'],
  copyToCache: true,
  success(res) {
    console.log(res.files)
    // res.files[i].name / size / mimeType / uri / path / ext
  },
  fail(err) {
    console.log(err.errCode, err.errMsg)
  }
})

参数

错误码

错误码常量见 utssdk/unierror.uts（ERR_*）。

平台

• Android：已实现（minSdk 21）
• iOS / 鸿蒙：未实现（后续版本）

注意

1. 修改 UTS 原生相关代码后，需重新制作 自定义调试基座 再运行。
2. 系统文件管理器对 MIME 过滤支持因 ROM 而异；extensions 会在结果侧再过滤一层。
3. content:// 的 uri 适合长期引用；上传请优先用 copyToCache: true 得到的 path。

售价

• 普通授权版：¥9.90
• 源码授权版：¥49.00