Communitygithub.com

lerchenflo/claudeskills

Fornece instruções para instalar e usar o CLI `android`. A ferramenta de linha de comando `android` é uma ferramenta essencial para desenvolvimento Android e ajuda a criar novos projetos Android, executar aplicativos Android em dispositivos, gerenciar e interagir com dispositivos virtuais Android (incluindo capturas de tela e inspeção de IU), gerenciar componentes do SDK Android, consultar documentação oficial do Android e descobrir e instalar habilidades oficiais do Android.

O que é claudeskills?

Esta habilidade transforma um agente de IA em um especialista em desenvolvimento Android, fornecendo acesso completo ao CLI `android`. Ela abrange todas as tarefas essenciais: criação de projetos a partir de modelos, gerenciamento do SDK (instalar, atualizar, remover e listar pacotes), execução de aplicativos em dispositivos conectados ou emuladores, inspeção da IU usando os comandos `layout` e `screen`, captura de tela de dispositivos e gerenciamento de Dispositivos Virtuais Android (AVDs) com o subcomando `emulator`. A habilidade também inclui busca de documentação oficial do Android através do comando `docs`, instalação e gerenciamento de habilidades do agente (`skills`) e configuração do ambiente com `init`. É útil para desenvolvedores Android que desejam automatizar tarefas de desenvolvimento, teste e implantação diretamente de um agente de IA, com suporte para plataformas Linux, macOS (Intel e Apple Silicon) e Windows.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lerchenflo/claudeskills/tree/HEAD/android/android-cli

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Especialista em CLI Android

Esta habilidade fornece instruções para usar a ferramenta de CLI android. A ferramenta inclui vários comandos para criar projetos, executar aplicativos, interagir com dispositivos e gerenciar o ambiente da CLI.

Instalação

Se a ferramenta android não estiver no PATH, instale-a. Para instalar, execute o seguinte comando: 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"

Gerenciamento do SDK

Para gerenciar a instalação de SDKs e ferramentas Android, use o comando sdk. Por exemplo:

  • android sdk install <package>[@<version>]...: Instalar pacotes específicos. Vários pacotes podem ser especificados, separados por espaços. <version> assume o padrão da versão mais recente. Por exemplo: android sdk install platforms/android-30@2 platforms/android-34
  • android sdk update [<pkg-name>]: Atualizar um pacote específico ou todos os pacotes para a versão mais recente.
  • android sdk remove <pkg-name>: Remover um pacote do SDK local.
  • android sdk list --all: Listar pacotes do SDK instalados e disponíveis.

Criação de projetos

Crie projetos a partir de modelos usando o comando create.

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

Interagindo com dispositivos Android

Use o comando android layout para inspecionar o layout da IU de um aplicativo Android no formato JSON. Use o comando android screen para inspecionar visualmente a IU e obter coordenadas delimitadoras para regiões visuais.

IMPORTANTE: Antes de usar android layout ou android screen, você DEVE ler esta referência: interact.md O arquivo de referência interact.md contém instruções para interagir corretamente com dispositivos Android. Siga suas instruções exatamente.

Executando testes de jornada

Testes de jornada envolvem interação com o dispositivo; use os comandos android layout e android screen para avaliar Jornadas. As instruções para interação com dispositivos também se aplicam aqui.

IMPORTANTE: Antes de avaliar uma jornada, você DEVE ler esta referência: journeys.md O arquivo de referência journeys.md contém instruções para avaliar corretamente uma jornada Android. Siga suas instruções exatamente.

Pesquisa de documentação

O comando docs pesquisa documentação oficial de desenvolvedor Android de alta qualidade na Base de Conhecimento Android. Ao fornecer algumas palavras-chave, esta ferramenta retornará artigos de alta qualidade que contêm exemplos ou orientações sobre como usar APIs ou bibliotecas Android. Use esta ferramenta para obter informações adicionais sobre como realizar tarefas específicas do Android ou para saber mais sobre APIs, superfícies, bibliotecas ou dispositivos Android.

