跳转至正文
@capgo/capacitor-downloader 文件与存储 开源

下载器 Capacitor 插件

后台下载大文件,支持进度跟踪和暂停/恢复

安装

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

指南

如何在 Capacitor 中使用 Downloader

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Downloader 插件预览二维码 code

使用 @capgo/capacitor-downloader

Capacitor 插件支持后台下载文件。提供支持进度追踪的断点续传功能。

安装

bun add @capgo/capacitor-downloader
bunx cap sync

插件暴露的内容

  • download - 启动新的下载任务。
  • pause - 暂停当前下载。稍后可从原位置恢复下载。
  • resume - 恢复已暂停的下载。从暂停处继续下载。
  • stop - 永久停止并取消下载。已下载的数据将被删除。

用法示例

download

启动一个新的下载任务。

import { CapacitorDownloader } from '@capgo/capacitor-downloader';

const task = await CapacitorDownloader.download({
  id: 'my-download',
  url: 'https://example.com/file.pdf',
  destination: 'downloads/file.pdf'
});

pause

暂停当前下载。稍后可以从相同位置恢复下载。

import { CapacitorDownloader } from '@capgo/capacitor-downloader';

await CapacitorDownloader.pause({ id: 'id-123' });

resume

恢复已暂停的下载。从暂停处继续下载。

import { CapacitorDownloader } from '@capgo/capacitor-downloader';

await CapacitorDownloader.resume({ id: 'id-123' });

stop

- 永久停止并取消下载。已下载的数据将被删除。

import { CapacitorDownloader } from '@capgo/capacitor-downloader';

await CapacitorDownloader.stop({ id: 'id-123' });

完整参考

继续探索 使用 @capgo/capacitor-downloader

如果你正在使用 使用 @capgo/capacitor-downloader 要规划迁移和企业运营,请将其与 @capgo/capacitor-downloader 有关 @capgo/capacitor-downloader 的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 企业版 用于 Capgo Enterprise 中的产品工作流, Ionic Enterprise 插件替代方案 查看 Ionic Enterprise 插件替代方案中的产品工作流,以及 Capgo 替代方案 有关 Capgo 替代方案的产品工作流。

常见问题

Downloader 插件常见问题

如何在 Capacitor 应用中安装 Downloader 插件?

运行 "bun add @capgo/capacitor-downloader" (或 "npm install @capgo/capacitor-downloader"),然后运行 "bunx cap sync" 以确保 iOS 和 Android 项目同步 native code。最后在你的应用 code 中从 "@capgo/capacitor-downloader" 导入即可。

@capgo/capacitor-downloader 是否支持 React、Vue 和 Angular?

支持。Downloader 是一个 Capacitor package,因此它适用于任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及纯 JavaScript。

@capgo/capacitor-downloader 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-downloader 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-downloader/,并且可以直接从 npm 免费安装。欢迎提交 Bug 报告和 Pull Request。

使用了 Downloader 的 code 能否不经过 App Store 审核就更新?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App 审核,即可快速发布 Downloader 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo