lerchenflo/claudeskills

Spécialiste CLI Android

Cette compétence fournit des instructions pour utiliser l'outil CLI android. L'outil comprend diverses commandes pour créer des projets, exécuter des applications, interagir avec les appareils et gérer l'environnement CLI.

Installation

Si l'outil android n'est pas dans le PATH, installez-le. Pour l'installer, exécutez la commande suivante : Linux : curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash Mac Arm : curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash Mac Intel : curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash Windows : curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"

Gestion du SDK

Pour gérer l'installation des SDK Android et des outils, utilisez la commande sdk. Par exemple :

• android sdk install <package>[@<version>]... : Installe des packages spécifiques. Plusieurs packages peuvent être spécifiés, séparés par des espaces. <version> par défaut à la dernière version. Exemple : android sdk install platforms/android-30@2 platforms/android-34
• android sdk update [<pkg-name>] : Met à jour un package spécifique ou tous les packages vers la dernière version.
• android sdk remove <pkg-name> : Supprime un package du SDK local.
• android sdk list --all : Liste les packages SDK installés et disponibles.

Création de projet

Créez des projets à partir de modèles en utilisant la commande create.

Par exemple : android create empty-activity --name="My App" --output=./my-app

Interaction avec les appareils Android

Utilisez la commande android layout pour inspecter la disposition UI d'une application Android au format JSON. Utilisez la commande android screen pour inspecter visuellement l'interface utilisateur et obtenir les coordonnées des régions visuelles.

IMPORTANT : Avant d'utiliser android layout ou android screen, vous DEVEZ lire cette référence : interact.md Le fichier de référence interact.md contient des instructions pour interagir correctement avec les appareils Android. Suivez ses instructions exactement.

Exécution de tests de parcours

Les tests de parcours impliquent une interaction avec l'appareil ; utilisez les commandes android layout et android screen pour évaluer les parcours. Les instructions pour l'interaction avec l'appareil s'appliquent également ici.

IMPORTANT : Avant d'évaluer un parcours, vous DEVEZ lire cette référence : journeys.md Le fichier de référence journeys.md contient des instructions pour évaluer correctement un parcours Android. Suivez ses instructions exactement.

Recherche de documentation

La commande docs recherche une documentation développeur Android faisant autorité et de haute qualité dans la Base de Connaissances Android. En fournissant quelques mots-clés, cet outil retournera des articles de haute qualité contenant des exemples ou des conseils sur l'utilisation des API ou bibliothèques Android. Utilisez cet outil pour obtenir des informations supplémentaires sur la manière d'effectuer des tâches spécifiques à Android ou pour en savoir plus sur les API, surfaces, bibliothèques ou appareils Android.

Utilisez toujours cet outil pour obtenir les informations les plus récentes sur les concepts Android. Les cas d'utilisation typiques sont :

• Trouver des guides de migration pour les API.
• Trouver des exemples pour les API.
• Trouver des informations à jour sur les API Android.
• Trouver les meilleures pratiques pour les concepts Android.

Exécution d'APK

Utilisez la commande run pour exécuter des applications Android.

Gestion des émulateurs

Gérez les appareils virtuels Android (AVD) à l'aide de la commande android emulator

Capture d'écran

Capturez une image de l'écran actuel d'un appareil Android connecté et écrivez-la dans un fichier à l'aide de la commande android screen.

Gestion des compétences

Gérez les compétences de l'agent pour Android à l'aide de la commande android skills.

Mise à jour de la CLI

Mettez à jour la CLI Android à l'aide de la commande android update.

Sortie de android help

Usage : android [-Vhv] [--sdk=PARAM] [COMMAND] -h, --help Affiche le message d'aide pour cette commande --sdk=PARAM Chemin vers le SDK Android -v, --verbose Active la sortie détaillée pour le dépannage -V, --version Affiche les informations de version et quitte Commandes : completion Installe la configuration d'autocomplétion du shell pour la CLI Android dans le profil utilisateur actuel create Crée un nouveau projet Android à partir des modèles disponibles. Permet de spécifier le nom du projet, le répertoire de sortie, minSdk et l'exécution simulée describe Analyse un projet Android pour générer des métadonnées descriptives. Cette commande identifie et affiche les chemins vers les fichiers JSON qui détaillent la structure du projet, y compris les cibles de compilation et leurs emplacements d'artefacts de sortie correspondants (par exemple, APK). Ces informations permettent à d'autres outils et commandes de localiser efficacement les artefacts de compilation docs Commandes de documentation Android pour rechercher et récupérer la documentation développeur à partir de la base de connaissances officielle emulator Gère les appareils virtuels Android (AVD). Inclut des commandes pour démarrer, arrêter, lister et voir les détails des émulateurs help Affiche l'aide de toutes les commandes info Affiche les informations d'environnement, y compris l'emplacement du SDK, les appareils connectés et les variables de configuration. Utilisez des champs spécifiques pour restreindre la sortie init Initialise l'environnement pour la CLI Android. Configure les configurations, répertoires et compétences par défaut requis install Installe une application Android (un ou plusieurs APK) sur un appareil connecté ou un émulateur sans activer de composants, en utilisant des optimisations incrémentielles pour un déploiement plus rapide que adb layout Retourne l'arborescence de disposition d'une application run Compile, déploie et lance une application Android sur un appareil connecté ou un émulateur screen Commandes pour visualiser l'appareil sdk Gère l'installation du SDK Android. Inclut des commandes pour installer, mettre à jour, supprimer et lister les packages SDK disponibles et installés skills Gère les compétences de la CLI Android. Inclut des commandes pour installer, supprimer, lister et rechercher des compétences par mot-clé studio Commandes Android Studio update Met à jour la CLI Android vers la dernière version

