Launcher change API and UI

Author: agg23

bridge-settings/react-app/src/components/LauncherSelect.tsx

@@ -0,0 +1,37 @@
+import React from "react";
+
+interface LauncherOption {
+  label: string;
+  component: string;
+}
+
+interface LauncherSelectProps {
+  launchers: LauncherOption[];
+  current: string;
+  onChange: (component: string) => void;
+}
+
+export const LauncherSelect: React.FC<LauncherSelectProps> = ({
+  launchers,
+  current,
+  onChange,
+}) => {
+  if (launchers.length === 0) {
+    return <span className="status-display">No launchers found</span>;
+  }
+
+  return (
+    <select
+      className="setting-select"
+      value={current}
+      onChange={(e) => onChange(e.target.value)}
+    >
+      {!current && <option value="">Select a launcher...</option>}
+      {launchers.map((launcher) => (
+        <option key={launcher.component} value={launcher.component}>
+          {launcher.label}
+        </option>
+      ))}
+    </select>
+  );
+};

bridge-settings/react-app/src/components/SystemSettings.tsx

@@ -2,6 +2,12 @@ import React from "react";
 import { useSettings } from "../hooks/useSettings";
 import { ToggleSwitch } from "./ToggleSwitch";
 import { Slider } from "./Slider";
