Flutter Launcher应用问题：Kiosk模式未生效及仅禁用Home/Recent按键

问题核心分析 #

你的代码存在两个关键问题：

• Kiosk模式逻辑倒置：当前先调用stopKioskMode()再打开应用，完全违背了锁定应用的需求逻辑
• 未配置系统级权限与规则：Kiosk模式依赖Android原生权限和设备管理策略，仅靠Flutter层面调用无法实现应用固定

同时，要实现仅禁用Home/Recent键、保留Back键的需求，必须结合Android原生API完成权限配置与事件拦截。

步骤1：配置Kiosk模式所需系统权限 #

Kiosk模式依赖Android的DevicePolicyManager，需先在Android项目中完成以下配置：

1. 在android/app/src/main/AndroidManifest.xml添加权限：

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

2. 注册设备管理接收器：
   创建MyDeviceAdminReceiver子类，在Manifest中声明：

<receiver
    android:name=".MyDeviceAdminReceiver"
    android:permission="android.permission.BIND_DEVICE_ADMIN">
    <meta-data
        android:name="android.app.device_admin"
        android:resource="@xml/device_admin" />
    <intent-filter>
        <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
    </intent-filter>
</receiver>

在res/xml/device_admin.xml中配置管理员权限：

<device-admin xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-policies>
        <lock-task />
        <disable-keyguard />
    </uses-policies>
</device-admin>

步骤2：修改Flutter代码，正确启用Kiosk模式 #

替换你当前的_showConfirmationDialog函数，调整逻辑为打开应用后启用Kiosk模式：

Future<void> _showConfirmationDialog(
    BuildContext context, Application application) {
  return showDialog(
      context: context,
      builder: (BuildContext context) {
        return AlertDialog(
          title: const Text("Open Application"),
          content: const Text("Are you Sure you want to open Application?"),
          actions: [
            TextButton(
                onPressed: () => Navigator.of(context).pop(),
                child: const Text("No")),
            TextButton(
                onPressed: () async {
                  Navigator.of(context).pop();
                  // 1. 打开目标应用
                  await DeviceApps.openApp(application.packageName);
                  // 2. 通过MethodChannel调用原生代码启用Kiosk模式
                  await const MethodChannel('com.your.package/kiosk')
                      .invokeMethod('startKioskMode', {
                    'packageName': application.packageName
                  });
                  showMessageAlert(context);
                },
                child: const Text("Yes"))
          ],
        );
      });
}

步骤3：实现原生层Kiosk模式与按键控制 #

在Android原生层创建MethodChannel处理Kiosk模式，并实现仅拦截Home/Recent键：

1. 配置MethodChannel（MainActivity.kt） #

private val CHANNEL = "com.your.package/kiosk"
private const val REQUEST_CODE_ENABLE_ADMIN = 1001

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
        when (call.method) {
            "startKioskMode" -> {
                val packageName = call.argument<String>("packageName")
                startKioskMode(packageName)
                result.success(null)
            }
            "stopKioskMode" -> {
                stopKioskMode()
                result.success(null)
            }
            else -> result.notImplemented()
        }
    }
}

2. 实现Kiosk模式锁定逻辑 #

private fun startKioskMode(packageName: String?) {
    val devicePolicyManager = getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
    val componentName = ComponentName(this, MyDeviceAdminReceiver::class.java)

    if (devicePolicyManager.isAdminActive(componentName)) {
        // 设置允许锁定的应用包名
        devicePolicyManager.setLockTaskPackages(componentName, arrayOf(packageName))
        // 启动锁定任务模式
        startLockTask()
    } else {
        // 请求设备管理员权限
        val intent = Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN).apply {
            putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN, componentName)
            putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION, "需要权限以启用Kiosk模式")
        }
        startActivityForResult(intent, REQUEST_CODE_ENABLE_ADMIN)
    }
}

private fun stopKioskMode() {
    if (isInLockTaskMode()) {
        stopLockTask()
    }
}

3. 拦截Home/Recent键，保留Back键 #

创建KioskAccessibilityService.kt实现全局按键拦截：

class KioskAccessibilityService : AccessibilityService() {
    override fun onAccessibilityEvent(event: AccessibilityEvent) {}

    override fun onInterrupt() {}

    override fun onKeyEvent(event: KeyEvent): Boolean {
        // 拦截Home键和Recent键，放行Back键
        return when (event.keyCode) {
            KeyEvent.KEYCODE_HOME, KeyEvent.KEYCODE_APP_SWITCH -> true
            else -> super.onKeyEvent(event)
        }
    }
}

在Manifest中注册该服务：

<service
    android:name=".KioskAccessibilityService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

创建res/xml/accessibility_service_config.xml：

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault"
    android:canRetrieveWindowContent="true"
    android:description="@string/accessibility_service_description" />

关键注意事项 #

• 必须在真机上测试Kiosk模式，模拟器存在权限限制
• 需提供明确的Kiosk模式退出入口（比如调用stopKioskMode()）
• 确保目标应用包名传递正确，否则无法锁定到指定应用

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