Présentation de l'interface de ligne de commande Android

L'interface de ligne de commande Android vous permet de développer plus efficacement pour Android à l'aide de l'outil de votre choix. Il standardise les compétences de développement de base pour les workflows axés sur les agents, en fournissant un point d'entrée vers les outils, les compétences et les connaissances officielles dont vous avez besoin pour développer plus efficacement. Il peut également simplifier l'intégration continue, la maintenance et toute autre automatisation scriptée pour la nature de plus en plus distribuée du développement Android.

Par exemple, un agent ou un script peut utiliser la CLI pour effectuer des tâches telles que les suivantes :

  • Automatiser la configuration de l'environnement et du SDK Android
  • Créer des projets à partir de modèles
  • Gérez les appareils virtuels, installez des APK et inspectez les écrans et les hiérarchies d'UI des appareils en direct directement depuis votre terminal.
  • Se connecter aux instances Android Studio en cours d'exécution pour l'analyse sémantique du code, le rendu de l'aperçu Compose et les recherches de versions de dépendances
  • Tester votre application avec Parcours

L'interface de ligne de commande Android donne également accès à vos agents aux compétences Android et à la base de connaissances Android spécialisée pour vous aider à vous assurer que vos projets appliquent les modèles et les bonnes pratiques recommandés par Android.

Pour obtenir une description complète des commandes et des options de l'interface de ligne de commande Android, consultez la documentation de référence sur les commandes de l'interface de ligne de commande Android.

Installer Android CLI

Pour installer Android CLI, procédez comme suit :

  1. Téléchargez Android CLI.

  2. Pour vous assurer d'utiliser la dernière version, mettez à jour Android CLI :

    android update

Pour vérifier si Android CLI est déjà installé sur votre machine, exécutez which android ou command -v android. Si un chemin d'accès est renvoyé, cela signifie qu'il est installé.

Configurer pour les agents

Pour aider les agents à comprendre et à utiliser la CLI Android, exécutez android init pour installer la compétence android-cli.

Données recueillies

L'interface de ligne de commande Android collecte des données sur l'utilisation de base de l'outil. Voici les données que nous collectons :

  • Appels de la commande android et des sous-commandes, par exemple android run et android create.
  • Noms des arguments ou options non positionnels utilisés, par exemple --sdk ou --version.
  • Arguments de position et valeurs d'indicateur qui correspondent à un ensemble fixe et prédéfini d'options système gérées par l'interface de ligne de commande Android. Par exemple, nous collectons les noms de modèles d'émulateur tels que medium_phone et large_desktop, ainsi que les noms d'agents tels que GEMINI, CLAUDE ou CODEX.
  • Traces de pile et messages d'exception, où les informations d'identification sont anonymisées avant la collecte pour garantir la confidentialité.

Voici quelques exemples de données que nous ne collectons pas :

  • Nous ne collectons pas les réponses de la CLI lorsqu'une commande est exécutée.
  • Nous ne collectons pas les entrées créées par les utilisateurs ni les identifiants externes transmis à la CLI, tels que les coordonnées Maven spécifiques, les chemins d'accès aux fichiers locaux ou les noms de projets personnalisés. Par exemple, si la commande android create --name=com.company.internal.app est exécutée, nous enregistrons que android create a été exécuté à l'aide de l'argument --name, mais nous ne stockons pas la valeur com.company.internal.app.

Pour désactiver la collecte de données, utilisez l'option --no-metrics lorsque vous exécutez une commande avec Android CLI.

Commentaires et problèmes

Si vous rencontrez des problèmes ou si vous souhaitez nous faire part de vos commentaires, signalez un bug.

Problèmes connus

  • La commande android emulator pour Windows est actuellement désactivée.
  • Le téléchargement de la CLI Android depuis Windows PowerShell n'est actuellement pas pris en charge.

Configurer l'interface de ligne de commande Android

Créez un fichier .androidrc pour appliquer automatiquement des indicateurs et des options chaque fois que vous appelez la CLI Android. Enregistrez le fichier à l'emplacement suivant, en fonction de votre système d'exploitation :

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

Ajoutez les indicateurs que vous souhaitez appliquer automatiquement au fichier, un par ligne.

Par exemple, pour que la CLI Android utilise un SDK Android spécifique par défaut à chaque fois, ajoutez l'option --sdk à votre fichier :

--sdk=<path-to-sdk>

Options globales

Il s'agit d'options facultatives que vous pouvez utiliser avec d'autres commandes Android CLI.

-h, --help

Utilisation : android <command> -h

Description : affiche le manuel d'aide de l'outil ou de la commande spécifique en question.

Exemples :

  • android -h
  • android create -h

--sdk

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

Description : chemin d'accès au SDK Android que vous souhaitez utiliser pour la commande suivante. Vous pouvez utiliser le paramètre --sdk pour remplacer temporairement le SDK Android par défaut au lieu de modifier vos variables d'environnement globales chaque fois que vous souhaitez changer de SDK. Pour vérifier quel SDK Android vous utilisez par défaut, exécutez android info.

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

-v, --verbose

Utilisation : android -v <command>

Description : active la sortie détaillée. Spécifiez plusieurs options -v pour augmenter la verbosité (par exemple, -v, -vv ou -vvv).

-V, --version

Utilisation : android -V

Description : imprimez les informations sur la version et quittez.

Commandes

Pour obtenir une description complète des commandes et des options de l'interface de ligne de commande Android, consultez la documentation de référence sur les commandes de l'interface de ligne de commande Android.