Настройка Android Studio

Android Studio предоставляет мастера и шаблоны, которые проверяют ваши системные требования, такие как Java Development Kit (JDK) и доступную оперативную память, а также настраивают параметры по умолчанию, такие как оптимизированная эмуляция виртуального устройства Android (AVD) по умолчанию и обновленные образы системы. В этом документе описаны дополнительные параметры конфигурации, позволяющие настроить использование Android Studio.

Android Studio предоставляет доступ к двум файлам конфигурации через меню «Справка» :

  • studio.vmoptions : настройка параметров виртуальной машины Java (JVM) Android Studio, таких как размер кучи и размер кэша. Обратите внимание, что на машинах Linux этот файл может называться studio64.vmoptions , в зависимости от вашей версии Android Studio.
  • idea.properties : настройте свойства Android Studio, такие как путь к папке плагинов или максимальный поддерживаемый размер файла.

Конкретную документацию по настройке и использованию эмулятора и устройства см. в следующих разделах:

Найдите файлы конфигурации

Оба файла конфигурации хранятся в каталоге конфигурации Android Studio. Чтобы найти каталог конфигурации, см. Каталоги .

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

  • STUDIO_VM_OPTIONS : установите имя и расположение файла .vmoptions .
  • STUDIO_PROPERTIES : установите имя и расположение файла .properties .

Вы можете настроить, какие JDK будут использоваться, посетив версии Java в сборках Android .

Настройте параметры виртуальной машины

Файл studio.vmoptions позволяет настраивать параметры JVM Android Studio. Чтобы повысить производительность Android Studio, наиболее распространенным вариантом настройки является максимальный размер кучи, но вы также можете использовать файл studio.vmoptions , чтобы переопределить другие настройки по умолчанию, такие как начальный размер кучи, размер кэша и переключатели сборки мусора Java.

Чтобы создать новый файл studio.vmoptions или открыть существующий, выполните следующие действия:

  1. Нажмите «Справка» > «Изменить пользовательские параметры виртуальной машины» . Если вы никогда раньше не редактировали параметры виртуальной машины для Android Studio, IDE предложит вам создать новый файл studio.vmoptions . Нажмите «Создать» , чтобы создать файл.
  2. Файл studio.vmoptions откроется в окне редактора Android Studio. Отредактируйте файл, добавив свои индивидуальные параметры виртуальной машины. Полный список настраиваемых параметров JVM см. на странице параметров Oracle Java HotSpot VM .

Созданный вами файл studio.vmoptions добавляется к файлу studio.vmoptions по умолчанию, расположенному в каталоге bin/ внутри папки установки Android Studio.

Не редактируйте напрямую файл studio.vmoptions , расположенный в папке программы Android Studio. Хотя вы можете получить доступ к файлу для просмотра параметров виртуальной машины Android Studio по умолчанию, редактирование только вашего собственного файла studio.vmoptions гарантирует, что вы не переопределите важные настройки по умолчанию для Android Studio. Поэтому в файле studio.vmoptions переопределите только нужные вам атрибуты и позвольте Android Studio продолжать использовать значения по умолчанию для всех атрибутов, которые вы не изменили.

Максимальный размер кучи

По умолчанию Android Studio имеет максимальный размер кучи 1280 МБ. Если вы работаете над большим проектом или в вашей системе много оперативной памяти, вы можете повысить производительность, увеличив максимальный размер кучи для процессов Android Studio, таких как ядро ​​IDE, демон Gradle и демон Kotlin.

Android Studio автоматически проверяет возможные варианты оптимизации размера кучи и уведомляет вас, если обнаруживает, что производительность можно повысить.

Настройки памяти, которые позволяют настроить максимальный объем оперативной памяти для процессов Android Studio.

Рисунок 1. Уведомление о рекомендуемых настройках памяти.

Если вы используете 64-разрядную систему с объемом оперативной памяти не менее 5 ГБ, вы также можете настроить размеры кучи для своего проекта вручную. Для этого выполните следующие действия:

  1. Нажмите «Файл» > «Настройки» в строке меню ( Android Studio > «Настройки» в macOS).
  2. Нажмите «Внешний вид и поведение» > «Настройки системы» > «Настройки памяти» .

    Настройки памяти, которые позволяют настроить максимальный объем оперативной памяти для процессов Android Studio.

    Рисунок 2. Настройте максимальный объем оперативной памяти в настройках памяти.

  3. Отрегулируйте размеры кучи.

  4. Нажмите Применить .

    Если вы измените размер кучи для IDE, вам необходимо перезапустить Android Studio, прежде чем новые настройки памяти будут применены.

Экспорт и импорт настроек IDE

Вы можете экспортировать файл Settings.jar , содержащий все или часть предпочитаемых вами настроек IDE для проекта. Затем вы можете импортировать файл JAR в другие свои проекты и/или предоставить доступ к файлу JAR своим коллегам для импорта в их проекты.

Дополнительную информацию см. в разделе «Поделиться настройками IDE» на сайте IntelliJ IDEA.

