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 企业插件替代方案的产品工作流程