iOS设置

iOS 后台处理使用 BGTaskScheduler。该应用程序必须在物理设备上调度工作之前声明背景模式和允许的任务标识符。

Info.plist

在此添加这些键 ios/App/App/Info.plist:

<key>UIBackgroundModes</key>
<array>
  <string>processing</string>
</array>
<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
  <string>app.capgo.backgroundtask.processing</string>
</array>

同步

npx cap sync ios

行为

• minimumInterval 映射到 earliestBeginDate.
• iOS根据电池、网络、使用模式和系统策略决定实际的运行时间。
• 在模拟器中，后台任务执行不稳定。测试在物理设备上。
• 插件在每次任务启动后重新安排下一个后台处理请求。

过期

使用 addExpirationListener 当iOS提前结束任务时，需要清理工作。

const handle = await BackgroundTask.addExpirationListener((event) => {
  console.warn('Task expired', event.taskName);
});

await handle.remove();

继续从iOS设置

如果您正在使用 iOS设置 来规划原生插件工作，连接它与 使用@capgo/capacitor-background-task 为原生能力在使用@capgo/capacitor-background-task中 Capgo插件目录 为产品工作流程在Capgo插件目录中 Capacitor由Capgo的插件 为实现细节在Capacitor由Capgo的插件中 添加或更新插件 对于在添加或更新插件中实现详细信息 Ionic 企业插件替代品 对于Ionic 企业插件替代品中的产品工作流程