- Add root dev:android script delegating to frontend - Add Android dev scripts and wrapper to resolve ANDROID_SDK_ROOT/ANDROID_HOME (Linux/WSL) - Keep Vite running when Android run fails and document troubleshooting in frontend README - Ignore generated frontend/android project in git
1.1 KiB
1.1 KiB
Frontend (Electron + Android)
Prerequisites
- Node.js and npm
- Android SDK +
adb+ an emulator or connected device (for Android dev mode)
Install dependencies
From repository root:
cd frontend
npm ci
Development
From repository root:
npm run dev
This starts desktop development mode (Vite + Electron).
From repository root:
npm run dev:android
This starts Android live-reload development mode:
- Ensures
frontend/androidexists (cap add androidon first run only) - Starts Vite on
0.0.0.0:5173 - Runs
cap run android -l --no-sync --port 5173 --forwardPorts 5173:5173
Troubleshooting (Android SDK)
If you get:
ERR_SDK_NOT_FOUND: No valid Android SDK root found.
set one of these environment variables and run again:
export ANDROID_SDK_ROOT="/path/to/Android/Sdk"
# or
export ANDROID_HOME="/path/to/Android/Sdk"
Typical locations:
- Linux:
$HOME/Android/Sdk - WSL + Android Studio on Windows:
/mnt/c/Users/<windows-user>/AppData/Local/Android/Sdk
Other scripts
From frontend/:
npm run build
npm run preview
npm run cap:sync
npm run dist