Android Audio E2E
Keep compilation, installation, and live audio verification as separate result
lanes.
Safety And Scope
- Obtain explicit approval in the current run before starting live microphone
capture. State that the example package
sound.example will record a short
test clip.
- Use non-sensitive audio. Do not upload, transcribe, or retain recordings
beyond the verification need.
- Preserve existing ADB reverse rules, permissions, accounts, and device files.
- Test background recording, phone/audio-focus interruption, Bluetooth routing,
or process death only when requested or required by the change.
Preflight
- Read
AGENTS.md, .github/workflows/ci-android.yml, the changed
Kotlin/spec/TS files, and the relevant example screen.
- Record
git status --short --branch and adb devices -l.
- Confirm JDK 17, the Android SDK, and a single intended emulator or device.
- Verify
RECORD_AUDIO appears in the example manifest and identify the
current permission state without changing it.
- Run
yarn install --immutable and yarn nitrogen when generated Android
bindings are involved.
Build Lane
Mirror the CI build:
yarn turbo run build:android --cache-dir=.turbo/android
If diagnosing Gradle directly, run the corresponding example task with
--no-daemon --console=plain and record the exact task and architecture.
Report BUILD PASS or BUILD FAIL independently.
Device Runtime Lane
After microphone approval:
- Install and launch
sound.example on the selected device.
- Grant microphone permission through Android's system UI; verify denial and
retry behavior when permission handling is the target.
- Start recording; require a resolved path, active state, and increasing
millisecond callbacks.
- Pause and resume; require time to pause and continue without duplicate
recorder instances or promise settlement.
- Stop; require terminal state, listener cleanup, and a non-empty app-owned
recording.
- Play the file; require increasing position, sensible duration, seek, volume,
speed, and one playback-end transition as applicable.
- Run Rapid Switch and Stress Test for MediaPlayer state or concurrency fixes.
- Inspect filtered
adb logcat for uncaught exceptions, rejected promises,
media-state errors, and leaked recorder/player resources.
When lifecycle, audio focus, or background behavior is in scope, explicitly
exercise Home/Recent Apps, focus loss/gain, and relaunch. Do not claim process
death or background support unless the exact transition was observed.
Evidence And Cleanup
Record the device serial, API level, ABI, build variant, permission state,
tested API/screen, callback progression, returned path metadata, and redacted
logs. Delete only recordings or temporary files created by the run. Report
RUNTIME PASS, RUNTIME FAIL, or BLOCKED separately and list untested rows.
1---2name: android-audio-e2e3description: Build and run device-backed Android end-to-end checks for react-native-nitro-sound permissions, recording, playback, listeners, pause/resume, seek, speed, audio focus, lifecycle behavior, and rapid switching. Use for Kotlin or Android regressions and runtime claims beyond a Gradle compile.4---56# Android Audio E2E78Keep compilation, installation, and live audio verification as separate result9lanes.1011## Safety And Scope1213- Obtain explicit approval in the current run before starting live microphone14 capture. State that the example package `sound.example` will record a short15 test clip.16- Use non-sensitive audio. Do not upload, transcribe, or retain recordings17 beyond the verification need.18- Preserve existing ADB reverse rules, permissions, accounts, and device files.19- Test background recording, phone/audio-focus interruption, Bluetooth routing,20 or process death only when requested or required by the change.2122## Preflight23241. Read `AGENTS.md`, `.github/workflows/ci-android.yml`, the changed25 Kotlin/spec/TS files, and the relevant example screen.262. Record `git status --short --branch` and `adb devices -l`.273. Confirm JDK 17, the Android SDK, and a single intended emulator or device.284. Verify `RECORD_AUDIO` appears in the example manifest and identify the29 current permission state without changing it.305. Run `yarn install --immutable` and `yarn nitrogen` when generated Android31 bindings are involved.3233## Build Lane3435Mirror the CI build:3637```bash38yarn turbo run build:android --cache-dir=.turbo/android39```4041If diagnosing Gradle directly, run the corresponding example task with42`--no-daemon --console=plain` and record the exact task and architecture.43Report `BUILD PASS` or `BUILD FAIL` independently.4445## Device Runtime Lane4647After microphone approval:48491. Install and launch `sound.example` on the selected device.502. Grant microphone permission through Android's system UI; verify denial and51 retry behavior when permission handling is the target.523. Start recording; require a resolved path, active state, and increasing53 millisecond callbacks.544. Pause and resume; require time to pause and continue without duplicate55 recorder instances or promise settlement.565. Stop; require terminal state, listener cleanup, and a non-empty app-owned57 recording.586. Play the file; require increasing position, sensible duration, seek, volume,59 speed, and one playback-end transition as applicable.607. Run Rapid Switch and Stress Test for MediaPlayer state or concurrency fixes.618. Inspect filtered `adb logcat` for uncaught exceptions, rejected promises,62 media-state errors, and leaked recorder/player resources.6364When lifecycle, audio focus, or background behavior is in scope, explicitly65exercise Home/Recent Apps, focus loss/gain, and relaunch. Do not claim process66death or background support unless the exact transition was observed.6768## Evidence And Cleanup6970Record the device serial, API level, ABI, build variant, permission state,71tested API/screen, callback progression, returned path metadata, and redacted72logs. Delete only recordings or temporary files created by the run. Report73`RUNTIME PASS`, `RUNTIME FAIL`, or `BLOCKED` separately and list untested rows.
hyochan