ภาพรวมของ Android CLI

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

ตัวอย่างเช่น เอเจนต์หรือสคริปต์สามารถใช้ CLI เพื่อทำงานต่างๆ เช่น ต่อไปนี้

  • ตั้งค่าสภาพแวดล้อมและ Android SDK โดยอัตโนมัติ
  • สร้างโปรเจ็กต์ใหม่จากเทมเพลต
  • จัดการอุปกรณ์เสมือน ติดตั้ง APK และตรวจสอบหน้าจออุปกรณ์จริงและลำดับชั้น UI ได้โดยตรงจากเทอร์มินัล
  • เชื่อมต่อกับอินสแตนซ์ Android Studio ที่กําลังทํางานเพื่อการวิเคราะห์โค้ดเชิงความหมาย การแสดงตัวอย่าง Compose และการค้นหาเวอร์ชันทรัพยากร Dependency
  • ทดสอบแอปด้วยเส้นทางการท่องเว็บ

นอกจากนี้ Android CLI ยังให้สิทธิ์ตัวแทนของคุณเข้าถึง ทักษะ Android และฐานความรู้ Android เฉพาะทางเพื่อช่วยให้มั่นใจว่า โปรเจ็กต์ของคุณใช้รูปแบบและแนวทางปฏิบัติแนะนำที่ Android แนะนำ

ดูคำอธิบายทั้งหมดของคำสั่งและตัวเลือก CLI ของ Android ได้ที่ข้อมูลอ้างอิงคำสั่ง CLI ของ Android

ติดตั้ง Android CLI

หากต้องการติดตั้ง Android CLI ให้ทำตามขั้นตอนต่อไปนี้

  1. ดาวน์โหลด Android CLI

  2. หากต้องการตรวจสอบว่าคุณใช้เวอร์ชันล่าสุดอยู่ ให้อัปเดต Android CLI โดยทำดังนี้

    android update

หากต้องการตรวจสอบว่าติดตั้ง Android CLI ในเครื่องแล้วหรือไม่ ให้เรียกใช้ which android หรือ command -v android หากระบบแสดงเส้นทาง แสดงว่าติดตั้งแล้ว

ตั้งค่าสำหรับตัวแทน

หากต้องการช่วยให้ตัวแทนเข้าใจและใช้ Android CLI ให้รัน android init เพื่อ ติดตั้งทักษะ android-cli

ข้อมูลที่รวบรวม

Android CLI จะรวบรวมข้อมูลเกี่ยวกับการใช้งานเครื่องมือขั้นพื้นฐาน ข้อมูลที่เรา รวบรวมมีดังนี้

  • การเรียกใช้คำสั่ง android และคำสั่งย่อย เช่น android run และ android create
  • ชื่อของอาร์กิวเมนต์หรือตัวเลือกที่ไม่ใช่ตำแหน่งที่ใช้ เช่น --sdk หรือ --version
  • อาร์กิวเมนต์ตำแหน่งและค่าแฟล็กที่แมปกับชุดตัวเลือกของระบบที่กำหนดไว้ล่วงหน้าแบบคงที่ ซึ่งจัดการโดย Android CLI เช่น เราจะเก็บรวบรวมชื่อเทมเพลตโปรแกรมจำลอง เช่น medium_phone และ large_desktop รวมถึงชื่อเอเจนต์ เช่น GEMINI, CLAUDE หรือ CODEX
  • Stack Trace และข้อความข้อยกเว้น โดยระบบจะลบข้อมูลระบุตัวบุคคล ออกก่อนการรวบรวมเพื่อช่วยให้มั่นใจในความเป็นส่วนตัว

