Создание и редактирование конфигураций запуска/отладки.

Когда вы запускаете, отлаживаете или тестируете свой код, Android Studio использует конфигурацию запуска/отладки, чтобы определить, как выполнить операцию. Обычно изначально созданной конфигурации достаточно для запуска или отладки приложения. Однако вы можете изменять и создавать новые конфигурации, а также изменять шаблоны конфигурации в соответствии с вашим процессом разработки, как описано на этой странице.

Для получения дополнительной информации также см. следующую документацию IntelliJ:

• Конфигурации запуска/отладки

О конфигурациях запуска/отладки

Конфигурации запуска/отладки определяют такие детали, как установка, запуск и параметры тестирования приложения. Вы можете определить конфигурацию для одноразового использования или сохранить ее для использования в будущем. После сохранения вы можете выбрать конфигурацию из раскрывающегося списка «Выбрать конфигурацию запуска/отладки» на панели инструментов . Android Studio сохраняет конфигурации как часть проекта.

Первоначально созданная конфигурация запуска/отладки

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

Объем проекта и контроль версий

Конфигурации запуска/отладки и изменения шаблонов применяются только к текущему проекту. Вы можете поделиться конфигурацией запуска/отладки (но не шаблоном) через свою систему контроля версий. Дополнительные сведения о том, как поделиться конфигурацией, см. в разделе Параметры конфигурации имени и общего ресурса .

Откройте диалоговое окно «Конфигурации запуска/отладки».

Чтобы открыть диалоговое окно «Выполнить/отладить конфигурации», выберите «Выполнить» > «Редактировать конфигурации» . Появится диалоговое окно «Конфигурации запуска/отладки» , как показано на рисунке 1.

Рисунок 1 . Диалоговое окно «Конфигурации запуска/отладки»

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

В этом диалоге вы можете:

• Создайте новые конфигурации запуска/отладки .
• Редактировать конфигурации запуска/отладки.
• Редактировать шаблоны конфигурации.
• Сортировка и группировка конфигураций.

Создайте новую конфигурацию запуска/отладки.

Вы можете определить новые конфигурации запуска/отладки в диалоговом окне «Конфигурации запуска/отладки» , в окне «Проект» или в редакторе кода. Новая конфигурация должна основываться на шаблоне конфигурации .

В диалоговом окне «Конфигурации запуска/отладки» отображаются конфигурации запуска/отладки и доступные шаблоны конфигурации. Новую конфигурацию можно запустить непосредственно из шаблона или из копии другой конфигурации. Затем вы можете изменить значения полей по мере необходимости.

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

В редакторе кода вы можете легко создать конфигурацию тестирования и запуска/отладки для класса или метода, а затем выполнить ее.

Когда вы создаете конфигурацию вне диалогового окна «Конфигурации запуска/отладки» , она является временной, если вы ее не сохраните. По умолчанию в проекте может быть до пяти временных конфигураций, прежде чем Android Studio начнет их удалять. Чтобы изменить это значение по умолчанию, откройте настройки Android Studio и измените «Дополнительные настройки» > «Запуск/отладка» > «Ограничение временных конфигураций» . Дополнительные сведения о временных конфигурациях см. в разделе Создание и сохранение временных конфигураций запуска/отладки .

Запуск настройки на основе шаблона

Чтобы определить конфигурацию запуска/отладки на основе шаблона, выполните следующие действия:

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Нажмите «Добавить новую конфигурацию». .
3. Выберите шаблон конфигурации .
4. Введите имя в поле Имя .
5. При необходимости измените конфигурацию.

Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.

6. Нажмите «Применить» или «ОК» .

Запуск конфигурации из копии

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

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Выберите существующую конфигурацию запуска/отладки на левой панели.
3. Нажмите «Копировать конфигурацию». .
4. Введите имя в поле Имя .
5. При необходимости измените конфигурацию.

Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.

6. Нажмите «Применить» или «ОК» .

Определить конфигурацию элемента в проекте

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

• Java-файл активности: шаблон приложения Android .
• Пакет: инструментальные тесты Android или шаблон Android JUnit , в зависимости от набора исходных кодов . Если вы выберете инструментированный тест , он будет использовать шаблон инструментальных тестов Android. Если вы выберете локальный модульный тест , то он будет использовать шаблон Android JUnit. Для локального модульного теста вы можете дополнительно запустить его с покрытием кода. Дополнительные сведения см. в разделе Покрытие кода .

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

1. Откройте проект в Android или в представлении «Проект» .
2. В окне «Проект» щелкните правой кнопкой мыши тестируемый элемент и выберите «Выполнить filename или filename отладки» . Android Studio создает временную конфигурацию запуска/отладки и запускает ваше приложение.
3. Откройте раскрывающийся список «Выбрать конфигурацию запуска/отладки» на панели инструментов.
4. Выберите «Сохранить конфигурацию» из вариантов рядом с конфигурацией, которую вы хотите сохранить.
   

   Рисунок 2 . Сохраните конфигурацию

Примечание. Если вы щелкнете правой кнопкой мыши и запустите или отладите тот же элемент (но не действие), Android Studio создаст новую конфигурацию.

Определите тестовую конфигурацию для класса или метода.

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

Android Studio использует инструментальные тесты Android или шаблон Android JUnit , в зависимости от набора исходных кодов . Для локального модульного теста вы можете дополнительно запустить его с покрытием кода .

Чтобы создать конфигурацию запуска/отладки для класса или метода в коде Java, выполните следующие действия:

1. Откройте проект в Android или в представлении «Проект» .
2. Откройте файл Java в редакторе кода.
3. Выберите класс или метод в коде, а затем нажмите Control+Shift+T (Command+Shift+T).
4. В появившемся меню выберите «Создать новый тест» .
5. В диалоговом окне «Создать тест» при необходимости измените или установите значения и нажмите «ОК» .
6. В диалоговом окне «Выбор каталога назначения» выберите место в проекте, в котором Android Studio должна разместить тест. Местоположение можно указать по структуре каталогов или выбрав соседний класс.
7. Нажмите ОК .

   Новый тест появится в окне «Проект» в соответствующем наборе источников тестов.

8. Чтобы запустить тест, выполните одно из следующих действий:
   • В окне проекта щелкните тест правой кнопкой мыши и выберите «Выполнить» или «Отладка» .
   • В редакторе кода щелкните правой кнопкой мыши определение класса или имя метода в тестовом файле и выберите «Выполнить» или «Отладка» , чтобы протестировать все методы в классе.
9. Откройте раскрывающийся список «Выбрать конфигурацию запуска/отладки» на панели инструментов.
10. Выберите «Сохранить конфигурацию» из вариантов рядом с конфигурацией, которую вы хотите сохранить.
    

    Рисунок 3 . Сохраните конфигурацию

Запуск или отладка приложения с использованием сохраненной конфигурации.

Если вы сохранили конфигурацию запуска/отладки, вы можете выбрать ее перед запуском или отладкой приложения.

Чтобы использовать сохраненную конфигурацию запуска/отладки, выполните следующие действия:

1. Выберите конфигурацию запуска/отладки в раскрывающемся списке «Выбрать конфигурацию запуска/отладки» на панели инструментов .

Раскрывающийся список находится слева от кнопки «Выполнить» . и отладка ; например, .

2. Выберите «Выполнить» > «Выполнить» или «Выполнить» > «Отладка» .

Либо нажмите «Выполнить» . или Отладка .

Изменение конфигурации запуска/отладки

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

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Выберите конфигурацию на левой панели.
3. При необходимости измените конфигурацию.

Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.

4. Нажмите «Применить» или «ОК» .

Изменение шаблона конфигурации запуска/отладки

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

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

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

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Нажмите Редактировать шаблоны конфигурации... .
3. Выберите шаблон конфигурации.
4. При необходимости измените конфигурацию.

Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.

5. Нажмите «Применить» или «ОК» .

Сортировка и группировка конфигураций

В диалоговом окне «Конфигурации запуска/отладки» вы можете упорядочить свои конфигурации, чтобы быстро их найти. Вы можете сортировать элементы в папке в алфавитном порядке и создавать новые папки для группировки конфигураций.

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

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Выберите папку, содержащую конфигурации.
3. Нажмите «Сортировать конфигурации». .
4. Нажмите кнопку ОК, чтобы закрыть диалоговое окно.

Чтобы сгруппировать конфигурации в папках, выполните следующие действия:

1. Откройте диалоговое окно «Конфигурации запуска/отладки» .
2. Выберите папку, содержащую конфигурации.
3. Нажмите «Создать новую папку». .
4. Введите имя в поле Имя папки .
5. Нажмите «Применить» , чтобы сохранить имя.

Перетащите элементы из той же категории шаблонов в папку.

Упорядочите папки и конфигурации в одной категории шаблонов, перетащив их на место.

Нажмите кнопку ОК, чтобы закрыть диалоговое окно.

Определите операции перед запуском

Вы можете указать задачи, которые необходимо выполнить, прежде чем применять конфигурацию запуска/отладки. Задачи выполняются в том порядке, в котором они указаны в списке.

Примечание. Определение задач перед запуском — это дополнительная функция. Вместо использования этой функции мы рекомендуем вам поместить любую логику подготовки в виде задач в файл build.gradle , чтобы они выполнялись при сборке из командной строки.

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

1. В нижней части диалогового окна « Конфигурации запуска/отладки» в разделе «Перед запуском» (возможно, вам придется прокрутить вниз) нажмите « Добавить».и выберите тип задачи. Если откроется диалоговое окно, заполните поля и нажмите «ОК» .
2. При необходимости добавляйте дополнительные задачи.
3. Чтобы упорядочить задачи, перетащите их или выберите задачу и нажмите «Вверх». и вниз чтобы переместить его вверх или вниз в списке.
4. Выберите «Показать эту страницу» , если вы хотите отображать параметры конфигурации запуска/отладки перед их применением.

   По умолчанию этот параметр не выбран.

5. Выберите «Активное окно инструмента» , если вы хотите, чтобы окно инструмента «Запуск» или «Отладка» активировалось при запуске или отладке приложения.

   Этот параметр выбран по умолчанию.

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

1. Выберите задачу.
2. Нажмите Удалить .

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

1. Выберите задачу.
2. Нажмите Редактировать .
3. В открывшемся диалоговом окне отредактируйте параметры задачи и нажмите «ОК» .

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

Задача	Описание
Запустить внешний инструмент	Запустите приложение, внешнее по отношению к Android Studio. В диалоговом окне «Внешние инструменты» выберите одно или несколько приложений, которые вы хотите запустить, и нажмите «ОК» . Если приложение еще не определено в Android Studio, добавьте его определение в диалоговом окне «Создать инструменты» . Дополнительные сведения см. в разделе Настройка сторонних инструментов и внешних инструментов .
Запустить другую конфигурацию	Выполните одну из существующих конфигураций запуска/отладки. В диалоговом окне «Выбор конфигурации для выполнения» выберите конфигурацию для выполнения и нажмите «ОК» .
Делать	Скомпилируйте проект или модуль. Android Studio выполняет команду Make Module, если в конфигурации запуска/отладки указан конкретный модуль, или выполняет команду Make Project , если модули не указаны.
Сделать проект	Скомпилируйте проект. Android Studio выполняет команду Make Project .
Сделать, нет проверки ошибок	Эта опция аналогична Make , за исключением того, что Android Studio выполняет конфигурацию запуска/отладки независимо от результата компиляции.
Создание артефактов	Не поддерживается в Android Studio.
Запустить задачу Gradle	Запустите задачу Gradle. В открывшемся диалоговом окне укажите детали и нажмите «ОК» . Для получения дополнительной информации см. Gradle .
Make с поддержкой Gradle	Скомпилируйте проект и запустите Gradle.
Конструктор Gradle App Engine	Задача компоновщика App Engine Gradle синхронизирует проект, а затем создает модуль.

Шаблоны конфигурации

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

