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.
125 lines
4.4 KiB
Kotlin
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)
|
|
}
|