diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index d667c691d9..fba4727ba7 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -126,6 +126,10 @@
android:name=".session.SessionService"
android:exported="false"
android:stopWithTask="false" />
+
+
LinuxRuntimeInstaller.install(this, release, listener) }
+ }
/**
* Shows an install's progress until it ends. [run] either starts one or joins the one already
diff --git a/app/src/main/java/com/droiddeck/launcher/runtime/LinuxRuntimeInstaller.java b/app/src/main/java/com/droiddeck/launcher/runtime/LinuxRuntimeInstaller.java
index 06290f8830..189666857c 100644
--- a/app/src/main/java/com/droiddeck/launcher/runtime/LinuxRuntimeInstaller.java
+++ b/app/src/main/java/com/droiddeck/launcher/runtime/LinuxRuntimeInstaller.java
@@ -55,7 +55,7 @@ public final class LinuxRuntimeInstaller {
public final String sha256;
public final long size;
- Release(String version, String url, String sha256, long size) {
+ public Release(String version, String url, String sha256, long size) {
this.version = version;
this.url = url;
this.sha256 = sha256;
diff --git a/app/src/main/java/com/droiddeck/launcher/runtime/RuntimeInstallService.kt b/app/src/main/java/com/droiddeck/launcher/runtime/RuntimeInstallService.kt
new file mode 100644
index 0000000000..31a26fd34d
--- /dev/null
+++ b/app/src/main/java/com/droiddeck/launcher/runtime/RuntimeInstallService.kt
@@ -0,0 +1,100 @@
+package com.droiddeck.launcher.runtime
+
+import android.app.Notification
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.PendingIntent
+import android.app.Service
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.os.IBinder
+import com.droiddeck.launcher.MainActivity
+import com.droiddeck.launcher.R
+
+/**
+ * Keeps the process in the foreground while the Linux runtime downloads and unpacks. The runtime
+ * is several hundred megabytes; without a foreground service Android may kill the app the moment
+ * the user switches away, and the install starts over from the resumable part file.
+ *
+ * The install itself is [LinuxRuntimeInstaller.install], which runs one job per process: the
+ * screen that asked for it joins the same job to show progress, so it does not matter which of the
+ * two gets there first.
+ */
+class RuntimeInstallService : Service() {
+ override fun onBind(intent: Intent?): IBinder? = null
+
+ override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+ val release = intent?.let(::releaseFrom)
+ startForeground(NOTIFICATION_ID, notification("Starting…", -1))
+ if (release == null) {
+ stopSelf(startId)
+ return START_NOT_STICKY
+ }
+ Thread({
+ val manager = getSystemService(NotificationManager::class.java)
+ var shown = Int.MIN_VALUE
+ LinuxRuntimeInstaller.install(applicationContext, release) { stage, percent ->
+ // Every percent at most once: a notification per read would flood the system.
+ if (percent != shown) {
+ shown = percent
+ manager?.notify(NOTIFICATION_ID, notification(stage, percent))
+ }
+ }
+ @Suppress("DEPRECATION")
+ stopForeground(true)
+ stopSelf(startId)
+ }, "runtime-install").start()
+ return START_NOT_STICKY
+ }
+
+ private fun notification(stage: String, percent: Int): Notification {
+ val manager = getSystemService(NotificationManager::class.java)
+ manager?.createNotificationChannel(NotificationChannel(CHANNEL_ID, "Runtime install",
+ NotificationManager.IMPORTANCE_LOW).apply {
+ description = "Shows while the Linux runtime downloads and installs"
+ setShowBadge(false)
+ setSound(null, null)
+ enableVibration(false)
+ })
+ val open = PendingIntent.getActivity(this, 0,
+ Intent(this, MainActivity::class.java).setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_REORDER_TO_FRONT),
+ PendingIntent.FLAG_IMMUTABLE)
+ return Notification.Builder(this, CHANNEL_ID)
+ .setSmallIcon(R.drawable.ic_stat_session)
+ .setContentTitle("Installing the Linux runtime")
+ .setContentText(stage)
+ .setProgress(100, percent.coerceIn(0, 100), percent < 0)
+ .setContentIntent(open)
+ .setOngoing(true)
+ .setOnlyAlertOnce(true)
+ .setShowWhen(false)
+ .build()
+ }
+
+ companion object {
+ private const val CHANNEL_ID = "runtime-install"
+ private const val NOTIFICATION_ID = 2
+ private const val EXTRA_VERSION = "version"
+ private const val EXTRA_URL = "url"
+ private const val EXTRA_SHA256 = "sha256"
+ private const val EXTRA_SIZE = "size"
+
+ /** Starts the install of [release] in the foreground; a running install is joined instead. */
+ fun start(context: Context, release: LinuxRuntimeInstaller.Release) {
+ val intent = Intent(context, RuntimeInstallService::class.java)
+ .putExtra(EXTRA_VERSION, release.version)
+ .putExtra(EXTRA_URL, release.url)
+ .putExtra(EXTRA_SHA256, release.sha256)
+ .putExtra(EXTRA_SIZE, release.size)
+ if (Build.VERSION.SDK_INT >= 26) context.startForegroundService(intent) else context.startService(intent)
+ }
+
+ private fun releaseFrom(intent: Intent): LinuxRuntimeInstaller.Release? {
+ val version = intent.getStringExtra(EXTRA_VERSION) ?: return null
+ val url = intent.getStringExtra(EXTRA_URL) ?: return null
+ val sha256 = intent.getStringExtra(EXTRA_SHA256) ?: return null
+ return LinuxRuntimeInstaller.Release(version, url, sha256, intent.getLongExtra(EXTRA_SIZE, 0L))
+ }
+ }
+}