Android 行为

Android 的调度由 WorkManager 支持。无需额外的应用程序清单条目来支持正常的周期性背景抓取工作。

调度

await BackgroundTask.registerTaskAsync('sync-offline-data', {
  minimumInterval: 30,
  requiresNetwork: true,
});

行为

• Android 对周期性工作强制执行 15 分钟的最小间隔时间。
• requiresNetwork: true 与 WorkManager 的连接网络约束对应。
• 每个任务名称都被计划为唯一的周期性工作，因此注册相同的任务名称会更新现有的计划。
• 任务运行会在 JavaScript 到达之前以原生方式记录，因此当 WebView 就绪时可以排空待处理事件。

测试

在开发期间使用测试触发器立即执行注册的回调函数：

await BackgroundTask.triggerTaskWorkerForTestingAsync();

限制

WorkManager 是为延迟工作设计的。它不保证精确的时间，并且不应用于闹钟、倒计时或用户可见的截止日期。

保持与 Android 行为一致

如果您正在使用 Android 行为 来规划原生插件工作，连接它与 使用 @capgo/capacitor-后台任务 为原生能力在使用 @capgo/capacitor-后台任务中 Capgo 插件目录 为产品工作流程在 Capgo 插件目录中 Capacitor 由 Capgo 提供的插件 为实现细节在 Capacitor 由 Capgo 提供的插件中 添加或更新插件 __CAPGO_KEEP_0__ Ionic 企业插件替代品 __CAPGO_KEEP_0__