Ringkasan Android CLI

Android CLI adalah antarmuka command line yang memungkinkan Anda membangun untuk Android secara lebih efisien menggunakan alat pilihan Anda. Hal ini menstandardisasi kompetensi pengembangan inti untuk alur kerja yang mengutamakan agen, sehingga memberikan titik entri ke alat, keterampilan, dan pengetahuan resmi yang Anda butuhkan untuk mengembangkan aplikasi secara lebih efektif. Hal ini juga dapat menyederhanakan CI, pemeliharaan, dan otomatisasi berbasis skrip lainnya untuk sifat pengembangan Android yang semakin terdistribusi.

Misalnya, agen atau skrip dapat menggunakan CLI untuk melakukan tugas seperti berikut:

  • Mengotomatiskan penyiapan lingkungan dan Android SDK
  • Buat project baru dari template
  • Mengelola perangkat virtual, menginstal APK, dan memeriksa layar perangkat aktif serta hierarki UI langsung dari terminal Anda
  • Menghubungkan ke instance Android Studio yang sedang berjalan untuk analisis kode semantik, rendering pratinjau Compose, dan pencarian versi dependensi
  • Menguji aplikasi Anda dengan Perjalanan

Android CLI juga memberi agen Anda akses ke keterampilan Android dan Pusat Informasi Android khusus untuk membantu memastikan bahwa project Anda menerapkan pola dan praktik terbaik yang direkomendasikan Android.

Untuk mengetahui deskripsi lengkap perintah dan opsi Android CLI, lihat referensi perintah Android CLI.

Instal Android CLI

Untuk menginstal Android CLI, ikuti langkah-langkah berikut:

  1. Download Android CLI.

  2. Untuk memastikan Anda menggunakan versi terbaru, update Android CLI:

    android update

Untuk memeriksa apakah Android CLI sudah diinstal di komputer Anda, jalankan which android atau command -v android: jika menampilkan jalur, berarti sudah diinstal.

Menyiapkan untuk agen

Untuk membantu agen memahami dan menggunakan Android CLI, jalankan android init untuk menginstal skill android-cli.

Data yang dikumpulkan

Android CLI mengumpulkan data tentang penggunaan dasar alat ini. Berikut data yang kami kumpulkan:

  • Pemanggilan perintah dan sub-perintah android, misalnya android run dan android create.
  • Nama argumen atau opsi non-posisional yang digunakan, misalnya --sdk atau --version.
  • Argumen posisi dan nilai tanda yang dipetakan ke serangkaian opsi sistem tetap yang telah ditentukan sebelumnya dan dikelola oleh Android CLI. Misalnya, kami mengumpulkan nama template emulator seperti medium_phone dan large_desktop, serta nama agen seperti GEMINI, CLAUDE, atau CODEX.
  • Stack trace dan pesan pengecualian, yang informasi identitas pribadi dianonimkan sebelum dikumpulkan untuk membantu memastikan privasi.

Berikut beberapa contoh data yang tidak kami kumpulkan:

  • Kami tidak mengumpulkan respons CLI saat perintah dijalankan.
  • Kami tidak mengumpulkan input buatan pengguna atau ID eksternal yang diteruskan ke CLI, seperti koordinat Maven tertentu, jalur file lokal, atau nama project kustom. Misalnya, jika perintah android create --name=com.company.internal.app dieksekusi, kita mencatat bahwa android create dieksekusi menggunakan argumen --name, tetapi kita tidak menyimpan nilai com.company.internal.app.

Untuk menonaktifkan pengumpulan data, gunakan flag --no-metrics saat menjalankan perintah dengan Android CLI.

Masukan dan masalah

Jika Anda mengalami masalah atau ingin memberikan masukan, laporkan bug.

Masalah umum

  • Perintah android emulator untuk Windows saat ini dinonaktifkan.
  • Mendownload Android CLI dari Windows PowerShell saat ini tidak didukung.

Mengonfigurasi Android CLI

Buat file .androidrc untuk menerapkan flag dan opsi secara otomatis setiap kali Anda memanggil Android CLI. Simpan file di lokasi berikut, bergantung pada sistem operasi Anda:

  • macOS dan Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

Tambahkan tanda yang ingin Anda terapkan secara otomatis ke file, satu per baris.

Misalnya, agar Android CLI menggunakan Android SDK tertentu secara default setiap kali, tambahkan flag --sdk ke file Anda:

--sdk=<path-to-sdk>

Opsi global

Ini adalah flag opsional yang dapat Anda gunakan dengan perintah Android CLI lainnya.

-h, --help

Penggunaan: android <command> -h

Deskripsi: Menampilkan panduan bantuan untuk alat atau perintah tertentu yang sedang dibahas.

Contoh:

  • android -h
  • android create -h

--sdk

Penggunaan: android --sdk=<path-to-sdk> <command>

Deskripsi: Jalur ke Android SDK yang ingin Anda gunakan untuk perintah berikutnya. Anda dapat menggunakan setelan --sdk untuk mengganti sementara Android SDK default, bukan mengubah variabel lingkungan global setiap kali Anda ingin beralih. Untuk memeriksa Android SDK yang Anda gunakan secara default, jalankan android info.

Contoh: android --sdk=<path/to/sdk> sdk list

-v, --verbose

Penggunaan: android -v <command>

Deskripsi: Aktifkan output panjang. Tentukan beberapa opsi -v untuk meningkatkan kejelasan (misalnya, -v, -vv, atau -vvv).

-V, --version

Penggunaan: android -V

Deskripsi: Mencetak informasi versi dan keluar.

Perintah

Untuk mengetahui deskripsi lengkap perintah dan opsi Android CLI, lihat referensi perintah Android CLI.