• Android-приложение
• Android-тесты
• App Engine DevAppServer
• Усложнение Wear OS, плитка и циферблат

Примечание: Android Studio 2.1. x и более ранние версии имели шаблон собственного приложения, которого нет в более новых версиях. Если в проекте есть шаблон собственного приложения, Android Studio преобразует его в приложение Android при загрузке проекта. Диалоговое окно «Преобразовать проект» проведет вас через весь процесс.

Неподдерживаемые шаблоны

Следующие неподдерживаемые шаблоны взяты из IntelliJ IDEA и не предназначены специально для разработки Android с помощью Android Studio. Для получения информации об использовании этих шаблонов перейдите по ссылкам на документацию IntelliJ IDEA.

• Приложение
• Сложный
• Градл
• классный
• JAR-приложение
• Java Скретч
• Юнит
• Котлин
• Котлин-скрипт
• Удаленная отладка
• Сценарий оболочки
• ТестНГ

Общие параметры конфигурации

Параметры «Имя» , «Разрешить параллельный запуск » и «Сохранить как файл проекта» являются общими для нескольких шаблонов конфигурации. Подробнее о них см. в разделе Общие настройки .

Android Studio хранит общую конфигурацию запуска/отладки в отдельных XML-файлах в папке project_directory /.idea/runConfigurations/ . Дополнительную информацию см. в разделе Формат на основе каталога в документации проектов IntelliJ.

Android-приложение

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

Вкладка «Общие»

На вкладке Общие вы можете указать параметры установки, запуска и развертывания. Вкладка «Разное» также содержит параметры установки.

Поле	Описание
Модуль	Выберите модуль , к которому нужно применить эту конфигурацию.
Варианты установки: Развернуть	Выберите вариант: APK по умолчанию . Создайте и разверните APK для выбранного в данный момент варианта . APK из пакета приложений . Создайте и разверните свое приложение из пакета приложений Android . То есть Android Studio сначала преобразует проект вашего приложения в пакет приложений, включающий весь скомпилированный код и ресурсы вашего приложения. Затем из этого пакета приложений Android Studio создает только те APK-файлы, которые необходимы для развертывания вашего приложения на подключенном устройстве. Обычно вам следует использовать этот вариант при тестировании пакета приложений, который вы собираетесь загрузить в Google Play, поскольку развертывание из пакета приложений увеличивает общее время сборки. Пользовательский артефакт — не поддерживается в Android Studio. Ничего . Не устанавливайте APK на устройство. Например, если вы предпочитаете устанавливать APK вручную, вам не нужна Android Studio для его установки.
Варианты установки: развернуть как мгновенное приложение.	Если ваше приложение поддерживает мгновенный интерфейс — то есть вы либо добавляете поддержку мгновенных приложений при создании нового проекта , либо создаете один или несколько функциональных модулей с мгновенной поддержкой — вы можете выбрать развертывание этих модулей с мгновенной поддержкой, установив флажок рядом с пунктом «Развернуть как приложение с мгновенным запуском» .
Варианты установки: функции для развертывания	Если ваше приложение включает функциональные модули , установите флажок рядом с каждой функцией, которую вы хотите включить при развертывании приложения. Вы видите эту опцию, только если ваше приложение включает функциональные модули. Примечание. Если вы хотите протестировать загрузку и установку функциональных модулей по требованию, вам необходимо сделать это после публикации пакета приложений, а затем использовать внутреннюю тестовую версию Play Console. Подробнее читайте в статье «Загрузка пакета приложений в Play Console» .
Варианты установки: Установить флаги	Введите любые параметры pm install которые вы хотите использовать. Отформатируйте параметры так же, как и в командной строке, но без пути. Вот несколько примеров: -i foo.bar.baz -r /path/to/apk и -d -r По умолчанию: без опций.
Параметры запуска: Запустить	Выберите вариант: Ничего — ничего не запускать, когда вы выбираете «Выполнить» или «Отладка» . Однако если ваше приложение уже запущено и вы выбрали «Отладка» , Android Studio подключит отладчик к процессу вашего приложения. Действие по умолчанию — запустите действие, которое вы пометили как запускаемое в манифесте. Например: <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> Указанное действие — запуск определенного действия приложения в вашем модуле. Если этот флажок установлен, ниже появится поле «Действие» , в котором вы можете ввести название действия, которое хотите запустить, или нажать «Дополнительно» , чтобы выбрать действие из списка. URL -адрес. Запустите URL-адрес, соответствующий фильтру намерений в манифесте вашего приложения. Если этот флажок установлен, ниже появится поле URL-адреса , в которое можно ввести URL-адрес. Вы должны заполнить это поле, чтобы запустить приложение Android Instant App . Вы также можете использовать это для проверки ссылок на приложения Android .
Параметры запуска: Флаги запуска	Введите любые параметры am start которые вы хотите использовать. Отформатируйте параметры так же, как и в командной строке, но без намерения. Например: -W Этот параметр не отображается, если вы выбрали для параметра запуска значение Nothing . По умолчанию: без опций.
Параметры цели развертывания: Цель	Выберите вариант: Открыть диалоговое окно «Выбор цели развертывания» — откройте диалоговое окно «Выбор цели развертывания», чтобы выбрать виртуальное или аппаратное устройство. USB-устройство . Используйте аппаратное устройство, подключенное к компьютеру разработки через USB-порт. Если их несколько, появится диалоговое окно, в котором вы сможете выбрать их. Эмулятор — используйте виртуальное устройство. В конфигурации вы можете выбрать AVD; в противном случае он просто использует первый AVD в списке.
Параметры цели развертывания: использовать то же устройство для будущих запусков.	По умолчанию этот параметр не выбран, поэтому каждый раз, когда вы запускаете приложение, появляется диалоговое окно «Выбор развертывания» , в котором вы можете выбрать устройство. Когда вы выбираете этот параметр, а затем запускаете приложение, появляется диалоговое окно «Выбор развертывания» , в котором можно выбрать устройство. Затем каждый раз, когда вы запускаете приложение, оно запускается на выбранном вами устройстве без отображения диалогового окна «Выбор развертывания» . Чтобы запустить приложение на другом устройстве, снимите флажок « Использовать то же устройство для будущих запусков» или остановите приложение, выбрав «Выполнить» > «Остановить app или «Остановить». , а затем запустите его снова. Откроется диалоговое окно «Выбор развертывания» , в котором вы сможете выбрать устройство.
Перед запуском	См. Определение операций перед запуском .

Вкладка «Разное»

На вкладке «Разное» можно указать параметры logcat, установки, запуска и развертывания. Вкладка «Общие» также содержит параметры установки.

Поле	Описание
Logcat: автоматически отображать logcat.	Если выбран этот параметр, окно Logcat открывается каждый раз при успешном развертывании и запуске приложения с использованием этой конфигурации. По умолчанию: выбрано.
Logcat: очистить журнал перед запуском	Выберите этот параметр, если вы хотите, чтобы Android Studio удаляла данные предыдущих сеансов из файла журнала перед запуском приложения. По умолчанию: не выбрано.
Варианты установки: Пропустить установку, если APK не изменился.	Если этот параметр выбран, Android Studio не будет повторно развертывать APK-файл, если обнаружит, что он не изменился. Если вы хотите, чтобы Android Studio принудительно установила APK, даже если он не изменился, снимите флажок с этой опции. По умолчанию: выбрано
Варианты установки: принудительно остановить запуск приложения перед запуском активности.	Если этот параметр выбран, когда Android Studio обнаружит, что ей не нужно переустанавливать APK, поскольку он не изменился, она принудительно остановит приложение, чтобы оно запускалось с действия средства запуска по умолчанию. Если этот параметр не выбран, Android Studio не останавливает приложение принудительно. Этот параметр работает с предыдущим параметром, который контролирует, установлен ли APK или нет. Для обоих полей «Параметры установки» оставьте значения по умолчанию, если только вы явно не хотите каждый раз принудительно устанавливать установку. В некоторых случаях вам может потребоваться отменить выбор этой опции. Например, если вы пишете механизм метода ввода (IME), принудительная остановка приложения отменяет его выбор в качестве текущей клавиатуры, что может вам не понадобиться. По умолчанию: выбрано
Перед запуском	См. Определение операций перед запуском .

Вкладка «Отладчик»

Укажите параметры отладки на вкладке «Отладчик» .

Для кода C и C++ Android Studio использует отладчик LLDB . В дополнение к обычному пользовательскому интерфейсу Android Studio в окне отладчика имеется вкладка LLDB , позволяющая вводить команды LLDB во время отладки. Вы можете вводить те же команды, которые Android Studio использует для отображения информации в пользовательском интерфейсе отладчика, а также выполнять дополнительные операции.

Для проектов C и C++ на вкладке «Отладчик» можно добавить каталоги символов, а также команды запуска LLDB и пост-подключения. Для этого вы используете кнопки, подобные следующим:

• Добавлять - Добавить каталог или команду.
• Удалять- Выберите каталог или команду, а затем нажмите эту кнопку, чтобы удалить элемент.
• Вверх - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент вверх в списке.
• Вниз - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент вниз в списке.

Дополнительную информацию об отладке в Android Studio см. в разделе «Отладка вашего приложения» .

Поле	Описание
Тип отладки	Выберите один из следующих вариантов: Только Java — отладка только кода Java. Обнаружение автоматически . Позвольте Android Studio выбрать лучший тип отладки для вашего проекта. Только собственный код — отладка собственного кода C или C++. Двойной (Java + Native) — отладка Java и собственного кода в двух отдельных сеансах отладки. Рекомендуется использовать параметр «Определять автоматически», поскольку он позволяет выбрать правильный тип отладки для вашего проекта.
Каталоги символов	Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию C или C++, созданную за пределами Android Studio, вы можете добавить сюда один или несколько каталогов. Android Studio предпочитает использовать любые файлы в этих каталогах, а не файлы, созданные подключаемым модулем Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдет то, что ему нужно. Он рекурсивно ищет файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите наиболее часто используемые каталоги в начало списка. Если вы укажете каталог высоко в дереве, поиск во всех подкаталогах может занять больше времени. Если вы добавите очень конкретный каталог, поиск займет меньше времени. Вам необходимо найти правильный баланс между скоростью и поиском файлов, необходимых для отладки. Например, если у вас есть каталог, содержащий подкаталоги для различных двоичных интерфейсов Android (ABI), вы можете добавить каталог для определенного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите выполнить отладку на другом устройстве. Обратите внимание: вам не нужно добавлять каталоги, содержащие файлы символов Gradle, поскольку отладчик использует их автоматически.
Команды запуска LLDB	Добавьте команды LLDB, которые вы хотите выполнить до того, как отладчик подключится к процессу. Например, вы можете определить настройки среды, как показано в следующей команде: settings set target.max-memory-read-size 2048 LLDB выполняет команды сверху вниз.
Команды пост-присоединения LLDB	Добавьте команды LLDB, которые вы хотите выполнить сразу после подключения отладчика к процессу. Например: process handle SIGPIPE -n true -p true -s false LLDB выполняет команды сверху вниз.
Рабочий каталог хоста	Укажите рабочий каталог LLDB.
Ведение журнала: целевые каналы	Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды — поэтому это не слишком медленно, но содержит необходимую информацию для устранения неполадок. Журнал часто запрашивается для отчетов об ошибках Android Studio. Это значение по умолчанию lldb process:gdb-remote packets Вы можете изменить значение по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной platform : lldb process platform :gdb-remote packets Чтобы получить полный список команд журнала, введите команду log list из окна оболочки LLDB в Android Studio. Android Studio размещает журналы устройства в следующем месте, где ApplicationId — это уникальный идентификатор приложения, который используется в созданном манифесте APK и идентифицирует ваше приложение на вашем устройстве и в магазине Google Play: /data/data/ ApplicationId /lldb/log Или, если к устройству обращаются несколько пользователей, журналы помещаются в следующее место, где AndroidUserId — это уникальный идентификатор пользователя на устройстве: /data/user/ AndroidUserId / ApplicationId /lldb/log Сведения об использовании LLDB для удаленной отладки см. в разделе Удаленная отладка .
Перед запуском	См. Определение операций перед запуском .

