Android Local Build Debug

Use this skill for repeatable local Android build + install + real-device debugging.

Run commands from repository root: E:\coding\TermLink

Target Devices

Use this priority by default:

1. da34332c
2. MQS7N19402011743

If multiple devices are online, always pass -Serial.

Quick Start

1. Ensure local server is running:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/ensure-local-server.ps1

2. Build debug APK:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/build-debug-apk.ps1

3. Install and launch:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/install-debug-apk.ps1

4. Stream logs:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/logcat-termlink.ps1

5. Validate local server config:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/validate-server-config.ps1

Standard Debug Loop

1. Run doctor and ensure local server:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/adb-doctor.ps1
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/ensure-local-server.ps1

2. Rebuild and reinstall:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/build-debug-apk.ps1
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/install-debug-apk.ps1 -Serial da34332c

3. Launch app:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/launch-termlink.ps1 -Serial da34332c

4. Reproduce issue and collect logs:

powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/logcat-termlink.ps1 -Serial da34332c

Rules

• Always use adb -s <serial> in scripts and manual commands.
• Keep package fixed to com.termlink.app.
• Prefer PID-filtered logcat; fall back to tag filter if PID is unavailable.
• Use JDK 21 for Android build.
• Store private validation URL in local-config.ps1 (gitignored).