Flutter闹钟应用：如何实现独立弹窗页面的正确关闭逻辑？

针对你遇到的「后台/关闭状态下触发闹钟后，关闭页面会回到首页而非退后台」的问题，采用安卓独立Activity承载闹钟页面的方案可以完美匹配需求，以下是分步实现细节：

一、创建安卓独立AlarmActivity #

让闹钟页面运行在单独的任务栈中，彻底和主应用路由栈解耦。

1. 在安卓项目的android/app/src/main/kotlin/[你的应用包名]/目录下新建AlarmActivity.kt：

package com.yourpackage.name // 替换为实际包名

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.embedding.engine.FlutterEngineCache
import io.flutter.embedding.engine.dart.DartExecutor

class AlarmActivity : FlutterActivity() {
    private val ENGINE_ID = "alarm_engine"

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 复用FlutterEngine避免重复初始化
        var flutterEngine = FlutterEngineCache.getInstance().get(ENGINE_ID)
        if (flutterEngine == null) {
            flutterEngine = FlutterEngine(this)
            flutterEngine.dartExecutor.executeDartEntrypoint(
                DartExecutor.DartEntrypoint.createDefault()
            )
            FlutterEngineCache.getInstance().put(ENGINE_ID, flutterEngine)
        }
        // 直接启动闹钟页面路由
        flutterEngine.navigationChannel.setInitialRoute("/alarm-notification")
        this.flutterEngine = flutterEngine
    }

    // 提供给Flutter调用的关闭Activity方法
    fun finishActivity() {
        finish()
    }
}

2. 修改AndroidManifest.xml，注册该Activity并配置启动规则：
   在<application>标签内添加：

<activity
    android:name=".AlarmActivity"
    android:launchMode="singleTask"
    android:taskAffinity=""
    android:excludeFromRecents="true"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar.Fullscreen">
</activity>

• launchMode="singleTask"：确保Activity在独立任务栈启动
• taskAffinity=""：脱离主应用任务栈
• excludeFromRecents：不在最近任务列表显示（可选，按需调整）
• 全屏主题：保证闹钟页面全屏展示

二、Flutter端逻辑调整 #

1. 区分应用状态选择启动方式 #

通过平台通道判断应用是否在前台，前台时用原有导航栈，后台/关闭时启动独立Activity：

首先添加平台通信依赖，在Flutter工具类中实现状态判断：

import 'package:flutter/services.dart';

// 判断应用是否在前台
Future<bool> isAppInForeground() async {
  final result = await MethodChannel('com.yourpackage.name/app_status')
      .invokeMethod('isInForeground');
  return result ?? false;
}

对应安卓端在MainActivity.kt中添加MethodChannel实现：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.yourpackage.name/app_status"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "isInForeground") {
                result.success(isAppInForeground())
            } else {
                result.notImplemented()
            }
        }
    }

    private fun isAppInForeground(): Boolean {
        val activityManager = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
        val runningProcesses = activityManager.runningAppProcesses ?: return false
        return runningProcesses.any {
            it.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND &&
            it.processName == packageName
        }
    }
}

然后修改闹钟触发逻辑：

// 闹钟触发时调用此方法
Future<void> showAlarmScreen() async {
  val isForeground = await isAppInForeground();
  if (isForeground) {
    // 前台状态：用原有导航栈推送页面
    App.navigatorKey.currentState?.pushNamedAndRemoveUntil(
      '/alarm-notification',
      (route) => route.isFirst,
    );
  } else {
    // 后台/关闭状态：启动独立Activity
    await MethodChannel('com.yourpackage.name/alarm')
        .invokeMethod('startAlarmActivity');
  }
}

安卓端在MainActivity.kt的MethodChannel中添加启动Activity的逻辑：

// 在MainActivity的MethodCallHandler中添加分支
else if (call.method == "startAlarmActivity") {
    val intent = Intent(this, AlarmActivity::class.java)
    intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
    startActivity(intent)
    result.success(null)
}

2. Dismiss按钮逻辑适配 #

在AlarmNotificationScreen中，判断当前页面所在环境，执行对应操作：

import 'package:flutter/services.dart';

class AlarmNotificationScreen extends StatelessWidget {
  final MethodChannel _alarmChannel = MethodChannel('com.yourpackage.name/alarm');

  void onDismissPressed() async {
    // 判断是否在独立AlarmActivity中
    val isInAlarmActivity = await _alarmChannel.invokeMethod('isInAlarmActivity');
    if (isInAlarmActivity == true) {
      // 独立Activity：调用安卓方法关闭页面，直接退后台
      await _alarmChannel.invokeMethod('finishAlarmActivity');
    } else {
      // 主应用栈：pop返回上一页
      if (App.navigatorKey.currentState?.canPop() ?? false) {
        App.navigatorKey.currentState?.pop();
      }
    }
  }

  @override
  Widget build(BuildContext context) {
    // 页面布局，包含Dismiss按钮
    return Scaffold(
      body: Center(
        child: ElevatedButton(
          onPressed: onDismissPressed,
          child: const Text('Dismiss'),
        ),
      ),
    );
  }
}

安卓端在AlarmActivity.kt中添加对应的MethodChannel逻辑：

private val CHANNEL = "com.yourpackage.name/alarm"

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
        when (call.method) {
            "isInAlarmActivity" -> result.success(true)
            "finishAlarmActivity" -> {
                finishActivity()
                result.success(null)
            }
            else -> result.notImplemented()
        }
    }
}

三、Heads Up通知Dismiss处理 #

给通知的Dismiss按钮设置独立PendingIntent，点击时直接取消通知，不启动应用：

// 创建Dismiss按钮的广播意图
val dismissIntent = Intent(this, AlarmReceiver::class.java).apply {
    action = "ACTION_DISMISS_ALARM"
    putExtra("ALARM_ID", alarmId)
}
val dismissPendingIntent = PendingIntent.getBroadcast(
    this,
    alarmId,
    dismissIntent,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

// 构建Heads Up通知
val notification = NotificationCompat.Builder(this, ALARM_CHANNEL_ID)
    .setContentTitle("闹钟触发")
    .setContentText("点击查看详情")
    .setPriority(NotificationCompat.PRIORITY_HIGH)
    .setCategory(NotificationCompat.CATEGORY_ALARM)
    .addAction(R.drawable.ic_dismiss, "Dismiss", dismissPendingIntent)
    .build()

然后在AlarmReceiver.kt中处理取消逻辑：

class AlarmReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        when (intent.action) {
            "ACTION_DISMISS_ALARM" -> {
                val alarmId = intent.getIntExtra("ALARM_ID", -1)
                val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
                notificationManager.cancel(alarmId)
                // 这里可添加闹钟取消的业务逻辑
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Ahsan Sarwar