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 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。