更新记录

1.0.1（2026-08-13） 下载此版本

Harmony 免费版全文件选择器 UTS 插件。配套 AndroidiOS 付费插件 ebook-select-files。API 与回调结构一致。

平台兼容性

uni-app(3.8.1)

ebook-files-harmony

Harmony 免费版全文件选择器 UTS 插件。

配套 Android / iOS 付费插件：ebook-select-files（市场售卖模式对齐 austin-select-files + austin-files-harmony）。

功能

• 支持 Harmony 系统文件选择（DocumentViewPicker）
• 支持单选和多选
• 支持后缀过滤
• 支持复制到应用缓存目录
• 返回统一文件信息（与付费版 API 一致）

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

• ebook-files-harmony 负责 Harmony（本插件，市场 0 元）
• ebook-select-files 负责 Android / iOS（普通授权 + 源码授权）
• 两个插件 API / 回调结构保持一致

推荐新建适配文件 utils/select-files.js：

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

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

业务侧：

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

安装

1. 将本目录放入项目 uni_modules/ebook-files-harmony
2. 制作包含鸿蒙的自定义调试基座后运行

API

selectFiles(options)

getSelectFilesCapabilities()

supportsMimeTypes 在本端为 false。

最小示例

import { selectFiles } from '@/uni_modules/ebook-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 请安装 ebook-select-files
• 用户取消：errCode = 8020001，errMsg = 'cancel'

隐私、权限声明

1. 本插件需要申请的系统权限列表：无
2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：插件不采集任何数据
3. 本插件是否包含广告：无