MAUI Android中如何检测前台服务是否正在运行

为什么Intent.Action检测会失效 #

直接通过Intent.Action判断前台服务是否运行的方式本身就不可靠，Android系统并未提供通过Intent Action直接查询服务运行状态的机制，尤其是Android 8.0+的后台限制下，这种方法大概率返回错误结果。

正确的检测方法：通过ActivityManager查询 #

借助ActivityManager获取当前正在运行的服务列表，匹配目标服务的类名来判断是否处于运行状态。注意不同Android版本的权限要求：

• Android 11（API 30）及以上：需要在AndroidManifest.xml中添加QUERY_ALL_PACKAGES权限，或者针对特定服务声明QUERY_PACKAGE_SERVICES权限
• 低版本：无需额外权限（除基础服务权限）

检测代码实现 #

在MAUI的Android平台代码中（比如MainActivity或自定义服务辅助类），添加以下方法：

using Android.App;
using Android.Content;
using Android.OS;

public bool IsForegroundServiceRunning<T>() where T : Service
{
    var activityManager = (ActivityManager)Android.App.Application.Context.GetSystemService(Context.ActivityService);
    var serviceClassName = Java.Lang.Class.FromType(typeof(T)).CanonicalName;

    foreach (var runningService in activityManager.GetRunningServices(int.MaxValue))
    {
        if (runningService.Service.ClassName.Equals(serviceClassName))
        {
            // 验证是否为前台服务
            if ((runningService.Flags & ServiceInfo.FlagForeground) != 0)
            {
                return true;
            }
        }
    }
    return false;
}

启动前台服务的逻辑 #

当检测到服务未运行时，调用启动逻辑。注意Android 8.0+必须创建通知通道并在启动时传入通知：

启动服务代码示例 #

public void StartForegroundServiceIfNeeded<T>() where T : Service
{
    if (!IsForegroundServiceRunning<T>())
    {
        var intent = new Intent(Android.App.Application.Context, typeof(T));
        
        if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
        {
            // Android 8.0+ 启动前台服务
            Android.App.Application.Context.StartForegroundService(intent);
        }
        else
        {
            // 低版本启动服务
            Android.App.Application.Context.StartService(intent);
        }
    }
}

前台服务类中的通知处理（示例） #

你的前台服务类MyForegroundService需要在OnStartCommand中创建通知并调用StartForeground：

[Service(ForegroundServiceType = ForegroundService.TypeRegular)]
public class MyForegroundService : Service
{
    private const int NotificationId = 1001;
    private const string ChannelId = "MyForegroundServiceChannel";

    public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
    {
        // 创建通知通道（Android 8.0+）
        CreateNotificationChannel();

        var notification = new NotificationCompat.Builder(this, ChannelId)
            .SetContentTitle("前台服务运行中")
            .SetContentText("服务正在后台执行任务")
            .SetSmallIcon(Resource.Drawable.ic_notification)
            .Build();

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

        // 在这里编写你的服务逻辑
        return StartCommandResult.Sticky;
    }

    private void CreateNotificationChannel()
    {
        if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
        {
            var channel = new NotificationChannel(ChannelId, "前台服务通道", NotificationImportance.Default)
            {
                Description = "用于显示前台服务的通知"
            };
            var notificationManager = (NotificationManager)GetSystemService(NotificationService);
            notificationManager.CreateNotificationChannel(channel);
        }
    }

    public override IBinder OnBind(Intent intent) => null;
}

AndroidManifest.xml配置 #

在Platforms/Android/AndroidManifest.xml中添加服务声明和权限：

<!-- 权限声明 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Android 11+ 权限 -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

<!-- 服务声明 -->
<service android:name=".MyForegroundService" android:foregroundServiceType="regular" />

使用示例 #

在MAUI的共享代码或Android平台代码中调用：

// 检测并启动前台服务
var serviceHelper = new ServiceHelper(); // 假设上述方法在ServiceHelper类中
serviceHelper.StartForegroundServiceIfNeeded<MyForegroundService>();

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