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

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

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

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

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

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

Мак
На дисплеях Retina элементы пользовательского интерфейса масштабируются в 200 %, а изображения отображаются в высоком разрешении. Не должно быть размытия из-за масштабирования даже в конфигурациях с несколькими мониторами. Обратите внимание, что не поддерживаются коэффициенты масштабирования, отличные от 100 % (для дисплеев, отличных от Retina) и 200 % (для дисплеев Retina).
Окна
Android Studio использует настройки разрешения основного дисплея для определения коэффициента масштабирования элементов пользовательского интерфейса. Для изображений, если коэффициент масштабирования меньше 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, а затем снова войдя в систему.
  • В системе с несколькими мониторами под управлением Windows 8.1 или более поздней версии при перемещении окна с одного дисплея на другой с другим разрешением или DPI могут возникнуть проблемы со шрифтом или изображением (см. ошибку 186007 ). На данный момент не существует известного обходного пути.
  • В более старых версиях JRE 1.8 была проблема с размытыми шрифтами (в частности, JRE 1.8.0_25-b18 amd64, см. ошибку 192316 ). Начиная с версии 2.2, студия Android включает в себя связанную версию последней поддерживаемой 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

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

Проблемы с эмулятором 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 для бета-версий и Canary-выпусков.
  • VERSION с версией. Например: 2023.1 или 2023.3 .