Вкладка «Профилирование»

Необходимо установить флажок «Включить расширенное профилирование», чтобы включить определенные функции Android Profiler , когда ваше устройство работает под управлением Android 7.1 или более ранней версии.

Android-тесты

Тестовый шаблон, который вам следует использовать, зависит от вашего исходного набора . Шаблон инструментальных тестов Android предназначен для инструментального тестирования . Шаблон Android JUnit предназначен для локального модульного теста.

Примечание. Если вы используете Firebase Test Lab для тестирования на различных устройствах, вы можете использовать шаблон Android JUnit для определения инструментированных тестов. Дополнительную информацию см. в разделе «Выполнение тестов с помощью Firebase Test Lab» .

Следующие описания вкладок охватывают вкладки и поля шаблона инструментированного теста Android. Информацию о вкладках и полях тестового шаблона Android JUnit см. на странице « Конфигурация запуска/отладки IntelliJ: JUnit» .

Вкладка «Общие»

На вкладке «Общие» вы можете указать местоположение теста, инструментарий, оболочку adb и параметры развертывания.

Поле	Описание
Модуль	Выберите модуль , к которому нужно применить эту конфигурацию.
Тест	В этой области укажите расположение тестов, которые вы хотите запустить: Все в модуле — запустить все тесты из выбранного модуля. Все в пакете — запустить все тесты из пакета, указанного в поле Пакет . Введите имя или нажмите «Еще» , чтобы выбрать пакет в диалоговом окне. Класс — запуск тестов класса, указанного в поле Класс . Введите имя или нажмите «Дополнительно» , чтобы выбрать класс в диалоговом окне. Метод — Запустите метод тестирования. В поле Класс укажите класс, содержащий метод. В поле Метод укажите метод. Введите имя или нажмите «Дополнительно» , чтобы выбрать класс или метод в диалоговом окне.
Специальный инструментарий (опционально)	Введите расположение направляющей приборов ; нажмите «Еще» , чтобы использовать диалоговое окно. Файл build.gradle указывает расположение средства запуска инструментов; это значение переопределяет его. По умолчанию обычно используется класс AndroidJUnitRunner из AndroidX Test .
Дополнительные опции	Введите любые параметры am instrument которые вы хотите использовать. Не вводите компонент. Например, если вы используете AndroidJUnitRunner из AndroidX Test , вы можете использовать это поле для передачи бегуну дополнительных параметров, таких как -e size small . По умолчанию: без опций
Параметры цели развертывания: Цель	Выберите вариант: Открыть диалоговое окно «Выбор цели развертывания» — откройте диалоговое окно «Выбор цели развертывания», чтобы выбрать виртуальное или аппаратное устройство. USB-устройство . Используйте аппаратное устройство, подключенное к компьютеру разработки через USB-порт. Если их несколько, появится диалоговое окно, в котором вы сможете выбрать их. Эмулятор — используйте виртуальное устройство. В конфигурации вы можете выбрать AVD; в противном случае он просто использует первый AVD в списке. Матрица устройств Firebase Test Lab — см. раздел «Выполнение тестов с помощью Firebase Test Lab» .
Параметры цели развертывания: использовать то же устройство для будущих запусков.	Если вы хотите в будущем автоматически использовать устройство, выбранное в диалоговом окне «Выбор цели развертывания» , выберите этот параметр. Если устройство недоступно, вы получите диалоговое окно. По умолчанию: не выбрано
Перед запуском	См. Определение операций перед запуском .

Вкладка «Разное»

Вкладка «Разное» содержит лог-код и параметры установки.

Поле	Описание
Logcat: очистить журнал перед запуском	Выберите этот параметр, если вы хотите, чтобы Android Studio удаляла данные предыдущих сеансов из файла журнала перед запуском приложения. По умолчанию: не выбрано.
Варианты установки: пропустить установку, если APK не изменился.	Если этот параметр выбран, Android Studio не будет повторно развертывать APK-файл, если обнаружит, что он не изменился. Если вы хотите, чтобы Android Studio принудительно установила APK, даже если он не изменился, снимите флажок с этой опции. По умолчанию: выбрано
Варианты установки: принудительно остановить запуск приложения перед запуском активности.	Если этот параметр выбран, когда Android Studio обнаружит, что ей не нужно переустанавливать APK, поскольку он не изменился, она принудительно остановит приложение, чтобы оно запускалось с действия средства запуска по умолчанию. Если этот параметр не выбран, Android Studio не останавливает приложение принудительно. Этот параметр работает в сочетании с предыдущим параметром, который контролирует, установлен ли APK или нет. В обоих полях «Параметры установки» оставьте значения по умолчанию, если вы явно не хотите каждый раз принудительно устанавливать установку. В некоторых случаях вам может потребоваться отменить выбор этой опции. Например, если вы пишете механизм метода ввода (IME), принудительная остановка приложения отменяет его выбор в качестве текущей клавиатуры, что может вам не понадобиться. По умолчанию: выбрано
Перед запуском	См. Определение операций перед запуском .

Вкладка «Отладчик»

Укажите параметры отладки на вкладке «Отладчик» .

Для кода C и C++ Android Studio использует отладчик LLDB . В дополнение к обычному пользовательскому интерфейсу Android Studio в окне отладчика имеется вкладка LLDB , позволяющая вводить команды LLDB во время отладки. Вы можете вводить те же команды, которые Android Studio использует для отображения информации в пользовательском интерфейсе отладчика, а также выполнять дополнительные операции.

Для проектов C и C++ на вкладке «Отладчик» можно добавить каталоги символов, а также команды запуска LLDB и пост-подключения. Для этого вы используете кнопки, подобные следующим:

• Добавлять - Добавить каталог или команду.
• Удалять- Выберите каталог или команду, а затем нажмите эту кнопку, чтобы удалить элемент.
• Вверх - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент вверх в списке.
• Вниз - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент вниз в списке.

Дополнительную информацию об отладке в Android Studio см. в разделе «Отладка вашего приложения» .

Поле	Описание
Тип отладки	Выберите один из следующих вариантов: Только Java — отладка только кода Java. Обнаружение автоматически . Позвольте Android Studio выбрать лучший тип отладки для вашего проекта. Только собственный код — отладка собственного кода C или C++. Двойной (Java + Native) — отладка Java и собственного кода в двух отдельных сеансах отладки. Рекомендуется использовать параметр «Определять автоматически», поскольку он позволяет выбрать правильный тип отладки для вашего проекта.
Каталоги символов	Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию C или C++, созданную за пределами Android Studio, вы можете добавить сюда один или несколько каталогов. Android Studio предпочитает использовать любые файлы в этих каталогах, а не файлы, созданные подключаемым модулем Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдет то, что ему нужно. Он рекурсивно ищет файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите наиболее часто используемые каталоги в начало списка. Если вы укажете каталог высоко в дереве, поиск во всех подкаталогах может занять больше времени. Если вы добавите очень конкретный каталог, поиск займет меньше времени. Вам необходимо найти правильный баланс между скоростью и поиском файлов, необходимых для отладки. Например, если у вас есть каталог, содержащий подкаталоги для различных двоичных интерфейсов Android (ABI), вы можете добавить каталог для определенного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите выполнить отладку на другом устройстве. Обратите внимание: вам не нужно добавлять каталоги, содержащие файлы символов Gradle, поскольку отладчик использует их автоматически.
Команды запуска LLDB	Добавьте команды LLDB, которые вы хотите выполнить до того, как отладчик подключится к процессу. Например, вы можете определить настройки для среды, как показано в следующей команде: settings set target.max-memory-read-size 2048 LLDB выполняет команды в порядке сверху вниз.
LLDB POST ATTH	Добавьте команды LLDB, которые вы хотите выполнить сразу после того, как отладчик присоединяется к процессу. Например: process handle SIGPIPE -n true -p true -s false LLDB выполняет команды в порядке сверху вниз.
Хозяин рабочий каталог	Укажите рабочий каталог LLDB.
Регистрация: целевые каналы	Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды - так что это не слишком медленно, но содержит необходимую информацию для проблем с устранением неполадок. Журнал часто требуется для отчетов об ошибках Android Studio. Это по умолчанию lldb process:gdb-remote packets Вы можете изменить по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной platform : lldb process platform :gdb-remote packets Для получения полного списка команд журнала введите команду log list из окна оболочки LLDB в Android Studio. Android Studio помещает журналы устройств в следующем месте, где ApplicationId - это уникальный идентификатор приложения, который используется в вашем застроенном манифесте APK, и идентифицирует ваше приложение на вашем устройстве и в магазине Google Play: /data/data/ ApplicationId /lldb/log Или, если несколько пользователей получают доступ к устройству, он помещает журналы в следующем месте, где AndroidUserId является уникальным идентификатором для пользователя на устройстве: /data/user/ AndroidUserId / ApplicationId /lldb/log Информацию об использовании LLDB для удаленной отладки см. В удаленной отладке .
Перед запуском	См. Определение перед операциями запуска .

App Engine Devappserver

Эта конфигурация запуска/отладки применима к платформе Google Cloud. Для получения дополнительной информации см. Запуск, тестирование и развертывание бэкэнда . Когда вы выполняете эти шаги и синхронизируйте свой проект с файлом build.gradle , Android Studio создает для вас конфигурацию приложения Devappserver.

Обратите внимание, что шаблон Engine Server App Intelly Idea - это другой шаблон, который недоступен в Android Studio.

