如何用.NET MAUI开发基于Intent.CategoryHome的Android启动器应用？

针对Android 7.1平台，要让你的MAUI应用成为默认启动器，核心是正确配置Activity的Intent过滤器，并避免不必要的代码逻辑干扰系统行为。以下是可行的分步解决方案：

1. 配置MainActivity的Intent过滤器 #

在.NET MAUI中，主Activity的配置通过[Activity]和[IntentFilter]特性完成，无需手动修改AndroidManifest.xml（系统会自动合并配置）。将以下特性添加到Platforms/Android/MainActivity.cs的类定义上：

[Activity(
    Label = "YourLauncherApp",
    MainLauncher = true,
    LaunchMode = LaunchMode.SingleTask,
    ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density
)]
[IntentFilter(
    new[] { Intent.ActionMain },
    Categories = new[] { Intent.CategoryHome, Intent.CategoryDefault }
)]
public class MainActivity : MauiAppCompatActivity
{
    // 保留原有的OnCreate等生命周期方法，无需添加额外的Intent启动代码
    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        // 这里只保留MAUI初始化相关代码即可
    }
}

关键配置说明： #

• LaunchMode = LaunchMode.SingleTask：确保启动器始终以单实例运行，避免重复创建Activity
• IntentFilter中的Intent.ActionMain+Intent.CategoryHome+Intent.CategoryDefault：是系统识别启动器应用的核心标识

2. 移除错误的OnCreate逻辑 #

你之前在OnCreate中主动启动Home Intent的代码会导致逻辑冲突，系统会在按下Home键时自动唤起符合过滤器的Activity，无需手动调用StartActivity(intent)。删除这部分代码即可。

3. 引导用户设置默认启动器 #

安装应用后，系统不会自动将其设为默认启动器，需要引导用户完成设置。可以在OnResume中添加检查逻辑，若当前应用不是默认启动器，弹出引导对话框：

protected override void OnResume()
{
    base.OnResume();
    CheckDefaultLauncherStatus();
}

private void CheckDefaultLauncherStatus()
{
    var homeIntent = new Intent(Intent.ActionMain);
    homeIntent.AddCategory(Intent.CategoryHome);
    var resolveInfo = PackageManager.ResolveActivity(homeIntent, PackageInfoFlags.MatchDefaultOnly);
    var currentPackage = PackageName;

    // 判断当前默认启动器是否为自己
    if (!resolveInfo.ActivityInfo.PackageName.Equals(currentPackage))
    {
        new AlertDialog.Builder(this)
            .SetTitle("设置默认启动器")
            .SetMessage("请将本应用设置为默认启动器以使用完整功能")
            .SetPositiveButton("前往设置", (s, e) =>
            {
                StartActivity(new Intent(Settings.ActionHomeSettings));
            })
            .SetNegativeButton("稍后", (s, e) => { })
            .Show();
    }
}

4. 关于FakeLauncherActivity的避坑提示 #

如果尝试过添加FakeLauncherActivity导致崩溃，通常是因为组件配置错误。实际上，直接配置MainActivity的Intent过滤器已足够，无需额外添加FakeActivity。若必须使用该方案，需确保：

1. 在AndroidManifest.xml中正确声明禁用的Activity：

<activity android:name=".FakeLauncherActivity" android:enabled="false">
    <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>

2. 启用时确保组件名称正确，避免类型转换错误：

private void ToggleFakeLauncher(bool enable)
{
    var component = new ComponentName(this, Java.Lang.Class.FromType(typeof(FakeLauncherActivity)));
    PackageManager.SetComponentEnabledSetting(
        component,
        enable ? ComponentEnabledState.Enabled : ComponentEnabledState.Disabled,
        ComponentEnableOption.DontKillApp
    );
}

内容的提问来源于stack exchange，提问作者Aarón García Egea