avdmanager

O avdmanager é uma ferramenta de linha de comando que permite criar e gerenciar dispositivos virtuais Android (AVDs) na linha de comando. Um AVD permite definir as características de um celular Android, smartwatch Wear OS ou dispositivo Android TV que você quer simular no Android Emulator.

Se você estiver usando o Android Studio, não vai precisar usar essa ferramenta. Em vez disso, crie e gerencie AVDs no ambiente de desenvolvimento integrado.

A ferramenta avdmanager está incluída no pacote de ferramentas de linha de comando do SDK do Android em android_sdk/cmdline-tools/version/bin/avdmanager.

Sintaxe

Para usar avdmanager, use esta sintaxe:

avdmanager [global options] command [command options]

Opções globais

Tabela 1. Lista de opções globais para o avdmanager.

Opção global Descrição
-s | --silent Modo silencioso: somente os erros são mostrados.
-h | --help Ajuda para uso.
-v | --verbose Modo detalhado: erros, alertas e mensagens informativas são mostrados.
--clear cache Limpe o cache de manifesto do repositório do SDK Manager.

Comandos e opções de comando

Tabela 2. Lista de comandos e opções para o avdmanager.

Comando e opções Descrição
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

Cria um novo AVD. Forneça um name para o AVD e especifique o código do pacote SDK a ser usado para o AVD colocando sdk_id entre aspas. Por exemplo, o comando a seguir cria um AVD chamado test usando a imagem de sistema x86 para o nível de API 25:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
Confira a seguir a descrição do uso das outras opções:
  • -c {path|size}: o caminho para a imagem do cartão SD para este AVD ou o tamanho de uma nova imagem de cartão SD a ser criado para o AVD, em KB ou MB, indicado por K ou M. Por exemplo, -c path/to/sdcard/ ou -c 1000M.
  • -f: força a criação do AVD. Use esta opção se precisar substituir um AVD já existente por um novo usando o mesmo nome.
  • -p path: caminho para o local onde o diretório com os arquivos deste AVD será criado. Se você não especificar um caminho, o AVD será criado em ~/.android/avd/.
delete avd -n name Exclui um AVD. É necessário especificar o AVD com name.
move avd -n name [-p path] [-r new-name] Mover ou renomear um AVD. É necessário especificar o AVD com name. Veja a seguir a descrição do uso das outras opções.
  • -p path: o caminho absoluto para o local onde será criado o diretório para o qual os arquivos deste AVD serão movidos. Se você não incluir esse argumento, o AVD não será movido. Você poderá optar por não incluir este argumento se quiser renomear o AVD no local.
  • -r new-name: o novo nome do AVD sendo renomeado.
list [target|device|avd] [-c] Lista todos os destinos, definições de dispositivos ou AVDs disponíveis. Se você não especificar target, device ou avd, avdmanager vai listar os três. Inclua o argumento -c para receber uma saída compacta, adequada para scripts. O argumento -c não está disponível na listagem das três opções em conjunto.