如何实现Xamarin应用开机自启？BroadcastReceiver启动组件异常排查

一、代码中的直接错误 #

• 你错误调用了Application.Context.StartForegroundService(intent);，这里传入的是广播接收的intent而非创建的服务Intent，这行代码完全无效，必须删除。
• Android O（API 26）及以上版本中，前台服务启动后5秒内必须调用StartForeground()，否则系统会直接终止服务，这是强制要求。

二、修正后的OnReceive代码 #

public override void OnReceive(Context context, Intent intent)
{
    if (intent.Action == Intent.ActionBootCompleted)
    {
        Toast.MakeText(context, "Boot Completed", ToastLength.Short).Show();

        // 启动前台服务
        var foreGroundServiceIntent = new Intent(context, typeof(ForegroundService));
        // 适配不同Android版本的服务启动方式
        if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
        {
            context.StartForegroundService(foreGroundServiceIntent);
        }
        else
        {
            context.StartService(foreGroundServiceIntent);
        }

        // 如需启动MainActivity，添加以下代码
        var activityIntent = new Intent(context, typeof(MainActivity));
        activityIntent.AddFlags(ActivityFlags.NewTask); // 必须添加此标志，否则无法在非Activity上下文启动Activity
        context.StartActivity(activityIntent);
    }
}

三、清单文件必须配置的关键项 #

1. 添加必要权限

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- Android 12及以上需添加通知权限，因为前台服务依赖通知 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

2. 注册BroadcastReceiver
   确保广播接收器在清单中正确注册并声明接收开机广播：

<receiver android:name=".BootCompletedReceiver"
          android:enabled="true"
          android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="android.intent.action.QUICKBOOT_POWERON" /> <!-- 适配部分机型的快速重启场景 -->
    </intent-filter>
</receiver>

3. 注册ForegroundService
   Android O及以上需指定前台服务类型：

<service android:name=".ForegroundService"
         android:foregroundServiceType="dataSync" <!-- 根据你的服务功能选择对应类型，如location/mediaPlayback -->
         android:enabled="true"
         android:exported="false" />

四、ForegroundService内部必须实现的逻辑 #

在服务的OnStartCommand方法中必须调用StartForeground()，示例代码：

public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
{
    // Android O及以上必须创建通知渠道
    if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
    {
        var channel = new NotificationChannel("boot_service_channel", "开机服务通知", NotificationImportance.Default)
        {
            Description = "用于维持前台服务运行"
        };
        var notificationManager = (NotificationManager)GetSystemService(NotificationService);
        notificationManager.CreateNotificationChannel(channel);
    }

    // 构建前台服务所需的通知
    var notification = new Notification.Builder(this, "boot_service_channel")
        .SetContentTitle("应用已启动")
        .SetContentText("后台服务运行中")
        .SetSmallIcon(Resource.Drawable.ic_notification)
        .Build();

    // 启动前台服务
    StartForeground(1, notification);

    return StartCommandResult.Sticky;
}

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