如何利用Gluon Mobile阻止应用休眠并满足导航类应用需求？

Android平台实现方案 #

1. 视觉模式：保持屏幕常亮+持续位置更新 #

屏幕常亮处理

无需额外权限，通过Android Activity的Window标记实现，可封装为Gluon自定义服务供前端调用：

public void enableScreenOn() {
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
}

public void disableScreenOn() {
    getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
}

切换到视觉模式时调用enableScreenOn()，退出视觉模式时调用disableScreenOn()。

位置服务持续运行

Android 8+系统会限制后台服务，需将位置服务转为前台服务避免被系统终止：

• 在Android Manifest中添加必要权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 12+ 需添加后台位置权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:maxSdkVersion="32" />

• 在位置服务类中启动前台服务，显示低优先级通知（不打扰用户）：

private void startForegroundLocationService() {
    // 创建Android 8+必需的通知渠道
    NotificationChannel channel = new NotificationChannel(
        "nav_location_channel", 
        "导航位置更新", 
        NotificationManager.IMPORTANCE_LOW
    );
    NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    manager.createNotificationChannel(channel);

    // 构建前台通知
    Notification notification = new NotificationCompat.Builder(this, "nav_location_channel")
        .setContentTitle("导航运行中")
        .setContentText("正在获取位置信息")
        .setSmallIcon(R.drawable.ic_nav_notification)
        .build();

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

启动位置服务时调用此方法，确保系统不会中断位置更新。

2. 声音模式：允许屏幕休眠+保持位置更新与通知能力 #

允许屏幕休眠，保持CPU运行

使用PowerManager的PARTIAL_WAKE_LOCK，确保设备休眠时CPU仍能运行以支持位置服务和通知：

• 在Manifest中添加权限：

<uses-permission android:name="android.permission.WAKE_LOCK" />

• 封装唤醒锁逻辑为Gluon自定义服务：

private PowerManager.WakeLock partialWakeLock;

public void initWakeLock() {
    PowerManager powerManager = (PowerManager) getSystemService(Context.POWER_SERVICE);
    partialWakeLock = powerManager.newWakeLock(
        PowerManager.PARTIAL_WAKE_LOCK, 
        "NavApp::LocationWakeLock"
    );
}

public void acquirePartialWakeLock() {
    if (!partialWakeLock.isHeld()) {
        partialWakeLock.acquire();
    }
}

public void releasePartialWakeLock() {
    if (partialWakeLock.isHeld()) {
        partialWakeLock.release();
    }
}

切换到声音模式时调用acquirePartialWakeLock()，退出声音模式时释放锁。

位置服务与通知

位置服务仍需保持前台服务状态（同视觉模式），确保后台位置更新不被限制。发送声音通知时，直接使用Android的Notification API指定声音即可：

Notification notification = new NotificationCompat.Builder(this, "nav_alert_channel")
    .setContentTitle("导航提醒")
    .setContentText("前方转弯")
    .setSmallIcon(R.drawable.ic_alert)
    .setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION))
    .build();

NotificationManagerCompat.from(this).notify(2, notification);

iOS平台规划（未来扩展） #

视觉模式 #

• 禁用系统休眠：UIApplication.shared.isIdleTimerDisabled = true，退出视觉模式时设为false。
• 位置服务：设置locationManager.allowsBackgroundLocationUpdates = true，并在Info.plist中添加位置权限描述（NSLocationAlwaysAndWhenInUseUsageDescription），同时开启后台模式中的Location updates。

声音模式 #

• 允许系统休眠（无需额外处理），保持allowsBackgroundLocationUpdates = true确保后台位置更新。
• 声音通知：注册本地通知权限，构建包含声音的UNNotificationRequest发送即可。

Gluon Mobile集成要点 #

由于Attach未提供相关API，需创建自定义Gluon服务：

1. 定义跨平台接口（如PowerManagementService、LocationForegroundService）。
2. 在Android/iOS端分别实现接口，通过ServiceProvider注册。
3. 前端代码通过Services.get(PowerManagementService.class)获取实例，调用对应方法切换模式。

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