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_KEEP_0__/__CAPGO_KEEP_1__-background-task 为原生能力在使用 @capgo/capacitor-background-task, for the native capability in Using @capgo/capacitor-background-task, Capgo 插件目录 为Capgo 插件目录中的产品工作流程 Capacitor 由Capgo 提供的插件 为Capacitor 由Capgo 提供的插件中的实现细节 添加或更新插件 为添加或更新插件中的实现细节 Ionic 企业插件替代品 为Ionic 企业插件替代品中的产品工作流程