@ capgo/ 容器- file- sharer

通过您的 Capacitor app 的本地共享表共享文件, 或者保存到 Android 上的设备中 。 在网络上,相同的通话下载文件.

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-file-sharer 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 加入@capgo/capor-file-sharrer到我的Capacitor应用上并把它接上 代理设置指南 • 妇女 主机磁共振

主要特点

• 份额数字 : share() 在iOS和Android上打开本地共享表.
• 保存:在Android上,(在Android上,在Android上,在Android上,在Android上,在Android上,在Android上,在Android上, save() 将文件存储在支持的 MediaStore 中,并保存旧版本的遗留路径。 在iOS上,它打开了共享工作表,让用户选择目的地.
• 灵活输入:通过基础64数据或本地文件.
• 网络倒置:两种方法都下载浏览器中的文件.
• 平台: iOS,Android和Web. 互联网档案馆的存檔,存档日期2013-12-02.

兼容性

插件主版本遵循Capacitor主版本. 新工作目标先是8号控制器.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-file-sharer` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

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

使用量

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

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

从本地文件路径或 Capacitor 文件 URL 共享 :

await FileSharer.share({
  filename: 'movie.mp4',
  contentType: 'video/mp4',
  path: fileUri,
});

直接保存在Android上或在Web上下载 :

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

console.log(result.uri);

综合说明

机器人

• 共享使用a FileProvider, (中文(简体) ), ClipData,而URI授予Android的选取者可以读取预览和缩略图.
• share() 在Android选择器打开后解决。 这避免了在活动状态下保留大型基地64有效载荷.
• save() 在Android 10+上向MediaStore写作,在较旧的Android版本上向对应的公共目录写作.
• 第9号及以下 WRITE_EXTERNAL_STORAGE 用于公共保存; 插件显示包含其中 maxSdkVersion=28。 。 。 .
• Android 保存目录 : downloads, (中文(简体) ), pictures, (中文(简体) ), movies, (中文(简体) ), music,以及 documents。 。 。 .

iOS系统

• share() 支持 base64Data 和直接当地 path 共享.
• save() 打开本地共享工作表,以便用户可以选择“保存到文件”或“其他目的地”.
• Swift包管理器和CocoaPods都得到了支持.

网页

• share() 财务报告和审定财务报表 save() 在浏览器中下载文件.
• Base64转换被块来避免Chromium中的大阵列分配失败.

错误代码

• ERR_PARAM_NO_FILENAME数字 : filename 缺少或空白.
• ERR_PARAM_NO_DATA: 无 base64Data 也没有 path 已提供.
• ERR_PARAM_DATA_INVALID: base64 输入无法解码 .
• ERR_LOCAL_FILE_NOT_FOUND: 无法打开提供的本地路径或内容 URI .
• ERR_FILE_CACHING_FAILED: 无法写入本地临时文件 .
• ERR_FILE_SAVE_FAILED: Android 无法将文件保存到公共存储.
• ERR_ACTIVITY_NOT_FOUND: Android 无法打开共享目标 .
• USER_CANCELLED:iOS共享表未完成被解职.

API 密码

• share(...)
• save(...)
• getPluginVersion()
• 接口
• 类型异名

电容文件共享器插件.

共享(...)

share(options: ShareFileOptions) => Promise<void>

使用Android和iOS上的本地共享页共享文件. 在网络上,这可以下载文件,因为浏览器不会暴露一个一致的本土文件共享目标.

保存(...)

save(options: SaveFileOptions) => Promise<SaveFileResult>

本地保存文件 . Android上这个写给MediaStore/Downloads。 在网络上下载文件 . 在 iOS 上,此打开共享工作表,以便用户选择保存到文件或其他目标 .

回返情况: Promise<SaveFileResult>

获取 PluginVersion ()

getPluginVersion() => Promise<PluginVersionResult>

返回平台执行版本标记 .

回返情况: Promise<PluginVersionResult>

接口

共享文件选项

用于共享文件的选项 .

Android 文件共享选项

用于文件共享和保存的Android特定行为.

保存文件结果

保存返回结果 () .

插件变压器

插件版本有效载荷 .

类型异名

Android Save Directory (英语:Android Save Directory) (英语:Android save Directory) 机器人保护指南(英语:Android Save Directory) 机器人保护指南(英语:Android Save Directory)

保存所用的Android公共收藏 ().

'downloads' | 'pictures' | 'movies' | 'music' | 'documents'

保存文件选项

用于本地保存文件的选项 .

ShareFileOptions

捐款

见 捐款额。 。 。 .

许可证

MPL - 2.0 导弹