Устранение неполадок Android Studio

На этой странице представлены рекомендации по устранению распространенных проблем и неполадок с конфигурацией в Android Studio.

Дисплеи высокой плотности

Начиная с версии 1.5, Android Studio обеспечивает поддержку дисплеев с высокой плотностью пикселей (таких как мониторы HiDPI и Retina) на всех платформах.

Настройки коэффициента масштабирования

В Android Studio коэффициент масштабирования для вашего дисплея определяется следующим образом:

Мак
На дисплеях Retina элементы пользовательского интерфейса масштабируются с коэффициентом 200%, а изображения отображаются в высоком разрешении. Размытия из-за масштабирования быть не должно, даже в многомониторных конфигурациях. Обратите внимание, что поддерживаются коэффициенты масштабирования, отличные от 100% (для дисплеев без Retina) и 200% (для дисплеев Retina).
Windows
Android Studio использует настройки DPI основного дисплея для определения коэффициента масштабирования элементов пользовательского интерфейса. Для изображений, если коэффициент масштабирования меньше 150%, изображения с обычным разрешением масштабируются вверх. Если коэффициент масштабирования больше 150%, изображения с высоким разрешением масштабируются соответствующим образом.
Linux
В Android Studio коэффициент масштабирования определяется на основе параметра "Коэффициент масштабирования текста", а затем на основе системных настроек DPI в XWindow.
Значение DPI, равное 96, соответствует коэффициенту масштабирования 100% (без масштабирования), а значение DPI, равное 192, соответствует коэффициенту масштабирования 200% (размер элементов пользовательского интерфейса удваивается). В настоящее время Android Studio поддерживает значения DPI от 96 (масштабирование 100%) до 288 (масштабирование 300%). Если Android Studio не определяет правильное значение DPI на вашем компьютере с Linux или Windows, вы можете установить его вручную, задав свойство hidpi в файле idea.properties , как описано в разделе «Настройка свойств IDE» . Обратите внимание, что это свойство не влияет на работу компьютеров Mac. Работа этого свойства следующая:
hidpi=true
Устанавливает разрешение 192 DPI (масштабирование 200%), игнорируя системные настройки.
hidpi=false
Устанавливает разрешение 96 DPI (масштабирование 100%), игнорируя системные настройки.

Размытые или пикселизированные элементы на дисплеях с высокой плотностью пикселей.

Если один или несколько элементов пользовательского интерфейса Android Studio отображаются размытыми или пикселизированными на вашем дисплее с высокой плотностью пикселей, возможно, вы столкнулись с одной из следующих проблем:

  • Если большая часть пользовательского интерфейса Android Studio выглядит нормально, но какой-либо значок размыт или пикселизирован, или какой-либо элемент интерфейса использует шрифт неправильного размера, вероятно, этот элемент еще не был полностью обновлен для поддержки HiDPI. Пожалуйста, сообщите об ошибке, нажав «Справка» > «Отправить отзыв» . Приложите снимок экрана и как можно больше информации о конфигурации вашей системы.
  • Если вы используете компьютер под управлением Windows или Linux, и ваш дисплей использует коэффициент масштабирования, отличный от 100% или 200%, изображения могут выглядеть слегка размытыми из-за масштабирования.
  • Если вы используете компьютер под управлением Windows и изменили размер шрифта Windows в Панели управления, шрифт может отображаться размытым или пикселизированным. Эту проблему можно решить, выйдя из системы Windows и снова войдя в неё.
  • В многомониторной конфигурации под управлением Windows 8.1 или более поздней версии при перемещении окна с одного дисплея на другой с другим разрешением или DPI могут возникать проблемы со шрифтами или изображениями (см. ошибку 186007 ). На данный момент известного способа решения этой проблемы нет.
  • В более старых версиях JRE 1.8 наблюдалась проблема с размытыми шрифтами (в частности, в JRE 1.8.0_25-b18 amd64, см. ошибку 192316 ). Начиная с версии 2.2, Android Studio включает в себя встроенную версию последней поддерживаемой версии JDK, которая включает JDE. Для решения этой проблемы обновите Android Studio до версии 2.2 или выше и переключитесь на использование встроенной версии JDK, щелкнув Файл > Структура проекта > Расположение SDK и установив флажок «Использовать встроенный JDK» .

Элементы неправильного размера на дисплеях с высокой плотностью пикселей.

