更新记录

1.0.0（2025-06-16） 下载此版本

测试用，暂请勿下载，后果自负。

平台兼容性

uni-app

uni-app x

飘文件管理器 UTS 插件

基于 UTS 开发的高性能文件管理插件，专为 uni-app-x 设计，完美解决文件选择和分享文件处理问题。

功能特性

• ✅ 单文件选择 - 支持选择任意类型的文件
• ✅ 多文件选择 - 支持同时选择多个文件（Android 4.4+）
• ✅ 分享文件处理 - 完美兼容 WPS、微信、QQ 等应用的文件分享
• ✅ 智能路径解析 - 自动处理 content://、file://等各种 URI 格式
• ✅ 流式文件复制 - 自动将无法直接访问的文件复制到临时目录
• ✅ 权限管理 - 自动请求和处理存储权限
• ✅ 临时文件清理 - 自动清理过期的临时文件
• ✅ 进度回调 - 支持文件处理进度监听
• ✅ 类型安全 - 完整的 TypeScript 类型定义

平台支持

• Android 5.0+ (API 21+)
• uni-app-x 项目

安装使用

1. 将插件复制到项目的 uni_modules 目录下
2. 在需要使用的页面中导入插件：

import {
  selectFile,
  selectMultipleFiles,
  getSharePath,
} from '@/uni_modules/piao-fileManager-uts';

API 文档

selectFile(options?) - 单文件选择

const file = await selectFile({
  : (current, total) => {
    console.log(`处理进度: ${current}/${total}`);
  },
});

if (file) {
  console.log('选择的文件:', file.name, file.path, file.sizeString);
}

selectMultipleFiles(options?) - 多文件选择

const files = await selectMultipleFiles({
  maxCount: 5, // 最大文件数量
  fallbackToSingle: true, // 不支持多选时是否降级到单选
  : (current, total, fileIndex, fileCount) => {
    console.log(
      `总进度: ${current}/${total}, 文件: ${fileIndex + 1}/${fileCount}`
    );
  },
  onFileProgress: (fileIndex, fileName, progress) => {
    console.log(`文件 ${fileName} 处理进度: ${progress}%`);
  },
});

if (files) {
  files.forEach((file) => {
    console.log('文件:', file.name, file.path, file.sizeString);
  });
}

getSharePath(options?) - 获取分享文件

// 在应用启动时调用，获取其他应用分享的文件
const sharedFiles = await getSharePath({
  : (current, total) => {
    console.log(`处理分享文件进度: ${current}/${total}`);
  },
});

if (sharedFiles) {
  if (Array.isArray(sharedFiles)) {
    // 多个分享文件
    sharedFiles.forEach((file) => {
      console.log('分享文件:', file.name, file.path);
    });
  } else {
    // 单个分享文件
    console.log('分享文件:', sharedFiles.name, sharedFiles.path);
  }
}

配置说明

插件需要在 AndroidManifest.xml 中配置 Intent 过滤器以接收分享文件，详见插件目录下的配置文件。

更新日志

v1.0.0

• 初始版本发布
• 支持单文件和多文件选择
• 支持分享文件处理
• 完美兼容 WPS 等应用