~/.android/avd를 지우면 Mac에 있는 모든 Android 에뮬레이터가 각 기기 안의 앱, 계정, 스냅샷과 함께 사라집니다. Mac에는 아무 문제가 없고, Android Studio로 새 기기를 만들 수도 있습니다. 하지만 예전 기기 안의 데이터는 돌아오지 않습니다. 에뮬레이터 하나가 커졌다면 그 기기의 데이터를 초기화하거나 그 기기 하나만 Android Studio에서 삭제하고, 폴더 자체는 도구에 맡기세요.
기본 원칙: 아직 쓰는 기기는 초기화하고, 쓰지 않는 기기는 삭제하고, Android Studio 목록에 더 이상 나오지 않는 기기만 폴더에서 직접 지우세요.
빠른 요약
du -sh ~/.android/avd/*로 크기를 잽니다.~/Library/Android/sdk/emulator/emulator -list-avds로 기기 목록을 봅니다.- 아직 쓰는 기기는 Device Manager, Wipe Data로 초기화합니다.
- 더 이상 필요 없는 기기는 Device Manager, Delete로 삭제합니다.
- 쓰지 않는 시스템 이미지는 SDK Manager에서 따로 제거합니다.
- 직접 지우는 것은 남은 잔여물에만 하고,
NAME.avd와NAME.ini를 함께 지웁니다.
~/.android/avd에는 무엇이 있나요
가상 기기 하나는 항목 두 개로 이루어집니다. NAME.ini 파일과, 그 파일이 가리키는 NAME.avd 폴더입니다. 2026년 10월 25일에 제 폴더를 재 봤습니다. 기기는 하나였고, Google Play 이미지를 쓰는 API 37의 Medium Phone 프로필이었으며, 2.8 GB를 차지했습니다.
NAME.avd 안 | 담고 있는 것 | 제 Mac에서 |
|---|---|---|
userdata-qemu.img.qcow2 | 데이터 파티션: 설치된 앱, 앱 데이터, 계정 | 2.2 GB |
sdcard.img | 에뮬레이션된 SD 카드 | 512 MB |
encryptionkey.img와 .qcow2 | 기기의 암호화 키 이미지 | 94 MB |
snapshots | 에뮬레이터가 저장했을 때의 Quick Boot 스냅샷 | 없음 |
config.ini | 하드웨어 프로필과 시스템 이미지 경로 | 수 KB |
데이터 파티션은 앱을 설치하고 쓸수록 커집니다. 이 기기의 config.ini에는 disk.dataPartition.size=10G가 설정되어 있어서, 이 파일 하나가 10 GB까지 커질 수 있습니다.
이 폴더에 없는 것
Android 시스템 자체는 AVD 폴더가 아니라 SDK에 있습니다. config.ini는 image.sysdir.1=system-images/android-37.0/google_apis_playstore/arm64-v8a/ 같은 줄로 그 위치를 가리킵니다. 제 Mac에서 ~/Library/Android/sdk/system-images는 2.7 GB를 더 차지했고, 에뮬레이터 바이너리는 1.2 GB, NDK는 2.1 GB였습니다.
이렇게 나뉘어 있어서 두 가지 결과가 생깁니다.
- 기기를 지워도 그 시스템 이미지의 공간은 확보되지 않습니다. 여러 기기가 이미지 하나를 함께 쓸 수 있습니다.
- 시스템 이미지를 지우면 그 이미지를 쓰는 기기는 이미지를 다시 설치할 때까지 부팅하지 못합니다.
Android Studio의 SDK Manager는 설치된 이미지를 보여 주고, 필요 없는 이미지를 제거해 줍니다.
초기화할까, 삭제할까
Wipe Data는 기기를 공장 초기 상태로 되돌리고 기기 정의는 유지합니다. 데이터 파티션이 다시 줄어들고, 로그인과 테스트 앱 설치는 다시 해야 합니다. Device Manager에서는 기기 메뉴 안에 있습니다. 터미널에서는 이 플래그를 붙여 기기를 한 번 시작합니다.
~/Library/Android/sdk/emulator/emulator -avd Medium_Phone_API_37.0 -wipe-data
에뮬레이터 도움말은 -wipe-data를 “reset the user data image (copy it from initdata)“(사용자 데이터 이미지를 초기화하고 initdata에서 복사)라고 설명합니다.
Delete는 기기와 그 파일을 지웁니다. 테스트 한 번 하려고 만들었다가 잊어버린 기기에 쓰세요.
스냅샷은 Quick Boot가 큰 상태를 저장할 때 신경 써야 합니다. -no-snapshot-save는 종료할 때 스냅샷을 저장하지 않도록 에뮬레이터를 시작하며, 기기의 snapshots 폴더를 보면 이전 세션이 무엇을 남겼는지 알 수 있습니다.
직접 지우기
수동 삭제는 잔여물에 어울립니다. 이미 제거한 Android Studio에서 만든 기기, 또는 지운 시스템 이미지를 가리키는 기기 같은 것들입니다. NAME.avd 폴더와 NAME.ini 파일을 둘 다 지우세요. .ini 파일은 그 폴더를 가리키려고만 존재합니다.
하는 김에 ~/.android 폴더 전체를 비우지는 마세요. 그 안에는 이런 것도 있습니다.
debug.keystore: 디버그 빌드에 서명하는 키입니다. 새로 만든 키는 지문이 달라서, 예전 디버그 SHA-1로 제한한 API 키는 디버그 빌드에서 작동하지 않게 됩니다.adbkey: 실제 테스트 기기가 USB 디버깅용으로 승인한 키입니다. 이 키가 바뀌면 기기가 다시 승인을 요청합니다.
핵심 요약
~/.android/avd를 지워도 Mac에서 깨지는 것은 없지만, 가진 에뮬레이터 전부가 데이터와 함께 사라집니다. 폴더 크기를 재고, 남길 기기는 초기화하고, 필요 없는 기기는 삭제하세요. 시스템 이미지는 그것을 쓰던 기기가 모두 없어진 뒤에 SDK Manager에서 제거하세요.
자주 묻는 질문
~/.android/avd를 지워도 안전한가요?
Mac에는 안전하지만, 에뮬레이터에는 되돌릴 수 없는 일입니다. 모든 가상 기기가 설치된 앱, 계정, 스냅샷과 함께 사라집니다. Android Studio로 새 기기를 만들 수는 있어도, 예전 기기 안에 있던 데이터는 돌아오지 않습니다.
AVD를 지우면 Android 시스템 이미지도 지워지나요?
아닙니다. 시스템 이미지는 SDK 폴더, 기본값으로는 ~/Library/Android/sdk/system-images에 있고, 각 기기의 config.ini는 그중 하나를 가리킬 뿐입니다. 시스템 이미지는 Android Studio의 SDK Manager에서 제거하세요.
에뮬레이터를 지우지 않고 크기를 줄이려면 어떻게 하나요?
데이터를 초기화하세요. Android Studio의 Device Manager에서 해당 기기의 Wipe Data를 고르거나, emulator -avd NAME -wipe-data로 한 번 시작합니다. 기기 정의는 그대로 남고, 새 휴대폰처럼 부팅됩니다.
~/.android 폴더 전체를 지워도 되나요?
전부 지우지는 마세요. avd 옆에는 디버그 빌드에 서명하는 키인 debug.keystore와, 실제 테스트 기기가 승인해 둔 adbkey가 있습니다. Android Studio가 새 키를 만들어 주지만, 기기는 다시 승인을 요청하고 예전 디버그 지문으로 제한한 API 키는 더 이상 작동하지 않습니다.
Mac에서 Android Studio는 에뮬레이터를 어디에 저장하나요?
ANDROID_AVD_HOME 환경 변수가 다른 곳을 가리키지 않는 한 ~/.android/avd에 저장합니다. 기기 하나는 NAME.ini 파일과 NAME.avd 폴더로 이루어집니다.