บันทึกประจำรุ่นสำหรับ Android CLI

Android CLI เป็นอินเทอร์เฟซหลักสำหรับการพัฒนา Android จากเทอร์มินัล ซึ่งสร้างขึ้นเพื่อเพิ่มประสิทธิภาพเวิร์กโฟลว์การพัฒนาโดยใช้ Agent และเครื่องมือที่คุณเลือก

หน้านี้แสดงฟีเจอร์ใหม่ใน Android CLI ทุกรุ่น หากต้องการดาวน์โหลด Android CLI ให้ไปที่หน้าดาวน์โหลด ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ Android CLI

เวอร์ชัน 1.1.16919734 (พฤศจิกายน 2026)

  • การติดตั้งแบบเดลต้าจะนำไฟล์ที่เปลี่ยนตำแหน่งแล้วมาใช้ซ้ำ: android install และ android run จะไม่ส่งไฟล์ที่ไม่มีการเปลี่ยนแปลงซึ่งตำแหน่งใน APK มีการเปลี่ยนแปลงอีกต่อไป หากต้องการปิดใช้ ให้ส่ง --use-delta-install-instructions=COPY,DATA
  • การติดตามการเขียน: android profiler systemtrace สามารถบันทึกสิ่งที่ Jetpack Compose ทำในแอปได้ ส่ง --enable=compose.composition เพื่อบันทึกส่วนสำหรับฟังก์ชันที่ประกอบกันได้แต่ละรายการที่ทำงานอยู่ หรือ --enable=compose.recomposition เพื่อบันทึกการอ่านและเขียนสถานะที่ทำให้เกิดการจัดองค์ประกอบใหม่ด้วย แอปต้องใช้ androidx.compose.runtime:runtime-tracing 1.13 ขึ้นไป ระบบจะบันทึกการติดตามเป็นไฟล์เก็บถาวรแบบ ZIP ที่คุณเปิดในเครื่องมือวิเคราะห์ของ Android Studio
  • ฮีปดัมป์ Perfetto: ส่ง --type=perfetto ไปยัง android profiler heapdump capture เพื่อบันทึกฮีปดัมป์เป็น Perfetto Trace โดยจะมีออบเจ็กต์และการอ้างอิงระหว่างออบเจ็กต์ แต่ไม่มีค่าของออบเจ็กต์ จึงมีขนาดเล็กกว่าไฟล์ .hprof โดยต้องใช้ Android 12 (API ระดับ 31) ขึ้นไป และแอปที่ทำโปรไฟล์หรือแก้ไขข้อบกพร่องได้
  • รูปแบบขนาด DEX ของไลบรารีใน JSON สำหรับการวิเคราะห์: ในเอาต์พุต android analyze --format=json สำหรับอาร์ติแฟกต์ไลบรารี (AAR และ JAR) ช่อง dexSizeBytes ใน d8CompileResult และ r8CompileResult ตอนนี้เป็นจำนวนเต็ม 64 บิตที่เรียงอันดับเป็นสตริงแทนตัวเลข
  • ผลลัพธ์อินพุตเป็น JSON: คำสั่งย่อย android input จะพิมพ์ผลลัพธ์เป็นออบเจ็กต์ JSON ที่มีรายการ results ในเอาต์พุตมาตรฐาน โดยใช้รูปแบบเดียวกันสำหรับทุกคำสั่งย่อย ความล้มเหลว เช่น ไม่มีองค์ประกอบที่ตรงกันหรือมีรายการที่ตรงกันหลายรายการจะรายงานในช่อง status ของผลลัพธ์แต่ละรายการแทนที่จะเป็นข้อความในข้อผิดพลาดมาตรฐาน
  • รหัสออกของโปรแกรมจำลอง: android emulator create, start, stop และ remove จะออกด้วยรหัสที่ไม่ใช่ 0 เมื่อดำเนินการไม่สำเร็จและพิมพ์ข้อผิดพลาดไปยังข้อผิดพลาดมาตรฐาน

