android: the phone, on the real core — the mockup shell, playback, the media card, the catalog, the resolver, Save, the dev flavour

The same Tauri 2 project builds for Android: mobile.html as a third Vite
entry (src/mobile/, the mockup on real data), tauri.android.conf.json, the
mobile stubs (updater, lyric alignment, vocal separation), rustls reqwest
on Android, the AAudio buffer, and a hand-driven detour build
(src-tauri/android/{env,build,deploy,dev}.sh) while Developer Mode is off.
ANDROID.md is the recipe.

Playback: the media-session plugin crate (lock-screen card, MediaStyle
notification, audio focus, headset buttons, a foreground service that
promotes itself first — Android 14 kills the app otherwise), session
restore across reload and restart, solid chrome after measuring the
backdrop-filter lag.

The catalog: Search is the desktop's top bar (the top-result rule, artist
cards), the artist page and the record page are the desktop's, Home is the
desktop's landing page, Gaps per followed shelf. Playing goes through the
desktop's own source rules, moved verbatim from state.svelte.js into
src/lib/sources.js so both apps share one resolver; the phone readies the
next three tracks and crosses boundaries gapless. Save fetches a record or
a track into the library by the download rules; Transfers shows the
burst. The raw Soulseek search stays, offered on request, a peer's copy
streaming with the lane rising as the bytes arrive. Community is the
Soulseek side (rooms, chat, buddies); the private layer waits.

The opener and storage plugins (social links, the picked library folder,
all-files access), the volume normalization switch, and the harness:
tests/mobile/smoke.mjs walks the mock (a fake network behind
src/lib/events.js) and the real phone over CDP, perf.mjs measures frames.

src-tauri/android/deploy.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# frontend → detour build → install on the connected phone → launch → screenshot
+set -euo pipefail
+cd /f/Coding/SoulStream
+export MSYS_NO_PATHCONV=1
+ADB="$(cygpath -u "$LOCALAPPDATA")/Android/Sdk/platform-tools/adb.exe"
+echo "== vite $(date +%T)"
+npx vite build 2>&1 | grep -i "error\|built in" || true
+bash src-tauri/android/build.sh
+APK=src-tauri/gen/android/app/build/outputs/apk/arm64/debug/app-arm64-debug.apk
+echo "== install $(date +%T)"
+"$ADB" install -r "$APK" 2>&1 | tail -2
+# the media card is a notification; a debug install grants the permission up
+# front so the first play never stops on the system's dialog
+"$ADB" shell pm grant com.soulstream.app android.permission.POST_NOTIFICATIONS 2>/dev/null || true
+"$ADB" shell am force-stop com.soulstream.app
+# launch and screenshot only when the phone is ours to drive: SoulStream or
+# the launcher on screen. Never take the screen from another app.
+FOCUS=$("$ADB" shell dumpsys window 2>/dev/null | grep -a "mCurrentFocus" | head -1)
+if echo "$FOCUS" | grep -qi "soulstream\|launcher"; then
+    "$ADB" shell am start -n com.soulstream.app/.MainActivity >/dev/null
+    sleep 5
+    OUT="${SS_SHOT_DIR:-$(cygpath -u "$TEMP")}"
+    "$ADB" exec-out screencap -p > "$OUT/px-1.png"
+    echo "== shot $(date +%T) -> $OUT/px-1.png"
+else
+    echo "== installed; not launched (the phone is in use: $FOCUS)"
+fi