Panoramica della CLI Android

CLI Android è un'interfaccia a riga di comando che ti consente di creare per Android in modo più efficiente utilizzando qualsiasi strumento a tua scelta. Standardizza le competenze di sviluppo di base per i workflow incentrati sugli agenti, fornendo un punto di accesso agli strumenti, alle competenze e alle conoscenze ufficiali necessari per sviluppare in modo più efficace. Può anche semplificare l'integrazione continua, la manutenzione e qualsiasi altra automazione basata su script per la natura sempre più distribuita dello sviluppo Android.

Ad esempio, un agente o uno script può utilizzare la CLI per svolgere attività come le seguenti:

  • Automatizzare la configurazione dell'ambiente e dell'SDK Android
  • Strutturare nuovi progetti a partire dai modelli
  • Gestisci i dispositivi virtuali, installa APK e ispeziona le schermate e le gerarchie dell'interfaccia utente dei dispositivi live direttamente dal terminale
  • Connettiti alle istanze di Android Studio in esecuzione per l'analisi semantica del codice, il rendering dell'anteprima di Compose e le ricerche delle versioni delle dipendenze
  • Testare l'app con i percorsi

La CLI Android offre inoltre agli agenti l'accesso alle skill Android e alla knowledge base Android specializzata per garantire che i tuoi progetti applichino i pattern e le best practice consigliati per Android.

Per una descrizione completa dei comandi e delle opzioni della CLI Android, consulta il riferimento ai comandi della CLI Android.

Installa CLI Android

Per installare CLI Android, segui questi passaggi:

  1. Scarica la CLI Android.

  2. Per assicurarti di utilizzare l'ultima versione, aggiorna CLI Android:

    android update

Per verificare se la CLI Android è già installata sul tuo computer, esegui which android o command -v android: se restituisce un percorso, significa che è installata.

Configurazione per gli agenti

Per aiutare gli agenti a comprendere e utilizzare la CLI Android, esegui android init per installare la skill android-cli.

Dati raccolti

La CLI Android raccoglie dati sull'utilizzo di base dello strumento. Ecco i dati che raccogliamo:

  • Chiamate del comando android e dei relativi sottocomandi, ad esempio android run e android create.
  • Nomi di argomenti o opzioni non posizionali utilizzati, ad esempio --sdk o --version.
  • Argomenti posizionali e valori dei flag che vengono mappati a un insieme fisso e predefinito di opzioni di sistema gestite dalla CLI Android. Ad esempio, raccogliamo nomi di modelli di emulatore come medium_phone e large_desktop e nomi di agenti come GEMINI, CLAUDE o CODEX.
  • Stack trace e messaggi di eccezione, in cui le informazioni identificative vengono anonimizzate prima della raccolta per garantire la privacy.

Ecco alcuni esempi di dati che non raccogliamo:

  • Non raccogliamo le risposte della CLI quando viene eseguito un comando.
  • Non raccogliamo input creati dagli utenti o identificatori esterni passati all'interfaccia a riga di comando, come coordinate Maven specifiche, percorsi di file locali o nomi di progetti personalizzati. Ad esempio, se viene eseguito il comando android create --name=com.company.internal.app, registriamo che android create è stato eseguito utilizzando l'argomento --name, ma non memorizziamo il valore com.company.internal.app.

Per disattivare la raccolta dei dati, utilizza il flag --no-metrics quando esegui un comando con CLI Android.

Feedback e problemi

Se riscontri problemi o vuoi fornire un feedback, segnala un bug.

Problemi noti

  • Il comando android emulator per Windows è attualmente disabilitato.
  • Il download della CLI Android da Windows PowerShell non è attualmente supportato.

Configura la CLI Android

Crea un file .androidrc per applicare automaticamente flag e opzioni ogni volta che richiami Android CLI. Salva il file nella seguente posizione, a seconda del sistema operativo:

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

Aggiungi i flag da applicare automaticamente al file, uno per riga.

Ad esempio, per fare in modo che CLI Android utilizzi uno specifico SDK Android per impostazione predefinita ogni volta, aggiungi il flag --sdk al file:

--sdk=<path-to-sdk>

Opzioni globali

Si tratta di flag facoltativi che puoi utilizzare con altri comandi della CLI Android.

-h, --help

Utilizzo: android <command> -h

Descrizione: visualizza il manuale di aiuto per lo strumento o il comando specifico in questione.

Esempi:

  • android -h
  • android create -h

--sdk

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

Descrizione: il percorso dell'SDK Android che vuoi utilizzare per il comando successivo. Puoi utilizzare l'impostazione --sdk per ignorare temporaneamente l'SDK Android predefinito anziché modificare le variabili di ambiente globali ogni volta che vuoi cambiare. Per controllare quale SDK Android utilizzi per impostazione predefinita, esegui android info.

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

-v, --verbose

Utilizzo: android -v <command>

Descrizione: abilita l'output dettagliato. Specifica più opzioni -v per aumentare il livello di dettaglio (ad esempio, -v, -vv o -vvv).

-V, --version

Utilizzo: android -V

Descrizione:stampa le informazioni sulla versione ed esce.

Comandi

Per una descrizione completa dei comandi e delle opzioni della CLI Android, consulta il riferimento ai comandi della CLI Android.