ตัวอย่างข้อมูลที่เราไม่ได้รวบรวมมีดังนี้

  • เราจะไม่รวบรวมการตอบกลับของ CLI เมื่อมีการเรียกใช้คำสั่ง
  • เราจะไม่รวบรวมข้อมูลที่ผู้ใช้สร้างขึ้นหรือตัวระบุภายนอกที่ส่งไปยัง CLI เช่น พิกัด Maven ที่เฉพาะเจาะจง เส้นทางไฟล์ในเครื่อง หรือชื่อโปรเจ็กต์ที่กำหนดเอง เช่น หากมีการเรียกใช้คำสั่ง android create --name=com.company.internal.app เราจะบันทึก ว่ามีการเรียกใช้ android create โดยใช้อาร์กิวเมนต์ --name แต่เราจะไม่ จัดเก็บค่า com.company.internal.app

หากต้องการปิดใช้การเก็บรวบรวมข้อมูล ให้ใช้แฟล็ก --no-metrics เมื่อเรียกใช้คำสั่งด้วย Android CLI

ความคิดเห็นและปัญหา

หากพบปัญหาหรือต้องการแสดงความคิดเห็น โปรดรายงานข้อบกพร่อง

ปัญหาที่ทราบแล้ว

  • ขณะนี้คำสั่ง android emulator สำหรับ Windows ปิดใช้อยู่
  • ขณะนี้ยังไม่รองรับการดาวน์โหลด Android CLI จาก Windows PowerShell

กำหนดค่า Android CLI

สร้างไฟล์ .androidrc เพื่อใช้ Flag และตัวเลือกโดยอัตโนมัติ ทุกครั้งที่คุณเรียกใช้ Android CLI บันทึกไฟล์ในตำแหน่งต่อไปนี้ โดยขึ้นอยู่กับระบบปฏิบัติการของคุณ

  • macOS และ Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

เพิ่มแฟล็กที่ต้องการใช้กับไฟล์โดยอัตโนมัติ โดยเพิ่ม 1 รายการต่อบรรทัด

เช่น หากต้องการให้ Android CLI ใช้ Android SDK ที่เฉพาะเจาะจงโดยค่าเริ่มต้นทุกครั้ง ให้เพิ่ม Flag --sdk ลงในไฟล์

--sdk=<path-to-sdk>

ตัวเลือกทั่วโลก

ซึ่งเป็นแฟล็กที่ไม่บังคับที่คุณใช้กับคำสั่ง Android CLI อื่นๆ ได้

-h, --help

การใช้งาน: android <command> -h

คำอธิบาย: แสดงคู่มือความช่วยเหลือสำหรับเครื่องมือหรือคำสั่งที่เฉพาะเจาะจง ที่เป็นปัญหา

ตัวอย่างเช่น

  • android -h
  • android create -h

--sdk

การใช้งาน: android --sdk=<path-to-sdk> <command>

คำอธิบาย: เส้นทางไปยัง Android SDK ที่คุณต้องการใช้สำหรับ คำสั่งที่ตามมา คุณสามารถใช้--sdkการตั้งค่าเพื่อลบล้าง Android SDK เริ่มต้นแทนการเปลี่ยนตัวแปรสภาพแวดล้อมส่วนกลางทุกครั้งที่ต้องการสลับ หากต้องการตรวจสอบว่าคุณใช้ Android SDK ใดโดยค่าเริ่มต้น ให้เรียกใช้ android info

ตัวอย่าง android --sdk=<path/to/sdk> sdk list

-v, --verbose

การใช้งาน: android -v <command>

คำอธิบาย: เปิดใช้เอาต์พุตแบบละเอียด ระบุตัวเลือก -v หลายรายการเพื่อ เพิ่มระดับการพูดรายละเอียด (เช่น -v, -vv หรือ -vvv)

-V, --version

การใช้งาน: android -V

คำอธิบาย: พิมพ์ข้อมูลเวอร์ชันและออก

คำสั่ง

ดูคำอธิบายทั้งหมดของคำสั่งและตัวเลือก CLI ของ Android ได้ที่ข้อมูลอ้างอิงคำสั่ง CLI ของ Android