更新记录

1.0.0（2025-10-16）

1.0.0

• 初始版本发布
• 支持文件选择功能
• 支持文件分享功能
• 兼容Android 5.0+

平台兼容性

uni-app(4.76)

uni-app x(4.76)

duiwei-file-share

Android 文件分享插件，基于 UTS 开发，支持选择内部文件和外部文件，并提供多种文件分享方案。

功能特点

• 支持文件分享功能，提供多种分享方案
• 支持多种文件类型（图片、视频、音频、文档等）
• 兼容 Android 5.0+ (API Level 21+)
• 完全兼容 Android 11+ 的分区存储策略

快速开始

导入插件

// 导入插件
import * as duiweiFileShare from "@/uni_modules/duiwei-file-share"

const {
  sharePrivateFileFunc,
  shareContentUriFunc,
} = duiweiFileShare

选择并分享文件

// 分享选中的文件
  shareContentUriFunc({
    uri: res.uri,
    shareTitle: "分享文件",
    success: () => {
      console.log("分享成功");
    },
    fail: (err) => {
      console.error("分享失败:", err);
    }
  });

API 文档

文件分享 API

sharePrivateFileFunc(options)

分享私有文件（应用内部文件），通过 FileProvider 生成安全 URI。

参数：

shareContentUriFunc(options)

分享公共媒体文件或用户选择的文件，直接分享系统返回的 URI。

参数：

注意事项

1. 内部文件选择：内部文件是指应用私有目录中的文件，包括内部存储和外部存储的私有目录。

2. 外部文件选择：使用系统文件选择器，可以指定MIME类型过滤文件。

3. URI与路径：不要尝试将content:// URI转换为文件路径，不同设备、不同文件提供者的路径格式不同。

4. Android 11+兼容性：插件已完全兼容Android 11+的分区存储策略，无需额外权限。

5. 临时权限：分享时添加的临时权限在设备重启或应用销毁后失效。

6. FileProvider配置：确保在AndroidManifest.xml中正确配置了FileProvider。

开发文档

• UTS语法
• UTS API插件
• UTS uni-app兼容模式组件
• UTS 标准模式组件
• Hello UTS