VSCode extension แบบเบาๆ สำหรับจัดการ Android emulator และทดสอบรัน APK โดยใช้ Android SDK ที่ติดตั้งในเครื่อง (ไม่ได้สร้าง emulator ใหม่จากศูนย์ — ห่อหุ้ม adb + emulator ของ Google SDK เพื่อให้ใช้งานสะดวกขึ้น)

คุณสมบัติ

List AVDs — แสดงรายการ Android Virtual Devices ที่มีในเครื่อง
Start / Stop emulator — เปิด/ปิด emulator ได้จาก side panel
Install APK — คลิกขวาที่ไฟล์ .apk ใน explorer แล้วสั่ง install ลงเครื่องเป้าหมาย หรือ drag จาก side panel
Launch / Uninstall app — รันหรือถอนแอปจากรายการ package
Logcat — ดู logcat แบบ live ใน Output channel
Screenshot — บันทึก PNG จากหน้าจอ device ลง workspace
Screen mirror — webview แสดงหน้าจอ emulator ผ่าน adb screencap polling + รองรับ tap / key events พื้นฐาน (Home, Back, Recents, ปุ่ม power/volume, ส่งข้อความ)
adb shell — เปิด terminal ที่เชื่อมกับ device โดยตรง

ความต้องการ

Java 17+ (Adoptium/Temurin แนะนำ) — จำเป็นสำหรับ sdkmanager

ส่วน Android SDK เลือกได้:

แบบง่าย (แนะนำ): เปิด extension → กด "ติดตั้ง Android SDK ให้ฉัน" ใน welcome view — extension จะดาวน์โหลด command-line tools (~150 MB) แล้วใช้ sdkmanager ติดตั้ง platform-tools + emulator + system image ให้ครบ
แบบใช้ของเดิม: ถ้ามี Android Studio อยู่แล้ว extension จะค้นหา SDK อัตโนมัติจาก:
1. การตั้งค่า gumdroidemu.sdkPath
2. ANDROID_HOME / ANDROID_SDK_ROOT
3. ตำแหน่งเริ่มต้น (%LOCALAPPDATA%\Android\Sdk บน Windows, ~/Library/Android/sdk บน macOS)

ถ้าไม่มี Java extension จะเสนอให้ติดตั้งผ่าน winget install EclipseAdoptium.Temurin.17.JDK (Windows) หรือเปิดหน้าดาวน์โหลด Adoptium

วิธีใช้ครั้งแรก

เปิด VSCode คลิก icon GumDroidEmu ใน activity bar
ถ้ายังไม่มี SDK กด "ติดตั้ง Android SDK ให้ฉัน" — รอประมาณ 5-10 นาที (ขึ้นกับเน็ต)
เมื่อเสร็จ extension จะถามว่าสร้าง AVD ตัวอย่างเลยไหม → กด สร้าง AVD → เริ่ม emulator
รอ emulator boot ครั้งแรกประมาณ 1-2 นาที
คลิกขวาที่ไฟล์ .apk ใน explorer → Install APK on device

ฟีเจอร์อื่นๆ

กดปุ่ม play ข้างชื่อ AVD เพื่อเปิด emulator
คลิกขวาที่ device ใน Running Devices แล้วเลือก Mirror screen, Open logcat, Screenshot, adb shell

การตั้งค่า

Setting	Default	คำอธิบาย
`gumdroidemu.sdkPath`	`""`	Path ของ Android SDK root
`gumdroidemu.emulatorArgs`	`["-no-snapshot-save", "-no-boot-anim"]`	argument เพิ่มเติมตอน start emulator
`gumdroidemu.mirrorFps`	`4`	อัตราการ refresh หน้าจอใน mirror panel
`gumdroidemu.logcatFilter`	`"*:I"`	filter สำหรับ logcat

ขอบเขต (ที่ตั้งใจจะ "เบา")

ตัว extension ไม่ได้ embed emulator engine มาเอง — ใช้ของ Google SDK ที่ทดสอบและบำรุงรักษามาดีแล้ว ตัว extension เองเป็นแค่ wrapper เล็กๆ ที่ทำให้ workflow ทดสอบ APK ใน VSCode สะดวกขึ้น

ถ้าต้องการ mirror หน้าจอแบบ smooth กว่านี้ แนะนำให้ใช้ scrcpy แทน — extension นี้ใช้วิธี screencap polling เพื่อให้ทำงานได้ทุกที่โดยไม่ต้องลง dependency เพิ่ม

โครงสร้าง code

src/
├── extension.ts            # entry + command handlers
├── sdk.ts                  # SDK auto-detection
├── installer.ts            # auto-install Android SDK (download + sdkmanager)
├── adb.ts                  # ADB wrapper
├── avdManager.ts           # emulator process management
├── avdTreeProvider.ts      # AVD tree view
├── deviceTreeProvider.ts   # connected devices tree view
├── mirrorPanel.ts          # screen mirror webview
└── logger.ts