go/DOCUMENTATION/FORDEV.md

Development & Build

Install dependencies:

npm install

Build the update payload:

npm run build:payload

Compile and assemble the release APK:

npm run build:apk

Release

Set credentials once per session, then run release:

$env:ANDROID_HOME = "$env:LOCALAPPDATA\Android\Sdk"
$env:NDK_HOME = "$env:LOCALAPPDATA\Android\Sdk\ndk\29.0.13846066"
$env:GITLAB_TOKEN = "your-token-here"
npm run release

This builds the payload, compiles the APK for arm64 and x86_64, commits and tags the version, uploads all artifacts, and creates the GitLab release automatically.

Logs

Stream live device logs:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo

Clear the logcat buffer then stream:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -c; & "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -s VylaGo

Dump logs to file:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -d -s VylaGo > vyla-go.log

Show all crash and fatal logs:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" logcat -d | Select-String "VylaGo|AndroidRuntime|FATAL"

List connected devices:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" devices

Install APK directly to device:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" install -r "src-tauri\gen\android\app\build\outputs\apk\universal\release\app-universal-release.apk"

Force-stop and clear app data:

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell am force-stop com.vyla.go
& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell pm clear com.vyla.go

Fix emulator DNS timeouts (if emulator gets network timeouts connecting to GitLab):

& "$env:LOCALAPPDATA\Android\Sdk\platform-tools\adb.exe" shell settings put global private_dns_mode off