文件共享

使用 @capgo/capacitor-file-sharer

从 base64 数据、数据 URL、本地文件路径、URL 等地方分享和保存文件 file:// URLs、Android content:// URI和Capacitor _capacitor_file_ URL。

安装

bun add @capgo/capacitor-file-sharer
bunx cap sync

此插件暴露的内容

• share - 在 Android 和 iOS 上打开原生分享面板，或者在 Web 上下载文件。
• save - 在 Android 上保存到公共收藏，或者在 iOS 上打开保存/分享面板，或者在 Web 上下载。
• getPluginVersion - 返回平台实现版本。

示例使用

分享一个生成的文件

import { FileSharer } from '@capgo/capacitor-file-sharer';

await FileSharer.share({
  filename: 'report.pdf',
  contentType: 'application/pdf',
  base64Data: reportBase64,
  title: 'Quarterly report',
  text: 'Attached report',
});

分享一个本地文件

await FileSharer.share({
  filename: 'export.zip',
  contentType: 'application/zip',
  path: fileUri,
});

在 Android 上保存到下载

const result = await FileSharer.save({
  filename: 'backup.zip',
  contentType: 'application/zip',
  base64Data: zipBase64,
  android: {
    saveDirectory: 'downloads',
    relativePath: 'Download/My App',
  },
});

console.log(result.uri);

平台说明

• Android 分享使用 FileProvider, ClipData, 并且 URI 授予者预览和缩略图可以读取文件。
• Android 保存使用 MediaStore 在 Android 10+ 和公共目录在 Android 9 以下。
• iOS 分享支持两种 base64 后备临时文件和直接本地路径共享。
• Web 分享和保存下载文件，使用大文件的分块 base64 转换。

完整参考

• GitHub: https://github.com/Cap-go/capacitor-file-sharer/
• 文档：/docs/plugins/file-sharer/

继续使用 @capgo/capacitor-file-sharer

如果您正在使用 使用 @capgo/capacitor-file-sharer To plan storage and file handling, connect it with @capgo/capacitor-file-sharer 关于 @capgo/capacitor-file-sharer 的实现细节 开始使用 关于开始使用的实现细节 @capgo/capacitor-data-storage-sqlite 关于 @capgo/capacitor-data-storage-sqlite 的实现细节 使用 @capgo/capacitor-data-storage-sqlite 关于使用 @capgo/capacitor-data-storage-sqlite 的原生能力 @capgo/capacitor-file 关于 @capgo/capacitor-file 的实现细节