Sempre use esta ferramenta para obter as informações mais atualizadas sobre conceitos Android. Casos de uso típicos e bons são:

  • Encontrar guias de migração para APIs.
  • Encontrar exemplos para APIs.
  • Encontrar informações atualizadas sobre APIs Android.
  • Encontrar melhores práticas para conceitos Android.

Executando APKs

Use o comando run para executar aplicativos Android.

Gerenciando emuladores

Gerencie Dispositivos Virtuais Android (AVDs) usando o comando android emulator.

Capturando capturas de tela

Capture uma imagem da tela atual de um dispositivo Android conectado e a envie para um arquivo usando o comando android screen.

Gerenciando habilidades

Gerencie habilidades do agente para Android usando o comando android skills.

Atualizando a CLI

Atualize a CLI Android usando o comando android update.

Saída de android help

Uso: android [-Vhv] [--sdk=PARAM] [COMANDO] -h, --help Mostra a mensagem de ajuda para este comando --sdk=PARAM Caminho para o SDK Android -v, --verbose Ativa saída detalhada para solução de problemas -V, --version Imprime informações da versão e sai Comandos: completion Instala a configuração de autocomplete do shell para a CLI Android no perfil de usuário atual create Crie um novo projeto Android a partir de modelos disponíveis. Permite especificar nome do projeto, diretório de saída, minSdk e execução de teste (dry-run) describe Analisa um projeto Android para gerar metadados descritivos. Este comando identifica e gera os caminhos para arquivos JSON que detalham a estrutura do projeto, incluindo alvos de compilação e suas localizações correspondentes de artefatos de saída (ex.: APKs). Essas informações permitem que outras ferramentas e comandos localizem artefatos de compilação de forma eficiente docs Comandos de documentação Android para pesquisar e buscar documentação do desenvolvedor na base de conhecimento oficial emulator Gerencia Dispositivos Virtuais Android (AVDs). Inclui comandos para iniciar, parar, listar e ver detalhes sobre emuladores help Mostra a ajuda de todos os comandos info Imprime informações do ambiente, incluindo localização do SDK, dispositivos conectados e variáveis de configuração. Use campos específicos para limitar a saída init Inicializa o ambiente para a CLI Android. Configura as configurações, diretórios e habilidades padrão necessários install Instala um Aplicativo Android (um ou mais APKs) em um dispositivo ou emulador conectado sem ativar nenhum componente, usando otimizações incrementais para implantação mais rápida que adb layout Retorna a árvore de layout de um aplicativo run Compila, implanta e inicia um aplicativo Android em um dispositivo ou emulador conectado screen Comandos para visualizar o dispositivo sdk Gerencia a instalação do SDK Android. Inclui comandos para instalar, atualizar, remover e listar pacotes do SDK disponíveis e instalados skills Gerencia habilidades da CLI Android. Inclui comandos para instalar, remover, listar e pesquisar habilidades por palavra-chave studio Comandos do Android Studio update Atualiza a CLI Android para a versão mais recente

completion Uso: android completion [-h] [] Instala a configuração de autocomplete do shell para a CLI Android no perfil de usuário atual

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai
      
      Parâmetros posicionais:
        <shell>  Se fornecido, imprime o complemento do shell fornecido sem
                 instalar. Suportado: bash, zsh

