Capacitor 文件共享器 __CAPGO_KEEP_0__ 插件:安装、设置和示例
@capgo/capacitor-文件共享器 文件 & 存储 开源

文件共享 Capacitor 插件

从 base64 数据或本地路径共享和保存文件,支持 Android、iOS 和 Web

安装

bun add @capgo/capacitor-file-sharer bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-file-sharer
  • pnpm add @capgo/capacitor-file-sharer
  • yarn add @capgo/capacitor-file-sharer

指南

如何在 Capacitor 中使用文件共享器

在设备上测试

下载 Capgo 应用程序,然后扫描二维码 code。

文件共享插件预览二维码code

使用@capgo/capacitor-file-sharer

从base64数据、数据URL、本地文件路径、URL、Android URI、和__CAPGO_KEEP_0__ file:// URL保存文件。 content:// URIs, 和Capacitor _capacitor_file_ 此插件暴露

Install

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

- 在Android上保存到公共集合,打开iOS保存/分享sheet,或者在Web上下载。

  • share - 在Web上下载文件。
  • save - 在Android上保存到公共集合,打开iOS保存/分享sheet,或者在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,
});

在安卓上保存到下载

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

console.log(result.uri);

平台说明

  • 安卓分享使用 FileProvider, ClipData, 和 URI 权限允许选择器预览和缩略图可以读取文件。
  • 安卓保存使用 MediaStore 在安卓 10+ 上和公共目录在安卓 9 以下。
  • iOS 分享支持两种方式:base64 后备临时文件和直接本地路径分享。
  • Web 分享和保存下载文件,使用分块 base64 转换处理大文件。

完整参考

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

如果您正在使用 使用@capgo/capacitor-file-sharer 来规划存储和文件处理,连接它到 @capgo/capacitor-文件共享器 查看@capgo/capacitor-file-sharer的实现细节 开始 查看开始的实现细节 @capgo/capacitor-sqlite-数据存储 为了在 @capgo/capacitor-data-storage-sqlite 中实现详细信息。 使用 @capgo/capacitor-data-storage-sqlite。 为了在使用 @capgo/capacitor-data-storage-sqlite 的原生能力中实现详细信息。 @capgo/capacitor-file。 为@capgo/capacitor文件的实现细节。

FAQ

文件共享器插件FAQ

如何在Capacitor应用中安装文件共享器插件?

运行“bun add @capgo/capacitor-file-sharer”(或“npm install @capgo/capacitor-file-sharer”),然后运行“bunx cap sync”,使iOS和Android项目捕获到native code。从“@capgo/capacitor-file-sharer”中导入文件共享器插件到您的code应用中。

是否@capgo/capacitor-file-sharer与React、Vue和Angular兼容?

是的。文件共享器是一个Capacitor包,因此它可以与任何在Capacitor中运行的Web框架一起工作,包括Ionic、React、Vue、Angular、Svelte和纯JavaScript。

Which Capacitor version does @capgo/capacitor-file-sharer support?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格列出了维护的版本。

是否@capgo/capacitor-file-sharer免费且开源?

是的。code源代码在GitHub上公开,地址为https://github.com/Cap-go/capacitor-file-sharer/,并且该包可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过 App Store 审核的情况下更新使用 File Sharer 的 code?

code 插件安装或升级会改变原生 code,因此需要重新构建 App Store。随后,调用插件的 JavaScript、HTML 和 CSS 更改可以立即通过 Capgo 实时更新。

不必等待应用程序审查就可以将文件共享的更改推送到商店

Capgo

使用Capgo