更新记录

1.0.2（2026-03-26）

拆分harmony 为免费 uts 插件

1.0.1（2026-03-25）

更新最新版鸿蒙兼容问题

1.0.0（2026-03-15）

• 支持 Android / iOS 系统文件选择
• 支持单选和多选
• 支持后缀过滤
• 支持复制到应用缓存目录
• 返回统一文件信息

平台兼容性

austin-select-files

austin-select-files 是一个 App 全文件选择器 UTS 插件，当前包含 Android / iOS / Harmony 实现。

点击试用插件

当前目录下的 index.vue 是完整模板页，点击试用后包含：

• 当前平台能力展示
• 可选后缀测试
• 可选数量测试
• 复制到应用缓存目录开关
• 调用 selectFiles
• 最近一次返回结果展示

功能

• 支持 Android / iOS / Harmony 系统文件选择
• 支持单选和多选
• 支持后缀过滤
• 支持复制到应用缓存目录
• 返回统一文件信息

Harmony 说明

• 如果你需要 Harmony，请同时安装 austin-files-harmony
• austin-select-files 负责 Android / iOS
• austin-files-harmony 负责 Harmony
• 两个插件的 API 和回调结构保持一致，可以通过一个适配文件统一成三端调用

推荐新建一个适配文件，例如 utils/austin-select-files.js：

// #ifdef APP-HARMONY
export {
  selectFiles,
  getSelectFilesCapabilities,
} from '@/uni_modules/austin-files-harmony'
// #endif

// #ifndef APP-HARMONY
export {
  selectFiles,
  getSelectFilesCapabilities,
} from '@/uni_modules/austin-select-files'
// #endif

业务侧统一这样导入：

import { selectFiles, getSelectFilesCapabilities } from '@/utils/austin-select-files'

API

selectFiles(options)

参数：

• count
  • 最多选择数量
  • 不传默认 1
  • Android / iOS 都支持
• extensions
  • 允许选择的后缀数组
  • 例如：['pdf', 'docx', 'xlsx']
  • 不传或传空数组时表示不限制类型
• mimeTypes
  • MIME 类型数组
  • 当前首版更推荐直接传 extensions
• copyToCache
  • 是否复制到应用缓存目录
  • 不传默认 true
  • 开启后返回稳定本地路径，便于后续上传、预览、读取
• success
  • 成功回调
• fail
  • 失败回调
• complete
  • 完成回调

getSelectFilesCapabilities()

返回当前平台能力：

• supported
• platform
• supportsMultiple
• supportsExtensions
• supportsMimeTypes
• supportsCopyToCache
• notes

返回结果

单个文件项包含：

• name
• path
• uri
• size
• ext
• mimeType

完整返回还包含：

• ok
• platform
• count
• copied
• files
• errCode
• errMsg

最小示例

import { selectFiles } from '@/uni_modules/austin-select-files'

selectFiles({
  count: 2,
  extensions: ['pdf', 'docx'],
  copyToCache: true,
  success(res) {
    console.log('select-files-success', res)
  },
  fail(res) {
    console.log('select-files-fail', res)
  },
})

注意

• copyToCache: true 时，返回的是应用自己目录里的稳定路径
• copyToCache: false 时，返回的可能是系统临时路径或原始 uri
• 如果你需要三端统一能力，请同时安装 austin-files-harmony
• Harmony 端的免费插件仓库内会说明如何和当前插件组合使用