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 incluemACTIVITY,WATCH_FACE,TILE,COMPLICATION,DECLARATIVE_WATCH_FACEeWEAR_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