Эта страница переведена с помощью Cloud Translation API.

Настройка Android Studio

Android Studio предоставляет мастера и шаблоны, которые проверяют системные требования, такие как комплект разработки Java (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 или открыть существующий, выполните следующие действия:

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

Созданный вами файл 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 ГБ, вы также можете вручную настроить размеры кучи для вашего проекта. Для этого выполните следующие действия:

В строке меню выберите «Файл» > «Настройки» ( в Android Studio > «Настройки» в macOS).
Нажмите «Внешний вид и поведение» > «Системные настройки» > «Настройки памяти» .
Рисунок 2. Настройка максимального объема оперативной памяти в параметрах памяти.
Отрегулируйте размеры кучи.
Нажмите «Применить» .
Если вы измените размер кучи для IDE, необходимо перезапустить Android Studio, прежде чем новые настройки памяти вступят в силу.

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

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

Перейдите в Настройки > Резервное копирование и синхронизация .
Рисунок 3. Резервное копирование и синхронизация в меню настроек Studio.
Выберите либо Google , чтобы использовать хранилище вашей учетной записи Google для синхронизации между установками Android Studio, либо Jetbrains , чтобы использовать вашу учетную запись Jetbrains для синхронизации между установками IntelliJ и Android Studio. В любом случае Android Studio откроет окно браузера, где вы сможете предоставить разрешение.
После того, как вы выполните все необходимые действия для предоставления Android Studio доступа к хранилищу вашей учетной записи, вернитесь в Android Studio.
Вернувшись на страницу настроек резервного копирования и синхронизации , просмотрите категории данных приложений, которые вы хотите синхронизировать со своей учетной записью, и внесите необходимые изменения. Чтобы полностью отключить эту функцию, снимите флажок «Включить резервное копирование и синхронизацию» .

Вы также можете напрямую экспортировать файл Settings.jar , содержащий все или часть ваших предпочтительных настроек IDE для проекта, перейдя в меню Файл > Управление настройками IDE > Экспорт настроек . Затем вы можете импортировать этот JAR-файл в другие свои проекты или предоставить его своим коллегам для импорта в их проекты. Чтобы импортировать файл настроек, перейдите в меню Файл > Управление настройками IDE > Импорт настроек .

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

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

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

Нажмите «Справка» > «Редактировать пользовательские свойства» . Если вы никогда раньше не редактировали свойства IDE, Android Studio предложит вам создать новый файл idea.properties . Нажмите «Да» , чтобы создать файл.
Файл 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 .
Включение режима энергосбережения: Включение режима энергосбережения позволяет отключить ряд ресурсоемких фоновых операций, требующих большого объема памяти и заряда батареи, включая подсветку ошибок и проверку в режиме реального времени, автоматическое автозавершение кода и автоматическую инкрементальную фоновую компиляцию. Чтобы включить режим энергосбережения, щелкните Файл > Режим энергосбережения .
Отключение ненужных проверок кода: Чтобы изменить, какие проверки кода выполняет 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, чтобы задать параметры HTTP-прокси.

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

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

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

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

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

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

В Android Studio откройте диалоговое окно «Настройки» (в macOS — «Предпочтения »), затем перейдите в раздел «Внешний вид и поведение» > «Системные настройки» > «Android SDK» .
Измените значение параметра «Расположение Android SDK» на C:\WorkFolder \AndroidSDK .
Чтобы избежать повторной загрузки SDK, скопируйте существующую папку SDK, которая по умолчанию находится по адресу %USERPROFILE%\AppData\Local\Android\SDK , в новое местоположение.