Files
chanora/poc/audio-capture-playback-android-spike/android/app/build.gradle.kts
T
EdisonJwa ec21a880d2 feat(poc/audio): add Android mobile audio spike
Closes the mobile half of the PoC plan §2 audio exit criterion
left open by poc/audio-capture-playback-spike. The desktop and
mobile halves together fully retire the audio PoC.

Stack:
  Kotlin (MainActivity) → JNI → Rust cdylib
    → cpal 0.16 → Oboe (AAudio / OpenSL ES) → Android audio HAL

Layout:
  rust crate (src/lib.rs)   — JNI_OnLoad, initContext,
                              playSine440, record1sToFile;
                              panic-catching at JNI boundary;
                              android_logger → logcat
  android/ (Gradle 8.7,     — minSdk 24, compileSdk 34, AGP 8.5.2.
   AGP 8.5.2, Kotlin 1.9.24)  cargoBuildRust task wraps cargo-ndk
                              -P 26 -t <abi> for all four ABIs;
                              wired into preBuild so AGP picks up
                              the produced .so files.

Verified on 2026-05-13 on a physical Motorola Moto G Stylus 5G
(2023), Android 14 SDK 34 arm64-v8a:
  - Playback: 500 ms 440 Hz mono sine, 22,050 frames emitted at
    44.1 kHz through cpal/Oboe/AAudio/device speaker.
  - Capture: 1 s from default input, 42,624 frames written to
    /data/data/app.chanora.poc.audio/files/chanora_poc_capture.wav.
    File pulled via 'adb exec-out run-as ... cat' and confirmed
    by file(1) as 'RIFF (little-endian) data, WAVE audio,
    Microsoft PCM, 16 bit, mono 44100 Hz'. Header bytes
    cross-checked against the reported frame count.

Notes:
  - cpal links libaaudio (introduced API 26), so cargo-ndk targets
    API 26 via -P 26 while the Android module's minSdk stays at 24
    (DEC-004). API 24/25 devices would fall back to OpenSL ES at
    runtime; not exercised here.
  - JNI panic safety: every JNI entry point wraps its body in
    std::panic::catch_unwind and a tracing panic hook routes
    panic messages to logcat under tag 'ChanoraAudioPoC'. Without
    this, cpal panicking inside an extern "system" function would
    abort the process.
  - The emulator AVD chanora-poc-api34 and its system image were
    installed during Phase 0 but emulator verification was skipped
    once the physical-device run succeeded. Real-device evidence
    is stronger.

Surfaced finding: DEC-011.1 mobile half promoted from Deferred to
Accepted for Android in the same docs commit; iOS remains
explicitly Deferred (requires macOS + Xcode hardware).

Authority: PoC plan §2, DEC-011, DEC-011.1.
Not product code; not promoted into chanora_audio.
2026-05-14 18:24:53 +08:00

125 lines
4.4 KiB
Kotlin

plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
}
android {
namespace = "app.chanora.poc.audio"
compileSdk = 34
defaultConfig {
applicationId = "app.chanora.poc.audio"
minSdk = 24 // matches DEC-004
targetSdk = 34
versionCode = 1
versionName = "0.1.0-poc"
ndk {
// Keep all four common ABIs so the same APK works on both
// the x86_64 emulator and a physical arm64 device.
abiFilters += listOf("x86_64", "arm64-v8a", "armeabi-v7a", "x86")
}
}
sourceSets {
getByName("main") {
// cargo-ndk drops .so files here.
jniLibs.srcDirs("src/main/jniLibs")
}
}
buildTypes {
getByName("debug") {
isMinifyEnabled = false
}
getByName("release") {
isMinifyEnabled = false
}
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget = "17"
}
packaging {
// Avoid duplicate-resource conflicts from native libs if any
// future deps bring them in.
resources.excludes += setOf("META-INF/AL2.0", "META-INF/LGPL2.1")
}
}
dependencies {
implementation("androidx.core:core-ktx:1.13.1")
implementation("androidx.appcompat:appcompat:1.7.0")
}
// ---------------------------------------------------------------------
// Rust cdylib build via cargo-ndk.
//
// Each ABI maps to a Rust target triple; cargo-ndk handles linker
// selection. The task copies the produced .so into the per-ABI
// jniLibs directory expected by Android Gradle Plugin.
// ---------------------------------------------------------------------
val rustCrateDir = rootProject.projectDir.parentFile // ../ -> the spike root
val rustTargetDir = file("$rustCrateDir/target")
val jniLibsDir = file("$projectDir/src/main/jniLibs")
val cargoBuildRust = tasks.register("cargoBuildRust") {
group = "build"
description = "Builds the Rust cdylib for all enabled Android ABIs via cargo ndk."
val abis = listOf(
Triple("x86_64", "x86_64-linux-android", "x86_64"),
Triple("arm64-v8a", "aarch64-linux-android", "arm64-v8a"),
Triple("armeabi-v7a", "armv7-linux-androideabi", "armeabi-v7a"),
Triple("x86", "i686-linux-android", "x86")
)
doLast {
// Resolve cargo: try CARGO_HOME/bin first, then PATH, then the
// rustup shim location.
val cargoBinDir = System.getenv("CARGO_HOME")?.let { "$it/bin" }
?: "${System.getProperty("user.home")}/.cargo/bin"
val cargo = listOf("$cargoBinDir/cargo", "/usr/local/bin/cargo", "/usr/bin/cargo")
.firstOrNull { file(it).exists() }
?: error("cargo not found; install via rustup")
val cargoNdkBin = listOf("$cargoBinDir/cargo-ndk", "/usr/local/bin/cargo-ndk")
.firstOrNull { file(it).exists() }
check(cargoNdkBin != null) { "cargo-ndk not installed (cargo install cargo-ndk)" }
val ndkHome = System.getenv("ANDROID_NDK_HOME")
?: System.getenv("NDK_HOME")
?: "/opt/android-sdk/ndk/26.3.11579264"
check(file(ndkHome).exists()) { "NDK not found at $ndkHome" }
// cargo-ndk is a cargo subcommand; invoke via `cargo ndk ...`.
// We must ensure cargo's PATH lookup can find cargo-ndk too.
// `-p 26` selects API 26 for the NDK toolchain so cpal can
// link against libaaudio (introduced in API 26). minSdk in
// the Android module stays at 24 — the device just won't
// execute the AAudio code path below API 26; cpal/Oboe falls
// back to OpenSL ES there.
val abiArgs = abis.flatMap { listOf("-t", it.first) }
val cargoCmd = listOf(cargo, "ndk", "-P", "26") + abiArgs +
listOf("-o", jniLibsDir.absolutePath, "build", "--release",
"--manifest-path", "$rustCrateDir/Cargo.toml")
println("[cargoBuildRust] running: ${cargoCmd.joinToString(" ")}")
exec {
commandLine(cargoCmd)
environment("ANDROID_NDK_HOME", ndkHome)
environment("PATH", "$cargoBinDir:${System.getenv("PATH")}")
}
}
}
// Make Android's preBuild depend on the Rust build so AGP picks up the .so files.
tasks.matching { it.name == "preBuild" }.configureEach {
dependsOn(cargoBuildRust)
}