Если весь интерфейс Android Studio отображается неправильно на вашем дисплее с высокой плотностью пикселей, см. раздел «Настройки коэффициента масштабирования» . Если некоторые элементы интерфейса Android Studio отображаются неправильно на вашем дисплее с высокой плотностью пикселей, а другие имеют правильный размер, возможно, у вас возникла одна из следующих проблем:

  • Если вы используете пользовательскую схему оформления редактора, шрифт редактора может отображаться слишком маленьким или слишком большим по сравнению с остальными элементами пользовательского интерфейса на экране с высокой плотностью пикселей. Чтобы исправить эту проблему, щелкните Файл > Настройки , затем щелкните Редактор > Цвета и шрифты > Шрифт и измените размер шрифта редактора. Обратите внимание, что при использовании схемы по умолчанию размер шрифта редактора масштабируется автоматически (см. ошибку 186920 ).
  • Если некоторые элементы пользовательского интерфейса Android Studio имеют правильный размер, а другие слишком малы или слишком велики, возможно, вы столкнулись с проблемой 186923. Пожалуйста, сообщите об ошибке, нажав «Справка» > «Отправить отзыв» . Приложите снимок экрана и как можно больше информации о конфигурации вашей системы.

Проблемы синхронизации проекта

При попытке синхронизации проекта может появиться следующее сообщение об ошибке: "Подключение к Интернету запрещено. ('Отказано в доступе: connect')". Для устранения этой ошибки добавьте в файл gradle.properties в Android Studio системное свойство -Djava.net.preferIPv4Stack=true следующим образом:

  1. Откройте файл gradle.properties в Android Studio.
  2. Добавьте в файл следующую строку:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    Обратите внимание, что если вы уже добавили другие аргументы JVM Gradle в файл gradle.properties , вы можете добавить это свойство в ту же строку, как показано в следующем примере: 
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
  3. Перезапустите Android Studio, чтобы изменения вступили в силу.
  4. Синхронизация проекта с файлами Gradle с помощью ClickSync для синхронизации вашего проекта.

Проблемы с обновлением IDE в Windows.

В Windows файлы, используемые процессом, нельзя удалить. При попытке использовать встроенный механизм обновления в IDE иногда возникает ошибка, обычно выражающая сообщение типа "Невозможно удалить C:\some\path\file".

Чтобы обойти эту проблему, откройте диспетчер задач и попробуйте завершить процессы, которые могут использовать этот файл, например, любые демоны Gradle.

Проблемы с minSdkVersion

Если вы используете устаревшую версию библиотек поддержки Android, вы можете получить сообщение об ошибке, подобное следующему:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

Для решения этой проблемы используйте менеджер SDK для обновления библиотек поддержки Android до последних (не предварительных) версий. Дополнительную информацию о настройке библиотек поддержки см. в разделе «Настройка библиотек поддержки» .

Проблемы с эмулятором Android

См. раздел «Устранение неполадок эмулятора Android» .

Справочники

Следующие каталоги используются Android Studio для хранения настроек, кэша, плагинов и журналов.

Windows

  • Конфигурация (idea.config.path): %APPDATA%\Google\ AndroidStudio VERSION
  • Плагины (idea.plugins.path): %APPDATA%\Google\ AndroidStudio VERSION \plugins
  • Система (idea.system.path): %LOCALAPPDATA%\Google\ AndroidStudio VERSION
  • Логи (idea.log.path): %LOCALAPPDATA%\Google\ AndroidStudio VERSION \log
  • Пример %APPDATA% : C:\Users\YourUserName\AppData\Roaming
  • Пример использования %LOCALAPPDATA% : C:\Users\YourUserName\AppData\Local

macOS

  • Конфигурация (idea.config.path): ~/Library/Application Support/Google/ AndroidStudio VERSION
  • Плагины (idea.plugins.path): ~/Library/Application Support/Google/ AndroidStudio VERSION /plugins
  • Система (idea.system.path): ~/Library/Caches/Google/ AndroidStudio VERSION
  • Логи (idea.log.path): ~/Library/Logs/Google/ AndroidStudio VERSION

Linux

  • Конфигурация (idea.config.path): ~/.config/Google/ AndroidStudio VERSION
  • Плагины (idea.plugins.path): ~/.local/share/Google/ AndroidStudio VERSION
  • Система (idea.system.path): ~/.cache/Google/ AndroidStudio VERSION
  • Логи (idea.log.path): ~/.cache/Google/ AndroidStudio VERSION /log

Каждый каталог представлен в следующем формате:

Заменять:

  • AndroidStudio с указанием названия продукта: AndroidStudio для стабильных версий или AndroidStudioPreview для версий RC и Canary.
  • VERSION с указанием версии. Например: 2023.1 или 2023.3 .