Voltar ao blog

É seguro apagar a pasta ~/.android/avd no Mac?

O que ~/.android/avd guarda, qual arquivo deixa um emulador Android grande, o que você perde ao apagá-la e como zerar ou remover um dispositivo virtual.

Publicado 25 de outubro de 2026 Autor Vladimir Chemeris Tempo de leitura 4 min de leitura
AndroidEmuladorDeveloper Cleanup

Apagar ~/.android/avd remove todos os emuladores Android do seu Mac, com os apps, as contas e os snapshots de cada um. O Mac não se importa, e o Android Studio pode criar dispositivos novos. Os dados dos antigos não voltam. Quando um emulador cresceu demais, zere os dados dele ou apague só aquele dispositivo pelo Android Studio, e deixe a pasta por conta das ferramentas.

Regra principal: zere os dispositivos que você ainda usa, apague os que não usa e só mexa na pasta à mão para dispositivos que o Android Studio não lista mais.

Resposta rápida

  1. Meça com du -sh ~/.android/avd/*.
  2. Liste os dispositivos com ~/Library/Android/sdk/emulator/emulator -list-avds.
  3. Zere um dispositivo que você ainda usa: Device Manager, Wipe Data.
  4. Apague um dispositivo de que não precisa mais: Device Manager, Delete.
  5. Remova à parte as imagens do sistema sem uso, no SDK Manager.
  6. Apague à mão só as sobras, e remova NAME.avd e NAME.ini juntos.

O que fica em ~/.android/avd

Cada dispositivo virtual são dois itens: um arquivo NAME.ini e a pasta NAME.avd para a qual ele aponta. Medi a minha pasta em 25 de outubro de 2026. Ela tinha um dispositivo, o perfil Medium Phone na API 37 com a imagem do Google Play, e ocupava 2,8 GB:

Dentro de NAME.avdO que guardaNo meu Mac
userdata-qemu.img.qcow2a partição de dados: apps instalados, os dados deles, contas2,2 GB
sdcard.imgo cartão SD emulado512 MB
encryptionkey.img e .qcow2a imagem da chave de criptografia do dispositivo94 MB
snapshotssnapshots do Quick Boot, quando o emulador os salvanenhum
config.inio perfil de hardware e o caminho para a imagem do sistemaalguns KB

A partição de dados cresce conforme você instala e usa apps. O config.ini deste dispositivo define disk.dataPartition.size=10G, então esse único arquivo pode chegar a 10 GB.

O que não fica nesta pasta

O sistema Android em si fica no SDK, não na pasta do AVD. O config.ini aponta para ele com uma linha como image.sysdir.1=system-images/android-37.0/google_apis_playstore/arm64-v8a/. No meu Mac, ~/Library/Android/sdk/system-images ocupava mais 2,7 GB, os binários do emulador 1,2 GB e o NDK 2,1 GB.

Essa separação tem duas consequências:

  • Apagar um dispositivo não libera a imagem do sistema dele. Vários dispositivos podem compartilhar uma mesma imagem.
  • Apagar uma imagem do sistema deixa os dispositivos que a usam sem conseguir iniciar até você instalar a imagem de novo.

O SDK Manager do Android Studio lista as imagens instaladas e remove as que você não usa.

Zerar ou apagar

O Wipe Data restaura o dispositivo ao estado de fábrica e mantém a definição dele. A partição de dados volta a encolher, e você faz login e instala seus apps de teste de novo. No Device Manager, a opção fica no menu do dispositivo. Pelo terminal, inicie o dispositivo uma vez com a flag:

~/Library/Android/sdk/emulator/emulator -avd Medium_Phone_API_37.0 -wipe-data

A ajuda do emulador descreve -wipe-data como “reset the user data image (copy it from initdata)” (redefine a imagem de dados do usuário, copiando-a de initdata).

O Delete remove o dispositivo e os arquivos dele. Use para dispositivos que você criou para um teste e esqueceu.

Os snapshots pesam quando o Quick Boot salva estados grandes. A flag -no-snapshot-save inicia o emulador sem salvar um snapshot ao sair, e a pasta snapshots do dispositivo mostra o que as sessões anteriores deixaram.

Apagar à mão

Apagar à mão faz sentido para sobras: dispositivos de um Android Studio que você já removeu, ou dispositivos que apontam para imagens do sistema que você apagou. Remova tanto a pasta NAME.avd quanto o arquivo NAME.ini dela, já que o .ini só existe para apontar para a pasta.

Não aproveite para limpar a pasta ~/.android inteira. Ela também guarda:

  • debug.keystore, a chave que assina seus builds de debug. Uma nova chave vem com uma nova impressão digital, então as chaves de API restritas ao SHA-1 de debug antigo param de funcionar nos builds de debug.
  • adbkey, a chave que seus dispositivos físicos de teste autorizaram para a depuração USB. Eles pedem autorização de novo depois que ela muda.

Conclusão

Apagar ~/.android/avd não quebra nada no seu Mac e remove todos os seus emuladores, com os dados de cada um. Meça a pasta, zere os dispositivos que vai manter, apague os outros e remova imagens do sistema pelo SDK Manager quando os dispositivos que as usavam já tiverem ido embora.

Sobre o autor

Vladimir Chemeris

Fundador, StorageRadar

Vladimir Chemeris desenvolve o StorageRadar, um app de macOS para análise de armazenamento com foco em privacidade, limpeza com revisão prévia, armazenamento de desenvolvedor e comparação antes e depois.

Perguntas frequentes

É seguro apagar ~/.android/avd?

É seguro para o seu Mac e definitivo para os seus emuladores. Todo dispositivo virtual desaparece junto com os apps instalados, as contas e os snapshots. O Android Studio pode criar dispositivos novos, mas os dados que estavam nos antigos não voltam.

Apagar um AVD remove a imagem do sistema Android?

Não. As imagens do sistema ficam na pasta do SDK, por padrão em ~/Library/Android/sdk/system-images, e o config.ini de cada dispositivo só aponta para uma delas. Remova imagens do sistema no SDK Manager do Android Studio.

Como diminuo um emulador sem apagá-lo?

Zere os dados dele. No Device Manager do Android Studio, escolha Wipe Data para o dispositivo, ou inicie-o uma vez com emulator -avd NAME -wipe-data. O dispositivo mantém a definição e inicia como um celular novo.

Posso apagar a pasta ~/.android inteira?

Não apague tudo. Ao lado de avd ficam o debug.keystore, a chave que assina seus builds de debug, e o adbkey, que seus dispositivos físicos de teste autorizaram. O Android Studio cria novos, mas os dispositivos pedem autorização de novo e as chaves de API restritas à impressão digital de debug antiga param de funcionar.

Onde o Android Studio guarda os emuladores no Mac?

Em ~/.android/avd, a menos que a variável de ambiente ANDROID_AVD_HOME aponte para outro lugar. Cada dispositivo é um arquivo NAME.ini mais uma pasta NAME.avd.

Fontes e referências

Veja seus emuladores ao lado do resto do armazenamento de desenvolvedor.

O Dev Cleanup do StorageRadar mede dados de emuladores Android, caches do Gradle, pastas do Xcode e caches de pacotes lado a lado, classifica cada um por risco e conduz os perfis arriscados por um Dry Run e um Guided Preflight.