ภาพรวมของ Android CLI

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

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

• สภาพแวดล้อมอัตโนมัติและการตั้งค่า Android SDK
• สร้างโครงสร้างโปรเจ็กต์ใหม่จากเทมเพลต
• สร้าง ติดตั้ง และเรียกใช้แอปในอุปกรณ์หรือโปรแกรมจำลองที่เชื่อมต่อ
• จัดการอุปกรณ์เสมือนจริง มิเรอร์และควบคุมอุปกรณ์ที่เชื่อมต่อในหน้าต่างเดสก์ท็อป รวมถึงตรวจสอบและโต้ตอบกับหน้าจออุปกรณ์แบบเรียลไทม์และลำดับชั้น UI ได้โดยตรงจากเทอร์มินัลของคุณ
• แสดงผลตัวอย่าง Jetpack Compose เป็นรูปภาพในเครื่อง โดยไม่ต้องใช้อุปกรณ์หรือ Android Studio
• เชื่อมต่อกับอินสแตนซ์ Android Studio ที่ทำงานอยู่เพื่อการวิเคราะห์โค้ดเชิงความหมาย การแสดงผลตัวอย่าง Compose และการค้นหาเวอร์ชันทรัพยากร Dependency
• ทดสอบแอปด้วย Journeys
• สร้างโปรไฟล์แอปโดยบันทึกการติดตามของระบบและบันทึกฮีปดัมป์ในอุปกรณ์ที่เชื่อมต่อหรือโปรแกรมจำลอง
• วิเคราะห์ APK, App Bundle และไลบรารีเพื่อรายงานขนาด, เมตริกการลดขนาดและการเพิ่มประสิทธิภาพ R8 รวมถึงคำเตือนเกี่ยวกับกฎการเก็บรักษา
• ตรวจสอบข้อขัดข้อง, ANR และปัญหาที่ไม่ร้ายแรงที่ Firebase Crashlytics รายงานสำหรับแอปของคุณในภาคสนาม รวมถึงฮีปดัมป์ที่ Crashlytics รวบรวมเกี่ยวกับข้อขัดข้องที่เกิดจากหน่วยความจำไม่เพียงพอ

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

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

ติดตั้ง Android CLI

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

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

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

   android update
   

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

ตั้งค่าสำหรับ Agent

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

android init

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

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

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

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

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

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

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

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

กำหนดค่า Android CLI

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

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

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

เช่น หากต้องการให้ Android CLI ใช้ Android SDK ที่เฉพาะเจาะจงโดยค่าเริ่มต้นทุกครั้ง ให้เพิ่มแฟล็ก --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

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

คำสั่ง

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