Skip to content
Capgo - Live Updates for Capacitor Apps Capgo

Android behavior

Android scheduling is backed by WorkManager. No extra app manifest entry is required for normal periodic background fetch work.

Scheduling

Section titled “Scheduling”
await BackgroundTask.registerTaskAsync('sync-offline-data', {
  minimumInterval: 30,
  requiresNetwork: true,
});

Behavior

Section titled “Behavior”
  • Android enforces a 15 minute minimum interval for periodic work.
  • requiresNetwork: true maps to WorkManager’s connected network constraint.
  • Each task name is scheduled as unique periodic work, so registering the same task name updates the existing schedule.
  • Task runs are recorded natively before being delivered to JavaScript, so pending events can be drained when the WebView is ready.

Testing

Section titled “Testing”

Use the test trigger to execute registered callbacks immediately during development:

await BackgroundTask.triggerTaskWorkerForTestingAsync();

Limits

Section titled “Limits”

WorkManager is designed for deferrable work. It does not guarantee exact timing and should not be used for alarms, countdowns, or user-visible deadlines.