Agent skill

android-local-build-debug

Build, install, and debug TermLink on real Android devices with adb. Use for local packaging, selecting target serials (da34332c or MQS7N19402011743), launching the app, collecting logcat, and reproducing mobile issues.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/android-local-build-debug

SKILL.md

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
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/ensure-local-server.ps1
  1. Build debug APK:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/build-debug-apk.ps1
  1. Install and launch:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/install-debug-apk.ps1
  1. Stream logs:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/logcat-termlink.ps1
  1. Validate local server config:
powershell
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
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
  1. Rebuild and reinstall:
powershell
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
  1. Launch app:
powershell
powershell -ExecutionPolicy Bypass -File ./skills/android-local-build-debug/scripts/launch-termlink.ps1 -Serial da34332c
  1. Reproduce issue and collect logs:
powershell
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).

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results