Ringkasan Android CLI

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

Android CLI mencakup seluruh siklus proses pengembangan, mulai dari membuat project dan mengujinya di perangkat hingga membuat profil performanya dan menyelidiki perilakunya di lapangan. Misalnya, agen atau skrip dapat menggunakan CLI untuk melakukan tugas seperti berikut:

Android CLI juga memberi agen Anda akses ke Android skills dan Android Knowledge Base 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.

Menginstal 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 Android CLI sudah diinstal.

Penyiapan 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 subperintah android, misalnya android run dan android create.
  • Nama argumen atau opsi non-posisional yang digunakan, misalnya --sdk atau --version.
  • Argumen posisi dan nilai flag yang dipetakan ke kumpulan 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.
  • Pelacakan tumpukan dan pesan pengecualian, dengan informasi identitas pribadi dianonimkan sebelum pengumpulan untuk membantu memastikan privasi.

Berikut beberapa contoh data yang tidak kami kumpulkan:

  • Kami tidak mengumpulkan respons CLI saat perintah dijalankan.
  • Kami tidak mengumpulkan input yang dibuat 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 dijalankan, kami mencatat bahwa android create dijalankan menggunakan argumen --name, tetapi kami 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.

Mengonfigurasi Android CLI

Buat file .androidrc untuk otomatis menerapkan flag dan opsi 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 saat, tambahkan flag --sdk ke file Anda:

--sdk=<path-to-sdk>

Opsi global

Berikut 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 dimaksud.

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 berikut. 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: Mengaktifkan output panjang. Tentukan beberapa opsi -v untuk meningkatkan panjang respons (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.