更新记录

1.0.0（2026-03-26） 下载此版本

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

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-files-harmony

austin-files-harmony 是一个 Harmony 免费版全文件选择器 UTS 插件。

配套 Android / iOS 插件： austin-select-files

点击试用插件

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

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

功能

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

与 austin-select-files 组合实现三端

• austin-files-harmony 负责 Harmony
• austin-select-files 负责 Android / iOS
• 两个插件的 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
  • Harmony 支持
• extensions
  • 允许选择的后缀数组
  • 例如：['pdf', 'docx', 'xlsx']
  • 不传或传空数组时表示不限制类型
• mimeTypes
  • MIME 类型数组
  • Harmony 当前不支持原生 MIME 过滤，会自动忽略
• 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-files-harmony'

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
• Android / iOS 请安装 austin-select-files