The app says when a later release is out: Account shows its version and a later release's APK to download (closes #7) e0004d61958c

package io.oxygenhub.android.update

import androidx.compose.foundation.layout.fillMaxWidth

import androidx.compose.material.icons.Icons

import androidx.compose.material.icons.outlined.SystemUpdate

import androidx.compose.material3.Card

import androidx.compose.material3.Icon

import androidx.compose.material3.ListItem

import androidx.compose.material3.Text

import androidx.compose.material3.TextButton

import androidx.compose.runtime.Composable

import androidx.compose.runtime.getValue

import androidx.compose.runtime.produceState

import androidx.compose.runtime.remember

import androidx.compose.ui.Modifier

import androidx.compose.ui.platform.LocalContext

import androidx.compose.ui.platform.LocalUriHandler

import io.oxygenhub.android.api.HubApi

import io.oxygenhub.android.api.Release

/** Where the app's own releases are (#7), built and signed by OxygenFlow. */

const val APP_HUB = "https://oxygenhub.io"

const val APP_OWNER = "andymccall"

const val APP_REPO = "oxygenhub-android"

/** `v1.2.3` or `1.2.3` as numbers; null for anything else (a pre-release such as `1.2.3-rc1`). */

fun versionOf(text: String): List<Int>? {

    val parts = text.trim().removePrefix("v").split(".")

    if (parts.size != 3) return null

    return parts.map { p -> p.toIntOrNull()?.takeIf { it >= 0 } ?: return null }

}

/** Whether [candidate] is a later version than [installed]. */

fun isNewer(candidate: String, installed: String): Boolean {

    val a = versionOf(candidate) ?: return false

    val b = versionOf(installed) ?: return true

    return a.zip(b).firstOrNull { (x, y) -> x != y }?.let { (x, y) -> x > y } ?: false

}

/** An update: the newest full release later than [installed], with its APK's address. */

data class Update(val version: String, val apkUrl: String, val pageUrl: String)

/** The newest full release of [releases] later than [installed] that carries an APK, if any. */

fun updateFrom(releases: List<Release>, installed: String, hub: String = APP_HUB): Update? {

    val newest = releases

        .filter { !it.prerelease && versionOf(it.tag) != null }

        .maxWithOrNull { a, b -> if (isNewer(a.tag, b.tag)) 1 else if (isNewer(b.tag, a.tag)) -1 else 0 }

        ?: return null

    if (!isNewer(newest.tag, installed)) return null

    val apk = newest.assets.firstOrNull { it.name.endsWith(".apk") } ?: return null

    fun absolute(u: String) = if (u.startsWith("http")) u else hub.trimEnd('/') + "/" + u.trimStart('/')

    val page = newest.url.ifEmpty { "/$APP_OWNER/$APP_REPO/releases" }

    return Update(newest.tag.removePrefix("v"), absolute(apk.url), absolute(page))

}

/**

 * The app's version and, when the hub signed in to is [APP_HUB] and it has

 * a later release, a link to its APK: Android installs it from the

 * download, as the same key signs every release.

 */

@Composable

fun UpdateCard(api: HubApi, hub: String) {

    val context = LocalContext.current

    val installed = remember(context) { context.packageManager.getPackageInfo(context.packageName, 0).versionName ?: "" }

    val update by produceState<Update?>(null, hub) {

        if (hub.trimEnd('/') == APP_HUB) {

            value = runCatching { updateFrom(api.releases(APP_OWNER, APP_REPO), installed) }.getOrNull()

        }

    }

    val uri = LocalUriHandler.current

    Card(Modifier.fillMaxWidth()) {

        ListItem(

            leadingContent = { Icon(Icons.Outlined.SystemUpdate, contentDescription = null) },

            headlineContent = { Text(update?.let { "Version ${it.version} is out" } ?: "OxygenHub $installed") },

            supportingContent = {

                Text(if (update != null) "You have $installed. Download it and open the file to update." else "Releases are at $APP_HUB/$APP_OWNER/$APP_REPO.")

            },

            trailingContent = update?.let { u -> { TextButton(onClick = { uri.openUri(u.apkUrl) }) { Text("Download") } } },

        )

    }

}

package io.oxygenhub.android.update

import io.oxygenhub.android.api.Release

import io.oxygenhub.android.api.ReleaseAsset

import org.junit.Assert.assertEquals

import org.junit.Assert.assertFalse

import org.junit.Assert.assertNull

import org.junit.Assert.assertTrue

import org.junit.Test

class AppUpdateTest {

    @Test

    fun versionsCompareAsNumbers() {

        assertTrue(isNewer("v0.10.0", "0.9.9"))

        assertTrue(isNewer("1.0.0", "0.99.99"))

        assertFalse(isNewer("v0.1.0", "0.1.0"))

        assertFalse(isNewer("0.1.0", "0.2.0"))

        // A pre-release is never offered; a debug build's odd version is always behind.

        assertFalse(isNewer("0.2.0-rc1", "0.1.0"))

        assertTrue(isNewer("0.1.0", "1.0"))

        assertNull(versionOf("1.2"))

    }

    private fun release(tag: String, vararg assets: String, pre: Boolean = false) =

        Release(tag = tag, prerelease = pre, url = "/andymccall/oxygenhub-android/release/$tag", assets = assets.map { ReleaseAsset(it, url = "/andymccall/oxygenhub-android/asset/1/$it") })

    @Test

    fun theNewestFullReleaseWithAnApkIsOffered() {

        val releases = listOf(

            release("v0.1.0", "oxygenhub-android-0.1.0-universal.apk"),

            release("v0.3.0", "oxygenhub-android-0.3.0-universal.apk", pre = true),

            release("v0.2.0", "oxygenhub-android-0.2.0-universal.apk", "SHA256SUMS"),

        )

        val u = updateFrom(releases, "0.1.0")!!

        assertEquals("0.2.0", u.version)

        assertEquals("https://oxygenhub.io/andymccall/oxygenhub-android/asset/1/oxygenhub-android-0.2.0-universal.apk", u.apkUrl)

        assertEquals("https://oxygenhub.io/andymccall/oxygenhub-android/release/v0.2.0", u.pageUrl)

        assertNull("up to date", updateFrom(releases, "0.2.0"))

        assertNull("no APK, no offer", updateFrom(listOf(release("v0.4.0", "SHA256SUMS")), "0.1.0"))

    }

}

- **The app says when it is out of date (#7):** Account shows the app's version and, signed in to oxygenhub.io, whether a later full release of andymccall/oxygenhub-android is out, with its APK to download; opening the file updates the app, since every release is signed with the same key. Pre-releases are not offered.

import io.oxygenhub.android.update.UpdateCard

                UpdateCard(api, session.hub)