Поле	Описание
Только один экземпляр	Если вы хотите убедиться, что в настоящее время выполняется только один экземпляр конфигурации Run/Debug, выберите эту опцию. Это не позволяет одновременно несколько прогонов одной и той же конфигурации. По умолчанию: выбрано
Модуль	Выберите модуль , чтобы применить эту конфигурацию.
Синхронизировать с конфигурацией Build.Gradle	Если вы добавите модуль двигателя приложений и синхронизируйте в файл build.gradle , поля конфигурации Devappserver App Engine заполняются для вас (рекомендуется). Выбор файла> Sync Project с Files Files также синхронизирует проект. По умолчанию: выбрано
App Engine SDK	Введите путь к Google App Engine SDK для Java на локальной машине. Нажмите ... Чтобы выбрать его из диалога.
Военный путь	Введите путь к каталогу приложения Archive Application (война) приложения, которое вы развертываете на локальном сервере разработки. Нажмите ... Чтобы выбрать его из диалога.
VM Args	Укажите параметры командной строки, которые вы хотите передать в виртуальную машину для запуска Devappserver. При указании параметров: Используйте пространства, чтобы разделить разные параметры. Для вариантов, которые имеют места, приложите пространство в кавычки ( " " ). Если вариант включает в себя кавычки, добавьте Backslash перед кавычками ( \" ). Для получения дополнительной информации о вариантах виртуальной машины см. Документацию для вашей версии J2SE, такой как java JDK 7 и java JDK 8 . По умолчанию: нет параметров
Адрес сервера	Введите адрес хоста для использования для сервера. Возможно, вам придется предоставить адрес, чтобы иметь возможность получить доступ к серверу разработки с другого компьютера в вашей сети. Адрес 0.0.0.0 позволяет как доступ к Localhost, так и на имя хоста. По умолчанию: Localhost
Серверный порт	Введите номер порта для использования для сервера. По умолчанию: 8080
Отключить проверку для приложения Engine SDK обновления	Если будет дан, сервер разработки не будет связываться с App Engine , чтобы проверить наличие нового выпуска SDK. По умолчанию сервер проверяет новую версию по запуску и печатает сообщение, если доступна новая версия.
Перед запуском	См. Определение перед операциями запуска .

Носит конфигурации запуска ОС/отладки

Шаблоны и Wear OS Secutemation, Tile и Watch Face позволяют запускать или отлаживать приложения OS OS на виртуальных или аппаратных устройствах. Большинство параметров конфигурации шаблона такие же, как и параметры приложения Android . Вот варианты, которые более специфичны для конфигураций Wear OS/отладки:

• Для всех конфигураций износа/отладки вам необходимо выбрать конкретный источник данных, плитка или часы (в зависимости от шаблона), чтобы применить конфигурацию. Как правило, каждая из этих объектов соответствует классу в вашем коде.
• Для конфигурации запуска осложнений OS/отладки вы должны выбрать слот , в котором вы хотите поместить данные о осложнениях, предоставленные источником данных осложнений. Вы можете выбрать его вверху, вправо, внизу, влево или фон лица.
• Для конфигурации запуска осложнений OS/отладки необходимо также выбрать тип данных осложнений, предоставленных источником данных осложнений. Типы, которые вы можете выбрать, ограничены теми, которые предоставляются выбранным источником данных осложнений и поддерживаются выбранным слотом. Список типов данных осложнений см. Типы и поля .

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

,

Когда вы запускаете, отлаживает или тестирует свой код, Android Studio использует конфигурацию запуска/отладки, чтобы определить, как выполнить операцию. Как правило, изначально созданной конфигурации достаточно для запуска или отладки приложения. Тем не менее, вы можете изменить и создавать новые конфигурации и изменить шаблоны конфигурации в соответствии с процессом разработки, как описано на этой странице.

Для получения дополнительной информации также см. Следующую документацию Intellij:

• Запуск/отладка конфигурации

О конфигурациях запуска/отладки

Конфигурации запуска/отладка указывают такие детали, как установка, запуск и тестирование приложений. Вы можете определить конфигурацию для единовременного использования или сохранить ее для будущего использования. После его сохранения вы можете выбрать конфигурацию из раскрывающегося списка Select Run/Debug Configuration на панели инструментов . Android Studio сохраняет конфигурации как часть проекта.

Первоначально созданная конфигурация запуска/отладки

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

Объем проекта и контроль версий

Запуск/отладка конфигурации и изменения шаблона применяются только к текущему проекту. Вы можете поделиться конфигурацией запуска/отладки (но не шаблона) через систему управления версиями. Для получения дополнительной информации о том, как поделиться конфигурацией, см. Имя и поделиться параметрами конфигурации .

Откройте диалог конфигураций запуска/отладки

Чтобы открыть диалог конфигураций запуска/отладка, выберите «Запустить» > «Редактировать конфигурации» . Появится диалоговое окно «Конфигурации конфигурации/отладки» , как показано на рисунке 1.

Рисунок 1 . Диалог конфигураций запуска/отладки

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

В этом диалоге вы можете:

• Создайте новые конфигурации запуска/отладки .
• Редактировать конфигурации запуска/отладка.
• Редактировать шаблоны конфигурации.
• Сортировка и групповые конфигурации.

Создать новую конфигурацию запуска/отладки

Вы можете определить новые конфигурации запуска/отладки из диалога конфигураций запуска/отладки , окна проекта или редактора кода. Новая конфигурация должна основываться на шаблоне конфигурации .

В диалоговом окне «Конфигурации»/«Конфигурации» отображается ваши конфигурации запуска/отладки и доступные шаблоны конфигурации. Вы можете запустить новую конфигурацию непосредственно из шаблона или из копии другой конфигурации. Затем вы можете изменить значения поля по мере необходимости.

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

В редакторе кода вы можете легко создать конфигурацию тестирования и запуска/отладки для класса или метода, а затем выполнить ее.

Когда вы создаете конфигурацию вне диалогового окна конфигураций Run/Debug , конфигурация является временной, если вы ее не сохраните. По умолчанию вы можете иметь до пяти временных конфигураций в проекте до того, как Android Studio начнет их удалять. Чтобы изменить это значение по умолчанию, откройте настройки Android Studio и измените расширенные настройки> запуск/отладка> Предел временных конфигураций . Для получения дополнительной информации о временных конфигурациях см. В создании и сохранении конфигураций временного запуска/отладки .

Запустить конфигурацию на основе шаблона

Чтобы определить конфигурацию запуска/отладки на основе шаблона, выполните следующие действия:

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Нажмите « Добавить новую конфигурацию .
3. Выберите шаблон конфигурации .
4. Введите имя в поле «Имя» .
5. Измените конфигурацию, по мере необходимости.

Обязательно исправьте любые ошибки, отображаемые внизу диалога.

6. Нажмите Применить или ОК .

Запустить конфигурацию из копии

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

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Выберите существующую конфигурацию запуска/отладки на левой панели.
3. Нажмите на конфигурацию копирования .
4. Введите имя в поле «Имя» .
5. Измените конфигурацию, по мере необходимости.

Обязательно исправьте любые ошибки, отображаемые внизу диалога.

6. Нажмите Применить или ОК .

Определите конфигурацию для элемента в проекте

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

• Активность Java File: шаблон приложения Android .
• Пакет: приборные тесты Android или шаблон Android Junit , в зависимости от вашего исходного набора . Если вы выберете инструментальный тест , то он использует шаблон Android, инструментальные тесты. Если вы выбираете локальный модульный тест , то он использует шаблон Android Junit. Для локального модульного теста вы можете при желании запустить с покрытием кода. Для получения дополнительной информации см. Покрытие кода .

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

1. Откройте проект в Android или Project View .
2. В окне проекта щелкните правой кнопкой мыши тестируемый элемент и выберите либо filename запустить или filename . Android Studio создает временную конфигурацию запуска/отладки и запускает ваше приложение.
3. Откройте раскрывающий список конфигурации Select/Debug на панели инструментов.
4. Выберите «Сохранить конфигурацию» из параметров рядом с конфигурацией, которую вы хотите сохранить.
   

   Рисунок 2 . Сохранить конфигурацию

Примечание. Если вы щелкните правой кнопкой мыши и запускаете или отлаживаете один и тот же элемент (но не на действие), Android Studio создает новую конфигурацию.

Определите тестовую конфигурацию для класса или метода

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

Android Studio использует инструментальные тесты Android или шаблон Android Junit , в зависимости от вашего исходного набора . Для локального модульного теста вы можете при желании запустить с покрытием кода .

Чтобы создать конфигурацию запуска/отладки для класса или метода в вашем коде Java, выполните следующие действия:

1. Откройте проект в Android или Project View .
2. Откройте файл Java в редакторе кода.
3. Выберите класс или метод в коде, а затем нажмите Control+Shift+T (команда+shift+t).
4. Выберите «Создать новый тест» из появляющегося меню.
5. В диалоговом окне «Создать тест» опционально измените или установите значения и нажмите OK .
6. В диалоговом окне «Выберите каталог назначения» , выберите, где в проекте вы хотите, чтобы Android Studio провела тест. Вы можете указать местоположение по структуре каталога или выбрав соседний класс.
7. Нажмите ОК .

   Новый тест появляется в окне проекта в соответствующем наборе источников теста.

8. Чтобы запустить тест, сделайте одно из следующих действий:
   • В окне проекта щелкните правой кнопкой мыши тест и выберите «Запустить» или отладку .
   • В редакторе кода щелкните правой кнопкой мыши определение класса или имя метода в тестовом файле и выберите «Запуск» или «Отладь» , чтобы проверить все методы в классе.
9. Откройте раскрывающий список конфигурации Select/Debug на панели инструментов.
10. Выберите «Сохранить конфигурацию» из параметров рядом с конфигурацией, которую вы хотите сохранить.
    

    Рисунок 3 . Сохранить конфигурацию

Запустить или отлаживать приложение, используя сохраненную конфигурацию

Если вы сохранили конфигурацию запуска/отладки, вы можете выбрать ее перед запуском или отладкой.

Чтобы использовать сохраненную конфигурацию запуска/отладки, выполните следующие действия:

1. Выберите конфигурацию Run/Debug из раскрывающегося списка Select Run/Debug Configuration на панели инструментов .

Раскрывающийся список слева от бега и отладка ; например, .

2. Выберите «Запустить» > «Запустить» или запустить > отладку .

В качестве альтернативы нажмите «Запуск или отладка .

Редактировать конфигурацию запуска/отладки

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

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Выберите конфигурацию на левой панели.
3. Измените конфигурацию, по мере необходимости.

Обязательно исправьте любые ошибки, отображаемые внизу диалога.

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

Редактировать шаблон конфигурации запуска/отладки

Вы можете редактировать шаблоны конфигурации, предоставленные Android Studio, чтобы соответствовать вашему процессу разработки. Когда вы редактируете шаблон, он не влияет на существующие конфигурации, которые используют шаблон. Так, например, если вам нужно создать ряд конфигураций определенного типа, вы можете редактировать шаблон, а затем изменить его обратно, когда вы закончите.

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

Чтобы редактировать шаблон, выполните эти шаги:

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Нажмите «Редактировать шаблоны конфигурации» ....
3. Выберите шаблон конфигурации.
4. Измените конфигурацию, по мере необходимости.

Обязательно исправьте любые ошибки, отображаемые внизу диалога.

5. Нажмите Применить или ОК .

Конфигурации сортировки и группы

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

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

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Выберите папку, которая содержит конфигурации.
3. Нажмите «Сортировать конфигурации» .
4. Нажмите ОК, чтобы закрыть диалог.

Для группы конфигурации в папках выполните следующие действия:

1. Откройте диалоговое окно конфигурации запуска/отладки .
2. Выберите папку, которая содержит конфигурации.
3. Нажмите « Создать новую папку» .
4. Введите имя в поле «Имя папки» .
5. Нажмите применить , чтобы сохранить имя.

Перетащите элементы из одной и той же категории шаблона в папку.

Закажите папки и конфигурации в одной и той же категории шаблонов, перетаскивая их в положение.

Нажмите ОК, чтобы закрыть диалог.

Определите операции перед напуском

Вы можете указать задачи для выполнения перед применением конфигурации запуска/отладки. Задачи выполняются в том порядке, в котором они появляются в списке.

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

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

1. В нижней части диалога конфигураций запуска/отладки перед запуском (вам может потребоваться прокрутить вниз), нажмите « Добавитьи выберите тип задачи. Если открывается диалог, заполните поля и нажмите ОК .
2. Добавьте больше задач по мере необходимости.
3. Чтобы заказать задачи, перетащите их или выберите задачу и нажмите и вниз Чтобы переместить его вверх или вниз в списке.
4. Выберите Показать эту страницу, если вы хотите отобразить настройки конфигурации Run/Debug, прежде чем их применять.

   Этот вариант отменен по умолчанию.

5. Выберите «Активное окно инструмента» , если вы хотите, чтобы окно инструмента «Запустить» или «Инструмент отладки» было активировано при запуска или отлаживании вашего приложения.

   Эта опция выбрана по умолчанию.

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

1. Выберите задачу.
2. Нажмите « Удалить» .

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

1. Выберите задачу.
2. Нажмите «Редактировать» .
3. Отредактируйте настройки задачи в открытии диалога, а затем нажмите OK .

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

Задача	Описание
Запустите внешний инструмент	Запустите приложение, которое внешнее Android Studio. В диалоговом окне «Внешние инструменты» выберите одно или несколько приложений, которые вы хотите запустить, а затем нажмите OK . Если приложение еще не определена в Android Studio, добавьте его определение в диалоговое окно «Создание инструментов» . Для получения дополнительной информации см. Настройку сторонних инструментов и внешних инструментов .
Запустите другую конфигурацию	Выполните одну из существующих конфигураций запуска/отладки. В диалоговом окне «Выберите конфигурацию» , выберите конфигурацию для выполнения, а затем нажмите ОК .
Делать	Составьте проект или модуль. Android Studio выполняет команду Make Module , если конфигурация Run/Debug указывает конкретный модуль, или она выполняет команду Make Project , если модули не указаны.
Сделать проект	Составьте проект. Android Studio выполняет команду Make Project .
Сделать, без проверки ошибок	Эта опция такая же, как и Make , за исключением того, что Android Studio выполняет конфигурацию выполнения/отладки независимо от результата компиляции.
Строить артефакты	Не поддерживается в Android Studio.
Запустите задачу Gradle	Запустите задачу Gradle. В диалоговом окне , который открывается, укажите детали, а затем нажмите ОК . Для получения дополнительной информации см. Gradle .
Gradle-ware Make	Составьте проект и запустите Gradle.
App Engine Gradle Builder	Задача App Engine Gradle Builder синхронизирует проект, а затем создает модуль.

Шаблоны конфигурации

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

• Android-приложение
• Андоидные тесты
• App Engine Devappserver
• Носить осложнение OS, плитка и смотреть лицо

Примечание: Android Studio 2.1. X и Lower имели нативный шаблон приложения, которого нет новых версий. Если у вас есть нативный шаблон приложения в проекте, Android Studio преобразует его в приложение Android при загрузке проекта. Конверт -диалог проекта проводит вас через процесс.

Неподдерживаемые шаблоны

Следующие неподдерживаемые шаблоны поступают от Intellij Idea и не являются специфичными для разработки Android с Android Studio. Для получения информации об использовании этих шаблонов перейдите по ссылкам на документацию Intellij Idea.

• Приложение
• Сложный
• Градл
• классный
• JAR Application
• Java Scratch
• Юнит
• Котлин
• Котлин Скрипт
• Отдаленная отладка
• Shell Script
• Тест

Общие параметры конфигурации

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

Android Studio хранит общую конфигурацию Run/Debug в отдельных файлах XML в папке project_directory /.idea/runConfigurations/ . Для получения дополнительной информации см. Формат на основе каталогов в документации IntelliJ Projects.

Android-приложение

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

Общая вкладка

На вкладке General вы можете указать параметры установки, запуска и развертывания. Вкладка Разное также содержит параметры установки.

Поле	Описание
Модуль	Выберите модуль , чтобы применить эту конфигурацию.
Параметры установки: развернуть	Выберите опцию: По умолчанию APK - Создайте и разверните APK для выбранного в настоящее время вариант . APK из приложения - создать и развернуть приложение из пакета приложений Android . То есть Android Studio сначала преобразует проект вашего приложения в комплект приложений, который включает в себя весь скомпилированный код и ресурсы вашего приложения. Затем из этого пакета приложений Android Studio генерирует только APK, которые необходимы для развертывания вашего приложения на подключенное устройство. Обычно вам следует использовать эту опцию при тестировании пакета приложений, который вы собираетесь загрузить в Google Play, потому что развертывание из пакета приложений продлевает общее время сборки. Пользовательский артефакт - не поддерживается в Android Studio. Ничего - не устанавливайте APK на устройство. Например, если вы предпочитаете вручную установить APK, вам не нужна Android Studio для его установки.
Параметры установки: развернуть как приложение Instant	Если ваше приложение поддерживает мгновенный опыт, то есть, вы либо добавляете поддержку для мгновенных приложений при создании нового проекта , либо создаете один или несколько модулей функций с интенсивностью рядом с развертыванием как мгновенное приложение .
Параметры установки: функции для развертывания	Если ваше приложение включает в себя модули функций , установите флажок рядом с каждой функцией, которую вы хотите включить при развертывании вашего приложения. Вы видите эту опцию только в том случае, если ваше приложение включает в себя модули функций. Примечание. Если вы хотите проверить загрузку и установку модулей функций по требованию, вы должны сделать это после публикации пакета приложений, а затем использовать внутреннюю тестовую дорожку Play Console. Чтобы узнать больше, прочитайте , загрузите свой пакет приложений в игровой консоли .
Параметры установки: установить флаги	Введите любые параметры pm install которые вы хотите использовать. Форматируйте параметры так же, как вы бы в командной строке, но без пути. Вот несколько примеров: -i foo.bar.baz -r /path/to/apk и -d -r По умолчанию: нет параметров.
Параметры запуска: запуск	Выберите опцию: Ничего - не запускайте ничего, когда вы выбираете запуск или отладку . Однако, если ваше приложение уже работает, и вы выбираете отладку , Android Studio прикрепляет отладчик к процессу приложения. Активность по умолчанию - запустите деятельность, которую вы отметили как стартап в манифесте. Например: <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> Указанная деятельность - запустите конкретную активность приложения в вашем модуле. При выборе поле активности появляется ниже, где вы можете ввести имя деятельности, которое вы хотите запустить, или нажать больше , чтобы выбрать действие из списка. URL - запустите URL, который соответствует фильтру намерения в манифесте вашего приложения. При выборе поле URL появляется ниже, где вы можете войти в URL. Вы должны заполнить это поле, чтобы запустить приложение Android Instant . Вы также можете использовать это для тестирования ваших ссылок на приложение Android .
Параметры запуска: флаги запуска	Введите любые параметры ADB am start , которые вы хотите использовать. Отформатируйте параметры так же, как вы бы в командной строке, но без намерения. Например: -W Эта опция не отображается, если вы выбрали стартовую стоимость ничего . По умолчанию: нет параметров.
Целевые варианты развертывания: цель	Выберите опцию: Откройте диалоговое окно «Развертывание» - откройте диалоговое окно «Выбрать цель развертывания», чтобы выбрать виртуальное или аппаратное устройство. Устройство USB - используйте аппаратное устройство, подключенное к вашему компьютеру разработки через USB -порт. Если есть более одного, появляется диалог, чтобы вы могли выбрать его. Эмулятор - используйте виртуальное устройство. В конфигурации вы можете выбрать AVD; В противном случае он просто использует первый AVD в списке.
Опции целей развертывания: Используйте то же устройство для будущих запусков	По умолчанию эта опция отменилась, так что каждый раз, когда вы запускаете приложение, выберет диалоговое окно «Выбор развертывания» , чтобы вы выбрали устройство. Когда вы выбираете эту опцию, а затем запускаете приложение, представлен диалоговое окно «Выбрать развертывание» , чтобы выбрать устройство. Затем каждый раз, когда вы запускаете приложение, оно запускается на выбранном вами устройстве, не отображая диалог Select Deployment . Чтобы запустить приложение на другом устройстве, либо отмените решение , используйте одно и то же устройство для будущих запусков , либо остановите приложение с app Run> Stop или Stop , а затем запустите это снова. Диалог «Выбрать развертывание» будет отображаться, так что вы можете выбрать устройство.
Перед запуском	См. Определение перед операциями запуска .

Разное вкладка

На вкладке Разное вы можете указать параметры LogCat, установку, запуска и развертывания. Вкладка General также содержит параметры установки.

Поле	Описание
LogCat: Show LogCat автоматически	При выборе этой опции окно LogCat открывается каждый раз, когда вы успешно развертываете и запускаете приложение, используя эту конфигурацию. По умолчанию: выбрано.
LogCat: очистить журнал перед запуском	Выберите эту опцию, если вы хотите, чтобы Android Studio удаляла данные из предыдущих сеансов из файла журнала перед запуском приложения. По умолчанию: отказано.
Параметры установки: пропустить установку, если APK не изменилась.	При выборе Android Studio не переведите ваш APK, если он обнаруживает, что он неизменен. Если вы хотите, чтобы Android Studio заставила установить APK, даже если он не изменился, то отмените эту опцию. По умолчанию: выбрано
Параметры установки: заставьте запуск приложения перед запуском активности	Если выбран, когда Android Studio обнаруживает, что ей не нужно переустановить APK, потому что он не изменился, он принудил приложение, так что приложение начинается с активности запуска по умолчанию. Если этот вариант отменен, Android Studio не заставляет приложение. Эта опция работает с предыдущей опцией, которая контролирует, установлен ли APK или нет. Для обоих полей установки , оставьте их по умолчанию, если вы явно не хотите заставить установку каждый раз. В некоторых случаях вы можете отказаться от этого варианта. Например, если вы пишете механизм метода ввода (IME), принудительное приложение отменит его как текущую клавиатуру, которую вы, возможно, не захотите. По умолчанию: выбрано
Перед запуском	См. Определение перед операциями запуска .

Вкладка отладчика

Укажите параметры отладки на вкладке Debugger .

Для кода C и C ++ Android Studio использует отладчик LLDB . В дополнение к обычному пользовательскому интерфейсу Android Studio, окно отладчика имеет вкладку LLDB , которая позволяет вводить команды LLDB во время отладки. Вы можете ввести те же команды, которые Android Studio использует для отображения информации в пользовательском интерфейсе отладчика, и вы можете выполнить дополнительные операции.

Для проектов C и C ++ вы можете добавить каталоги символов, а также запуск LLDB и публиковать команды прикрепления, на вкладке отладчика . Для этого вы используете кнопки, похожие на следующее:

• Добавлять - Добавить каталог или команду.
• Удалять- Выберите каталог или команду, а затем нажмите эту кнопку, чтобы удалить элемент.
• Вверх - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент в списке.
• Вниз - Выберите каталог или команду, а затем нажмите эту кнопку, чтобы переместить элемент в списке.

Смотрите отладку в вашем приложении для получения дополнительной информации о отладке в Android Studio.

Поле	Описание
Тип отладки	Выберите один из следующих вариантов: Только Java - отладка кода Java. Обнаружение автоматически - пусть Android Studio выберите лучший тип отладки для вашего проекта. Только нативно - отладка нативного C или C ++ Code. Двойной (Java + Native) - отладка Java и Native Code в двух отдельных сессиях отладки. Рекомендуется опция Detect Automatic, потому что он выбирает правильный тип отладки для вашего проекта.
Символьные каталоги	Если вы хотите добавить файлы символов для предоставления отладчику с помощью информации C или C ++, созданной за пределами Android Studio, вы можете добавить здесь один или несколько каталогов. Android Studio преимущественно использует любые файлы в этих каталогах по сравнению с файлами, сгенерированными плагином Android для Gradle . Отладчик ищет каталоги сверху донизу, пока он не найдет то, что ему нужно. Он ищет рекурсивно через файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите используемые каталоги, используемые чаще всего в верхней части списка. Если вы указываете каталог высокого уровня в дереве, для поиска всех подкаталогов может потребоваться больше времени. Если вы добавите очень специфический каталог, для поиска требуется меньше времени. Вам нужно найти правильный баланс между скоростью и поиском необходимых файлов для отладки. Например, если у вас есть каталог, который содержит подкаталог для различных двоичных интерфейсов Android (ABIS), вы можете добавить каталог для конкретного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите отладить на другом устройстве. Обратите внимание, что вам не нужно добавлять каталоги, содержащие файлы символов Gradle, потому что отладчик использует их автоматически.
Команды запуска LLDB	Добавьте команды LLDB, которые вы хотите выполнить, прежде чем отладчик приложит к процессу. Например, вы можете определить настройки для среды, как показано в следующей команде: settings set target.max-memory-read-size 2048 LLDB выполняет команды в порядке сверху вниз.
LLDB POST ATTH	Добавьте команды LLDB, которые вы хотите выполнить сразу после того, как отладчик присоединяется к процессу. Например: process handle SIGPIPE -n true -p true -s false LLDB выполняет команды в порядке сверху вниз.
Хозяин рабочий каталог	Укажите рабочий каталог LLDB.
Регистрация: целевые каналы	Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды - так что это не слишком медленно, но содержит необходимую информацию для проблем с устранением неполадок. Журнал часто требуется для отчетов об ошибках Android Studio. Это по умолчанию lldb process:gdb-remote packets Вы можете изменить по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной platform : lldb process platform :gdb-remote packets Для получения полного списка команд журнала введите команду log list из окна оболочки LLDB в Android Studio. Android Studio помещает журналы устройств в следующем месте, где ApplicationId - это уникальный идентификатор приложения, который используется в вашем застроенном манифесте APK, и идентифицирует ваше приложение на вашем устройстве и в магазине Google Play: /data/data/ ApplicationId /lldb/log Или, если несколько пользователей получают доступ к устройству, он помещает журналы в следующем месте, где AndroidUserId является уникальным идентификатором для пользователя на устройстве: /data/user/ AndroidUserId / ApplicationId /lldb/log Информацию об использовании LLDB для удаленной отладки см. В удаленной отладке .
Перед запуском	См. Определение перед операциями запуска .

Профилирование вкладка

Опция расширенного профилирования для включения необходимо проверить, чтобы включить определенные функции в Android Profiler , когда ваше устройство работает Android 7.1 или ниже.

Андоидные тесты

Тестовый шаблон, который вы должны использовать, зависит от вашего исходного набора . Шаблон приборных тестов Android предназначен для инструментального теста . Шаблон Android Junit предназначен для локального модульного теста.

Примечание. Если вы используете Test Lab Firebase для тестирования на различных устройствах, вы можете использовать шаблон Android Junit для определения ваших инструментальных тестов. Для получения дополнительной информации см. Запустите свои тесты с помощью тестовой лаборатории Firebase .

Следующие описания вкладок охватывают вкладки и поля для инструментального тестового шаблона Android. Информацию о вкладках и полях для тестового шаблона Android Junit см. В конфигурации Intellij Run/Debug: Junit Page.

Общая вкладка

В общем вкладках вы можете указать местоположение тестирования, бегун на приборе, оболочку ADB и параметры развертывания.

Поле	Описание
Модуль	Выберите модуль , чтобы применить эту конфигурацию.
Тест	В этой области укажите местоположение тестов, которые вы хотите запустить: Все в модуле - запустите все тесты из выбранного модуля. All In Package - запустите все тесты из пакета, указанного в поле пакета . Введите имя или нажмите больше , чтобы выбрать пакет из диалога. Класс - Запуск тестов класса, указанного в поле класса . Введите имя или нажмите больше , чтобы выбрать класс из диалога. Метод - запустить метод испытания. В поле класса укажите класс, который содержит метод. В поле метода укажите метод. Введите имя или нажмите больше , чтобы выбрать класс или метод из диалога.
Конкретный инструментальный бегун (необязательно)	Введите местоположение инструментального бегуна ; Нажмите больше , чтобы использовать диалог. Файл build.gradle указывает местоположение инструментального бегуна; Это значение переопределяет его. The default is typically the AndroidJUnitRunner class from AndroidX Test .
Extra options	Type any adb am instrument options you want to use. Don't type the component. For example, if you're using AndroidJUnitRunner from AndroidX Test , you can use this field to pass additional options to the runner, such as -e size small . Default: no options
Deployment Target Options: Target	Select an option: Open Select Deployment Target Dialog - Open the Select Deployment Target dialog to select a virtual or hardware device. USB Device - Use a hardware device connected to your development computer through a USB port. If there's more than one, a dialog appears so you can select it. Emulator - Use a virtual device. In a configuration, you can select an AVD; otherwise, it just uses the first AVD in the list. Firebase Test Lab Device Matrix - See Run Your Tests with Firebase Test Lab .
Deployment Target Options: Use same device for future launches	If you want to automatically use the device you chose through the Select Deployment Target dialog in the future, select this option. If the device isn't available, you'll receive a dialog. Default: deselected
Before Launch	See Defining Before Launch Operations .

Miscellaneous tab

The Miscellaneous tab contains logcat and installation options.

Поле	Описание
Logcat: Clear log before launch	Select this option if you want Android Studio to remove data from previous sessions from the log file before starting the app. Default: deselected.
Installation Options: Skip installation if APK has not changed	When selected, Android Studio doesn't redeploy your APK if it detects that it's unchanged. If you want Android Studio to force an install of the APK, even if it hasn't changed, then deselect this option. Default: selected
Installation Options: Force stop running application before launching activity	If selected, when Android Studio detects that it doesn't have to reinstall an APK because it hasn't changed, it will force-stop the app so that the app starts from the default launcher activity. If this option is deselected, Android Studio doesn't force-stop the app. This option works in conjunction with the previous option that controls whether an APK is installed or not. For both Installation Options fields, leave them at the default unless you explicitly want to force an install every time. In some cases you might want to deselect this option. For example, if you're writing an input method engine (IME), force-stopping the app deselects it as the current keyboard, which you might not want. Default: selected
Before Launch	See Defining Before Launch Operations .

Debugger tab

Specify debug options in the Debugger tab.

For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.

For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:

• Добавлять - Add a directory or command.
• Удалять- Select a directory or command, and then click this button to remove the item.
• Вверх - Select a directory or command, and then click this button to move the item up in the list.
• Вниз - Select a directory or command, and then click this button to move the item down in the list.

See Debug Your App for more information about debugging in Android Studio.

Поле	Описание
Debug type	Выберите один из следующих вариантов: Java only - Debug Java code only. Detect Automatically - Let Android Studio choose the best debug type for your project. Native Only - Debug native C or C++ code. Dual (Java + Native) - Debug Java and native code in two separate debug sessions. The Detect Automatically option is recommended because it chooses the right debug type for your project.
Symbol Directories	If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically.
LLDB Startup Commands	Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: settings set target.max-memory-read-size 2048 LLDB executes the commands in order from top to bottom.
LLDB Post Attach Commands	Add LLDB commands that you want to execute right after the debugger attaches to the process. Например: process handle SIGPIPE -n true -p true -s false LLDB executes the commands in order from top to bottom.
Host working directory	Specify the LLDB working directory.
Logging: Target channels	Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is lldb process:gdb-remote packets You can change the default to gather more information. For example, the following log options gather information about a specific platform : lldb process platform :gdb-remote packets For a complete list of log commands, enter the log list command from an LLDB shell window in Android Studio. Android Studio places device logs in the following location, where ApplicationId is the unique application ID that's used in your built APK manifest, and identifies your app on your device and in the Google Play Store: /data/data/ ApplicationId /lldb/log Or, if multiple users access a device, it places the logs in the following location, where AndroidUserId is a unique identifier for a user on the device: /data/user/ AndroidUserId / ApplicationId /lldb/log For information about using LLDB for remote debugging, see Remote Debugging .
Before Launch	See Defining Before Launch Operations .

App Engine DevAppServer

This run/debug configuration applies to the Google Cloud Platform. For more information, see Running, Testing, and Deploying the Backend . When you follow these steps and sync your project to the build.gradle file, Android Studio creates an App Engine DevAppServer configuration for you.

Note that the IntellJ IDEA App Engine Server template is a different template that's not available in Android Studio.

Поле	Описание
Single instance only	If you want to make sure that only one instance of the run/debug configuration is currently executed, select this option. It doesn't allow multiple runs of the same configuration at the same time. Default: selected
Модуль	Select a module to apply this configuration to.
Synchronize with build.gradle configuration	If you add an App Engine module and sync to the build.gradle file, the App Engine DevAppServer configuration fields are filled in for you (recommended). Selecting File > Sync Project with Gradle Files also syncs the project. Default: selected
App Engine SDK	Type a path to a Google App Engine SDK for Java on the local machine. Click ... to select it from a dialog.
War Path	Type a path to the Web Application Archive (WAR) directory of the app you're deploying on the local development server. Click ... to select it from a dialog.
VM Args	Specify the command-line options you want to pass to the VM for launching the DevAppServer. When specifying the options: Use spaces to separate different options. For options that have spaces, enclose the space in quotation marks ( " " ). If an option includes quotation marks, add a backslash before the quotation mark ( \" ). For more information about VM options, see the documentation for your J2SE version, such as java JDK 7 and java JDK 8 . Default: no options
Server Address	Type the host address to use for the server. You might need to provide the address to be able to access the development server from another computer on your network. An address of 0.0.0.0 allows both localhost access and hostname access. Default: localhost
Server Port	Type the port number to use for the server. Default: 8080
Disable Check for App Engine SDK Updates	If given, the development server will not contact App Engine to check for the availability of a new release of the SDK. By default, the server checks for a new version on startup, and prints a message if a new version is available.
Before Launch	See Defining Before Launch Operations .

Wear OS run/debug configurations

The Wear OS Complication, Tile, and Watch Face templates let you run or debug Wear OS apps on virtual or hardware devices. Most of the template configuration options are the same as the Android App options . Here are the options that are more specific to the Wear OS run/debug configurations:

• For all Wear run/debug configurations, you have to select a specific complication data source, tile, or watch face (depending on the template) to apply the configuration to. Generally each of these entities corresponds to a class in your code.
• For the Wear OS Complication run/debug configuration, you must choose the Slot where you want to put the complication data provided by the complication data source. You can choose to put it at the top, right, bottom, left, or background of the watch face.
• For the Wear OS Complication run/debug configuration, you must also select the Type of the complication data provided by the complication data source. The types you can choose from are limited to those that are provided by the chosen complication data source and supported by the chosen slot. For a list of complication data types, see Types and fields .

Alternatively, you can also run these surfaces from the gutter icon that is located next to the declaration of the surface, as shown in the following image.

,

When you run, debug, or test your code, Android Studio uses a run/debug configuration to determine how to perform the operation. Typically, the initially-created configuration is sufficient to run or debug an app. However, you can modify and create new configurations, and modify the configuration templates to suit your development process as described on this page.

For more information, also see the following IntelliJ documentation:

• Run/Debug Configurations

About run/debug configurations

Run/debug configurations specify details such as app installation, launch, and test options. You can define a configuration for one-time use, or save it for future use. After you save it, you can select the configuration from the Select Run/Debug Configuration drop-down list within the toolbar . Android Studio saves configurations as part of the project.

Initially-created run/debug configuration

When you first create a project, Android Studio creates a run/debug configuration for the main activity based on the Android App template . To run or debug your project, you must always have at least one run/debug configuration defined. For this reason, we recommend that you don't delete the initially-created configuration.

Project scope and version control

Run/debug configurations and template changes apply to the current project only. You can share a run/debug configuration (but not a template) through your version control system. For more information about how to share a configuration, see Name and Share Configuration Options .

Open the Run/Debug Configurations dialog

To open the Run/Debug Configurations dialog, select Run > Edit Configurations . The Run/Debug Configurations dialog appears, as shown in figure 1.

Рисунок 1 . The Run/Debug Configurations dialog

The left panel of the dialog groups your defined configurations by template type, and allows you to edit configuration templates at the bottom. You can edit the selected configuration in the right panel. Resize the dialog to see any hidden items.

In this dialog, you can:

• Create new run/debug configurations .
• Edit run/debug configurations.
• Edit configuration templates.
• Sort and group configurations.

Create a new run/debug configuration

You can define new run/debug configurations from the Run/Debug Configurations dialog, the Project window, or the Code Editor. The new configuration must be based on a configuration template .

The Run/Debug Configurations dialog displays your run/debug configurations and the available configuration templates. You can start a new configuration directly from a template, or from a copy of another configuration. You can then change the field values as needed.

Alternatively, you can right-click an item in the Project window to automatically create a configuration specific to that item. For example, if you want to run a particular activity, you can right-click the activity Java file and select Run . Depending on the item, Android Studio uses an Android App , Android Instrumented Tests , or JUnit configuration template to create the configuration.

In the Code Editor, you can easily create a test and run/debug configuration for a class or method, and then execute it.

When you create a configuration outside of the Run/Debug Configurations dialog, the configuration is temporary unless you save it. By default, you can have up to five temporary configurations in the project before Android Studio starts to remove them. To change this default, open Android Studio settings, and change Advanced Settings > Run/Debug > Temporary configurations limit . For more information about temporary configurations, see Creating and Saving Temporary Run/Debug Configurations .

Start a configuration based on a template

To define a run/debug configuration based on a template, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Click Add New Configuration .
3. Select a configuration template .
4. Type a name in the Name field.
5. Modify the configuration, as needed.

Be sure to correct any errors displayed at the bottom of the dialog.

6. Click Apply or OK .

Start a configuration from a copy

To define a run/debug configuration starting from a copy of another configuration, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Select an existing run/debug configuration in the left pane.
3. Click Copy Configuration .
4. Type a name in the Name field.
5. Modify the configuration, as needed.

Be sure to correct any errors displayed at the bottom of the dialog.

6. Click Apply or OK .

Define a configuration for an item in the project

Android Studio can create a run/debug configuration for some items displayed in the Project window. The configuration is based on a configuration template, as follows:

• Activity Java file: The Android App template.
• Package: Android Instrumented Tests or Android JUnit template, depending on your source set . If you select an instrumented test , then it uses the Android Instrumented Tests template. If you select a local unit test , then it uses the Android JUnit template. For a local unit test, you can optionally run with code coverage. For more information, see Code Coverage .

To create a run/debug configuration for an item in your project, follow these steps:

1. Open a project in Android or Project view .
2. In the Project window, right-click a testable item and select either Run filename or Debug filename . Android Studio creates a temporary run/debug configuration and launches your app.
3. Open the Select Run/Debug Configuration drop-down list in the toolbar.
4. Select Save Configuration from the options next to the configuration that you want to save.
   

   Рисунок 2 . Save the configuration

Note: If you right-click and run or debug the same item (but not an activity), Android Studio creates a new configuration.

Define a test configuration for a class or method

Android Studio lets you define a test run configuration for a class or method, and then execute it. For example, if you create a new class, you can create and run a test for it. If the test passes, you can then run the tests for the rest of the project to make sure that your new code doesn't break anything somewhere else.

Android Studio uses the Android Instrumented Tests or Android JUnit template, depending on your source set . For a local unit test, you can optionally run with code coverage .

To create a run/debug configuration for a class or method in your Java code, follow these steps:

1. Open a project in Android or Project view .
2. Open a Java file in the Code Editor.
3. Select a class or method in the code, and then press Control+Shift+T (Command+Shift+T).
4. Select Create New Test from the menu that appears.
5. In the Create Test dialog, optionally change or set the values and click OK .
6. In the Choose Destination Directory dialog, select where in the project you want Android Studio to place the test. You can specify the location by directory structure or by selecting a neighboring class.
7. Нажмите ОК .

   The new test appears in the Project window in the corresponding test source set.

8. To run the test, do one of the following:
   • In the Project window, right-click the test and select Run or Debug .
   • In the Code Editor, right-click a class definition or method name in the test file and select Run or Debug to test all methods in the class.
9. Open the Select Run/Debug Configuration drop-down list in the toolbar.
10. Select Save Configuration from the options next to the configuration that you want to save.
    

    Рисунок 3 . Save the configuration

Run or debug an app using a saved configuration

If you've saved a run/debug configuration, you can select it before you run or debug your app.

To use a saved run/debug configuration, follow these steps:

1. Select the run/debug configuration from the Select Run/Debug Configuration drop-down list within the toolbar .

The drop-down list is to the left of Run and Debug ; например, .

2. Select Run > Run or Run > Debug .

Alternatively, click Run or Debug .

Edit a run/debug configuration

To edit a run/debug configuration, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Select a configuration in the left pane.
3. Modify the configuration, as needed.

Be sure to correct any errors displayed at the bottom of the dialog.

4. Click Apply or OK .

Edit a run/debug configuration template

You can edit the configuration templates provided by Android Studio to suit your development process. When you edit a template, it doesn't affect existing configurations that use the template. So, for example, if you need to create a number of configurations of a certain type, you can edit the template and then change it back when you're done.

Although you can't create new templates, you can create configurations to use similar to a template. You can copy a configuration and edit the copy to create new configurations.

To edit a template, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Click Edit configuration templates... .
3. Select a configuration template.
4. Modify the configuration, as needed.

Be sure to correct any errors displayed at the bottom of the dialog.

5. Click Apply or OK .

Sort and group configurations

In the Run/Debug Configurations dialog, you can order your configurations to find them quickly. You can sort the items in the folder alphabetically, and create new folders to group configurations.

To sort configurations alphabetically, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Select a folder that contains configurations.
3. Click Sort Configurations .
4. Click OK to close the dialog.

To group configurations in folders, follow these steps:

1. Open the Run/Debug Configurations dialog .
2. Select a folder that contains configurations.
3. Click Create New Folder .
4. Type a name in the Folder Name field.
5. Click Apply to save the name.

Drag items from the same template category into the folder.

Order the folders and configurations in the same template category by dragging them into position.

Click OK to close the dialog.

Define before-launch operations

You can specify tasks to execute before applying the run/debug configuration. The tasks are performed in the order they appear in the list.

Note: Defining before launch tasks is an advanced feature. Instead of using this feature, we recommend that you put any preparation logic as tasks in your build.gradle file so they'll be executed when you build from the command line.

To create a task list, follow these steps:

1. At the bottom of the Run/Debug Configurations dialog under Before launch (you may need to scroll down), click Addand select a task type. If a dialog opens, fill in the fields and click OK .
2. Add more tasks as needed.
3. To order the tasks, drag them or select a task and click Up and Down to move it up or down in the list.
4. Select Show this page if you want to display the run/debug configuration settings before applying them.

   This option is deselected by default.

5. Select Active tool window if you want the Run or Debug tool window to be activated when you run or debug your app.

   This option is selected by default.

To remove a task from the list, follow these steps:

1. Select a task.
2. Click Remove .

To edit a task, follow these steps:

1. Select a task.
2. Click Edit .
3. Edit the task settings in the dialog that opens, and then click OK .

The following table lists the available tasks you can add.

Задача	Описание
Run External tool	Run an application that's external to Android Studio. In the External Tools dialog, select one or more applications that you want to run and then click OK . If the application isn't defined in Android Studio yet, add its definition in the Create Tools dialog. For more information, see Configuring Third-Party Tools and External Tools .
Run Another Configuration	Execute one of the existing run/debug configurations. In the Choose Configuration to Execute dialog, select a configuration to execute and then click OK .
Делать	Compile the project or the module. Android Studio executes the Make Module command if the run/debug configuration specifies a particular module, or it executes the Make Project command if no modules are specified.
Make Project	Compile the project. Android Studio executes the Make Project command .
Make, no error check	This option is the same as Make , except that Android Studio executes the run/debug configuration irrespective of the compilation result.
Build Artifacts	Unsupported in Android Studio.
Run Gradle task	Run a Gradle task. In the dialog that opens, specify the details and then click OK . For more information, see Gradle .
Gradle-aware Make	Compile the project and run Gradle.
App Engine Gradle builder	The App Engine Gradle builder task syncs the project and then builds the module.

Configuration templates

Android Studio provides configuration templates to help you get started quickly. The following sections describe the templates that apply to Android development with Android Studio:

• Android-приложение
• Android Tests
• App Engine DevAppServer
• Wear OS Complication, Tile, and Watch Face

Note: Android Studio 2.1. x and lower had a Native Application template, which newer versions don't have. If you have a Native Application template in a project, Android Studio converts it to Android App when you load the project. A Convert Project dialog guides you through the process.

Unsupported templates

The following unsupported templates come from IntelliJ IDEA and aren't specific to Android development with Android Studio. For information about using these templates, follow the links to the IntelliJ IDEA documentation.

• Приложение
• Сложный
• Градл
• классный
• JAR Application
• Java Scratch
• Юнит
• Котлин
• Kotlin Script
• Remote Debug
• Shell Script
• TestNG

Common configuration options

The Name , Allow parallel run , and Store as project file options are common to multiple configuration templates. To learn more about them, see Common settings .

Android Studio stores the shared run/debug configuration in individual XML files under the project_directory /.idea/runConfigurations/ folder. For more information, see Directory-based format in the IntelliJ projects documentation.

Android-приложение

You can run or debug Android apps and activities on virtual or hardware devices by using configurations based on this template.

General tab

In the General tab, you can specify installation, launch, and deployment options. The Miscellaneous tab also contains installation options.

Поле	Описание
Модуль	Select a module to apply this configuration to.
Installation Options: Deploy	Select an option: Default APK - Build and deploy an APK for your currently selected variant . APK from app bundle - Build and deploy your app from an Android App Bundle . That is, Android Studio first converts your app project into an app bundle that includes all your app's compiled code and resources. Then, from that app bundle, Android Studio generates only the APKs that are required to deploy your app to the connected device. You should typically use this option when testing the app bundle you intend to upload to Google Play because deploying from an app bundle extends the total build time. Custom Artifact - Unsupported in Android Studio. Nothing - Don't install an APK on a device. For example, if you prefer to manually install the APK, you don't need Android Studio to install it.
Installation Options: Deploy as instant app	If your app supports instant experiences—that is, you either add support for instant apps when you create a new project , or you create one or more instant-enabled feature modules —you can choose to deploy those instant-enabled modules by checking the box next to Deploy as instant app .
Installation Options: Features to deploy	If your app includes feature modules , check the box next to each feature you want to include when deploying your app. You see this option only if your app includes feature modules. Note: If you want to test downloading and installing feature modules on demand, you must do so after you publish your app bundle and then use the Play Console internal test track. To learn more, read Upload your app bundle to the Play Console .
Installation Options: Install Flags	Type any adb pm install options you want to use. Format the options the same way that you would on the command line, but without a path. Here are some examples: -i foo.bar.baz -r /path/to/apk и -d -r Default: no options.
Launch Options: Launch	Select an option: Nothing - Don't launch anything when you select Run or Debug . However, if your app is already running and you select Debug , Android Studio attaches the debugger to your app process. Default Activity - Launch the activity you've marked as startup in the manifest. Например: <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> Specified Activity - Launch a particular app activity in your module. When selected, the Activity field appears below, where you can type the name of the activity you want to launch, or click More to select an activity from a list. URL - Launch a URL that matches an intent filter in your app's manifest. When selected, the URL field appears below, where you can enter the URL. You must fill in this field to launch an Android Instant App . You may also use this to test your Android App Links .
Launch Options: Launch Flags	Type any adb am start options you want to use. Format the options the same way that you would on the command line, but without an intent. Например: -W This option doesn't appear if you chose a Launch value of Nothing . Default: no options.
Deployment Target Options: Target	Select an option: Open Select Deployment Target Dialog - Open the Select Deployment Target dialog to select a virtual or hardware device. USB Device - Use a hardware device connected to your development computer through a USB port. If there's more than one, a dialog appears so you can select it. Emulator - Use a virtual device. In a configuration, you can select an AVD; otherwise, it just uses the first AVD in the list.
Deployment Target Options: Use same device for future launches	By default this option is deselected so that every time you run an app, the Select Deployment dialog appears for you to select a device. When you select this option and then run an app, the Select Deployment dialog appears for you to select a device. Then, every time you run the app, it launches on the device you selected without displaying the Select Deployment dialog. To run the app on a different device, either deselect Use same device for future launches , or stop the app with Run > Stop app or Stop , and then start it again. The Select Deployment dialog will display so you can select a device.
Before Launch	See Defining Before Launch Operations .

Miscellaneous tab

In the Miscellaneous tab, you can specify logcat, installation, launch, and deployment options. The General tab also contains installation options.

Поле	Описание
Logcat: Show logcat automatically	When this option is selected, the Logcat window opens every time you successfully deploy and launch an app using this configuration. Default: selected.
Logcat: Clear log before launch	Select this option if you want Android Studio to remove data from previous sessions from the log file before starting the app. Default: deselected.
Installation Options: Skip installation if APK has not changed.	When selected, Android Studio doesn't redeploy your APK if it detects that it's unchanged. If you want Android Studio to force an install of the APK, even if it hasn't changed, then deselect this option. Default: selected
Installation Options: Force stop running application before launching activity	If selected, when Android Studio detects that it doesn't have to reinstall an APK because it hasn't changed, it will force-stop the app so that the app starts from the default launcher activity. If this option is deselected, Android Studio doesn't force-stop the app. This option works with the previous option that controls whether an APK is installed or not. For both Installation Options fields, leave them at the default unless you explicitly want to force an install every time. In some cases you might want to deselect this option. For example, if you're writing an input method engine (IME), force-stopping the app deselects it as the current keyboard, which you might not want. Default: selected
Before Launch	See Defining Before Launch Operations .

Debugger tab

Specify debug options in the Debugger tab.

For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.

For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:

• Добавлять - Add a directory or command.
• Удалять- Select a directory or command, and then click this button to remove the item.
• Вверх - Select a directory or command, and then click this button to move the item up in the list.
• Вниз - Select a directory or command, and then click this button to move the item down in the list.

See Debug Your App for more information about debugging in Android Studio.

Поле	Описание
Debug type	Выберите один из следующих вариантов: Java only - Debug Java code only. Detect Automatically - Let Android Studio choose the best debug type for your project. Native Only - Debug native C or C++ code. Dual (Java + Native) - Debug Java and native code in two separate debug sessions. The Detect Automatically option is recommended because it chooses the right debug type for your project.
Symbol Directories	If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically.
LLDB Startup Commands	Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: settings set target.max-memory-read-size 2048 LLDB executes the commands in order from top to bottom.
LLDB Post Attach Commands	Add LLDB commands that you want to execute right after the debugger attaches to the process. Например: process handle SIGPIPE -n true -p true -s false LLDB executes the commands in order from top to bottom.
Host working directory	Specify the LLDB working directory.
Logging: Target channels	Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is lldb process:gdb-remote packets You can change the default to gather more information. For example, the following log options gather information about a specific platform : lldb process platform :gdb-remote packets For a complete list of log commands, enter the log list command from an LLDB shell window in Android Studio. Android Studio places device logs in the following location, where ApplicationId is the unique application ID that's used in your built APK manifest, and identifies your app on your device and in the Google Play Store: /data/data/ ApplicationId /lldb/log Or, if multiple users access a device, it places the logs in the following location, where AndroidUserId is a unique identifier for a user on the device: /data/user/ AndroidUserId / ApplicationId /lldb/log For information about using LLDB for remote debugging, see Remote Debugging .
Before Launch	See Defining Before Launch Operations .

Profiling tab

The Enable advanced profiling option must be checked to enable certain features in the Android Profiler when your device is running Android 7.1 or lower.

Android Tests

The test template that you should use depends on your source set . The Android Instrumented Tests template is for an instrumented test . The Android JUnit template is for a local unit test.

Note: If you're using Firebase Test Lab to test on a variety of devices, you can use the Android JUnit template to define your instrumented tests. For more information, see Run Your Tests with Firebase Test Lab .

The following tab descriptions cover the tabs and fields for the Android Instrumented test template. For information about the tabs and fields for the Android JUnit test template, see the IntelliJ Run/Debug Configuration: JUnit page.

General tab

In General tab, you can specify test location, instrumentation runner, adb shell, and deployment options.

Поле	Описание
Модуль	Select a module to apply this configuration to.
Тест	In this area, specify the location of tests that you want to run: All in module - Launch all tests from the selected module. All in package - Launch all tests from the package specified in the Package field. Type the name, or click More to select the package from a dialog. Class - Launch tests of the class specified in the Class field. Type the name, or click More to select the class from a dialog. Method - Launch a test method. In the Class field, specify the class that contains the method. In the Method field, specify the method. Type the name, or click More to select the class or method from a dialog.
Specific instrumentation runner (optional)	Type the location of the instrumentation runner ; click More to use a dialog. The build.gradle file specifies the location of the instrumentation runner; this value overrides it. The default is typically the AndroidJUnitRunner class from AndroidX Test .
Extra options	Type any adb am instrument options you want to use. Don't type the component. For example, if you're using AndroidJUnitRunner from AndroidX Test , you can use this field to pass additional options to the runner, such as -e size small . Default: no options
Deployment Target Options: Target	Select an option: Open Select Deployment Target Dialog - Open the Select Deployment Target dialog to select a virtual or hardware device. USB Device - Use a hardware device connected to your development computer through a USB port. If there's more than one, a dialog appears so you can select it. Emulator - Use a virtual device. In a configuration, you can select an AVD; otherwise, it just uses the first AVD in the list. Firebase Test Lab Device Matrix - See Run Your Tests with Firebase Test Lab .
Deployment Target Options: Use same device for future launches	If you want to automatically use the device you chose through the Select Deployment Target dialog in the future, select this option. If the device isn't available, you'll receive a dialog. Default: deselected
Before Launch	See Defining Before Launch Operations .

Miscellaneous tab

The Miscellaneous tab contains logcat and installation options.

Поле	Описание
Logcat: Clear log before launch	Select this option if you want Android Studio to remove data from previous sessions from the log file before starting the app. Default: deselected.
Installation Options: Skip installation if APK has not changed	When selected, Android Studio doesn't redeploy your APK if it detects that it's unchanged. If you want Android Studio to force an install of the APK, even if it hasn't changed, then deselect this option. Default: selected
Installation Options: Force stop running application before launching activity	If selected, when Android Studio detects that it doesn't have to reinstall an APK because it hasn't changed, it will force-stop the app so that the app starts from the default launcher activity. If this option is deselected, Android Studio doesn't force-stop the app. This option works in conjunction with the previous option that controls whether an APK is installed or not. For both Installation Options fields, leave them at the default unless you explicitly want to force an install every time. In some cases you might want to deselect this option. For example, if you're writing an input method engine (IME), force-stopping the app deselects it as the current keyboard, which you might not want. Default: selected
Before Launch	See Defining Before Launch Operations .

Debugger tab

Specify debug options in the Debugger tab.

For C and C++ code, Android Studio uses the LLDB debugger. In addition to the normal Android Studio UI, the debugger window has an LLDB tab that lets you enter LLDB commands during debugging. You can enter the same commands that Android Studio uses to display information in the debugger UI, and you can perform additional operations.

For C and C++ projects, you can add symbol directories, as well as LLDB startup and post attach commands, in the Debugger tab. To do so, you use buttons similar to the following:

• Добавлять - Add a directory or command.
• Удалять- Select a directory or command, and then click this button to remove the item.
• Вверх - Select a directory or command, and then click this button to move the item up in the list.
• Вниз - Select a directory or command, and then click this button to move the item down in the list.

See Debug Your App for more information about debugging in Android Studio.

Поле	Описание
Debug type	Выберите один из следующих вариантов: Java only - Debug Java code only. Detect Automatically - Let Android Studio choose the best debug type for your project. Native Only - Debug native C or C++ code. Dual (Java + Native) - Debug Java and native code in two separate debug sessions. The Detect Automatically option is recommended because it chooses the right debug type for your project.
Symbol Directories	If you want to add symbol files to provide the debugger with C or C++ information generated outside of Android Studio, you can add one or more directories here. Android Studio preferentially uses any files within these directories over files generated by the Android Plugin for Gradle . The debugger searches the directories from top to bottom, in order, until it finds what it needs. It searches recursively through the files in the directory. To optimize the list and save time, put the directories used most often toward the top of the list. If you specify a directory high in the tree, it can take longer to search all of the subdirectories. If you add a very specific directory, it takes less time to search. You need to find the right balance between speed and finding the files you need for debugging. For example, if you have a directory that contains subdirectories for different Android Binary Interfaces (ABIs), you can choose to add a directory for a specific ABI or for all ABIs. Although it can take longer to search through the upper-level directory, it's also more foolproof if you decide to debug on a different device. Note that you don't have to add directories containing Gradle symbol files because the debugger uses them automatically.
LLDB Startup Commands	Add LLDB commands that you want to execute before the debugger attaches to the process. For example, you can define settings for the environment, as shown in the following command: settings set target.max-memory-read-size 2048 LLDB executes the commands in order from top to bottom.
LLDB Post Attach Commands	Add LLDB commands that you want to execute right after the debugger attaches to the process. Например: process handle SIGPIPE -n true -p true -s false LLDB executes the commands in order from top to bottom.
Host working directory	Specify the LLDB working directory.
Logging: Target channels	Specify LLDB log options. Android Studio sets the default options based on the team's experience — so it's not too slow but contains needed information for troubleshooting issues. The log is often requested for Android Studio bug reports. This default is lldb process:gdb-remote packets You can change the default to gather more information. For example, the following log options gather information about a specific platform : lldb process platform :gdb-remote packets For a complete list of log commands, enter the log list command from an LLDB shell window in Android Studio. Android Studio places device logs in the following location, where ApplicationId is the unique application ID that's used in your built APK manifest, and identifies your app on your device and in the Google Play Store: /data/data/ ApplicationId /lldb/log Or, if multiple users access a device, it places the logs in the following location, where AndroidUserId is a unique identifier for a user on the device: /data/user/ AndroidUserId / ApplicationId /lldb/log For information about using LLDB for remote debugging, see Remote Debugging .
Before Launch	See Defining Before Launch Operations .

App Engine DevAppServer

This run/debug configuration applies to the Google Cloud Platform. For more information, see Running, Testing, and Deploying the Backend . When you follow these steps and sync your project to the build.gradle file, Android Studio creates an App Engine DevAppServer configuration for you.

Note that the IntellJ IDEA App Engine Server template is a different template that's not available in Android Studio.

Поле	Описание
Single instance only	If you want to make sure that only one instance of the run/debug configuration is currently executed, select this option. It doesn't allow multiple runs of the same configuration at the same time. Default: selected
Модуль	Select a module to apply this configuration to.
Synchronize with build.gradle configuration	If you add an App Engine module and sync to the build.gradle file, the App Engine DevAppServer configuration fields are filled in for you (recommended). Selecting File > Sync Project with Gradle Files also syncs the project. Default: selected
App Engine SDK	Type a path to a Google App Engine SDK for Java on the local machine. Click ... to select it from a dialog.
War Path	Type a path to the Web Application Archive (WAR) directory of the app you're deploying on the local development server. Click ... to select it from a dialog.
VM Args	Specify the command-line options you want to pass to the VM for launching the DevAppServer. When specifying the options: Use spaces to separate different options. For options that have spaces, enclose the space in quotation marks ( " " ). If an option includes quotation marks, add a backslash before the quotation mark ( \" ). For more information about VM options, see the documentation for your J2SE version, such as java JDK 7 and java JDK 8 . Default: no options
Server Address	Type the host address to use for the server. You might need to provide the address to be able to access the development server from another computer on your network. An address of 0.0.0.0 allows both localhost access and hostname access. Default: localhost
Server Port	Type the port number to use for the server. Default: 8080
Disable Check for App Engine SDK Updates	If given, the development server will not contact App Engine to check for the availability of a new release of the SDK. By default, the server checks for a new version on startup, and prints a message if a new version is available.
Before Launch	See Defining Before Launch Operations .

Wear OS run/debug configurations

The Wear OS Complication, Tile, and Watch Face templates let you run or debug Wear OS apps on virtual or hardware devices. Most of the template configuration options are the same as the Android App options . Here are the options that are more specific to the Wear OS run/debug configurations:

• For all Wear run/debug configurations, you have to select a specific complication data source, tile, or watch face (depending on the template) to apply the configuration to. Generally each of these entities corresponds to a class in your code.
• For the Wear OS Complication run/debug configuration, you must choose the Slot where you want to put the complication data provided by the complication data source. You can choose to put it at the top, right, bottom, left, or background of the watch face.
• For the Wear OS Complication run/debug configuration, you must also select the Type of the complication data provided by the complication data source. The types you can choose from are limited to those that are provided by the chosen complication data source and supported by the chosen slot. For a list of complication data types, see Types and fields .

Alternatively, you can also run these surfaces from the gutter icon that is located next to the declaration of the surface, as shown in the following image.