Flutter前台保活插件android_foreground_alive的使用

android_foreground_alive 是一个 Flutter 插件，用于在 Android 平台上实现前台服务的保活功能。通过使用该插件，你可以在应用进入后台时保持应用的活动状态，防止系统杀死应用进程。

安装插件

首先，你需要在 pubspec.yaml 文件中添加 android_foreground_alive 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  android_foreground_alive: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装插件。

使用插件

1. 初始化插件

在使用插件之前，你需要在 main.dart 文件中初始化插件：

import 'package:android_foreground_alive/android_foreground_alive.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AndroidForegroundAlive.init();
  runApp(MyApp());
}

2. 启动前台服务

在需要保活的地方，调用 startForegroundService 方法启动前台服务：

import 'package:android_foreground_alive/android_foreground_alive.dart';

void startForegroundService() async {
  await AndroidForegroundAlive.startForegroundService(
    title: 'My App',
    content: 'App is running in the background',
    icon: 'ic_notification',  // 通知图标资源名称
  );
}

icon 参数是通知图标的资源名称，你需要在 android/app/src/main/res/drawable 目录下放置相应的图标文件（例如 ic_notification.png）。

3. 停止前台服务

当不再需要保活时，可以调用 stopForegroundService 方法停止前台服务：

void stopForegroundService() async {
  await AndroidForegroundAlive.stopForegroundService();
}

4. 处理生命周期

你可以在 WidgetsBindingObserver 中监听应用的生命周期，以在应用进入后台时启动前台服务，并在应用回到前台时停止前台服务：

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  [@override](/user/override)
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  [@override](/user/override)
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  [@override](/user/override)
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.paused) {
      startForegroundService();
    } else if (state == AppLifecycleState.resumed) {
      stopForegroundService();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Foreground Service Example'),
        ),
        body: Center(
          child: Text('Keep app alive in the background'),
        ),
      ),
    );
  }
}

注意事项

1. 权限：在 Android 10 及以上版本，你需要在 AndroidManifest.xml 中添加 FOREGROUND_SERVICE 权限：

   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
   

2. 通知图标：确保你提供的通知图标资源存在于 drawable 目录中，并且名称与代码中的 icon 参数一致。

3. 后台限制：Android 系统对后台应用的活动有一定的限制，尤其是在 Android 8.0（API 26）及以上版本。前台服务可以帮助你绕过这些限制，但仍然需要遵循 Android 的最佳实践。

4. 电池优化：长时间运行的前台服务可能会影响设备的电池寿命，建议在不需要时及时停止服务。

示例代码

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:android_foreground_alive/android_foreground_alive.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AndroidForegroundAlive.init();
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  [@override](/user/override)
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  [@override](/user/override)
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  [@override](/user/override)
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.paused) {
      startForegroundService();
    } else if (state == AppLifecycleState.resumed) {
      stopForegroundService();
    }
  }

  void startForegroundService() async {
    await AndroidForegroundAlive.startForegroundService(
      title: 'My App',
      content: 'App is running in the background',
      icon: 'ic_notification',
    );
  }

  void stopForegroundService() async {
    await AndroidForegroundAlive.stopForegroundService();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Foreground Service Example'),
        ),
        body: Center(
          child: Text('Keep app alive in the background'),
        ),
      ),
    );
  }
}