Настройте свойства IDE

Файл idea.properties позволяет настроить свойства IDE для Android Studio, такие как путь к установленным пользователем плагинам и максимальный размер файла, поддерживаемый IDE. Файл idea.properties объединяется со свойствами по умолчанию для IDE, поэтому вы можете указать только свойства переопределения.

Чтобы создать новый файл idea.properties или открыть существующий файл, выполните следующие действия:

  1. Нажмите «Справка» > «Редактировать пользовательские свойства» . Если вы никогда раньше не редактировали свойства IDE, Android Studio предложит вам создать новый файл idea.properties . Нажмите Да , чтобы создать файл.
  2. Файл idea.properties откроется в окне редактора Android Studio. Отредактируйте файл, добавив свои собственные свойства IDE.

Следующий файл idea.properties содержит часто настраиваемые свойства IDE. Полный список свойств можно найти в файле idea.properties для IntelliJ IDEA .

#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger the file is, the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features.
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise", then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6.
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff.
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480

Настройка IDE для машин с низким объемом памяти

Если вы используете Android Studio на машине с техническими характеристиками, отличными от рекомендуемых (см. системные требования ), вы можете настроить IDE для повышения производительности вашего компьютера следующим образом:

  • Уменьшите максимальный размер кучи, доступный для Android Studio: уменьшите максимальный размер кучи для Android Studio до 512 МБ. Дополнительные сведения об изменении максимального размера кучи см. в разделе Максимальный размер кучи .
  • Обновите Gradle и плагин Android Gradle: обновите последние версии Gradle и плагин Android Gradle, чтобы воспользоваться преимуществами последних улучшений производительности. Дополнительные сведения об обновлении Gradle и плагине Android Gradle см. в примечаниях к выпуску плагина Android Gradle .
  • Включить режим энергосбережения. Включите режим энергосбережения, чтобы отключить ряд фоновых операций, ресурсоемких для памяти и аккумулятора, включая выделение ошибок и оперативные проверки, автоматическое завершение кода во всплывающих окнах и автоматическую инкрементную фоновую компиляцию. Чтобы включить режим энергосбережения, нажмите «Файл» > «Режим энергосбережения» .
  • Отключите ненужные проверки lint. Чтобы изменить, какие проверки lint будут выполняться в Android Studio для вашего кода, выполните следующие действия:

    1. Нажмите «Файл» > «Настройки» (в macOS, Android Studio > «Настройки» ), чтобы открыть диалоговое окно «Настройки» .
    2. На левой панели разверните раздел «Редактор» и нажмите «Проверки» .
    3. Установите флажки, чтобы выбрать или отменить выбор проверок ворса в зависимости от вашего проекта.
    4. Нажмите «Применить» или «ОК» , чтобы сохранить изменения.
  • Отладка на физическом устройстве. Улучшите общую производительность Android Studio за счет отладки на физическом устройстве . Отладка на эмуляторе использует больше памяти, чем отладка на физическом устройстве.

  • Включайте в качестве зависимостей только необходимые службы Google Play. Включайте в свой проект в качестве зависимостей только необходимые службы Google Play. Зависимости увеличивают необходимый объем памяти, поэтому их ограничение улучшает использование памяти и производительность. Дополнительную информацию см. в разделе «Объявление зависимостей для сервисов Google Play» .

  • Уменьшите максимальный размер кучи, доступный для Gradle. Уменьшите значение максимального размера кучи Gradle по умолчанию (1536 МБ), переопределив свойство org.gradle.jvmargs в файле gradle.properties , как показано:

    # Make sure to gradually decrease this value and note
    # changes in performance. Allocating too little memory can
    # also decrease performance.
    org.gradle.jvmargs = -Xmx1536m
    
  • Убедитесь, что параллельная компиляция не включена: Android Studio может компилировать независимые модули параллельно, но оставьте эту функцию отключенной, если у вас система с нехваткой памяти. Чтобы проверить эту настройку, сделайте следующее:

    1. Нажмите «Файл» > «Настройки» (в macOS, Android Studio > «Настройки» ), чтобы открыть диалоговое окно «Настройки» .
    2. На левой панели разверните «Сборка», «Выполнение», «Развертывание» и нажмите «Компилятор» .
    3. Убедитесь, что опция «Компилировать независимые модули параллельно» не отмечена.
    4. Если вы внесли изменения, нажмите «Применить» или «ОК» , чтобы изменения вступили в силу.

Установить настройки прокси

Прокси служат промежуточными точками соединения между HTTP-клиентами и веб-серверами, которые повышают безопасность и конфиденциальность интернет-соединений.

Чтобы обеспечить запуск Android Studio за брандмауэром, используйте страницу настроек HTTP-прокси Android Studio IDE, чтобы настроить параметры HTTP-прокси.

При запуске плагина Android Gradle из командной строки или на компьютерах, где Android Studio не установлена, например, на серверах непрерывной интеграции, задайте настройки прокси-сервера в файле сборки Gradle.

