avdmanager
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
|
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# avdmanager\n\nThe `avdmanager` is a command-line tool that lets you create and manage\nAndroid Virtual Devices (AVDs) from the command line. An AVD lets you define the\ncharacteristics of an Android handset, Wear OS watch, or Android TV device\nthat you want to simulate in the Android Emulator.\n\nIf you're using Android Studio, then you don't need to use this tool and you\ncan instead\n[create and manage AVDs from the IDE](/studio/run/managing-avds).\n\nThe `avdmanager` tool is included in the Android SDK Command-Line Tools package\nat\n\u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/cmdline-tools/`\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e`/bin/avdmanager`.\n\nSyntax\n------\n\nTo use `avdmanager`, use the following syntax: \n\n```\navdmanager [global options] command [command options]\n```\n\n### Global options\n\n**Table 1.** List of global options for\navdmanager.\n\n| Global option | Description |\n|---------------------|-------------------------------------------------------------------------|\n| `-s` \\| `--silent` | Silent mode: only errors are printed out. |\n| `-h` \\| `--help` | Usage help. |\n| `-v` \\| `--verbose` | Verbose mode: errors, warnings, and informational messages are printed. |\n| `--clear cache` | Clear the SDK Manager repository manifest cache. |\n\n### Commands and command options\n\n**Table 2.** List of commands and options\nfor avdmanager.\n\n| Command and options | Description |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `create avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e` -k \"`\u003cvar translate=\"no\"\u003esdk_id\u003c/var\u003e`\" [-c {`\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`|`\u003cvar translate=\"no\"\u003esize\u003c/var\u003e`}] [-f] [-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`]` | Create a new AVD. You must provide a \u003cvar translate=\"no\"\u003ename\u003c/var\u003e for the AVD and specify the ID of the SDK package to use for the AVD using \u003cvar translate=\"no\"\u003esdk_id\u003c/var\u003e wrapped in quotes. For example, the following command creates an AVD named `test` using the x86 system image for API level 25: ``` avdmanager create avd -n test -k \"system-images;android-25;google_apis;x86\" ``` The following describes the usages for the other options: - `-c {`\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`|`\u003cvar translate=\"no\"\u003esize\u003c/var\u003e`}`: The path to the SD card image for this AVD or the size of a new SD card image to create for this AVD in KB or MB, denoted with `K` or `M`. For example, `-c path/to/sdcard/` or `-c 1000M`. - `-f`: Force creation of the AVD. Use this option if you need to overwrite an existing AVD with a new AVD using the same name. - `-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e: Path to the location where the directory for this AVD's files will be created. If you don't specify a path, the AVD is created in `~/.android/avd/`. |\n| `delete avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e | Delete an AVD. You must specify the AVD with \u003cvar translate=\"no\"\u003ename\u003c/var\u003e. |\n| `move avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e` [-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`] [-r `\u003cvar translate=\"no\"\u003enew-name\u003c/var\u003e`]` | Move or rename an AVD. You must specify the AVD with \u003cvar translate=\"no\"\u003ename\u003c/var\u003e. The following describes the usages for the other options: - `-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e: The absolute path to the location at which to create the directory where this AVD's files will be moved. If you don't include this argument, the AVD won't be moved. You might choose not to include this argument if you want to rename the AVD in place. - `-r `\u003cvar translate=\"no\"\u003enew-name\u003c/var\u003e: The new name of the AVD being renamed. |\n| `list [target|device|avd] [-c]` | List all available targets, device definitions, or AVDs. If you don't specify `target`, `device`, or `avd`, `avdmanager` lists all three. Include the `-c` argument to receive a compact output suitable for scripts. The `-c` argument is not available when listing all three options together. |"]]