เวอร์ชัน 1.1.16717390 (ตุลาคม 2026)

  • สัญญาณข้อขัดข้องในภาคสนาม: ใช้คำสั่ง android signals ใหม่เพื่อตรวจสอบลักษณะการทำงานของแอปในภาคสนามด้วย Firebase Crashlytics หลังจากลงชื่อเข้าใช้ด้วย android auth login แล้ว ให้ค้นหาโปรเจ็กต์และแอปด้วย android signals context จากนั้นแสดงรายการ กรอง และแจกแจงปัญหาข้อขัดข้อง, ANR และปัญหาที่ไม่ร้ายแรงด้วย android signals crashes list, facets, describe และ samples
  • ฮีปดัมป์ในฟิลด์: ใช้ android signals heaps เพื่อแสดงรายการ อธิบาย และดาวน์โหลดฮีปดัมป์ที่ Crashlytics รวบรวมไว้เมื่อเกิดข้อขัดข้องเนื่องจากหน่วยความจำไม่เพียงพอและการปิดแอปเนื่องจากหน่วยความจำไม่เพียงพอ พร้อมกับข้อมูลเมตา คีย์ที่กำหนดเอง และบันทึกของเซสชันที่สร้างฮีปดัมป์เหล่านั้น
  • การทำโปรไฟล์แอป: ใช้คำสั่ง android profiler ใหม่เพื่อบันทึกการติดตามของระบบด้วย android profiler systemtrace และบันทึกฮีปดัมป์ของ JVM ด้วย android profiler heapdump capture ในอุปกรณ์ที่เชื่อมต่อหรือโปรแกรมจำลอง จัดการเซสชันการทำโปรไฟล์ด้วย android profiler session list, status และ terminate
  • การวิเคราะห์อาร์ติแฟกต์: ใช้คำสั่ง android analyze ใหม่เพื่อตรวจสอบ APK, AAB, AAR และ JAR อย่างน้อย 1 รายการ และรายงานรายละเอียดแพ็กเกจ, ขนาด DEX, เมตริกการลดขนาดและการเพิ่มประสิทธิภาพ R8 รวมถึงคำเตือนเกี่ยวกับกฎการเก็บรักษาไลบรารีและการเพิ่มประสิทธิภาพต่ำ ส่ง --format=json หรือ --format=textproto สำหรับเอาต์พุตที่เครื่องอ่านได้
  • ตัวอย่าง Compose: ใช้คำสั่ง android preview list ใหม่เพื่อค้นหาฟังก์ชัน @Preview ของ Jetpack Compose ในเป้าหมาย และใช้ android preview render --fqn <name> เพื่อแสดงผลเป็นรูปภาพ PNG และไฟล์ JSON ของแผนผังคอมโพเนนต์ในเครื่องโดยไม่ต้องใช้ Android Studio ส่ง --output เพื่อเลือกตำแหน่งที่จะเขียนไฟล์
  • สร้างการอ้างอิงในการเรียกใช้และติดตั้ง: android run และ android install ยอมรับการอ้างอิงบิลด์ตามตำแหน่งเพื่อสร้างและติดตั้งใช้งานเป้าหมายที่เฉพาะเจาะจง ตอนนี้เป้าหมาย Gradle ที่ไม่มีตัวแปร เช่น :app จะใช้ตัวแปร debug เป็นค่าเริ่มต้น
  • หน้าต่างการมิเรอร์อุปกรณ์: ใช้คำสั่ง android device hub ใหม่เพื่อเปิดหน้าต่างเดสก์ท็อปสำหรับการมิเรอร์หน้าจอแบบเรียลไทม์และการควบคุมแบบอินเทอร์แอกทีฟของอุปกรณ์ Android จริงที่เชื่อมต่ออยู่ (รวมถึงอุปกรณ์ระยะไกลที่เชื่อมต่อผ่าน android device remote connect) และโปรแกรมจำลองของ Android

เวอร์ชัน 1.0.16625370 (ตุลาคม 2026)

  • การโต้ตอบกับ UI: ใช้คำสั่ง android input ใหม่เพื่อแตะ เลื่อน ปัด พิมพ์ข้อความ และกดแป้นบนอุปกรณ์ที่เชื่อมต่อหรือโปรแกรมจำลอง กำหนดเป้าหมายองค์ประกอบ UI ด้วยตัวเลือก เช่น text=Submit หรือ id=email,class=EditText และรวมเข้ากับ android layout เพื่อค้นหาองค์ประกอบที่จะโต้ตอบด้วย

เวอร์ชัน 1.0.16500706 (ตุลาคม 2026)

  • เชื่อมต่อกับการจอง: ตอนนี้ android device remote create จะเชื่อมต่อการจองใหม่กับ adb โดยอัตโนมัติ ส่ง --connect=false เพื่อสร้างการจองเท่านั้นและเชื่อมต่อในภายหลังด้วย android device remote connect

