更新记录

1.0.5（2026-03-23）

鸿蒙优化

1.0.4（2026-03-20）

修复鸿蒙语法报错

1.0.3（2026-03-20）

新增readTextFile方法，支持同步读取本地文本文件内容

平台兼容性

uni-app(4.0)

uni-app x(5.0)

其他

dh-choose-file

Android / iOS / HarmonyOS 原生文件选择插件，支持按类型过滤音频、视频、图片、文档等文件，也支持按扩展名精确过滤。

使用

import { chooseFile, readTextFile } from '@/uni_modules/dh-choose-file'

// 按文件类型过滤
chooseFile({
  fileTypes: ['audio'],
  success: (res) => {
    const file = res.files[0]
    console.log('文件路径:', file.path)
    console.log('文件名:', file.name)
    console.log('文件大小:', file.size, 'bytes')
    console.log('MIME 类型:', file.mimeType)
    console.log('扩展名:', file.extension)
    console.log('时长:', file.duration, 'ms') // 音频/视频有效，其他为 0
  },
  fail: (err) => {
    if (err.errCode === 8020001) {
      console.log('用户取消选择')
    } else {
      console.error('选择失败:', err.errMsg)
    }
  },
})

// 多选（最多 3 个），同时支持音频和视频
chooseFile({
  count: 3,
  fileTypes: ['audio', 'video'],
  success: (res) => {
    for (const file of res.files) {
      console.log(file.name, file.path)
    }
  },
})

// 按扩展名精确过滤（优先级高于 fileTypes）
chooseFile({
  extensions: ['mp3', 'wav', 'flac'],
  success: (res) => { ... },
})

// 选择所有类型文件
chooseFile({
  fileTypes: ['all'],
  success: (res) => { ... },
})

// 选择文本文件后读取内容
chooseFile({
  extensions: ['txt', 'json', 'xml', 'kml'],
  success: (res) => {
    const content = readTextFile(res.files[0].path)
    console.log('文件内容:', content)
  },
})

参数说明

ChooseFileOptions

fileTypes 支持的值

可传多个值，如 ['audio', 'video'] 表示同时显示音频和视频文件。

extensions 优先级高于 fileTypes：若同时传入 extensions，fileTypes 不生效。

ChooseFileItem（文件信息）

readTextFile

同步读取本地文本文件内容。

readTextFile(filePath: string): string

该函数为同步操作，大文件建议配合 loading 提示。

错误码

权限配置

三个平台均无需声明任何权限。

注意事项

• 返回的 path 是应用缓存目录中的文件副本（Android 复制自 content URI，iOS asCopy=true），应用退出后可能被系统清理
• 如需持久化存储，请将文件从 path 复制到应用 Documents 目录
• Android 的文件复制在 UI 线程执行，选择大文件时建议配合 loading 提示
• iOS 最低版本要求 14+（UIDocumentPickerViewController(forOpeningContentTypes:asCopy:) 在 iOS 14 引入）