execução do Android

Implanta e inicia um app Android em um dispositivo conectado ou emulador.

Uso

android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM] [--install-options=PARAM] [--type=PARAM] [--use-delta-install] [<apks_or_reference>] [-- <build_args>]

Opções

  • --activity=PARAM: o nome da atividade.
  • --apks=PARAM: os caminhos para os APKs, separados por vírgulas.
  • --debug: executa no modo de depuração.
  • --device=PARAM: o número de série do dispositivo.
  • -h,--help: mostra a mensagem de ajuda do comando especificado.
  • --install-options=PARAM: opções ou flags adicionais para transmitir à instalação do gerenciador de pacotes (por exemplo, -g, -d).
  • --type=PARAM: o tipo de componente (ACTIVITY, WATCH_FACE, TILE, COMPLICATION, DECLARATIVE_WATCH_FACE, WEAR_WIDGET).
  • --use-delta-install: usa a instalação delta rápida (acelera as atualizações incrementais transferindo apenas o código e os recursos modificados; padrão: true).

Opções de android:

  • --sdk=PARAM: caminho para o SDK do Android.
  • -v,--verbose: ativa a saída detalhada para solução de problemas.
  • -V,--version: imprime as informações da versão e sai.

Argumentos posicionais

  • <apks_or_reference>: caminhos de arquivo APK ou uma referência de build ([system://][path]?[target]).
  • -- <build_args>: argumentos transmitidos literalmente para o sistema de build. Use -- para separar de outros argumentos.

Descrição

O android run implanta um ou mais arquivos APK em um dispositivo ou emulador Android conectado e inicia imediatamente o componente do app de destino.

Transmita uma referência de build ([system://][path]?[target]) para criar e implantar a partir da origem ou transmita caminhos de arquivo APK pré-criados (em <apks_or_reference> ou com --apks).

Especificar o que executar (--type e --activity)

Por padrão, android run inicia a atividade principal padrão declarada no manifesto do app. É possível modificar o que é iniciado usando as seguintes opções:

  • --activity: especifica o nome da classe da atividade ou do componente a ser iniciado (obrigatório se o APK declarar várias atividades que podem ser iniciadas).
  • --type: especifica o tipo de componente a ser iniciado em vez de uma atividade de interface padrão. Os valores compatíveis incluem ACTIVITY, WATCH_FACE, TILE, COMPLICATION, DECLARATIVE_WATCH_FACE e WEAR_WIDGET.
  • --debug: inicia o app no modo de depuração e aguarda a conexão de um depurador do Android Studio ou de uma ferramenta de linha de comando.

Exemplos

Crie, implante e inicie a variante de depuração padrão de :app no espaço de trabalho atual do Gradle:

android run :app

Crie e execute a variante debug de :app (:app@debug) no espaço de trabalho do Gradle em $HOME/my-app, transmitindo argumentos extras para o Gradle:

android run $HOME/my-app?:app@debug -- --offline

Implante um único APK de depuração e inicie a atividade principal dele no dispositivo conectado padrão:

android run --apks=app/build/outputs/apk/debug/app-debug.apk

Implantar vários APKs divididos em um emulador específico:

android run --device=emulator-5554 --apks=base.apk,density-hdpi.apk,lang-en.apk

Implante um APK e inicie uma atividade específica no modo de depuração:

android run --debug --activity=.ui.MainActivity --apks=app-debug.apk