Flutter锁屏时打开应用方法及Alarm Manager锁屏启动失效问题

Hey there! Let's tackle your two questions step by step:

1. 如何在Flutter中实现屏幕锁定状态下打开应用？ #

Flutter本身没有直接的跨平台API处理锁屏唤醒，因为这涉及系统级权限和行为限制，得依赖Android/iOS的原生能力。重点说Android端的实现（毕竟你提到了Alarm Manager）：

• 先在AndroidManifest.xml中添加唤醒锁、锁屏显示等必要权限
• 配置主Activity允许在锁屏时显示并点亮屏幕
• 借助原生组件（比如Alarm Manager、BroadcastReceiver）触发应用启动，同时配合唤醒机制确保设备被唤醒

2. 能否用Alarm Manager在锁屏时打开应用？你的代码问题出在哪？ #

答案是可以，但你的当前代码缺少关键配置，导致锁屏时无法生效。下面分析问题并给出修复方案：

问题分析 #

你的代码只是简单启动了一个Intent，但锁屏状态下Android系统会限制后台应用启动Activity的行为，同时设备可能处于休眠状态，没有足够的唤醒机制支持应用启动。

修复步骤 #

第一步：添加必要权限到AndroidManifest.xml

打开android/app/src/main/AndroidManifest.xml，添加以下权限：

<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- Android 10+ 需要 -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" /> <!-- 可选，确保重启后闹钟仍有效 -->

同时在主Activity标签中添加属性，允许锁屏显示：

<activity
    android:name=".MainActivity"
    android:showWhenLocked="true"
    android:turnScreenOn="true">
    <!-- 其他原有配置 -->
</activity>

第二步：修改Alarm回调代码，添加唤醒锁和Intent Flags

你需要用唤醒锁确保设备启动应用时保持唤醒状态，同时给Intent添加必要flags绕过锁屏限制。这里可以借助power_manager包（或自行实现原生方法）获取唤醒锁：

static Future<void> callback() async {
  print('Alarm fired!');

  // 唤醒设备并保持唤醒状态
  final powerManager = await PowerManager.instance;
  await powerManager.wakeUpDevice();
  await powerManager.acquireWakeLock();

  // 构建启动应用的Intent，指定主Activity并添加关键flags
  final AndroidIntent intent = AndroidIntent(
    action: 'android.intent.action.MAIN',
    package: 'com.example.app',
    componentName: 'com.example.app.MainActivity', // 替换成你的主Activity路径
    flags: [
      'FLAG_ACTIVITY_NEW_TASK',
      'FLAG_ACTIVITY_REORDER_TO_FRONT',
      'FLAG_SHOW_WHEN_LOCKED',
      'FLAG_TURN_SCREEN_ON',
    ],
  );

  await intent.launch();

  // 按需释放唤醒锁（若需保持屏幕唤醒可跳过）
  await powerManager.releaseWakeLock();
}

第三步：确保Alarm Manager使用唤醒类型

设置Alarm时，要使用RTC_WAKEUP或ELAPSED_REALTIME_WAKEUP类型，这样闹钟才能在设备休眠时唤醒设备：

// 示例：设置Alarm（依赖android_alarm_manager_plus包）
await AndroidAlarmManager.oneShot(
  const Duration(seconds: 10),
  0,
  callback,
  wakeup: true, // 关键：设置为true，确保唤醒设备
  exact: true,
);

额外注意事项 #

• Android 12及以上版本，可能需要在Activity的onCreate方法中补充代码：

  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setShowWhenLocked(true)
      setTurnScreenOn(true)
  }
  

• 部分厂商定制系统（如小米、华为）有后台限制，需将应用加入“白名单”或允许后台运行权限，否则Alarm可能无法正常触发。

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