如何在Android前台服务中访问.NET MAUI注册的单例服务？

问题背景 #

我们已在.NET MAUI项目中注册了IHTTPClient单例服务，代码如下：

namespace MyApp
{
    public class Startup : IStartup
    {
        public void Configure(IAppHostBuilder appBuilder)
        {
            appBuilder
                .ConfigureServices((context, services) =>
                {
                    services.AddSingleton<IHTTPClient, HTTPClient>();
                });
        }
    }
}

public interface IHTTPClient
{
    Task<string> GetAsync(string url);
    Task<string> PostAsync(string url, HttpContent content);
}

public class HTTPClient : IHTTPClient
{
    private readonly HttpClient _client;

    public HTTPClient()
    {
        _client = new HttpClient();
    }

    public async Task<string> GetAsync(string url)
    {
        var response = await _client.GetAsync(url);
        response.EnsureSuccessStatusCode();
        return await response.Content.ReadAsStringAsync();
    }

    public async Task<string> PostAsync(string url, HttpContent content)
    {
        var response = await _client.PostAsync(url, content);
        response.EnsureSuccessStatusCode();
        return await response.Content.ReadAsStringAsync();
    }
}

但Android前台服务MyForegroundService无法直接使用依赖注入，也无法通过MauiApp.Current.Services.GetService<IHTTPClient>()获取服务，需要实现该服务对IHTTPClient的访问：

using Android.App;
using Android.Content;
using Android.OS;
using Microsoft.Maui;

namespace MyApp.Droid
{
    [Service]
    public class MyForegroundService : Service
    {
        public const int SERVICE_RUNNING_NOTIFICATION_ID = 10000;

        public override void OnCreate()
        {
            base.OnCreate();
        }

        public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
        {
            var notification = new Notification.Builder(this, "my_channel_id")
                .SetContentTitle("My Foreground Service")
                .SetContentText("My Foreground Service is running...")
                .SetSmallIcon(Resource.Drawable.notification_icon_background)
                .SetOngoing(true)
                .Build();

            StartForeground(SERVICE_RUNNING_NOTIFICATION_ID, notification);

            return StartCommandResult.Sticky;
        }

        public override IBinder OnBind(Intent intent)
        {
            return null;
        }

        public override void OnDestroy()
        {
            base.OnDestroy();
        }
    }
}

解决方案 #

方法一：使用静态服务定位器 #

创建静态类保存MAUI的服务提供者，让Android服务可以直接访问。

1. 添加静态服务定位器类

namespace MyApp
{
    public static class ServiceLocator
    {
        public static IServiceProvider? Services { get; set; }
    }
}

2. 在MAUI启动时初始化定位器
   修改Startup类的Configure方法，构建服务提供者并赋值给定位器：

public void Configure(IAppHostBuilder appBuilder)
{
    appBuilder
        .ConfigureServices((context, services) =>
        {
            services.AddSingleton<IHTTPClient, HTTPClient>();
        });
    
    // 构建服务提供者并保存到定位器
    var serviceProvider = appBuilder.Services.BuildServiceProvider();
    ServiceLocator.Services = serviceProvider;
}

如果项目使用MauiProgram.cs作为启动入口，修改如下：

var builder = MauiApp.CreateBuilder();
builder.ConfigureServices(services =>
{
    services.AddSingleton<IHTTPClient, HTTPClient>();
});

var app = builder.Build();
// 保存服务提供者到定位器
ServiceLocator.Services = app.Services;

return app;

3. 在Android前台服务中使用
   修改MyForegroundService的OnStartCommand方法，通过定位器获取服务：

public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
{
    var notification = new Notification.Builder(this, "my_channel_id")
        .SetContentTitle("My Foreground Service")
        .SetContentText("My Foreground Service is running...")
        .SetSmallIcon(Resource.Drawable.notification_icon_background)
        .SetOngoing(true)
        .Build();

    StartForeground(SERVICE_RUNNING_NOTIFICATION_ID, notification);

    // 获取IHTTPClient实例
    var httpClient = ServiceLocator.Services?.GetService<IHTTPClient>();
    if (httpClient != null)
    {
        // 在后台线程执行异步操作，避免阻塞服务线程
        Task.Run(async () =>
        {
            try
            {
                var response = await httpClient.GetAsync("https://example.com/api/data");
                // 处理返回结果
            }
            catch (Exception ex)
            {
                // 处理异常
            }
        });
    }

    return StartCommandResult.Sticky;
}

方法二：直接注入静态实例到Android服务 #

在MAUI初始化时获取服务实例，赋值给Android服务的静态字段。

1. 在MyForegroundService中添加静态字段

[Service]
public class MyForegroundService : Service
{
    public static IHTTPClient? HttpClientInstance { get; set; }
    // ... 原有代码
}

2. 在MAUI的MainActivity中初始化静态字段

namespace MyApp.Droid
{
    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
    public class MainActivity : MauiAppCompatActivity
    {
        protected override void OnCreate(Bundle savedInstanceState)
        {
            base.OnCreate(savedInstanceState);
            
            // 获取服务实例并赋值给Android服务的静态字段
            var httpClient = ServiceLocator.Services?.GetService<IHTTPClient>();
            MyForegroundService.HttpClientInstance = httpClient;
        }
    }
}

3. 在Android服务中使用实例

public override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)
{
    // ... 原有通知代码

    if (HttpClientInstance != null)
    {
        Task.Run(async () =>
        {
            var response = await HttpClientInstance.GetAsync("https://example.com/api/data");
            // 处理结果
        });
    }

    return StartCommandResult.Sticky;
}

注意事项 #

• 确保服务定位器在Android服务启动前已完成初始化，避免空引用异常
• 所有异步操作必须放在后台线程执行，不要阻塞服务的主线程
• 静态定位器的方式需注意内存泄漏风险，但由于服务是单例且与应用生命周期一致，风险较低

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