Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

feat(ui): add server-mode button and explainer card to the terminal

ExTvec9c5e3b91f6
diff --git a/app/src/main/java/com/excp/podroid/ui/screens/terminal/ServerModeSheet.kt b/app/src/main/java/com/excp/podroid/ui/screens/terminal/ServerModeSheet.kt
new file mode 100644
index 0000000..8a9e28e
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/screens/terminal/ServerModeSheet.kt
@@ -0,0 +1,55 @@
+/*
+ * Podroid - Rootless Podman for Android
+ * Copyright (C) 2024-2026 Podroid contributors
+ *
+ * Explainer card for server (headless) mode. Modeled on X11SettingsSheet: a
+ * ModalBottomSheet styled from PodroidTokens. Describes the feature and how to
+ * exit, with one primary action to enable it.
+ */
+package com.excp.podroid.ui.screens.terminal
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.ModalBottomSheet
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import com.excp.podroid.R
+import com.excp.podroid.ui.components.PodroidPrimaryButton
+import com.excp.podroid.ui.theme.PodroidTokens
+
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun ServerModeSheet(onDismiss: () -> Unit, onEnable: () -> Unit) {
+ ModalBottomSheet(onDismissRequest = onDismiss) {
+ Column(
+ modifier = Modifier
+ .fillMaxWidth()
+ .padding(horizontal = PodroidTokens.Spacing.XL)
+ .padding(bottom = PodroidTokens.Spacing.XL),
+ ) {
+ Text(
+ text = stringResource(R.string.server_mode),
+ style = MaterialTheme.typography.titleLarge,
+ color = MaterialTheme.colorScheme.onSurface,
+ )
+ Spacer(Modifier.height(PodroidTokens.Spacing.SM))
+ Text(
+ text = stringResource(R.string.server_mode_desc),
+ style = MaterialTheme.typography.bodyMedium,
+ color = MaterialTheme.colorScheme.onSurfaceVariant,
+ )
+ Spacer(Modifier.height(PodroidTokens.Spacing.LG))
+ PodroidPrimaryButton(
+ text = stringResource(R.string.server_mode_enable),
+ onClick = { onEnable(); onDismiss() },
+ )
+ }
+ }
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalScreen.kt b/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalScreen.kt
index 80b1a3a..8f01468 100644
--- a/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalScreen.kt
+++ b/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalScreen.kt
@@ -45,6 +45,7 @@ import androidx.compose.material3.TextButton
import androidx.compose.material3.TopAppBar
import androidx.compose.material3.TopAppBarDefaults
import androidx.compose.material3.windowsizeclass.WindowSizeClass
+import androidx.compose.material.icons.filled.Bedtime
import androidx.compose.material.icons.filled.Close
import androidx.compose.material.icons.filled.DesktopWindows
import androidx.compose.material.icons.filled.Tune
@@ -129,6 +130,7 @@ fun TerminalScreen(
val showQuickSettings by viewModel.showQuickSettings.collectAsStateWithLifecycle()
val showExtraKeys by viewModel.showExtraKeysFlow.collectAsStateWithLifecycle()
val hapticsEnabled by viewModel.hapticsEnabledFlow.collectAsStateWithLifecycle()
+ var showServerSheet by remember { mutableStateOf(false) }
DisposableEffect(Unit) {
val activity = context as? Activity
@@ -202,6 +204,10 @@ fun TerminalScreen(
}
},
actions = {
+ IconButton(onClick = { showServerSheet = true }) {
+ Icon(Icons.Default.Bedtime, contentDescription = stringResource(R.string.server_mode))
+ }
+ Spacer(Modifier.width(PodroidTokens.Spacing.XS))
IconButton(onClick = onNavigateToX11) {
Icon(Icons.Default.DesktopWindows, contentDescription = "X11 screen")
}
@@ -212,6 +218,13 @@ fun TerminalScreen(
},
)
+ if (showServerSheet) {
+ ServerModeSheet(
+ onDismiss = { showServerSheet = false },
+ onEnable = { viewModel.enableServerMode() },
+ )
+ }
+
when (vmState) {
is VmState.Idle, is VmState.Stopped -> {
Box(modifier = Modifier.weight(1f).fillMaxWidth(), contentAlignment = Alignment.Center) {
diff --git a/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalViewModel.kt b/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalViewModel.kt
index 93481d0..89fd1d9 100644
--- a/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalViewModel.kt
+++ b/app/src/main/java/com/excp/podroid/ui/screens/terminal/TerminalViewModel.kt
@@ -64,6 +64,7 @@ class TerminalViewModel @Inject constructor(
@ApplicationContext private val context: Context,
private val engine: VmEngine,
private val settingsRepository: SettingsRepository,
+ private val headlessModeManager: com.excp.podroid.engine.hostbridge.HeadlessModeManager,
) : ViewModel() {
val vmState: StateFlow<VmState> = engine.state
@@ -95,6 +96,8 @@ class TerminalViewModel @Inject constructor(
fun openQuickSettings() { _showQuickSettings.value = true }
fun closeQuickSettings() { _showQuickSettings.value = false }
+ fun enableServerMode() = headlessModeManager.setActive(true)
+
fun updateShowExtraKeys(value: Boolean) {
viewModelScope.launch { settingsRepository.setShowExtraKeys(value) }
}
diff --git a/app/src/main/res/values-zh/strings.xml b/app/src/main/res/values-zh/strings.xml
index d34866e..c3c66c6 100644
--- a/app/src/main/res/values-zh/strings.xml
+++ b/app/src/main/res/values-zh/strings.xml
@@ -216,4 +216,8 @@
<string name="usb_passthrough_settings_description_available">在虚拟机中热插拔外部 USB 设备(Wi-Fi、存储、串口等)。设备连接时会询问许可。启动时添加 USB 控制器,因此需要重启虚拟机以应用更改。</string>
<string name="usb_passthrough_settings_description_unavailable">%1$s 后端不可用:USB 设备直通需要 QEMU 的 QMP 控制套接字,而 AVF 后端不提供此功能。</string>
<string name="downloads_sharing_unavailable">此 %1$s 构建不可用 - AVF 要求特权系统应用安装(Google 的终端应用通过这种方式绕过);第三方 APK 无法跨越 SELinux 域读取 /storage/emulated/Download。</string>
+ <string name="server_mode">服务器模式</string>
+ <string name="server_mode_desc">在屏幕变黑的情况下保持虚拟机运行以省电。应用会保持在前台,因此虚拟机不会被停止。要退出,请在任意位置长按 3 秒。</string>
+ <string name="server_mode_enable">启用服务器模式</string>
+ <string name="server_mode_exit_hint">长按 3 秒退出</string>
</resources>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 12cbbdf..fa00cea 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -215,4 +215,8 @@
<string name="usb_passthrough_settings_description_available">Hot-plugs external USB devices (Wi-Fi, storage, serial, etc.) into the VM. Each device asks for permission when attached. Adds a USB controller at boot, so restart the VM to apply.</string>
<string name="usb_passthrough_settings_description_unavailable">Not available on the %1$s backend: USB passthrough rides QEMU\'s QMP control socket, which the AVF backend doesn\'t provide.</string>
<string name="downloads_sharing_unavailable">Not available on this %1$s build — AVF requires a privileged system-app install (Google\'s Terminal app cheats this way); third-party APKs can\'t cross SELinux domains to read /storage/emulated/Download.</string>
+ <string name="server_mode">Server mode</string>
+ <string name="server_mode_desc">Keeps the VM running with the screen blacked out to save power. The app stays in the foreground so the VM is never stopped. To exit, press and hold anywhere for 3 seconds.</string>
+ <string name="server_mode_enable">Enable server mode</string>
+ <string name="server_mode_exit_hint">Hold 3 seconds to exit</string>
</resources>