Shiny.net + MAUI.net位置追踪异常：后台委托未触发问题排查

1. 确认GPS委托实现正确性 #

Shiny 3.x版本已废弃旧的IGpsListener接口，必须实现IGpsDelegate，且三个方法需完整实现（即使是空逻辑）。检查你的MyGpsDelegate是否符合以下结构：

public class MyGpsDelegate : IGpsDelegate
{
    public Task OnGpsReading(GpsReading reading)
    {
        // 添加调试日志确认是否触发
        System.Diagnostics.Debug.WriteLine($"GPS更新: {reading.Latitude}, {reading.Longitude}");
        return Task.CompletedTask;
    }

    public Task OnListenerStarted()
    {
        System.Diagnostics.Debug.WriteLine("GPS监听器启动");
        return Task.CompletedTask;
    }

    public Task OnListenerStopped(bool isDisposed)
    {
        System.Diagnostics.Debug.WriteLine($"GPS监听器停止，是否释放: {isDisposed}");
        return Task.CompletedTask;
    }
}

2. 补充Android Manifest配置 #

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

<!-- 基础位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 后台位置权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

<!-- 注册Shiny GPS前台服务 -->
<service android:name="Shiny.Locations.GpsForegroundService" android:foregroundServiceType="location" />

3. 完善Shiny初始化与前台服务委托注册 #

在MauiProgram.cs中，需显式启用Shiny位置模块，并注册前台服务委托：

builder.Services.AddSingleton<IAndroidForegroundServiceDelegate, MyForegroundServiceDelegate>();

builder.UseShiny(shiny =>
{
    shiny.UseLocations();
    // 可选：启用调试日志排查问题
    shiny.UseLogging(config =>
    {
        config.SetMinimumLevel(LogLevel.Debug);
        config.AddDebug();
    });
});

确保你的MyForegroundServiceDelegate配置了合法的通知渠道与内容：

public class MyForegroundServiceDelegate : IAndroidForegroundServiceDelegate
{
    public void Configure(AndroidX.Core.App.NotificationCompat.Builder builder)
    {
        builder.SetContentTitle("位置追踪中")
               .SetContentText("后台正在获取位置数据")
               .SetSmallIcon(Resource.Drawable.ic_notification)
               .SetOngoing(true);
    }

    public string ChannelId => "location_tracking_channel";
    public string ChannelName => "位置追踪";
    public Android.App.Importance ChannelImportance => Android.App.Importance.Low;
}

4. 规范监听器启动逻辑 #

避免重复启动监听器，先检查状态再操作：

var status = await gpsManager.GetStatus();
if (!status.IsListening)
{
    var request = new GpsRequest(
        GpsBackgroundMode.Standard,
        interval: TimeSpan.FromSeconds(10),
        distanceFilterMeters: 10
    );
    await gpsManager.StartListener(request);
}

注意：GpsBackgroundMode.Standard依赖前台服务，若前台服务委托未正确注册，后台定位会被系统拦截。

5. 排查系统级限制 #

• 关闭设备对该应用的电池优化（Android 12+后台定位受电池优化影响极大）；
• 确认Android 13+设备已授予ACCESS_FINE_LOCATION、ACCESS_COARSE_LOCATION、ACCESS_BACKGROUND_LOCATION三项权限；
• 测试时避免应用被完全划掉（部分厂商系统会直接终止后台进程）。

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