Настройте прокси-сервер Android Studio

Android Studio поддерживает настройки HTTP-прокси, поэтому вы можете запускать Android Studio за брандмауэром или защищенной сетью. Чтобы установить настройки HTTP-прокси в Android Studio:

  1. В строке меню нажмите «Файл» > «Настройки» (в macOS нажмите «Android Studio» > «Настройки» ).
  2. На левой панели нажмите «Внешний вид и поведение» > «Настройки системы» > «Прокси-сервер HTTP» . Появится страница HTTP-прокси.
  3. Выберите «Автоопределение настроек прокси-сервера» , чтобы использовать URL-адрес автоматической настройки прокси-сервера для настроек прокси-сервера, или «Настройка прокси-сервера вручную» , чтобы ввести все параметры самостоятельно. Подробное объяснение этих настроек см. в разделе HTTP-прокси .
  4. Нажмите «Применить» или «ОК» , чтобы изменения вступили в силу.

Плагин Android для настроек HTTP-прокси Gradle

При запуске плагина Android из командной строки или на компьютерах, где Android Studio не установлена, установите настройки прокси-сервера плагина Android Gradle в файле сборки Gradle.

Для настроек HTTP-прокси для конкретного приложения задайте настройки прокси-сервера в файле build.gradle , необходимые для каждого модуля приложения:

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        ...
        systemProp.http.proxyHost=proxy.company.com
        systemProp.http.proxyPort=443
        systemProp.http.proxyUser=userid
        systemProp.http.proxyPassword=password
        systemProp.http.auth.ntlm.domain=domain
    }
    ...
}

Для настроек HTTP-прокси для всего проекта установите настройки прокси в файле gradle/gradle.properties :

# Project-wide Gradle settings.
...

systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain

systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain

...

Информацию об использовании свойств Gradle для настроек прокси см. в Руководстве пользователя Gradle .

Оптимизация производительности Android Studio в Windows

На производительность Android Studio в Windows может влиять множество факторов. В этом разделе описывается, как оптимизировать настройки Android Studio для достижения максимально возможной производительности в Windows.

Минимизируйте влияние антивирусного ПО на скорость сборки.

Некоторые антивирусные программы могут мешать процессу сборки Android Studio, в результате чего сборки выполняются значительно медленнее. Когда вы запускаете сборку в Android Studio, Gradle компилирует ресурсы и исходный код вашего приложения, а затем упаковывает скомпилированные ресурсы в APK или AAB. Во время этого процесса на вашем компьютере создается множество файлов. Если в вашем антивирусном программном обеспечении включено сканирование в реальном времени, антивирусное программное обеспечение может принудительно останавливать процесс сборки каждый раз при создании файла во время его сканирования.

Чтобы избежать этой проблемы, вы можете исключить определенные каталоги из сканирования в реальном времени с помощью антивирусного программного обеспечения. В Windows Build Analyzer может помочь вам определить каталоги, которые следует исключить из активного сканирования, и исключить их.

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

Кэш Gradle
%USERPROFILE%\.gradle
Проекты Android Studio
%USERPROFILE%\AndroidStudioProjects
Android SDK
%USERPROFILE%\AppData\Local\Android\SDK

Системные файлы Android Studio

Синтаксис: %LOCALAPPDATA%\Google\ <product><version>

Пример: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1

Настройте расположение каталогов для сред, контролируемых групповой политикой.

Если групповая политика ограничивает каталоги, которые вы можете исключить из сканирования в реальном времени на вашем компьютере, вы можете переместить каталоги Android Studio в одно из мест, которые централизованная групповая политика уже исключает.

В следующем списке показано, как настроить расположение каждого каталога Android Studio, где C:\WorkFolder — это каталог, который уже исключен вашей групповой политикой:

Кэш Gradle
Определите переменную среды GRADLE_USER_HOME , чтобы она указывала на C:\WorkFolder \.gradle .
Проекты Android Studio
Переместите или создайте каталоги проекта в соответствующем подкаталоге C:\WorkFolder . Например, C:\WorkFolder \AndroidStudioProjects .
Android SDK

Выполните следующие действия, чтобы настроить местоположение:

  1. В Android Studio откройте диалоговое окно «Настройки» ( «Настройки» в macOS), затем перейдите в «Внешний вид и поведение» > «Настройки системы» > «Android SDK» .

  2. Измените значение местоположения Android SDK на C:\WorkFolder \AndroidSDK .

    Чтобы избежать повторной загрузки SDK, скопируйте существующий каталог SDK, расположенный по умолчанию %USERPROFILE%\AppData\Local\Android\SDK , в новое место.

Системные файлы Android Studio

Выполните следующие действия, чтобы настроить местоположение:

  1. В Android Studio нажмите «Справка» > «Редактировать пользовательские свойства» .

    Android Studio предложит вам создать файл idea.properties , если у вас его еще нет.

  2. Добавьте следующую строку в файл idea.properties :

    idea.system.path=c:/workfolder/studio/caches/trunk-system