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 di 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 di cui hai bisogno 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.

La CLI Android copre l'intero ciclo di vita dello sviluppo, dalla creazione di un progetto e dal test su un dispositivo alla profilazione delle prestazioni e all'analisi del suo comportamento sul campo. Ad esempio, un agente o uno script può utilizzare l'interfaccia a riga di comando per eseguire attività come le seguenti:

La CLI Android consente inoltre ai tuoi agenti di accedere 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 di CLI Android, consulta il Riferimento dei comandi di CLI Android.

Installa la CLI Android

Per installare la CLI Android, segui questi passaggi:

  1. Scarica l'interfaccia a riga di comando di Android.

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

    android update

Per verificare se la CLI Android è già installata sul tuo computer, esegui which android o command -v android: se viene restituito 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 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 corrispondono a un insieme fisso e predefinito di opzioni di sistema gestite dalla CLI Android. Ad esempio, raccogliamo i nomi dei template dell'emulatore, come medium_phone e large_desktop, e i nomi degli agenti, come GEMINI, CLAUDE o CODEX.
  • Analisi dello stack e messaggi di eccezione, in cui le informazioni identitarie vengono anonimizzate prima della raccolta per garantire la privacy.

Ecco alcuni esempi di dati che non raccogliamo:

  • Non raccogliamo le risposte dell'interfaccia a riga di comando quando viene eseguito un comando.
  • Non raccogliamo input creati dagli utenti o identificatori esterni passati alla CLI, 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 disabilitare la raccolta dei dati, utilizza il flag --no-metrics quando esegui un comando con la CLI Android.

Feedback e problemi

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

Configura la CLI Android

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

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

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

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

--sdk=<path-to-sdk>

Opzioni globali

Questi sono flag facoltativi che puoi utilizzare con altri comandi della CLI Android.

-h, --help

Utilizzo: android <command> -h

Descrizione: visualizza il manuale di assistenza 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 seguente. Puoi utilizzare l'impostazione --sdk per eseguire l'override temporaneo dell'SDK Android predefinito anziché modificare le variabili di ambiente globali ogni volta che vuoi cambiare. Per controllare quale SDK Android stai utilizzando per impostazione predefinita, esegui android info.

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

-v, --verbose

Utilizzo: android -v <command>

Descrizione: attiva 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 di CLI Android, consulta il Riferimento dei comandi di CLI Android.