+import { LauncherSelect } from "./LauncherSelect";
+
+interface LauncherOption {
+  label: string;
+  component: string;
+}
 
 export const SystemSettings: React.FC = () => {
   const { getSystemSettings, updateSystemSetting } = useSettings();
@@ -15,10 +21,28 @@ export const SystemSettings: React.FC = () => {
     updateSystemSetting(key, value);
   };
 
+  const handleLauncherChange = (component: string) => {
+    updateSystemSetting("launcher.current", component);
+  };
+
+  const availableLaunchers = (systemSettings["launcher.available"] ?? []) as LauncherOption[];
+  const currentLauncher = (systemSettings["launcher.current"] ?? "") as string;
+
   return (
     <div className="settings-section">
       <h2>System Settings</h2>
 
+      <div className="setting-item">
+        <span className="setting-label">Default Launcher</span>
+        <div className="setting-control">
+          <LauncherSelect
+            launchers={availableLaunchers}
+            current={currentLauncher}
+            onChange={handleLauncherChange}
+          />
+        </div>
+      </div>
+
       <div className="setting-item">
         <span className="setting-label">Display Enabled</span>
         <div className="setting-control">

bridge-settings/react-app/src/styles/index.css

@@ -621,6 +621,35 @@ input[type="range"]::-moz-range-thumb {
   flex: 1;
 }
 
+/* Select / Dropdown Styles */
+.setting-select {
+  padding: 8px 12px;
+  border: 1px solid #555555;
+  border-radius: 4px;
+  font-size: 14px;
+  background: #404040;
+  color: #e0e0e0;
+  cursor: pointer;
+  min-width: 200px;
+  max-width: 350px;
+}
+
+.setting-select:focus {
+  outline: none;
+  border-color: #3498db;
+  box-shadow: 0 0 0 2px rgba(52, 152, 219, 0.3);
+}
+
+.setting-select:hover {
+  border-color: #666666;
+}
+
+.setting-select option {
+  background: #404040;
+  color: #e0e0e0;
+  padding: 4px 8px;
+}
+
 /* eSIM Help Styles */
 .esim-help {
   margin-top: 24px;

bridge-settings/src/main/java/com/penumbraos/bridge_settings/LauncherController.kt

@@ -0,0 +1,182 @@
+package com.penumbraos.bridge_settings
+
+import android.util.Log
+import com.penumbraos.sdk.api.ShellClient
+
+private const val TAG = "LauncherController"
+
+data class LauncherInfo(
+    val label: String,
+    val component: String
+)
+
+class LauncherController(private val shellClient: ShellClient) {
+
+    companion object {
+        private val KNOWN_LAUNCHER_NAMES = mapOf(
+            "humane.experience.systemnavigation/humaneinternal.system.ipc.HumaneExperienceActivity" to "Humane SystemNavigation",
+            "com.penumbraos.mabl.pin/com.penumbraos.mabl.MainActivity" to "MABL",
+            "com.android.settings/.FallbackHome" to "Settings Fallback",
+        )
+    }
+
+    /**
+     * Queries available launcher apps by resolving activities with CATEGORY_HOME.
+     * Uses `pm query-activities` to find all apps registered as home/launcher.
+     */
+    suspend fun getAvailableLaunchers(): List<LauncherInfo> {
+        return try {
+            val result = shellClient.executeCommand(
+                "pm query-activities --brief -a android.intent.action.MAIN -c android.intent.category.HOME"
+            )
+            val output = result.output.trim()
+            Log.d(TAG, "query-activities output:\n$output")
+
+            if (!result.isSuccess || output.isEmpty()) {
+                Log.w(
+                    TAG,
+                    "Failed to query launcher activities, exit=${result.exitCode}, error='${result.error}'"
+                )
+                return emptyList()
+            }
+
+            parseLaunchers(output)
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to get available launchers", e)
+            emptyList()
+        }
+    }
+
+    /**
+     * Parses the output of `pm query-activities --brief` which outputs lines like:
+     *   com.android.launcher3/.Launcher
+     *   com.example.app/.HomeActivity
+     *
+     * Or in some Android versions with a "priority=N" header line followed by component names.
+     */
+    private fun parseLaunchers(output: String): List<LauncherInfo> {
+        val launchers = mutableListOf<LauncherInfo>()
+
+        for (line in output.lines()) {
+            val trimmed = line.trim()
+            // Skip empty lines, header lines like "priority=0", and other non-component lines
+            if (trimmed.isEmpty() || !trimmed.contains("/")) continue
+
+            // Component format: package/class (e.g., com.android.launcher3/.Launcher)
+            val component = trimmed
+            val packageName = component.substringBefore("/")
+
+            val label = KNOWN_LAUNCHER_NAMES[component] ?: packageName
+
+            launchers.add(LauncherInfo(label = label, component = component))
+            Log.d(TAG, "Found launcher: $label ($component)")
+        }
+
+        Log.i(TAG, "Found ${launchers.size} available launchers")
+        return launchers
+    }
+
+    /**
+     * Gets the current default launcher using `cmd shortcut get-default-launcher`.
+     * Returns the component name string, or null if it can't be determined.
+     */
+    suspend fun getCurrentLauncher(): String? {
+        return try {
+            val result = shellClient.executeCommand("cmd shortcut get-default-launcher")
+            val output = result.output.trim()
+            Log.d(TAG, "get-default-launcher output: '$output', exit=${result.exitCode}")
+
+            if (!result.isSuccess) {
+                Log.w(
+                    TAG,
+                    "Failed to get default launcher, exit=${result.exitCode}, error='${result.error}'"
+                )
+                return null
+            }
+
+            // Output format varies. It may be just a component name, or it may include
+            // extra text. Try to extract a component name (package/class pattern).
+            val componentRegex = Regex("""[\w.]+/[\w.]+""")
+            val match = componentRegex.find(output)
+
+            if (match != null) {
+                val component = match.value
+                Log.i(TAG, "Current default launcher: $component")
+                component
+            } else {
+                Log.w(TAG, "Could not parse default launcher from output: '$output'")
+                null
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to get current launcher", e)
+            null
+        }
+    }
+
+    /**
+     * Sets the default launcher using `cmd package set-home-activity`
+     * Verifies the change took effect by re-querying afterward, then force-stops
+     * the old launcher so Android immediately switches to the new one
+     *
+     * @param componentName The component name in package/class format (e.g., "com.android.launcher3/.Launcher")
+     * @return true if the launcher was changed successfully
+     */
+    suspend fun setDefaultLauncher(componentName: String): Boolean {
+        return try {
+            Log.i(TAG, "Setting default launcher to: $componentName")
+
+            // Get the current launcher before changing so we can force-stop it
+            val previousLauncher = getCurrentLauncher()
+            val previousPackage = previousLauncher?.substringBefore("/")
+            val newPackage = componentName.substringBefore("/")
+
+            val result = shellClient.executeCommandWithTimeout(
+                "cmd package set-home-activity $componentName",
+                timeoutMs = 10000
+            )
+
+            Log.d(
+                TAG,
+                "set-home-activity result: exit=${result.exitCode}, output='${result.output}', error='${result.error}'"
+            )
+
+            if (!result.isSuccess) {
+                Log.w(
+                    TAG,
+                    "set-home-activity command failed, exit=${result.exitCode}, error='${result.error}', output='${result.output}'"
+                )
+                return false
+            }
+
+            // Verify the change took effect
+            val currentLauncher = getCurrentLauncher()
+            if (currentLauncher != null && currentLauncher == componentName) {
+                Log.i(TAG, "Default launcher successfully changed to: $componentName")
+            } else {
+                Log.w(
+                    TAG,
+                    "Launcher change may not have taken effect. Expected=$componentName, got=$currentLauncher"
+                )
+            }
+
+            // Force-stop the old launcher so Android immediately resolves to the new one.
+            // Only do this if the launcher actually changed (different package).
+            if (previousPackage != null && previousPackage != newPackage) {
+                Log.i(TAG, "Force-stopping previous launcher: $previousPackage")
+                val stopResult = shellClient.executeCommandWithTimeout(
+                    "am force-stop $previousPackage",
+                    timeoutMs = 5000
+                )
+                Log.d(
+                    TAG,
+                    "force-stop result: exit=${stopResult.exitCode}, output='${stopResult.output}', error='${stopResult.error}'"
+                )
+            }
+
+            true
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to set default launcher to $componentName", e)
+            false
+        }
+    }
+}

bridge-settings/src/main/java/com/penumbraos/bridge_settings/SettingsRegistry.kt

@@ -119,6 +119,7 @@ class SettingsRegistry(
 
 
     private val humaneDisplayController = HumaneDisplayController(shellClient)
+    private val launcherController = LauncherController(shellClient)
     private val temperatureController = TemperatureController(shellClient)
     private val registryScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
 
@@ -203,14 +204,31 @@ class SettingsRegistry(
                 systemSettings["display.humane_enabled"] = false
             }
 
+            // Launcher settings
+            try {
+                val availableLaunchers = launcherController.getAvailableLaunchers()
+                systemSettings["launcher.available"] = availableLaunchers.map { launcher ->
+                    mapOf("label" to launcher.label, "component" to launcher.component)
+                }
+
+                val currentLauncher = launcherController.getCurrentLauncher()
+                systemSettings["launcher.current"] = currentLauncher ?: ""
+                Log.i(TAG, "Loaded launcher settings: current=$currentLauncher, available=${availableLaunchers.size}")
+            } catch (e: Exception) {
+                Log.e(TAG, "Failed to load launcher settings", e)
+                systemSettings["launcher.available"] = emptyList<Map<String, String>>()
+                systemSettings["launcher.current"] = ""
+            }
+
         } catch (e: Exception) {
             Log.e(TAG, "Failed to load current Android settings", e)
         }
     }
 
     private fun isAndroidSystemSetting(key: String): Boolean {
         return when (key) {
-            "audio.volume", "audio.muted", "display.humane_enabled", "device.temperature" -> true
+            "audio.volume", "audio.muted", "display.humane_enabled", "device.temperature",
+            "launcher.current", "launcher.available" -> true
             else -> false
         }
     }
@@ -271,6 +289,28 @@ class SettingsRegistry(
                     success
                 }
 
+                "launcher.current" -> {
+                    val componentName = when (value) {
+                        is String -> value
+                        else -> return false
+                    }
+                    Log.i(TAG, "Attempting to set default launcher to $componentName")
+                    val success = launcherController.setDefaultLauncher(componentName)
+                    if (success) {
+                        systemSettings["launcher.current"] = componentName
+                        Log.i(TAG, "Default launcher set to $componentName")
+                    } else {
+                        Log.w(TAG, "Failed to set default launcher to $componentName")
+                    }
+                    success
+                }
+
+                "launcher.available" -> {
+                    // Read-only setting, cannot be changed by clients
+                    Log.w(TAG, "launcher.available is read-only")
+                    false
+                }
+
                 else -> {
                     Log.w(TAG, "Unknown Android system setting: $key")
                     false
@@ -440,6 +480,8 @@ class SettingsRegistry(
             "audio.muted" -> value is Boolean
             "display.humane_enabled" -> value is Boolean
             "device.temperature" -> value is Number // Read-only, but validate type
+            "launcher.current" -> value is String && value.contains("/")
+            "launcher.available" -> false // Read-only
             else -> true // Allow unknown settings for extensibility
         }
     }

bridge-settings/src/main/java/com/penumbraos/bridge_settings/SettingsService.kt

@@ -77,6 +77,7 @@ class SettingsService {
                 settingsRegistry.setWebServer(webServer)
                 settingsProvider.setWebServer(webServer)
 
+                // TODO: This seems to cause deadlocks sometimes
                 webServer.start()
 
                 waitForBridgeSystem(TAG, bridge)

bridge-system/src/main/java/com/penumbraos/bridge_system/provider/WebSocketProvider.kt

@@ -81,6 +81,7 @@ class WebSocketProvider(private val client: OkHttpClient) : IWebSocketProvider.S
             }
         } else {
             Log.e("WebSocketProviderService", "WebSocket not found for requestId: $requestId")
+            throw IllegalStateException("WebSocket not found for requestId: $requestId")
         }
     }