completion

Usage : android completion [-h] [<shell>]
Installe la configuration d'autocomplétion du shell pour la CLI Android dans
le profil utilisateur actuel

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte

Paramètres positionnels :
  <shell>  Si fourni, affiche l'autocomplétion pour ce shell sans l'installer.
           Supporte : bash, zsh

create

Usage : android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM]
                       [--name=PARAM] [--namespace=PARAM] [--output=PARAM]
                       [<template-name>]
Crée un nouveau projet Android à partir des modèles disponibles. Permet de
spécifier le nom du projet, le répertoire de sortie, minSdk et l'exécution
simulée

Options :
      --application-id=PARAM  L'ID d'application pour l'application (par
                              exemple 'com.example.myapp')
  -h, --help                  Affiche le message d'aide pour cette commande
      --list                  Liste tous les modèles disponibles
      --min-sdk=PARAM         Le 'minSdk' supporté par l'application (par
                              défaut, défini dans le modèle)
      --name=PARAM            Le nom de l'application (par exemple 'My
                              Application')
      --namespace=PARAM       L'espace de noms pour les ressources et nom du
                              package pour les fichiers source Kotlin
  -o, --output=PARAM          Le chemin du répertoire du projet de destination
                              (par défaut '.')

Options android :
      --sdk=PARAM             Chemin vers le SDK Android
  -v, --verbose               Active la sortie détaillée pour le dépannage
  -V, --version               Affiche les informations de version et quitte

Paramètres positionnels :
  <template-name>  Le nom du modèle

describe

Usage : android describe [-h] [--project_dir=PARAM]
Analyse un projet Android pour générer des métadonnées descriptives. Cette
commande identifie et affiche les chemins vers les fichiers JSON qui
détaillent la structure du projet, y compris les cibles de compilation et
leurs emplacements d'artefacts de sortie correspondants (par exemple, APK).
Ces informations permettent à d'autres outils et commandes de localiser
efficacement les artefacts de compilation

Options :
  -h, --help               Affiche le message d'aide pour cette commande
      --project_dir=PARAM  Le répertoire du projet à décrire

Options android :
      --sdk=PARAM          Chemin vers le SDK Android
  -v, --verbose            Active la sortie détaillée pour le dépannage
  -V, --version            Affiche les informations de version et quitte

docs

Usage : android docs [-h] [COMMAND]
Commandes de documentation Android pour rechercher et récupérer la
documentation développeur à partir de la base de connaissances officielle

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte
Commandes :
  fetch   Récupère un article de documentation Android à partir d'une URL
          (kb://...)
  search  Recherche dans la documentation Android. Entourez les mots-clés de
          guillemets

emulator

Usage : android emulator [-h] [COMMAND]
Gère les appareils virtuels Android (AVD). Inclut des commandes pour
démarrer, arrêter, lister et voir les détails des émulateurs

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte
Commandes :
  create  Crée un appareil virtuel
  list    Liste les appareils virtuels disponibles
  remove  Supprime un appareil virtuel
  start   Lance l'appareil virtuel spécifié. Cette commande retournera
          lorsque l'émulateur sera complètement démarré et prêt à être utilisé
  stop    Arrête l'appareil virtuel spécifié

help

Usage : android help [-h] [COMMAND]
Affiche l'aide de toutes les commandes

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte

Paramètres positionnels :
  COMMAND  La commande pour laquelle afficher l'aide

info

Usage : android info [-h] [<field>]
Affiche les informations d'environnement, y compris l'emplacement du SDK,
les appareils connectés et les variables de configuration. Utilisez des champs
spécifiques pour restreindre la sortie

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte

Paramètres positionnels :
  <field>  Le champ spécifique dont afficher la valeur. Si omis, affiche tout

init

Usage : android init [-h]
Initialise l'environnement pour la CLI Android. Configure les configurations,
répertoires et compétences par défaut requis

Options :
  -h, --help       Affiche le message d'aide pour cette commande

Options android :
      --sdk=PARAM  Chemin vers le SDK Android
  -v, --verbose    Active la sortie détaillée pour le dépannage
  -V, --version    Affiche les informations de version et quitte

install

Usage : android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM]
                        [--use-delta-install]
Installe une application Android (un ou plusieurs APK) sur un appareil connecté
ou un émulateur sans activer de composants, en utilisant des optimisations
incrémentielles pour un déploiement plus rapide que adb

Options :
      --apks=PARAM             Les chemins vers les APK, séparés par des virgules
      --device=PARAM           Le numéro de série de l'appareil
  -h, --help                   Affiche le message d'aide pour cette commande
      --install-options=PARAM  Options/drapeaux supplémentaires à passer au
                               gestionnaire de packages pour l'installation (par
                               exemple -g,-d)
      --use-delta-install      Utiliser l'installation delta rapide (accélère les
                               mises à jour incrémentielles en transférant
                               uniquement le code et les ressources modifiés ;
                               défaut : true)

Options android :
      --sdk=PARAM              Chemin vers le SDK Android
  -v, --verbose                Active la sortie détaillée pour le dépannage
  -V, --version                Affiche les informations de version et quitte

Paramètres positionnels :
  <apk-path>...  Chemins vers les APK à installer

[Le contenu est tronqué pour la traduction]