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

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

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

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

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

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

Мак
Для дисплеев Retina элементы пользовательского интерфейса масштабируются с коэффициентом 200%, а изображения отображаются в высоком разрешении. Размытость изображения, вызванная масштабированием, не должна возникать даже в конфигурациях с несколькими мониторами. Обратите внимание, что поддержка коэффициентов масштабирования, отличных от 100% (для дисплеев без Retina) и 200% (для дисплеев Retina), не поддерживается.
Окна
Android Studio использует настройки DPI основного дисплея для определения коэффициента масштабирования элементов пользовательского интерфейса. Если коэффициент масштабирования изображений меньше 150%, изображения с обычным разрешением масштабируются. Если коэффициент масштабирования больше 150%, изображения с высоким разрешением масштабируются соответствующим образом.
Линукс
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
Устанавливает DPI на 192 (масштаб 200%), игнорируя системные настройки.
hidpi=false
Устанавливает DPI на 96 (масштабирование 100%), игнорируя системные настройки.

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

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

  • Если большая часть пользовательского интерфейса Android Studio выглядит нормально, но один конкретный значок размыт или пикселизирован, или один конкретный элемент интерфейса использует шрифт неправильного размера, вероятно, этот элемент ещё не полностью обновлён для поддержки HiDPI. Сообщите об ошибке, нажав «Справка» > «Отправить отзыв» . Приложите снимок экрана и как можно больше информации о конфигурации вашей системы.
  • Если вы используете компьютер с ОС Windows или Linux и ваш дисплей использует коэффициент масштабирования, отличный от 100% или 200%, изображения могут выглядеть слегка размытыми из-за масштабирования.
  • Если вы используете компьютер с 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. Сообщите об ошибке, нажав «Справка» > «Отправить отзыв» . Приложите снимок экрана и как можно больше информации о конфигурации вашей системы.

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

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

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

Проблемы с обновлением 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

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

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

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

Каталоги

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

Окна

  • Конфигурация (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

Линукс

  • Конфигурация (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 .