🎬 Demo #

Watch lifecycle_guard in action: App swipe → Background survival → Task completion.

✨ Features #

🚀 Quick Start #

Installation #

Add to your pubspec.yaml:

dependencies:
  lifecycle_guard: ^1.0.0

⚙️ Platform-Specific Setup #

For production use, you must configure the native layer for each platform. Click below for detailed guides:

💡 Usage #

import 'package:lifecycle_guard/lifecycle_guard.dart';

// Trigger a mission-critical background task
await LifecycleGuard.runSecureTask(
  id: "sync_user_data",
  payload: {
    "userId": "12345",
    "retry": true,
    "timestamp": DateTime.now().toIso8601String(),
  },
);

🧠 How It Works #

graph TD
    subgraph Flutter_Layer ["Flutter App (UI Thread)"]
        A[LifecycleGuard.runSecureTask]
    end

    subgraph Native_Bridge ["MethodChannel Bridge"]
        B{Platform Check}
    end

    subgraph Native_Layer ["Native Protection Layer"]
        C[Android: LifecycleService<br/><i>Foreground + dataSync</i>]
        D[iOS: BGTaskScheduler<br/><i>BGProcessingTask</i>]
    end

    A --> B
    B -- Android --> C
    B -- iOS --> D

    subgraph Results ["Survival Benefits"]
        E[✅ App Swipe Survival]
        F[✅ Doze Mode Protection]
        G[✅ Battery Saver Compliance]
    end

    C --> Results
    D --> Results

    style Flutter_Layer fill:#02569B,color:#fff,stroke:#fff
    style Native_Layer fill:#2E7D32,color:#fff,stroke:#fff
    style Native_Bridge fill:#333,color:#fff
    style Results fill:#1b1f23,color:#3fb950,stroke:#3fb950

📄 License #

BSD 3-Clause License — see LICENSE for details.