เวอร์ชัน 1.0.16457483 (กันยายน 2569)

  • ลงชื่อเข้าใช้บริการของ Google: ลงชื่อเข้าใช้บัญชี Google ด้วย android auth login Android CLI เพื่อให้สามารถเรียกใช้บริการของ Google ที่ต้องมีการตรวจสอบสิทธิ์ได้
  • แคตตาล็อกอุปกรณ์ระยะไกล: ค้นหาโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่คุณสามารถสตรีมอุปกรณ์ได้ด้วย android device remote projects และเรียกดูอุปกรณ์จริงที่พร้อมใช้งานด้วย android device remote models
  • การจองอุปกรณ์ระยะไกล: จองอุปกรณ์จริงระยะไกลด้วย android device remote create จากนั้นจัดการการจองด้วย list, extend --duration <minutes> และ remove
  • เชื่อมต่อกับอุปกรณ์ระยะไกล: ใช้ android device remote connect เพื่อเชื่อมต่ออุปกรณ์ที่จองไว้กับ adb ผ่านการเชื่อมต่อเบื้องหลัง เพื่อให้ทำงานร่วมกับ android run, android install และคำสั่งอื่นๆ ของอุปกรณ์ได้เหมือนกับอุปกรณ์ในเครื่อง ใช้ android device remote disconnect เพื่อถอดออก

เวอร์ชัน 1.0.16406183 (กันยายน 2026)

  • เริ่มต้นระบบได้เร็วขึ้น: Android CLI เริ่มต้นระบบได้เร็วขึ้นประมาณ 2 เท่า เนื่องจากไลบรารีเครื่องมือดาวน์โหลดแบบเนทีฟจะโหลดเมื่อมีการใช้งานเท่านั้น และจะไม่แตกไฟล์ไปยังไดเรกทอรีชั่วคราวทุกครั้งที่มีการเรียกใช้
  • แก้ไขรหัสออก: ตอนนี้คำสั่งจะแสดงรหัสออกที่ไม่ใช่ 0 เมื่อดำเนินการไม่สำเร็จ ซึ่งรวมถึง create, run, install, describe, layout, docs, info, skills และ update ซึ่งทำให้การเขียนสคริปต์และ CI มีความน่าเชื่อถือมากขึ้น
  • การปรับแต่งคำอธิบายประกอบบนหน้าจอ: android screen --annotate แสดงพารามิเตอร์การปรับแต่งสำหรับการตรวจหาฟีเจอร์ ซึ่งรวมถึงเกณฑ์การตรวจหาขอบ การกรองรูปร่าง และกลยุทธ์การจัดกลุ่ม ซึ่งระบุไว้ใน--help
  • ตัวเลือกการสร้างโปรเจ็กต์: android create รองรับแฟล็ก --application-id และ --namespace รวมถึงชื่อตัวเลือกที่มีเครื่องหมายขีดกลาง เช่น --min-sdk ตอนนี้เทมเพลต Compose ใช้ชุดซอร์ส src/main/kotlin และธีม Material 3 แล้ว
  • โปรแกรมจำลองแบบ Headless: เริ่มโปรแกรมจำลองโดยไม่มีหน้าต่างโดยใช้ android emulator start --headless
  • ความน่าเชื่อถือของ SDK: คำสั่ง android sdk จะใช้การล็อกระหว่างกระบวนการเพื่อให้การเรียกใช้พร้อมกันไม่ขัดแย้งกัน ยืนยันเส้นทางและเวอร์ชันของแพ็กเกจที่ติดตั้ง อัปเดตไฟล์ XML เดิมเมื่อจำเป็นเท่านั้น และรายงานข้อผิดพลาดที่ชัดเจนยิ่งขึ้น
  • เอาต์พุตตัวอย่างการเขียน: android studio render-compose-preview จะพิมพ์ Absolute Path ของรูปภาพที่แสดงผล และยืนยันการเขียนแม้ว่าจะใช้ --print-semantics ก็ตาม
  • การรองรับระดับ API ที่เก่ากว่า: แก้ไขความล้มเหลวในการโต้ตอบกับอุปกรณ์ เช่น android layout ในอุปกรณ์ที่ใช้ API ระดับ 32 และต่ำกว่า

เวอร์ชัน 1.0.16261425 (กันยายน 2026)

  • การแก้ไขเลย์เอาต์: แก้ไขปัญหาที่คำสั่งเลย์เอาต์ไม่ทำงานในบางสถานการณ์ หากต้องการเปลี่ยนกลับไปใช้ลักษณะการทำงานของเลย์เอาต์แบบเก่าชั่วคราว ให้export ANDROID_CLI_LAYOUT_V1=1

