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

La CLI Android est une interface de ligne de commande qui vous permet de créer des applications pour Android plus efficacement à l'aide de l'outil de votre choix. Elle standardise les compétences de développement de base pour les workflows axés sur les agents, et fournit un point d'entrée vers les outils, les compétences et les connaissances officiels dont vous avez besoin pour développer plus efficacement. Il peut également simplifier l'intégration continue, la maintenance et toute autre automatisation par script pour la nature de plus en plus distribuée du développement Android.

La CLI Android couvre l'intégralité du cycle de développement, de la création d'un projet et de son test sur un appareil au profilage de ses performances et à l'analyse de son comportement sur le terrain. Par exemple, un agent ou un script peut utiliser la CLI pour effectuer des tâches telles que les suivantes :

La CLI Android permet également à vos agents d'accéder aux compétences Android et à la base de connaissances Android spécialisée pour s'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 la CLI Android, consultez la documentation de référence sur les commandes de la CLI Android.

Installer la CLI Android

Pour installer la CLI Android, procédez comme suit :

  1. Téléchargez la CLI Android.

  2. Pour vous assurer que vous utilisez la dernière version, mettez à jour la CLI Android :

    android update

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

Configuration 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

La CLI 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 positionnels et valeurs d'option qui correspondent à un ensemble fixe et prédéfini d'options système gérées par la CLI Android. Par exemple, nous collectons les noms des 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 la pile et messages d'exception, où les informations permettant d'identifier l'utilisateur 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 l'utilisateur 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 la CLI Android.

Commentaires et problèmes

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

Configurer la CLI Android

Créez un fichier .androidrc pour appliquer automatiquement des options et des indicateurs 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 options que vous souhaitez appliquer automatiquement au fichier, à raison d'une 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 de la CLI Android.

-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 le SDK Android que 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 le niveau de détail (par exemple, -v, -vv ou -vvv).

-V, --version

Utilisation : android -V

Description : imprime les informations sur la version, puis quitte.

Commandes

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