android-audio-e2e

name	android-audio-e2e
description	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.

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

1. Read AGENTS.md, .github/workflows/ci-android.yml, the changed Kotlin/spec/TS files, and the relevant example screen.
2. Record git status --short --branch and adb devices -l.
3. Confirm JDK 17, the Android SDK, and a single intended emulator or device.
4. Verify RECORD_AUDIO appears in the example manifest and identify the current permission state without changing it.
5. 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:

1. Install and launch sound.example on the selected device.
2. Grant microphone permission through Android's system UI; verify denial and retry behavior when permission handling is the target.
3. Start recording; require a resolved path, active state, and increasing millisecond callbacks.
4. Pause and resume; require time to pause and continue without duplicate recorder instances or promise settlement.
5. Stop; require terminal state, listener cleanup, and a non-empty app-owned recording.
6. Play the file; require increasing position, sensible duration, seek, volume, speed, and one playback-end transition as applicable.
7. Run Rapid Switch and Stress Test for MediaPlayer state or concurrency fixes.
8. 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.