如何让Flutter应用成为Android默认桌面启动器？弹窗未出现问题

一、检查Manifest配置完整性 #

确保AndroidManifest.xml中主Activity的配置完全符合要求，除已添加的HOME和DEFAULT类别，还需补充必要的action与属性：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTask"
    android:stateNotNeeded="true">
    <!-- 应用启动入口的intent-filter -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- 桌面启动器的intent-filter -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.HOME" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

重点确认：

• android:exported="true"：必须开启，桌面启动器属于系统调用的组件，关闭此属性会导致系统无法识别
• android:launchMode="singleTask"：避免重复创建Activity实例，符合桌面应用的生命周期需求
• android:stateNotNeeded="true"：允许系统在必要时重启Activity，适配桌面应用的后台管理逻辑

二、清除现有默认桌面设置 #

如果设备已设置过其他默认桌面应用，系统不会自动弹出选择弹窗，需手动重置：

1. 打开设备设置 → 应用和通知（不同品牌设备可能命名为"应用管理"）
2. 找到当前默认的桌面应用（如系统自带桌面、第三方Launcher）
3. 进入应用详情页，点击默认打开 → 清除默认设置

完成上述操作后，再次按下Home键即可看到桌面选择弹窗。

三、代码方式强制唤起选择弹窗 #

若手动清除默认设置后仍无反应，可通过Flutter平台通道调用Android原生代码，主动触发选择弹窗：

1. Android原生代码（在MainActivity中添加） #

fun requestDefaultLauncher() {
    val intent = Intent(Intent.ACTION_MAIN)
    intent.addCategory(Intent.CATEGORY_HOME)
    intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
    startActivity(Intent.createChooser(intent, "选择默认桌面"))
}

2. Flutter端调用逻辑 #

通过MethodChannel与原生代码通信：

import 'package:flutter/services.dart';

class LauncherHelper {
  static const MethodChannel _channel = MethodChannel('launcher_default_channel');

  static Future<void> showLauncherChooser() async {
    try {
      await _channel.invokeMethod('requestDefaultLauncher');
    } on PlatformException catch (e) {
      print("唤起选择弹窗失败: ${e.message}");
    }
  }
}

在应用启动后或合适的用户交互时机，调用LauncherHelper.showLauncherChooser()即可触发弹窗。

四、测试注意事项 #

• 确保应用为已签名的调试版或正式版，部分设备会限制未签名应用的桌面权限
• 使用物理Home键测试，部分模拟器的虚拟Home键存在兼容性问题
• 不同Android版本的设置路径可能有差异，找不到选项时可直接搜索"清除默认应用"

内容的提问来源于stack exchange，提问作者Muhammad Hassan Saleem