Skip to content

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

Bump to v1.0.8: Android 8+ support and lint cleanup

ExTv21945db82250
diff --git a/README.md b/README.md
index e313b07..d30ec7a 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ Podroid spins up a lightweight Alpine Linux VM on your phone using QEMU and give
## Requirements
- **arm64** Android device
-- Android **14+** (API 34)
+- Android **8.0+** (API 26)
- ~150 MB free storage
## Quick Start
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 6b709b5..bc2ea86 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -21,10 +21,10 @@ android {
defaultConfig {
applicationId = "com.excp.podroid"
- minSdk = 34
+ minSdk = 26
targetSdk = 36
- versionCode = 10
- versionName = "1.0.7"
+ versionCode = 11
+ versionName = "1.0.8"
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index 269a871..02b5132 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -21,6 +21,9 @@
<!-- Keep CPU awake while VM is running -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
+ <!-- Terminal bell haptic feedback (used by Termux terminal view) -->
+ <uses-permission android:name="android.permission.VIBRATE" />
+
<!-- Foreground service for QEMU process -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
@@ -59,7 +62,6 @@
android:name=".MainActivity"
android:configChanges="orientation|screenSize|keyboardHidden|keyboard"
android:exported="true"
- android:label="@string/app_name"
android:theme="@style/Theme.Podroid"
android:windowSoftInputMode="adjustResize">
<intent-filter>
diff --git a/app/src/main/java/com/excp/podroid/MainActivity.kt b/app/src/main/java/com/excp/podroid/MainActivity.kt
index a339c26..df764a7 100644
--- a/app/src/main/java/com/excp/podroid/MainActivity.kt
+++ b/app/src/main/java/com/excp/podroid/MainActivity.kt
@@ -39,6 +39,7 @@ class MainActivity : ComponentActivity() {
}
private fun requestNotificationPermissionIfNeeded() {
+ if (android.os.Build.VERSION.SDK_INT < 33) return
if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS)
!= PackageManager.PERMISSION_GRANTED
) {
@@ -51,6 +52,7 @@ class MainActivity : ComponentActivity() {
}
private fun requestStoragePermissionIfNeeded() {
+ if (android.os.Build.VERSION.SDK_INT < android.os.Build.VERSION_CODES.R) return
if (!Environment.isExternalStorageManager()) {
startActivity(
Intent(
diff --git a/app/src/main/java/com/excp/podroid/engine/PodroidQemu.kt b/app/src/main/java/com/excp/podroid/engine/PodroidQemu.kt
index b6855fa..9c5b79f 100644
--- a/app/src/main/java/com/excp/podroid/engine/PodroidQemu.kt
+++ b/app/src/main/java/com/excp/podroid/engine/PodroidQemu.kt
@@ -8,6 +8,7 @@
*/
package com.excp.podroid.engine
+import android.annotation.SuppressLint
import android.content.Context
import android.util.Log
import com.excp.podroid.data.repository.PortForwardRule
@@ -28,6 +29,7 @@ import java.util.concurrent.TimeUnit
import javax.inject.Inject
import javax.inject.Singleton
+@SuppressLint("StaticFieldLeak") // ApplicationContext — lives as long as the process, no leak
@Singleton
class PodroidQemu @Inject constructor(
@ApplicationContext private val context: Context,
@@ -359,7 +361,8 @@ class PodroidQemu @Inject constructor(
val downloadsDir = android.os.Environment.getExternalStoragePublicDirectory(
android.os.Environment.DIRECTORY_DOWNLOADS
)
- if (android.os.Environment.isExternalStorageManager() && downloadsDir.exists()) {
+ if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.R &&
+ android.os.Environment.isExternalStorageManager() && downloadsDir.exists()) {
args += "-fsdev"
args += "local,id=fsdev0,path=${downloadsDir.absolutePath},security_model=none"
args += "-device"
diff --git a/app/src/main/java/com/excp/podroid/service/PodroidService.kt b/app/src/main/java/com/excp/podroid/service/PodroidService.kt
index 3716b46..60109b9 100644
--- a/app/src/main/java/com/excp/podroid/service/PodroidService.kt
+++ b/app/src/main/java/com/excp/podroid/service/PodroidService.kt
@@ -7,6 +7,7 @@
*/
package com.excp.podroid.service
+import android.annotation.SuppressLint
import android.app.Notification
import android.app.NotificationChannel
import android.app.NotificationManager
@@ -85,7 +86,8 @@ class PodroidService : Service() {
PowerManager.PARTIAL_WAKE_LOCK,
"Podroid::VmWakeLock"
).apply {
- acquire()
+ @SuppressLint("WakelockTimeout")
+ acquire() // VM must run indefinitely — timeout would kill it
}
Log.d(TAG, "WakeLock acquired")
}
@@ -140,7 +142,11 @@ class PodroidService : Service() {
}
releaseWakeLock()
- stopForeground(STOP_FOREGROUND_REMOVE)
+ if (android.os.Build.VERSION.SDK_INT >= 33) {
+ stopForeground(STOP_FOREGROUND_REMOVE)
+ } else {
+ @Suppress("DEPRECATION") stopForeground(true)
+ }
stopSelf()
}
}
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 e1e0113..1099641 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
@@ -7,6 +7,7 @@
*/
package com.excp.podroid.ui.screens.terminal
+import android.annotation.SuppressLint
import android.content.Context
import android.os.Build
import android.os.VibrationEffect
@@ -47,6 +48,7 @@ class TerminalViewModel @Inject constructor(
val terminalFontSize: StateFlow<Int> = settingsRepository.terminalFontSize
.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), 20)
+ @SuppressLint("StaticFieldLeak") // Nulled in onCleared(); ViewModel is nav-scoped, no real leak
private var terminalView: TerminalView? = null
private var emulator: TerminalEmulator? = null
private var attached = false
@@ -182,12 +184,7 @@ class TerminalViewModel @Inject constructor(
extraAlt = false
return true
}
- if ((ctrlDown || extraCtrl) && codePoint in 96..122) {
- qemu.writeToConsole(byteArrayOf((codePoint - 96).toByte()))
- extraCtrl = false
- extraAlt = false
- return true
- }
+
val chars = Character.toChars(codePoint)
val charBytes = String(chars).toByteArray(Charsets.UTF_8)
diff --git a/app/src/main/res/drawable/ic_refresh.xml b/app/src/main/res/drawable/ic_refresh.xml
deleted file mode 100644
index c4d65c2..0000000
--- a/app/src/main/res/drawable/ic_refresh.xml
+++ /dev/null
@@ -1,13 +0,0 @@
-<!--
- Refresh icon used in the foreground service notification action.
- Copyright (C) 2024 Podroid contributors
--->
-<vector xmlns:android="http://schemas.android.com/apk/res/android"
- android:width="24dp"
- android:height="24dp"
- android:viewportWidth="24"
- android:viewportHeight="24">
- <path
- android:fillColor="@android:color/white"
- android:pathData="M17.65,6.35C16.2,4.9 14.21,4 12,4c-4.42,0 -7.99,3.58 -7.99,8s3.57,8 7.99,8c3.73,0 6.84,-2.55 7.73,-6h-2.08c-0.82,2.33 -3.07,4 -5.65,4c-3.31,0 -6,-2.69 -6,-6s2.69,-6 6,-6c1.66,0 3.14,0.69 4.22,1.78L13,11h7V4l-2.35,2.35z" />
-</vector>
diff --git a/app/src/main/res/values/colors.xml b/app/src/main/res/values/colors.xml
index f8c6127..545704f 100644
--- a/app/src/main/res/values/colors.xml
+++ b/app/src/main/res/values/colors.xml
@@ -1,10 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
-<resources>
- <color name="purple_200">#FFBB86FC</color>
- <color name="purple_500">#FF6200EE</color>
- <color name="purple_700">#FF3700B3</color>
- <color name="teal_200">#FF03DAC5</color>
- <color name="teal_700">#FF018786</color>
- <color name="black">#FF000000</color>
- <color name="white">#FFFFFFFF</color>
-</resources>
\ No newline at end of file
+<resources />
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index aeb768a..b243a88 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -5,23 +5,4 @@
-->
<resources>
<string name="app_name">Podroid</string>
-
- <!-- Notification -->
- <string name="notification_vm_running">Podman running</string>
- <string name="notification_action_stop">Stop</string>
-
- <!-- Home screen -->
- <string name="podroid_start">Start Podman</string>
- <string name="podroid_stop">Stop Podman</string>
- <string name="podroid_terminal">Web Terminal</string>
- <string name="podroid_status_ready">Ready to start</string>
- <string name="podroid_status_running">Podman is running</string>
- <string name="podroid_status_starting">Starting Podman…</string>
- <string name="podroid_open_terminal">Open Terminal</string>
- <string name="podroid_copy_link">Copy Link</string>
- <string name="podroid_link_copied">Link copied to clipboard</string>
-
- <!-- Error messages -->
- <string name="error_qemu_failed">QEMU failed to start</string>
- <string name="error_qemu_not_found">QEMU binary not found</string>
</resources>
diff --git a/init-podroid b/init-podroid
index 29394ed..6e63bc2 100644
--- a/init-podroid
+++ b/init-podroid
@@ -82,8 +82,13 @@ echo "nameserver 8.8.8.8" >> /etc/resolv.conf
echo "nameserver 1.1.1.1" >> /etc/resolv.conf
# ── Downloads folder ─────────────────────────────────────────────────────────
+# msize=1048576: 1MB message size instead of the default 8KB — reduces round-trips
+# 128x for large files (400MB = 400 trips instead of 51200)
+# cache=loose: guest page-caches data already read; reads the same file twice
+# without going back to the host
+# noatime: skip access time writes on every read
mkdir -p /mnt/downloads
-if mount -t 9p -o trans=virtio,version=9p2000.L,rw downloads /mnt/downloads 2>/dev/null; then
+if mount -t 9p -o trans=virtio,version=9p2000.L,rw,msize=1048576,cache=loose,noatime downloads /mnt/downloads 2>/dev/null; then
echo "[init] Downloads folder mounted at /mnt/downloads"
fi