mcpField
F
flutter-background-execution

flutter-background-execution

github.com/thienqo开发1792 次安装今天更新
代码仓库

关于 flutter-background-execution

用于规划和验证 Flutter 后台任务的指导技能，涵盖操作系统调度器。它帮助 Flutter 开发者根据任务要求选择执行方式，并验证平台生命周期行为。

主要功能

  1. 01评估任务要求
  2. 02选择调度器的指导
  3. 03按需查阅平台资料
  4. 04验证生命周期与失败处理

适用场景

  1. 01为可延迟任务选择调度器
  2. 02检查进程终止或重启后的行为
  3. 03测试重试、取消和重复投递

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-background-execution

安装后在 Claude Code 中输入/flutter-background-execution确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
android-scheduling-and-services.md
apple-background-tasks.md
headless-execution-and-reliability.md

详细介绍

Flutter 后台执行

应将后台执行视为操作系统契约，而不是能够保证持续运行的 Dart 计时器。如果项目现有的调度器或插件满足需求，就应保留；更改之前，请检查 pubspec.yaml、SDK 约束、目标平台、原生能力和现有注册情况。

定义任务

记录触发条件、可接受的延迟、最长运行时间、进程终止或设备重启后是否仍需运行、网络／电源约束、用户可见性、取消方式，以及用户退出登录或删除数据后应如何处理。区分“最终必须运行”和“必须在准确时间运行”；移动平台的调度器通常只能尽力安排任务。

选择归属方

  • 如果工作只需在应用进程存活时运行，就使用 dart-concurrency。
  • 对于可延后执行、但必须在应用不再前台显示后仍能运行的工作，使用由操作系统支持的调度器。
  • 仅当平台允许此用例，且其披露要求、权限和限制均得到满足时，才使用用户可见的前台运行或持续处理模式。
  • 将准确的用户提醒和通知投递交由 flutter-notifications 处理。
  • 将自定义原生调度器桥接或可复用的插件实现交由 flutter-platform-integration 处理。

不要默认添加调度软件包。应先确认平台覆盖范围、维护情况、目标 SDK 支持、回调模型以及仓库现有依赖。

按需加载详细信息

  • 如需了解 WorkManager、前台服务、精确闹钟、重启行为或 Android 权限，请阅读 Android 调度与服务。
  • 如需了解 BGTaskScheduler、刷新／处理任务、过期、功能配置或 iOS 调度要求，请阅读 Apple 后台任务。
  • 如需了解回调分发器、隔离区、插件访问、重试、去重或持久化进度，请阅读 无界面执行与可靠性。

验证

在不依赖平台的边界后测试任务主体，涵盖成功、可重试失败、永久失败、取消、重复投递和身份信息过期。然后在每个受支持的目标平台上验证原生注册和生命周期：应用进入后台、进程终止、约束条件、过期或超时、重新调度、承诺支持时的设备重启，以及退出登录后的清理。报告实际设备和生命周期验证结果；直接调用函数成功，并不能证明操作系统调度有效。

资料来源

评论

支持 Markdown