@capgo/capacitor-background-task

概览

使用 @capgo/capacitor-background-task 当您的 Capacitor 应用需要周期性背景抓取工作，例如同步、缓存刷新、收件箱轮询、分析刷新或轻量级维护作业时。

该插件遵循 Expo BackgroundTask 的实用功能集，包括带有名称的任务、持久注册、状态检查、注销、开发触发器和 iOS 过期事件。

核心功能

• defineTask - 为指定任务注册 JavaScript 回调函数。
• registerTaskAsync - 持久化并计划一个周期性任务。
• unregisterTaskAsync - 取消一个任务的未来运行。
• isTaskRegisteredAsync - 检查是否已注册一个任务。
• getRegisteredTasksAsync - 列出当前已注册的任务名称。
• getPendingTaskRunsAsync - 检查本地任务事件的记录，事件发生在 JavaScript 未准备好之前。
• getStatusAsync - 检查本地后台任务的可用性。
• triggerTaskWorkerForTestingAsync - 在开发环境下，立即运行已注册的任务。
• addExpirationListener - 处理 iOS 过期回调函数。
• define, schedule, cancel, statusAsync, 和 finish - 兼容性帮助器 react-native-background-task.

平台行为

背景任务不是精确的定时器。 Android 和 iOS 根据电池、网络、应用程序使用情况和系统政策决定何时运行预定的工作。

平台	原生调度器	重要行为
Android	WorkManager	周期性工作有一个 15 分钟的最小间隔。
iOS	BGTaskScheduler	minimumInterval 是一个最早开始的日期，而不是保证的节奏。
Web	仅用于测试的备选方案	没有可用的真实背景调度器。

公共API

方法	描述
defineTask	定义一个命名任务的JavaScript回调。
registerTaskAsync	注册一个命名的周期性背景任务。
unregisterTaskAsync	取消未来的任务运行。
isTaskRegisteredAsync	返回一个任务是否已注册。
getRegisteredTasksAsync	列出已注册的任务名称。
getPendingTaskRunsAsync	列出等待完成的本机任务事件。
getStatusAsync	是否支持原生背景调度
triggerTaskWorkerForTestingAsync	触发已注册的任务（开发和QA）
addExpirationListener	监听iOS过期事件

真实数据来源

此参考资料是从 src/definitions.ts 在 capacitor-背景任务.

从@capgo/capacitor-背景任务继续

如果您正在使用 @capgo/capacitor-背景任务 为原生插件工作做好准备，连接它 使用 @capgo/capacitor-background-task 在使用 @capgo/capacitor-background-task 中的原生能力 Capgo 插件目录 在 Capgo 插件目录 中的产品工作流 Capacitor 由 Capgo 提供的插件 在 Capacitor 由 Capgo 提供的插件 中的实现细节 添加或更新插件 在添加或更新插件 中的实现细节 Ionic 企业插件替代品 在 Ionic 企业插件替代品 中的产品工作流