เวอร์ชัน 1.0.16251017 (กันยายน 2026)

  • การดัมพ์เลย์เอาต์: ตอนนี้ android layout รองรับแฟล็ก --no-idle เพื่อดึงข้อมูลเลย์เอาต์โดยไม่ต้องรอสถานะไม่มีการใช้งาน นอกจากนี้ android layout ยังรองรับแฟล็ก --full เพื่อแสดงผลแผนผังเลย์เอาต์ทั้งหมดโดยไม่มีการกรอง โดยค่าเริ่มต้น layout จะแสดงผลเฉพาะองค์ประกอบแบบอินเทอร์แอกทีฟเท่านั้น
  • การเติมข้อความอัตโนมัติใน Shell: สร้างและติดตั้งสคริปต์การเติมข้อความอัตโนมัติใน Shell สำหรับ Bash และ Zsh โดยใช้คำสั่ง android completion ใหม่
  • อัปเดตทักษะ: อัปเดตทักษะให้เป็นปัจจุบันอยู่เสมอด้วยคำสั่ง android skills update ใหม่ และติดตั้งหรือนำทักษะหลายรายการออกในการเรียกใช้ครั้งเดียว (เช่น android skills install <skill1> <skill2>)
  • แสดงรายการทักษะตาม Agent: ตอนนี้ android skills list จะแสดงผลแบบละเอียดโดยค่าเริ่มต้น ซึ่งรวมถึงคำอธิบายทักษะและ Agent ที่ติดตั้งทักษะไว้ android skills list ยังรองรับแฟล็ก --agent <agent> เพื่อแสดงรายการทักษะทั้งหมดที่ติดตั้งไว้สำหรับ Agent ด้วย
  • ประสิทธิภาพการติดตั้งแบบเดลต้า: เร่งการแพตช์ APK ที่เพิ่มขึ้นใน android install โดยใช้การเรียกใช้ระบบเคอร์เนลแบบ Zero-Copy
  • การตรวจหาขอบหน้าจอ: ปรับปรุงฟีเจอร์และการตรวจหาขอบใน android screen โดยใช้อัลกอริทึมการตรวจหาขอบ Canny

เวอร์ชัน 1.0.15985488 (กรกฎาคม 2026)

  • คำสั่งติดตั้งเฉพาะ: ติดตั้ง APK โดยใช้คำสั่ง android install แบบสแตนด์อโลนที่มีฟีเจอร์พุช APK แบบเพิ่มทีละส่วน ซึ่งทำให้การติดตั้งแบบเพิ่มทีละส่วนรวดเร็วกว่า adb อย่างมาก
  • เรียกใช้การติดตั้งแบบเพิ่มขึ้น: ในทำนองเดียวกัน ให้ใช้แฟล็ก --use-delta-install ใหม่ใน android run เพื่อให้ติดตั้งใช้งาน APK แบบเพิ่มขึ้นในอุปกรณ์ได้เร็วขึ้น
  • การจัดการ SDK ข้ามแพลตฟอร์ม: กำหนดเป้าหมายแพลตฟอร์มที่ไม่ใช่โฮสต์ด้วยแฟล็ก --platform <os_arch> ใหม่ในคำสั่ง android sdk (install, update, materialize) เพื่อตรวจสอบ แก้ไข และติดตั้งคอมโพเนนต์ในสถาปัตยกรรมระบบปฏิบัติการและ CPU
  • การปรับปรุง CLI ของทักษะ: ขยายคำสั่งย่อย android skills (add, remove, list, find) พร้อมเอกสารประกอบ --help, ความคิดเห็นที่ชัดเจนเมื่อไม่มีทักษะ และการจัดเตรียมการดาวน์โหลดแบบอะตอมที่ปลอดภัยยิ่งขึ้นพร้อมการย้อนกลับอัตโนมัติ

