求助：Android WebView应用关屏后JavaScript停止，需维持GPS信号追踪

核心原因 #

Android设备息屏后，系统会触发Doze模式或让应用进入后台休眠状态，WebView的JavaScript线程会被系统暂停，直接导致GPS追踪中断。要解决这个问题，必须从Android原生代码层面配置，配合WebView设置保障后台运行能力。

具体解决方案 #

1. 添加必要权限 #

在AndroidManifest.xml中声明后台运行、位置获取相关权限：

<!-- 后台获取位置权限（Android 10+必需） -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 唤醒锁权限，防止CPU休眠 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- 申请忽略电池优化权限 -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

2. 配置WebView后台运行策略 #

初始化WebView时，关闭自动暂停逻辑，允许后台执行JS：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
// 禁用媒体播放需用户交互的限制，确保后台可运行
webSettings.setMediaPlaybackRequiresUserGesture(false);

// Android 8.0+配置渲染优先级，保障后台JS线程
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    webView.setRendererPriorityPolicy(WebView.RENDERER_PRIORITY_BOUND, true);
}

3. 使用唤醒锁维持CPU运行 #

通过Partial Wake Lock确保设备息屏后CPU不会完全休眠：

PowerManager powerManager = (PowerManager) getSystemService(Context.POWER_SERVICE);
WakeLock wakeLock = powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "GPS:TrackLock");

// 开始追踪时获取唤醒锁，设置超时时间（按需调整）
wakeLock.acquire(30*60*1000L);

// 停止追踪后及时释放唤醒锁，避免耗电
if (wakeLock.isHeld()) {
    wakeLock.release();
}

4. 申请忽略电池优化 #

系统电池优化会限制后台应用，需引导用户将应用加入白名单：

String packageName = getPackageName();
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
if (!pm.isIgnoringBatteryOptimizations(packageName)) {
    Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
    intent.setData(Uri.parse("package:" + packageName));
    startActivity(intent);
}

5. 用前台服务托管追踪逻辑 #

长时间后台运行需使用前台服务，避免被系统杀死：

public class GPSTrackService extends Service {
    private static final int NOTIFY_ID = 1001;

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        // 创建前台通知（Android 8.0+需先创建通知渠道）
        Notification notification = new NotificationCompat.Builder(this, "GPS_CHANNEL")
                .setContentTitle("GPS追踪中")
                .setContentText("正在获取位置数据")
                .setSmallIcon(R.drawable.ic_gps)
                .build();
        startForeground(NOTIFY_ID, notification);

        // 在这里执行GPS追踪逻辑，或通过WebView的JS接口调用前端代码
        return START_STICKY;
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

在AndroidManifest.xml中注册服务：

<service android:name=".GPSTrackService" android:foregroundServiceType="location" />

6. JS层面配合优化 #

使用watchPosition持续监听位置，设置后台运行参数：

// 启动位置监听，开启后台更新
const watchId = navigator.geolocation.watchPosition(
    (pos) => {
        console.log(`位置：${pos.coords.latitude}, ${pos.coords.longitude}`);
        // 处理位置数据逻辑
    },
    (err) => {
        console.error(err.message);
    },
    {
        enableHighAccuracy: true,
        timeout: 5000,
        maximumAge: 0,
        // Android 10+必需，允许后台获取位置
        enableBackgroundLocationUpdates: true
    }
);

// 停止追踪时清除监听
// navigator.geolocation.clearWatch(watchId);

注意事项 #

• Android 10及以上，需动态申请ACCESS_BACKGROUND_LOCATION权限，JS中必须设置enableBackgroundLocationUpdates: true。
• 唤醒锁会增加耗电，务必在追踪结束后释放。
• 小米、华为等定制系统可能有额外后台限制，需引导用户手动开启应用的"后台运行权限"。

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