create Uso: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [] Crie um novo projeto Android a partir de modelos disponíveis. Permite especificar nome do projeto, diretório de saída, minSdk e execução de teste (dry-run)

      Opções:
            --application-id=PARAM  O ID do aplicativo para o aplicativo
                                    (ex.: 'com.example.myapp')
        -h, --help                  Mostra a mensagem de ajuda para este comando
            --list                  Lista todos os modelos disponíveis
            --min-sdk=PARAM         O 'minSdk' compatível com o
                                    aplicativo (o padrão é definido no
                                    modelo)
            --name=PARAM            O nome do aplicativo (ex.: 'My
                                    Application')
            --namespace=PARAM       O namespace para recursos e nome do pacote
                                    para arquivos de origem Kotlin
        -o, --output=PARAM          O caminho do diretório do projeto de destino
                                    (o padrão é '.')
      
      opções android:
            --sdk=PARAM             Caminho para o SDK Android
        -v, --verbose               Ativa saída detalhada para
                                    solução de problemas
        -V, --version               Imprime informações da versão e sai
      
      Parâmetros posicionais:
        <nome-do-modelo>  O nome do modelo

describe Uso: android describe [-h] [--project_dir=PARAM] Analisa um projeto Android para gerar metadados descritivos. Este comando identifica e gera os caminhos para arquivos JSON que detalham a estrutura do projeto, incluindo alvos de compilação e suas localizações correspondentes de artefatos de saída (ex.: APKs). Essas informações permitem que outras ferramentas e comandos localizem artefatos de compilação de forma eficiente

      Opções:
        -h, --help               Mostra a mensagem de ajuda para este comando
            --project_dir=PARAM  O diretório do projeto a ser descrito
      
      opções android:
            --sdk=PARAM          Caminho para o SDK Android
        -v, --verbose            Ativa saída detalhada para solução de
                                 problemas
        -V, --version            Imprime informações da versão e sai

docs Uso: android docs [-h] [COMANDO] Comandos de documentação Android para pesquisar e buscar documentação do desenvolvedor na base de conhecimento oficial

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai
      Comandos:
        fetch   Busca um artigo de documentação Android de uma URL (kb://...)
        search  Pesquisa documentação Android. Coloque as palavras-chave entre
                aspas

emulator Uso: android emulator [-h] [COMANDO] Gerencia Dispositivos Virtuais Android (AVDs). Inclui comandos para iniciar, parar, listar e ver detalhes sobre emuladores

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai
      Comandos:
        create  Cria um dispositivo virtual
        list    Lista dispositivos virtuais disponíveis
        remove  Exclui um dispositivo virtual
        start   Inicia o dispositivo virtual especificado. Este comando
                retornará quando o emulador estiver totalmente iniciado e
                pronto para uso
        stop    Para o dispositivo virtual especificado

help Uso: android help [-h] [COMANDO] Mostra a ajuda de todos os comandos

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai
      
      Parâmetros posicionais:
        COMANDO  O comando para o qual mostrar ajuda

info Uso: android info [-h] [] Imprime informações do ambiente, incluindo localização do SDK, dispositivos conectados e variáveis de configuração. Use campos específicos para limitar a saída

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai
      
      Parâmetros posicionais:
        <campo>  O campo específico para imprimir o valor. Se omitido,
                 imprime tudo

init Uso: android init [-h] Inicializa o ambiente para a CLI Android. Configura as configurações, diretórios e habilidades padrão necessários

      Opções:
        -h, --help       Mostra a mensagem de ajuda para este comando
      
      opções android:
            --sdk=PARAM  Caminho para o SDK Android
        -v, --verbose    Ativa saída detalhada para solução de problemas
        -V, --version    Imprime informações da versão e sai

install Uso: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM] [--use-delta-install] Instala um Aplicativo Android (um ou mais APKs) em um dispositivo ou emulador conectado sem ativar nenhum componente, usando otimizações incrementais para implantação mais rápida que adb

      Opções:
            --apks=PARAM             Os caminhos para os APKs, separados por vírgula
            --device=PARAM           O número de série do dispositivo
        -h, --help                   Mostra a mensagem de ajuda para este comando
            --install-options=PARAM  Opções/indicadores adicionais para
                                     passar para a instalação do gerenciador de
                                     pacotes (ex.: -g,-d)
            --use-delta-install      Usa instalação delta rápida (acelera
                                     atualizações incrementais transferindo apenas
                                     código e recursos modificados; padrão: true)
      
      opções android:
            --sdk=PARAM              Caminho para o SDK Android
        -v, --verbose                Ativa saída detalhada para
                                     solução de problemas
        -V, --version                Imprime informações da versão e sai
      
      Parâmetros posicionais:
        <apk>  Os caminhos para os APKs

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas