Удаление ~/.android/avd убирает все эмуляторы Android на вашем Mac вместе с приложениями, аккаунтами и снимками внутри каждого. Самому 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, на которую он указывает. Я измерил свою папку 25 октября 2026 года. В ней было одно устройство, профиль Medium Phone на API 37 с образом Google Play, и занимала она 2,8 ГБ:
Внутри NAME.avd | Что хранит | На моём Mac |
|---|---|---|
userdata-qemu.img.qcow2 | раздел данных: установленные приложения, их данные, аккаунты | 2,2 ГБ |
sdcard.img | эмулируемая SD-карта | 512 МБ |
encryptionkey.img и .qcow2 | образ ключа шифрования устройства | 94 МБ |
snapshots | снимки Quick Boot, если эмулятор их сохраняет | нет |
config.ini | аппаратный профиль и путь к системному образу | несколько КБ |
Раздел данных растёт по мере того, как вы ставите приложения и пользуетесь ими. В config.ini этого устройства задано disk.dataPartition.size=10G, так что один этот файл может дорасти до 10 ГБ.
Чего в этой папке нет
Сама система Android лежит в SDK, а не в папке AVD. config.ini ссылается на неё строкой вида image.sysdir.1=system-images/android-37.0/google_apis_playstore/arm64-v8a/. На моём Mac ~/Library/Android/sdk/system-images занимала ещё 2,7 ГБ, бинарники эмулятора 1,2 ГБ, а NDK 2,1 ГБ.
У такого разделения два следствия:
- Удаление устройства не освобождает его системный образ. Один образ могут использовать несколько устройств.
- После удаления системного образа устройства, которые на нём работают, не запустятся, пока вы не установите образ снова.
SDK Manager в Android Studio показывает установленные образы и удаляет ненужные.
Стереть данные или удалить
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, ключ, которым подписываются ваши отладочные сборки. У нового ключа будет новый отпечаток, поэтому API-ключи, ограниченные старым отладочным SHA-1, перестанут работать в отладочных сборках.adbkey, ключ, который ваши физические тестовые устройства авторизовали для отладки по USB. После его смены они запросят разрешение снова.
Итог
Удаление ~/.android/avd ничего не ломает на вашем Mac, но убирает все ваши эмуляторы вместе с данными. Измерьте папку, сотрите данные устройств, которые оставляете, удалите ненужные, а системные образы убирайте через SDK Manager, когда устройств, которые их использовали, уже не осталось.
FAQ
Безопасно ли удалять ~/.android/avd?
Для Mac безопасно, для эмуляторов необратимо. Исчезнет каждое виртуальное устройство вместе с установленными приложениями, аккаунтами и снимками. Android Studio может создать новые устройства, но данные из старых не вернутся.
Если удалить AVD, удалится ли системный образ Android?
Нет. Системные образы лежат в папке SDK, по умолчанию в ~/Library/Android/sdk/system-images, а config.ini каждого устройства только указывает на один из них. Удаляйте системные образы через SDK Manager в Android Studio.
Как уменьшить эмулятор, не удаляя его?
Сотрите его данные. В Device Manager в Android Studio выберите для устройства Wipe Data или один раз запустите его командой emulator -avd NAME -wipe-data. Устройство сохранит свою конфигурацию и загрузится как новый телефон.
Можно ли удалить всю папку ~/.android?
Целиком не удаляйте. Рядом с avd в ней лежат debug.keystore, ключ, которым подписываются ваши отладочные сборки, и adbkey, который авторизовали ваши физические тестовые устройства. Android Studio создаст новые, но устройства снова запросят авторизацию, а API-ключи, ограниченные старым отладочным отпечатком, перестанут работать.
Где Android Studio хранит эмуляторы на Mac?
В ~/.android/avd, если переменная окружения ANDROID_AVD_HOME не указывает в другое место. Каждое устройство состоит из файла NAME.ini и папки NAME.avd.