เวอร์ชัน 1.0.15857036 (กรกฎาคม 2026)

  • การรองรับทักษะ Agent ที่กว้างขึ้น: ติดตั้งทักษะในสภาพแวดล้อม Agent หลายสิบรายการ (รวมถึง Claude Code, Cursor, Cline, OpenHands, Windsurf, Zed และ Devin) โดยใช้ android skills install
  • เครื่องมือดาวน์โหลดแบบเนทีฟที่รองรับพร็อกซี: ดาวน์โหลดทรัพยากรเครือข่ายได้อย่างน่าเชื่อถือโดยใช้เครื่องมือดาวน์โหลด HTTP แบบเนทีฟที่รองรับพร็อกซีขององค์กรได้ทันที
  • การจัดการแพ็กเกจ SDK: จัดการแพ็กเกจ SDK ด้วยการนำหลายแพ็กเกจออกใน android sdk remove และการแก้ไขตาม SHA ใน android sdk resolve
  • การปรับปรุงการอธิบายและหน้าจอ: ดูข้อผิดพลาดในการบิลด์ Gradle โดยตรงในเอาต์พุตมาตรฐานใน android describe และกำหนดเป้าหมายอุปกรณ์ที่เฉพาะเจาะจงโดยใช้แฟล็ก --device ใน android screen
  • ความสามารถในการใช้งาน CLI และ Error Reporting: ข้อความแสดงข้อผิดพลาดที่ชัดเจนยิ่งขึ้นเมื่อป้อนคำสั่งที่ไม่รู้จักหรือเป้าหมายการสร้างโปรเจ็กต์ที่ไม่ถูกต้อง คำสั่ง android emulator ที่ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

เวอร์ชัน 1.0.15498356 (พฤษภาคม 2026)

  • การโหลดเทมเพลต SDK แบบไดนามิก: ตอนนี้ระบบจะดาวน์โหลดเทมเพลตโปรเจ็กต์สำหรับ android create แบบไดนามิกจากแพ็กเกจ Android SDK แทนที่จะรวมไว้ในไบนารี CLI เพื่อให้มั่นใจว่าโปรเจ็กต์ใหม่จะใช้เทมเพลตล่าสุดเสมอ
  • ความเข้ากันได้ของใบอนุญาต SDK: ใบอนุญาต SDK ที่ยอมรับซึ่งบันทึกโดย android sdk จะตรงกับรูปแบบไฟล์ที่เครื่องมือ Android SDK และปลั๊กอิน Gradle เวอร์ชันเก่าคาดไว้
  • การรองรับ Symlink: เพิ่มการรองรับลิงก์สัญลักษณ์ในคำสั่ง CLI และการดำเนินการกับไฟล์
  • การแยกไบนารีแบบอะตอม: ป้องกันภาวะแข่งขันในการแยกข้อมูลระหว่างการเรียกใช้ CLI แบบหลายกระบวนการพร้อมกันโดยการแตกแพ็กเกจไบนารีไปยังไดเรกทอรีชั่วคราวก่อนที่จะย้ายไปยังตำแหน่งที่ต้องการแบบอะตอม
  • ความเสถียรของ Windows: ปรับปรุงความเข้ากันได้และประสิทธิภาพของ Windows ใน Windows 11 พร้อมกับการแก้ไขการแปลงเส้นทางไดเรกทอรีหลัก

เวอร์ชัน 1.0.15433482 (พฤษภาคม 2026)

  • การผสานรวม Antigravity: ตอนนี้ Android CLI และทักษะต่างๆ ได้ผสานรวมเข้ากับ Google Antigravity 2.0 อย่างเป็นทางการแล้ว โดยเป็นชุดทรัพยากรเสริมเพื่อปรับปรุงการพัฒนา Agentic AI ของคุณให้มีประสิทธิภาพมากขึ้น
  • คำสั่ง Android Studio: ใช้คำสั่ง android studio ใหม่เพื่อช่วยให้ Agent ใช้ประโยชน์จากความสามารถเชิงบริบทที่ลึกซึ้งของ Android Studio ได้ ซึ่งรวมถึงการวิเคราะห์โค้ด การค้นหาเชิงความหมาย และการแสดงผล Compose
  • การรองรับเส้นทาง: ตรวจสอบประสบการณ์ของผู้ใช้ที่สำคัญโดยใช้เส้นทาง ซึ่งเป็นคำอธิบายภาษาธรรมชาติของโฟลว์ผู้ใช้ที่ Agent สามารถเรียกใช้จากเทอร์มินัลหรือใน CI/CD
  • ทักษะใหม่ๆ เกี่ยวกับ Android: เข้าถึงคลังทักษะใหม่ๆ เกี่ยวกับ Android ซึ่งรวมถึงทักษะสำหรับการย้ายข้อมูล CameraX, UI ที่ปรับเปลี่ยนตามอุปกรณ์, AppFunctions และสไตล์ Compose
  • ตัวเลือกการติดตั้งเพิ่มเติม: ติดตั้งและอัปเดต Android CLI โดยใช้เครื่องมือจัดการแพ็กเกจยอดนิยม ซึ่งรวมถึง apt-get, winget และ homebrew โปรดดูรายละเอียดที่ตัวเลือกการดาวน์โหลด

เวอร์ชัน 0.7 (เมษายน 2026)

รุ่นแรก