Android Native App

.gitignore

@@ -44,6 +44,8 @@ gfn_tokens.json
 
 # Test files
 test/
+!android/app/src/test/
+!android/app/src/test/**
 
 package-lock.json
 opennow-stable/package-lock.json
@@ -56,3 +58,6 @@ release-notes.md
 result
 .deriveddata/
 .deriveddata-device/
+
+/android/app/.cxx
+/android/app/release

android/.gitignore

@@ -0,0 +1,8 @@
+.gradle/
+.idea/
+build/
+local.properties
+captures/
+*.iml
+app/build/
+app/release/

android/README.md

@@ -0,0 +1,35 @@
+# OpenNOW Native Android
+
+This folder is a standalone Android Studio project for the native Kotlin / Jetpack Compose OpenNOW target.
+
+Open it from Android Studio with **File > Open > `OpenNOW/android`**. Android Studio will install/use the required Gradle, Android SDK, CMake, and NDK components from the project configuration.
+
+## Build Targets
+
+- `:app:assembleDebug` builds a debug APK.
+- `:app:assembleRelease` builds the direct-distribution release APK with APK update support.
+- `:app:bundleRelease` builds the Google Play Android App Bundle. This task removes `REQUEST_INSTALL_PACKAGES` and disables APK self-updates so Play installs use Google Play's update mechanism.
+
+## APK Update Manifest
+
+APK and debug builds check `https://api.printedwaste.com/releases/opennow/latest` and can download the returned APK. App Bundle builds installed from Google Play detect `com.android.vending` as the install source and do not check, download, or install APK updates. The manifest should look like this:
+
+```json
+{
+  "versionCode": 7,
+  "versionName": "0.5.2",
+  "apkUrl": "https://api.printedwaste.com/release-files/opennow/app-release.apk",
+  "artifactUrl": "https://api.printedwaste.com/release-files/opennow/app-release.apk",
+  "sha256": "optional lowercase apk checksum",
+  "releaseNotes": "Short notes shown in Settings\nSecond line"
+}
+```
+
+`apkUrl`, `artifactUrl`, or `url` may point at the APK. `releaseNotes` may use real newlines or literal `\n` separators. The app compares `versionCode` against its installed build and asks Android's package installer to confirm the downloaded APK.
+
+## Runtime Notes
+
+- UI is native Compose.
+- GFN auth, catalog, subscription, CloudMatch session creation/polling/claim/stop, signaling, and input packet behavior are implemented in Kotlin from the Electron project contracts.
+- Streaming uses Android WebRTC plus hardware MediaCodec probing. The bundled `opennow_native` JNI library exposes native runtime diagnostics and keeps the NDK/CMake path wired for media-sensitive code.
+- Queue ad metadata is preserved in `SessionInfo`; ad playback can use the included Media3 dependency when the server returns an ad media URL.

android/app/build.gradle.kts

@@ -0,0 +1,161 @@
+import java.util.Properties
+
+plugins {
+    id("com.android.application")
+    id("org.jetbrains.kotlin.plugin.compose")
+    id("org.jetbrains.kotlin.plugin.serialization")
+}
+
+val localProperties = Properties().apply {
+    rootProject.file("local.properties").takeIf { it.exists() }?.inputStream()?.use { load(it) }
+}
+fun Sequence<String?>.firstNonBlankOrNull(): String? =
+    mapNotNull { value -> value?.trim()?.takeIf { it.isNotEmpty() } }.firstOrNull()
+
+fun gradlePropertyValue(vararg names: String): String? =
+    names.asSequence().map { name -> providers.gradleProperty(name).orNull }.firstNonBlankOrNull()
+
+fun localPropertyValue(vararg names: String): String? =
+    names.asSequence().map { name -> localProperties.getProperty(name) }.firstNonBlankOrNull()
+
+fun environmentValue(vararg names: String): String? =
+    names.asSequence().map { name -> providers.environmentVariable(name).orNull }.firstNonBlankOrNull()
+
+fun firstNonBlankValue(vararg values: String?): String =
+    values.asSequence().firstNonBlankOrNull().orEmpty()
+
+fun buildConfigString(value: String): String =
+    "\"" + value
+        .replace("\\", "\\\\")
+        .replace("\"", "\\\"")
+        .replace("\n", "\\n")
+        .replace("\r", "\\r") + "\""
+
+val defaultPostHogProjectToken = "phc_pdob6BhBvbayfd7BA6zXBkty8o6EkxKYY7sF3ZwLymk3"
+val defaultPostHogHost = "https://aa.printedwaste.com"
+
+val postHogProjectToken = firstNonBlankValue(
+    gradlePropertyValue("posthog.apiKey", "posthog.projectToken"),
+    environmentValue("POSTHOG_API_KEY", "POSTHOG_PROJECT_TOKEN"),
+    localPropertyValue("posthog.apiKey", "posthog.projectToken"),
+    defaultPostHogProjectToken,
+)
+val postHogHost = firstNonBlankValue(
+    gradlePropertyValue("posthog.host"),
+    environmentValue("POSTHOG_HOST"),
+    localPropertyValue("posthog.host"),
+    defaultPostHogHost,
+)
+val buildingPlayReleaseBundle = gradle.startParameter.taskNames.any { taskName ->
+    taskName.substringAfterLast(":").equals("bundleRelease", ignoreCase = true)
+}
+
+android {
+    namespace = "com.opencloudgaming.opennow"
+    compileSdk = 37
+
+    defaultConfig {
+        applicationId = "com.opencloudgaming.opennow"
+        minSdk = 24
+        targetSdk = 36
+        versionCode = 36
+        versionName = "0.8.1"
+
+        buildConfigField("String", "POSTHOG_PROJECT_TOKEN", buildConfigString(postHogProjectToken))
+        buildConfigField("String", "POSTHOG_HOST", buildConfigString(postHogHost))
+        buildConfigField("boolean", "APK_UPDATES_SUPPORTED", "true")
+
+        ndk {
+            abiFilters += listOf("arm64-v8a", "armeabi-v7a", "x86_64")
+        }
+
+    }
+
+    buildTypes {
+        debug {
+            isMinifyEnabled = false
+        }
+        release {
+            isMinifyEnabled = true
+            isShrinkResources = true
+            buildConfigField("boolean", "APK_UPDATES_SUPPORTED", (!buildingPlayReleaseBundle).toString())
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro",
+            )
+        }
+    }
+
+    sourceSets {
+        if (buildingPlayReleaseBundle) {
+            getByName("release").manifest.srcFile("src/playBundle/AndroidManifest.xml")
+        }
+    }
+
+    buildFeatures {
+        compose = true
+        buildConfig = true
+    }
+
+    externalNativeBuild {
+        cmake {
+            path = file("src/main/cpp/CMakeLists.txt")
+            version = "3.22.1"
+        }
+    }
+
+    packaging {
+        jniLibs {
+            useLegacyPackaging = false
+        }
+        resources {
+            excludes += setOf(
+                "META-INF/AL2.0",
+                "META-INF/LGPL2.1",
+                "META-INF/LICENSE*",
+                "META-INF/NOTICE*",
+            )
+        }
+    }
+}
+
+kotlin {
+    jvmToolchain(17)
+}
+
+dependencies {
+    implementation(platform("androidx.compose:compose-bom:2026.06.00"))
+    androidTestImplementation(platform("androidx.compose:compose-bom:2026.06.00"))
+
+    implementation("androidx.activity:activity-compose:1.13.0")
+    implementation("androidx.browser:browser:1.10.0")
+    implementation("androidx.compose.foundation:foundation")
+    implementation("androidx.compose.material3:material3")
+    implementation("androidx.compose.ui:ui")
+    implementation("androidx.compose.ui:ui-tooling-preview")
+    implementation("androidx.core:core:1.19.0")
+    implementation("androidx.lifecycle:lifecycle-runtime-compose:2.11.0")
+    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.11.0")
+    implementation("androidx.media3:media3-common:1.10.1")
+    implementation("androidx.media3:media3-exoplayer:1.10.1")
+    implementation("androidx.media3:media3-ui:1.10.1")
+
+    implementation("io.coil-kt.coil3:coil-compose:3.4.0")
+    implementation("io.coil-kt.coil3:coil-network-okhttp:3.4.0")
+
+    implementation("com.squareup.okhttp3:logging-interceptor:5.4.0")
+    implementation("com.squareup.okhttp3:okhttp-dnsoverhttps:5.4.0")
+    implementation("com.squareup.okhttp3:okhttp:5.4.0")
+    implementation("io.github.webrtc-sdk:android:144.7559.09")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.11.0")
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.11.0")
+    implementation("com.posthog:posthog-android:3.51.2")
+
+    debugImplementation("androidx.compose.ui:ui-tooling")
+    debugImplementation("androidx.compose.ui:ui-test-manifest")
+
+    testImplementation("junit:junit:4.13.2")
+    androidTestImplementation("androidx.test.ext:junit:1.3.0")
+    androidTestImplementation("androidx.test.espresso:espresso-core:3.7.0")
+    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
+}

android/app/proguard-rules.pro

@@ -0,0 +1,6 @@
+-keep class org.webrtc.** { *; }
+-keep class org.jni_zero.** { *; }
+-keep class kotlinx.serialization.** { *; }
+-keepclassmembers class com.opencloudgaming.opennow.** {
+    @kotlinx.serialization.Serializable *;
+}

android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.VIBRATE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+
+    <uses-feature
+        android:name="android.hardware.gamepad"
+        android:required="false" />
+    <uses-feature
+        android:name="android.hardware.touchscreen"
+        android:required="false" />
+    <uses-feature
+        android:name="android.hardware.faketouch"
+        android:required="false" />
+    <uses-feature
+        android:name="android.software.leanback"
+        android:required="false" />
+    <uses-feature
+        android:name="android.hardware.microphone"
+        android:required="false" />
+
+    <application
+        android:name=".OpenNowApplication"
+        android:allowBackup="false"
+        android:appCategory="game"
+        android:banner="@drawable/opennow_banner"
+        android:hardwareAccelerated="true"
+        android:icon="@drawable/opennow_icon"
+        android:label="@string/app_name"
+        android:networkSecurityConfig="@xml/network_security_config"
+        android:resizeableActivity="true"
+        android:roundIcon="@drawable/opennow_icon"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.OpenNOW">
+        <service
+            android:name=".AndroidQueueStatusService"
+            android:exported="false"
+            android:foregroundServiceType="dataSync" />
+        <activity
+            android:name=".MainActivity"
+            android:configChanges="keyboard|keyboardHidden|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:supportsPictureInPicture="true"
+            android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+                <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="opennow" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="http" android:host="localhost" android:port="2259" />
+                <data android:scheme="http" android:host="localhost" android:port="6460" />
+                <data android:scheme="http" android:host="localhost" android:port="7119" />
+                <data android:scheme="http" android:host="localhost" android:port="8870" />
+                <data android:scheme="http" android:host="localhost" android:port="9096" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="http" android:host="127.0.0.1" android:port="2259" />
+                <data android:scheme="http" android:host="127.0.0.1" android:port="6460" />
+                <data android:scheme="http" android:host="127.0.0.1" android:port="7119" />
+                <data android:scheme="http" android:host="127.0.0.1" android:port="8870" />
+                <data android:scheme="http" android:host="127.0.0.1" android:port="9096" />
+            </intent-filter>
+        </activity>
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.updates"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/update_file_paths" />
+        </provider>
+    </application>
+</manifest>

android/app/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,22 @@
+cmake_minimum_required(VERSION 3.22.1)
+
+project(opennow_native)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+add_library(opennow_native SHARED opennow_native.cpp)
+
+target_compile_options(opennow_native PRIVATE -fexceptions -frtti)
+
+find_library(log-lib log)
+find_library(android-lib android)
+find_library(mediandk-lib mediandk)
+
+target_link_libraries(
+    opennow_native
+    ${android-lib}
+    ${log-lib}
+    ${mediandk-lib}
+)

android/app/src/main/cpp/opennow_native.cpp

@@ -0,0 +1,39 @@
+#include <jni.h>
+#include <media/NdkMediaCodec.h>
+#include <media/NdkMediaFormat.h>
+#include <sstream>
+#include <string>
+
+extern "C" JNIEXPORT jstring JNICALL
+Java_com_opencloudgaming_opennow_NativeCodecProbe_nativeRuntimeSummary(JNIEnv *env, jobject) {
+    std::ostringstream out;
+    out << "{";
+    out << "\"nativeLibrary\":\"opennow_native\",";
+    out << "\"mediaNdk\":true,";
+    out << "\"rtpPacketSize\":1140,";
+    out << "\"inputProtocolVersion\":3";
+    out << "}";
+    const std::string value = out.str();
+    return env->NewStringUTF(value.c_str());
+}
+
+extern "C" JNIEXPORT jboolean JNICALL
+Java_com_opencloudgaming_opennow_NativeCodecProbe_nativeDecoderAvailable(JNIEnv *env, jobject, jstring mimeType) {
+    if (mimeType == nullptr) {
+        return JNI_FALSE;
+    }
+
+    const char *rawMimeType = env->GetStringUTFChars(mimeType, nullptr);
+    if (rawMimeType == nullptr) {
+        return JNI_FALSE;
+    }
+
+    AMediaCodec *codec = AMediaCodec_createDecoderByType(rawMimeType);
+    env->ReleaseStringUTFChars(mimeType, rawMimeType);
+    if (codec == nullptr) {
+        return JNI_FALSE;
+    }
+
+    AMediaCodec_delete(codec);
+    return JNI_TRUE;
+}