Когда вы запускаете, отлаживаете или тестируете свой код, Android Studio использует конфигурацию запуска/отладки, чтобы определить, как выполнить операцию. Обычно изначально созданной конфигурации достаточно для запуска или отладки приложения. Однако вы можете изменять и создавать новые конфигурации, а также изменять шаблоны конфигурации в соответствии с вашим процессом разработки, как описано на этой странице.
Для получения дополнительной информации также см. следующую документацию IntelliJ:
О конфигурациях запуска/отладки
Конфигурации запуска/отладки определяют такие детали, как установка, запуск и параметры тестирования приложения. Вы можете определить конфигурацию для одноразового использования или сохранить ее для использования в будущем. После сохранения вы можете выбрать конфигурацию из раскрывающегося списка «Выбрать конфигурацию запуска/отладки» на панели инструментов . Android Studio сохраняет конфигурации как часть проекта.
Первоначально созданная конфигурация запуска/отладки
Когда вы впервые создаете проект, Android Studio создает конфигурацию запуска/отладки для основного действия на основе шаблона приложения Android . Чтобы запустить или отладить проект, у вас всегда должна быть определена хотя бы одна конфигурация запуска/отладки. По этой причине мы рекомендуем не удалять изначально созданную конфигурацию.
Объем проекта и контроль версий
Конфигурации запуска/отладки и изменения шаблонов применяются только к текущему проекту. Вы можете поделиться конфигурацией запуска/отладки (но не шаблоном) через свою систему контроля версий. Дополнительные сведения о том, как поделиться конфигурацией, см. в разделе Параметры конфигурации имени и общего ресурса .
Откройте диалоговое окно «Конфигурации запуска/отладки».
Чтобы открыть диалоговое окно «Выполнить/отладить конфигурации», выберите «Выполнить» > «Редактировать конфигурации» . Появится диалоговое окно «Конфигурации запуска/отладки» , как показано на рисунке 1.
Рисунок 1 . Диалоговое окно «Конфигурации запуска/отладки»
Левая панель диалогового окна группирует определенные конфигурации по типу шаблона и позволяет редактировать шаблоны конфигурации внизу. Редактировать выбранную конфигурацию можно в правой панели. Измените размер диалогового окна, чтобы увидеть все скрытые элементы.
В этом диалоге вы можете:
- Создайте новые конфигурации запуска/отладки .
- Редактировать конфигурации запуска/отладки.
- Редактировать шаблоны конфигурации.
- Сортировка и группировка конфигураций.
Создайте новую конфигурацию запуска/отладки.
Вы можете определить новые конфигурации запуска/отладки в диалоговом окне «Конфигурации запуска/отладки» , в окне «Проект» или в редакторе кода. Новая конфигурация должна основываться на шаблоне конфигурации .
В диалоговом окне «Конфигурации запуска/отладки» отображаются конфигурации запуска/отладки и доступные шаблоны конфигурации. Новую конфигурацию можно запустить непосредственно из шаблона или из копии другой конфигурации. Затем вы можете изменить значения полей по мере необходимости.
Альтернативно вы можете щелкнуть правой кнопкой мыши элемент в окне «Проект» , чтобы автоматически создать конфигурацию, специфичную для этого элемента. Например, если вы хотите запустить определенное действие, вы можете щелкнуть правой кнопкой мыши Java-файл действия и выбрать «Выполнить» . В зависимости от элемента Android Studio использует приложение Android , инструментальные тесты Android или шаблон конфигурации JUnit для создания конфигурации.
В редакторе кода вы можете легко создать конфигурацию тестирования и запуска/отладки для класса или метода, а затем выполнить ее.
Когда вы создаете конфигурацию вне диалогового окна «Конфигурации запуска/отладки» , она является временной, если вы ее не сохраните. По умолчанию в проекте может быть до пяти временных конфигураций, прежде чем Android Studio начнет их удалять. Чтобы изменить это значение по умолчанию, откройте настройки Android Studio и измените «Дополнительные настройки» > «Запуск/отладка» > «Ограничение временных конфигураций» . Дополнительные сведения о временных конфигурациях см. в разделе Создание и сохранение временных конфигураций запуска/отладки .
Запуск настройки на основе шаблона
Чтобы определить конфигурацию запуска/отладки на основе шаблона, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Нажмите «Добавить новую конфигурацию».
. - Выберите шаблон конфигурации .
- Введите имя в поле Имя .
- При необходимости измените конфигурацию.
- Нажмите «Применить» или «ОК» .
Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.
Запуск конфигурации из копии
Чтобы определить конфигурацию запуска/отладки, начиная с копии другой конфигурации, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Выберите существующую конфигурацию запуска/отладки на левой панели.
- Нажмите «Копировать конфигурацию».
. - Введите имя в поле Имя .
- При необходимости измените конфигурацию.
- Нажмите «Применить» или «ОК» .
Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.
Определить конфигурацию элемента в проекте
Android Studio может создать конфигурацию запуска/отладки для некоторых элементов, отображаемых в окне проекта . Конфигурация основана на следующем шаблоне конфигурации:
- Java-файл активности: шаблон приложения Android .
- Пакет: инструментальные тесты Android или шаблон Android JUnit , в зависимости от набора исходных кодов . Если вы выберете инструментированный тест , он будет использовать шаблон инструментальных тестов Android. Если вы выберете локальный модульный тест , то он будет использовать шаблон Android JUnit. Для локального модульного теста вы можете дополнительно запустить его с покрытием кода. Дополнительные сведения см. в разделе Покрытие кода .
Чтобы создать конфигурацию запуска/отладки для элемента вашего проекта, выполните следующие действия:
- Откройте проект в Android или в представлении «Проект» .
- В окне «Проект» щелкните правой кнопкой мыши тестируемый элемент и выберите «Выполнить filename или filename отладки» . Android Studio создает временную конфигурацию запуска/отладки и запускает ваше приложение.
- Откройте раскрывающийся список «Выбрать конфигурацию запуска/отладки» на панели инструментов.
- Выберите «Сохранить конфигурацию» из вариантов рядом с конфигурацией, которую вы хотите сохранить.
Рисунок 2 . Сохраните конфигурацию
Примечание. Если вы щелкнете правой кнопкой мыши и запустите или отладите тот же элемент (но не действие), Android Studio создаст новую конфигурацию.
Определите тестовую конфигурацию для класса или метода.
Android Studio позволяет определить конфигурацию тестового запуска для класса или метода, а затем выполнить ее. Например, если вы создаете новый класс, вы можете создать и запустить для него тест. Если тест пройден, вы можете запустить тесты для остальной части проекта, чтобы убедиться, что ваш новый код ничего не сломает где-то еще.
Android Studio использует инструментальные тесты Android или шаблон Android JUnit , в зависимости от набора исходных кодов . Для локального модульного теста вы можете дополнительно запустить его с покрытием кода .
Чтобы создать конфигурацию запуска/отладки для класса или метода в коде Java, выполните следующие действия:
- Откройте проект в Android или в представлении «Проект» .
- Откройте файл Java в редакторе кода.
- Выберите класс или метод в коде, а затем нажмите Control+Shift+T (Command+Shift+T).
- В появившемся меню выберите «Создать новый тест» .
- В диалоговом окне «Создать тест» при необходимости измените или установите значения и нажмите «ОК» .
- В диалоговом окне «Выбор каталога назначения» выберите место в проекте, в котором Android Studio должна разместить тест. Местоположение можно указать по структуре каталогов или выбрав соседний класс.
- Нажмите ОК .
Новый тест появится в окне «Проект» в соответствующем наборе источников тестов.
- Чтобы запустить тест, выполните одно из следующих действий:
- В окне проекта щелкните тест правой кнопкой мыши и выберите «Выполнить» или «Отладка» .
- В редакторе кода щелкните правой кнопкой мыши определение класса или имя метода в тестовом файле и выберите «Выполнить» или «Отладка» , чтобы протестировать все методы в классе.
- Откройте раскрывающийся список «Выбрать конфигурацию запуска/отладки» на панели инструментов.
- Выберите «Сохранить конфигурацию» из вариантов рядом с конфигурацией, которую вы хотите сохранить.
Рисунок 3 . Сохраните конфигурацию
Запуск или отладка приложения с использованием сохраненной конфигурации.
Если вы сохранили конфигурацию запуска/отладки, вы можете выбрать ее перед запуском или отладкой приложения.
Чтобы использовать сохраненную конфигурацию запуска/отладки, выполните следующие действия:
- Выберите конфигурацию запуска/отладки в раскрывающемся списке «Выбрать конфигурацию запуска/отладки» на панели инструментов .
- Выберите «Выполнить» > «Выполнить» или «Выполнить» > «Отладка» .
Раскрывающийся список находится слева от кнопки «Выполнить» .
и отладка
; например,
.
Либо нажмите «Выполнить» . или Отладка .
Изменение конфигурации запуска/отладки
Чтобы изменить конфигурацию запуска/отладки, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Выберите конфигурацию на левой панели.
- При необходимости измените конфигурацию.
- Нажмите «Применить» или «ОК» .
Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.
Изменение шаблона конфигурации запуска/отладки
Вы можете редактировать шаблоны конфигурации, предоставляемые Android Studio, в соответствии с вашим процессом разработки. Редактирование шаблона не влияет на существующие конфигурации, использующие этот шаблон. Так, например, если вам нужно создать несколько конфигураций определенного типа, вы можете отредактировать шаблон, а затем изменить его обратно, когда закончите.
Хотя вы не можете создавать новые шаблоны, вы можете создавать конфигурации, аналогичные шаблону. Вы можете скопировать конфигурацию и отредактировать копию, чтобы создать новые конфигурации.
Чтобы отредактировать шаблон, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Нажмите Редактировать шаблоны конфигурации... .
- Выберите шаблон конфигурации.
- При необходимости измените конфигурацию.
- Нажмите «Применить» или «ОК» .
Обязательно исправьте все ошибки, отображаемые в нижней части диалогового окна.
Сортировка и группировка конфигураций
В диалоговом окне «Конфигурации запуска/отладки» вы можете упорядочить свои конфигурации, чтобы быстро их найти. Вы можете сортировать элементы в папке в алфавитном порядке и создавать новые папки для группировки конфигураций.
Чтобы отсортировать конфигурации по алфавиту, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Выберите папку, содержащую конфигурации.
- Нажмите «Сортировать конфигурации».
. - Нажмите кнопку ОК, чтобы закрыть диалоговое окно.
Чтобы сгруппировать конфигурации в папках, выполните следующие действия:
- Откройте диалоговое окно «Конфигурации запуска/отладки» .
- Выберите папку, содержащую конфигурации.
- Нажмите «Создать новую папку».
. - Введите имя в поле Имя папки .
- Нажмите «Применить» , чтобы сохранить имя.
Определите операции перед запуском
Вы можете указать задачи, которые необходимо выполнить, прежде чем применять конфигурацию запуска/отладки. Задачи выполняются в том порядке, в котором они указаны в списке.
Примечание. Определение задач перед запуском — это дополнительная функция. Вместо использования этой функции мы рекомендуем вам поместить любую логику подготовки в виде задач в файл build.gradle , чтобы они выполнялись при сборке из командной строки.
Чтобы создать список задач, выполните следующие действия:
- В нижней части диалогового окна « Конфигурации запуска/отладки» в разделе «Перед запуском» (возможно, вам придется прокрутить вниз) нажмите « Добавить».и выберите тип задачи. Если откроется диалоговое окно, заполните поля и нажмите «ОК» .
- При необходимости добавляйте дополнительные задачи.
- Чтобы упорядочить задачи, перетащите их или выберите задачу и нажмите «Вверх».
и вниз
чтобы переместить его вверх или вниз в списке. - Выберите «Показать эту страницу» , если вы хотите отображать параметры конфигурации запуска/отладки перед их применением.
По умолчанию этот параметр не выбран.
- Выберите «Активное окно инструмента» , если вы хотите, чтобы окно инструмента «Запуск» или «Отладка» активировалось при запуске или отладке приложения.
Этот параметр выбран по умолчанию.
Чтобы удалить задачу из списка, выполните следующие действия:
- Выберите задачу.
- Нажмите Удалить
.
Чтобы отредактировать задачу, выполните следующие действия:
- Выберите задачу.
- Нажмите Редактировать
. - В открывшемся диалоговом окне отредактируйте параметры задачи и нажмите «ОК» .
В следующей таблице перечислены доступные задачи, которые вы можете добавить.
| Задача | Описание |
|---|---|
| Запустить внешний инструмент | Запустите приложение, внешнее по отношению к 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 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 на виртуальных или аппаратных устройствах, используя конфигурации на основе этого шаблона.
Вкладка «Общие»
На вкладке Общие вы можете указать параметры установки, запуска и развертывания. Вкладка «Разное» также содержит параметры установки.
| Поле | Описание |
|---|---|
| Модуль | Выберите модуль , к которому нужно применить эту конфигурацию. |
| Варианты установки: Развернуть | Выберите вариант:
|
| Варианты установки: развернуть как мгновенное приложение. | Если ваше приложение поддерживает мгновенный интерфейс — то есть вы либо добавляете поддержку мгновенных приложений при создании нового проекта , либо создаете один или несколько функциональных модулей с мгновенной поддержкой — вы можете выбрать развертывание этих модулей с мгновенной поддержкой, установив флажок рядом с пунктом «Развернуть как приложение с мгновенным запуском» . |
| Варианты установки: функции для развертывания | Если ваше приложение включает функциональные модули , установите флажок рядом с каждой функцией, которую вы хотите включить при развертывании приложения. Вы видите эту опцию, только если ваше приложение включает функциональные модули. Примечание. Если вы хотите протестировать загрузку и установку функциональных модулей по требованию, вам необходимо сделать это после публикации пакета приложений, а затем использовать внутреннюю тестовую версию Play Console. Подробнее читайте в статье «Загрузка пакета приложений в Play Console» . |
| Варианты установки: Установить флаги | Введите любые параметры pm install которые вы хотите использовать. Отформатируйте параметры так же, как и в командной строке, но без пути. Вот несколько примеров: и По умолчанию: без опций. |
| Параметры запуска: Запустить | Выберите вариант:
|
| Параметры запуска: Флаги запуска | Введите любые параметры am start которые вы хотите использовать. Отформатируйте параметры так же, как и в командной строке, но без намерения. Например: Этот параметр не отображается, если вы выбрали для параметра запуска значение Nothing . По умолчанию: без опций. |
| Параметры цели развертывания: Цель | Выберите вариант:
|
Параметры цели развертывания: использовать то же устройство для будущих запусков. | По умолчанию этот параметр не выбран, поэтому каждый раз, когда вы запускаете приложение, появляется диалоговое окно «Выбор развертывания» , в котором вы можете выбрать устройство. Когда вы выбираете этот параметр, а затем запускаете приложение, появляется диалоговое окно «Выбор развертывания» , в котором можно выбрать устройство. Затем каждый раз, когда вы запускаете приложение, оно запускается на выбранном вами устройстве без отображения диалогового окна «Выбор развертывания» . Чтобы запустить приложение на другом устройстве, снимите флажок « Использовать то же устройство для будущих запусков» или остановите приложение, выбрав «Выполнить» > «Остановить 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 см. в разделе «Отладка вашего приложения» .
| Поле | Описание |
|---|---|
| Тип отладки | Выберите один из следующих вариантов:
Рекомендуется использовать параметр «Определять автоматически», поскольку он позволяет выбрать правильный тип отладки для вашего проекта. |
| Каталоги символов | Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию C или C++, созданную за пределами Android Studio, вы можете добавить сюда один или несколько каталогов. Android Studio предпочитает использовать любые файлы в этих каталогах, а не файлы, созданные подключаемым модулем Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдет то, что ему нужно. Он рекурсивно ищет файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите наиболее часто используемые каталоги в начало списка. Если вы укажете каталог высоко в дереве, поиск во всех подкаталогах может занять больше времени. Если вы добавите очень конкретный каталог, поиск займет меньше времени. Вам необходимо найти правильный баланс между скоростью и поиском файлов, необходимых для отладки. Например, если у вас есть каталог, содержащий подкаталоги для различных двоичных интерфейсов Android (ABI), вы можете добавить каталог для определенного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите выполнить отладку на другом устройстве. Обратите внимание: вам не нужно добавлять каталоги, содержащие файлы символов Gradle, поскольку отладчик использует их автоматически. |
| Команды запуска LLDB | Добавьте команды LLDB, которые вы хотите выполнить до того, как отладчик подключится к процессу. Например, вы можете определить настройки среды, как показано в следующей команде: LLDB выполняет команды сверху вниз. |
| Команды пост-присоединения LLDB | Добавьте команды LLDB, которые вы хотите выполнить сразу после подключения отладчика к процессу. Например: LLDB выполняет команды сверху вниз. |
| Рабочий каталог хоста | Укажите рабочий каталог LLDB. |
| Ведение журнала: целевые каналы | Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды — поэтому это не слишком медленно, но содержит необходимую информацию для устранения неполадок. Журнал часто запрашивается для отчетов об ошибках Android Studio. Это значение по умолчанию Вы можете изменить значение по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной lldb process platform :gdb-remote packets Чтобы получить полный список команд журнала, введите команду Android Studio размещает журналы устройства в следующем месте, где Или, если к устройству обращаются несколько пользователей, журналы помещаются в следующее место, где Сведения об использовании 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 . |
| Дополнительные опции | Введите любые параметры По умолчанию: без опций |
| Параметры цели развертывания: Цель | Выберите вариант:
|
| Параметры цели развертывания: использовать то же устройство для будущих запусков. | Если вы хотите в будущем автоматически использовать устройство, выбранное в диалоговом окне «Выбор цели развертывания» , выберите этот параметр. Если устройство недоступно, вы получите диалоговое окно. По умолчанию: не выбрано |
| Перед запуском | См. Определение операций перед запуском . |
Вкладка «Разное»
Вкладка «Разное» содержит лог-код и параметры установки.
| Поле | Описание |
|---|---|
| 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 см. в разделе «Отладка вашего приложения» .
| Поле | Описание |
|---|---|
| Тип отладки | Выберите один из следующих вариантов:
Рекомендуется использовать параметр «Определять автоматически», поскольку он позволяет выбрать правильный тип отладки для вашего проекта. |
| Каталоги символов | Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию C или C++, созданную за пределами Android Studio, вы можете добавить сюда один или несколько каталогов. Android Studio предпочитает использовать любые файлы в этих каталогах, а не файлы, созданные подключаемым модулем Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдет то, что ему нужно. Он рекурсивно ищет файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите наиболее часто используемые каталоги в начало списка. Если вы укажете каталог высоко в дереве, поиск во всех подкаталогах может занять больше времени. Если вы добавите очень конкретный каталог, поиск займет меньше времени. Вам необходимо найти правильный баланс между скоростью и поиском файлов, необходимых для отладки. Например, если у вас есть каталог, содержащий подкаталоги для различных двоичных интерфейсов Android (ABI), вы можете добавить каталог для определенного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите выполнить отладку на другом устройстве. Обратите внимание: вам не нужно добавлять каталоги, содержащие файлы символов Gradle, поскольку отладчик использует их автоматически. |
| Команды запуска LLDB | Добавьте команды LLDB, которые вы хотите выполнить до того, как отладчик подключится к процессу. Например, вы можете определить настройки для среды, как показано в следующей команде: LLDB выполняет команды в порядке сверху вниз. |
| LLDB POST ATTH | Добавьте команды LLDB, которые вы хотите выполнить сразу после того, как отладчик присоединяется к процессу. Например: LLDB выполняет команды в порядке сверху вниз. |
| Хозяин рабочий каталог | Укажите рабочий каталог LLDB. |
| Регистрация: целевые каналы | Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды - так что это не слишком медленно, но содержит необходимую информацию для проблем с устранением неполадок. Журнал часто требуется для отчетов об ошибках Android Studio. Это по умолчанию Вы можете изменить по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной lldb process platform :gdb-remote packets Для получения полного списка команд журнала введите команду Android Studio помещает журналы устройств в следующем месте, где Или, если несколько пользователей получают доступ к устройству, он помещает журналы в следующем месте, где Информацию об использовании 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. При указании параметров:
Для получения дополнительной информации о вариантах виртуальной машины см. Документацию для вашей версии J2SE, такой как По умолчанию: нет параметров |
| Адрес сервера | Введите адрес хоста для использования для сервера. Возможно, вам придется предоставить адрес, чтобы иметь возможность получить доступ к серверу разработки с другого компьютера в вашей сети. Адрес 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 и измените расширенные настройки> запуск/отладка> Предел временных конфигураций . Для получения дополнительной информации о временных конфигурациях см. В создании и сохранении конфигураций временного запуска/отладки .
Запустить конфигурацию на основе шаблона
Чтобы определить конфигурацию запуска/отладки на основе шаблона, выполните следующие действия:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Нажмите « Добавить новую конфигурацию .
- Выберите шаблон конфигурации .
- Введите имя в поле «Имя» .
- Измените конфигурацию, по мере необходимости.
- Нажмите Применить или ОК .
Обязательно исправьте любые ошибки, отображаемые внизу диалога.
Запустить конфигурацию из копии
Чтобы определить конфигурацию запуска/отладки, начиная с копии другой конфигурации, выполните следующие действия:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Выберите существующую конфигурацию запуска/отладки на левой панели.
- Нажмите на конфигурацию копирования .
- Введите имя в поле «Имя» .
- Измените конфигурацию, по мере необходимости.
- Нажмите Применить или ОК .
Обязательно исправьте любые ошибки, отображаемые внизу диалога.
Определите конфигурацию для элемента в проекте
Android Studio может создать конфигурацию запуска/отладки для некоторых элементов, отображаемых в окне проекта . Конфигурация основана на шаблоне конфигурации следующим образом:
- Активность Java File: шаблон приложения Android .
- Пакет: приборные тесты Android или шаблон Android Junit , в зависимости от вашего исходного набора . Если вы выберете инструментальный тест , то он использует шаблон Android, инструментальные тесты. Если вы выбираете локальный модульный тест , то он использует шаблон Android Junit. Для локального модульного теста вы можете при желании запустить с покрытием кода. Для получения дополнительной информации см. Покрытие кода .
Чтобы создать конфигурацию запуска/отладки для элемента в вашем проекте, выполните следующие действия:
- Откройте проект в Android или Project View .
- В окне проекта щелкните правой кнопкой мыши тестируемый элемент и выберите либо filename запустить или filename . Android Studio создает временную конфигурацию запуска/отладки и запускает ваше приложение.
- Откройте раскрывающий список конфигурации Select/Debug на панели инструментов.
- Выберите «Сохранить конфигурацию» из параметров рядом с конфигурацией, которую вы хотите сохранить.
Рисунок 2 . Сохранить конфигурацию
Примечание. Если вы щелкните правой кнопкой мыши и запускаете или отлаживаете один и тот же элемент (но не на действие), Android Studio создает новую конфигурацию.
Определите тестовую конфигурацию для класса или метода
Android Studio позволяет определить конфигурацию тестового запуска для класса или метода, а затем выполнять ее. Например, если вы создаете новый класс, вы можете создать и запустить тест для него. Если тест проходит, вы можете запустить тесты для остальной части проекта, чтобы убедиться, что ваш новый код ничего не нарушает.
Android Studio использует инструментальные тесты Android или шаблон Android Junit , в зависимости от вашего исходного набора . Для локального модульного теста вы можете при желании запустить с покрытием кода .
Чтобы создать конфигурацию запуска/отладки для класса или метода в вашем коде Java, выполните следующие действия:
- Откройте проект в Android или Project View .
- Откройте файл Java в редакторе кода.
- Выберите класс или метод в коде, а затем нажмите Control+Shift+T (команда+shift+t).
- Выберите «Создать новый тест» из появляющегося меню.
- В диалоговом окне «Создать тест» опционально измените или установите значения и нажмите OK .
- В диалоговом окне «Выберите каталог назначения» , выберите, где в проекте вы хотите, чтобы Android Studio провела тест. Вы можете указать местоположение по структуре каталога или выбрав соседний класс.
- Нажмите ОК .
Новый тест появляется в окне проекта в соответствующем наборе источников теста.
- Чтобы запустить тест, сделайте одно из следующих действий:
- В окне проекта щелкните правой кнопкой мыши тест и выберите «Запустить» или отладку .
- В редакторе кода щелкните правой кнопкой мыши определение класса или имя метода в тестовом файле и выберите «Запуск» или «Отладь» , чтобы проверить все методы в классе.
- Откройте раскрывающий список конфигурации Select/Debug на панели инструментов.
- Выберите «Сохранить конфигурацию» из параметров рядом с конфигурацией, которую вы хотите сохранить.
Рисунок 3 . Сохранить конфигурацию
Запустить или отлаживать приложение, используя сохраненную конфигурацию
Если вы сохранили конфигурацию запуска/отладки, вы можете выбрать ее перед запуском или отладкой.
Чтобы использовать сохраненную конфигурацию запуска/отладки, выполните следующие действия:
- Выберите конфигурацию Run/Debug из раскрывающегося списка Select Run/Debug Configuration на панели инструментов .
- Выберите «Запустить» > «Запустить» или запустить > отладку .
Раскрывающийся список слева от бега и отладка ; например, .
В качестве альтернативы нажмите «Запуск или отладка .
Редактировать конфигурацию запуска/отладки
Чтобы отредактировать конфигурацию запуска/отладки, выполните следующие действия:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Выберите конфигурацию на левой панели.
- Измените конфигурацию, по мере необходимости.
- Нажмите Применить или ОК .
Обязательно исправьте любые ошибки, отображаемые внизу диалога.
Редактировать шаблон конфигурации запуска/отладки
Вы можете редактировать шаблоны конфигурации, предоставленные Android Studio, чтобы соответствовать вашему процессу разработки. Когда вы редактируете шаблон, он не влияет на существующие конфигурации, которые используют шаблон. Так, например, если вам нужно создать ряд конфигураций определенного типа, вы можете редактировать шаблон, а затем изменить его обратно, когда вы закончите.
Хотя вы не можете создавать новые шаблоны, вы можете создавать конфигурации для использования, аналогичных шаблону. Вы можете скопировать конфигурацию и отредактировать копию для создания новых конфигураций.
Чтобы редактировать шаблон, выполните эти шаги:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Нажмите «Редактировать шаблоны конфигурации» ....
- Выберите шаблон конфигурации.
- Измените конфигурацию, по мере необходимости.
- Нажмите Применить или ОК .
Обязательно исправьте любые ошибки, отображаемые внизу диалога.
Конфигурации сортировки и группы
В диалоговом окне конфигураций запуска/отладки вы можете заказать свои конфигурации, чтобы найти их быстро. Вы можете сортировать элементы в папке в алфавитном порядке и создавать новые папки для групповых конфигураций.
Чтобы сортировать конфигурации в алфавитном порядке, выполните следующие действия:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Выберите папку, которая содержит конфигурации.
- Нажмите «Сортировать конфигурации» .
- Нажмите ОК, чтобы закрыть диалог.
Для группы конфигурации в папках выполните следующие действия:
- Откройте диалоговое окно конфигурации запуска/отладки .
- Выберите папку, которая содержит конфигурации.
- Нажмите « Создать новую папку» .
- Введите имя в поле «Имя папки» .
- Нажмите применить , чтобы сохранить имя.
Определите операции перед напуском
Вы можете указать задачи для выполнения перед применением конфигурации запуска/отладки. Задачи выполняются в том порядке, в котором они появляются в списке.
Примечание: определение задач запуска является расширенной функцией. Вместо того, чтобы использовать эту функцию, мы рекомендуем вам поместить любую логику подготовки в качестве задач в вашем файле build.gradle , чтобы они были выполнены при создании из командной строки.
Чтобы создать список задач, выполните следующие действия:
- В нижней части диалога конфигураций запуска/отладки перед запуском (вам может потребоваться прокрутить вниз), нажмите « Добавитьи выберите тип задачи. Если открывается диалог, заполните поля и нажмите ОК .
- Добавьте больше задач по мере необходимости.
- Чтобы заказать задачи, перетащите их или выберите задачу и нажмите и вниз Чтобы переместить его вверх или вниз в списке.
- Выберите Показать эту страницу, если вы хотите отобразить настройки конфигурации Run/Debug, прежде чем их применять.
Этот вариант отменен по умолчанию.
- Выберите «Активное окно инструмента» , если вы хотите, чтобы окно инструмента «Запустить» или «Инструмент отладки» было активировано при запуска или отлаживании вашего приложения.
Эта опция выбрана по умолчанию.
Чтобы удалить задачу из списка, выполните следующие действия:
- Выберите задачу.
- Нажмите « Удалить» .
Чтобы отредактировать задачу, выполните следующие действия:
- Выберите задачу.
- Нажмите «Редактировать» .
- Отредактируйте настройки задачи в открытии диалога, а затем нажмите 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 вы можете указать параметры установки, запуска и развертывания. Вкладка Разное также содержит параметры установки.
| Поле | Описание |
|---|---|
| Модуль | Выберите модуль , чтобы применить эту конфигурацию. |
| Параметры установки: развернуть | Выберите опцию:
|
| Параметры установки: развернуть как приложение Instant | Если ваше приложение поддерживает мгновенный опыт, то есть, вы либо добавляете поддержку для мгновенных приложений при создании нового проекта , либо создаете один или несколько модулей функций с интенсивностью рядом с развертыванием как мгновенное приложение . |
| Параметры установки: функции для развертывания | Если ваше приложение включает в себя модули функций , установите флажок рядом с каждой функцией, которую вы хотите включить при развертывании вашего приложения. Вы видите эту опцию только в том случае, если ваше приложение включает в себя модули функций. Примечание. Если вы хотите проверить загрузку и установку модулей функций по требованию, вы должны сделать это после публикации пакета приложений, а затем использовать внутреннюю тестовую дорожку Play Console. Чтобы узнать больше, прочитайте , загрузите свой пакет приложений в игровой консоли . |
| Параметры установки: установить флаги | Введите любые параметры pm install которые вы хотите использовать. Форматируйте параметры так же, как вы бы в командной строке, но без пути. Вот несколько примеров: и По умолчанию: нет параметров. |
| Параметры запуска: запуск | Выберите опцию:
|
| Параметры запуска: флаги запуска | Введите любые параметры ADB am start , которые вы хотите использовать. Отформатируйте параметры так же, как вы бы в командной строке, но без намерения. Например: Эта опция не отображается, если вы выбрали стартовую стоимость ничего . По умолчанию: нет параметров. |
| Целевые варианты развертывания: цель | Выберите опцию:
|
Опции целей развертывания: Используйте то же устройство для будущих запусков | По умолчанию эта опция отменилась, так что каждый раз, когда вы запускаете приложение, выберет диалоговое окно «Выбор развертывания» , чтобы вы выбрали устройство. Когда вы выбираете эту опцию, а затем запускаете приложение, представлен диалоговое окно «Выбрать развертывание» , чтобы выбрать устройство. Затем каждый раз, когда вы запускаете приложение, оно запускается на выбранном вами устройстве, не отображая диалог 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.
| Поле | Описание |
|---|---|
| Тип отладки | Выберите один из следующих вариантов:
Рекомендуется опция Detect Automatic, потому что он выбирает правильный тип отладки для вашего проекта. |
| Символьные каталоги | Если вы хотите добавить файлы символов для предоставления отладчику с помощью информации C или C ++, созданной за пределами Android Studio, вы можете добавить здесь один или несколько каталогов. Android Studio преимущественно использует любые файлы в этих каталогах по сравнению с файлами, сгенерированными плагином Android для Gradle . Отладчик ищет каталоги сверху донизу, пока он не найдет то, что ему нужно. Он ищет рекурсивно через файлы в каталоге. Чтобы оптимизировать список и сэкономить время, поместите используемые каталоги, используемые чаще всего в верхней части списка. Если вы указываете каталог высокого уровня в дереве, для поиска всех подкаталогов может потребоваться больше времени. Если вы добавите очень специфический каталог, для поиска требуется меньше времени. Вам нужно найти правильный баланс между скоростью и поиском необходимых файлов для отладки. Например, если у вас есть каталог, который содержит подкаталог для различных двоичных интерфейсов Android (ABIS), вы можете добавить каталог для конкретного ABI или для всех ABI. Хотя поиск в каталоге верхнего уровня может занять больше времени, это также более надежно, если вы решите отладить на другом устройстве. Обратите внимание, что вам не нужно добавлять каталоги, содержащие файлы символов Gradle, потому что отладчик использует их автоматически. |
| Команды запуска LLDB | Добавьте команды LLDB, которые вы хотите выполнить, прежде чем отладчик приложит к процессу. Например, вы можете определить настройки для среды, как показано в следующей команде: LLDB выполняет команды в порядке сверху вниз. |
| LLDB POST ATTH | Добавьте команды LLDB, которые вы хотите выполнить сразу после того, как отладчик присоединяется к процессу. Например: LLDB выполняет команды в порядке сверху вниз. |
| Хозяин рабочий каталог | Укажите рабочий каталог LLDB. |
| Регистрация: целевые каналы | Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды - так что это не слишком медленно, но содержит необходимую информацию для проблем с устранением неполадок. Журнал часто требуется для отчетов об ошибках Android Studio. Это по умолчанию Вы можете изменить по умолчанию, чтобы собрать больше информации. Например, следующие параметры журнала собирают информацию о конкретной lldb process platform :gdb-remote packets Для получения полного списка команд журнала введите команду Android Studio помещает журналы устройств в следующем месте, где Или, если несколько пользователей получают доступ к устройству, он помещает журналы в следующем месте, где Информацию об использовании LLDB для удаленной отладки см. В удаленной отладке . |
| Перед запуском | См. Определение перед операциями запуска . |
Профилирование вкладка
Опция расширенного профилирования для включения необходимо проверить, чтобы включить определенные функции в Android Profiler , когда ваше устройство работает Android 7.1 или ниже.
Андоидные тесты
Тестовый шаблон, который вы должны использовать, зависит от вашего исходного набора . Шаблон приборных тестов Android предназначен для инструментального теста . Шаблон Android Junit предназначен для локального модульного теста.
Примечание. Если вы используете Test Lab Firebase для тестирования на различных устройствах, вы можете использовать шаблон Android Junit для определения ваших инструментальных тестов. Для получения дополнительной информации см. Запустите свои тесты с помощью тестовой лаборатории Firebase .
Следующие описания вкладок охватывают вкладки и поля для инструментального тестового шаблона Android. Информацию о вкладках и полях для тестового шаблона Android Junit см. В конфигурации Intellij Run/Debug: Junit Page.
Общая вкладка
В общем вкладках вы можете указать местоположение тестирования, бегун на приборе, оболочку ADB и параметры развертывания.
| Поле | Описание |
|---|---|
| Модуль | Выберите модуль , чтобы применить эту конфигурацию. |
| Тест | В этой области укажите местоположение тестов, которые вы хотите запустить:
|
| Конкретный инструментальный бегун (необязательно) | Введите местоположение инструментального бегуна ; Нажмите больше , чтобы использовать диалог. Файл build.gradle указывает местоположение инструментального бегуна; Это значение переопределяет его. The default is typically the AndroidJUnitRunner class from AndroidX Test . |
| Extra options | Type any adb Default: no options |
| Deployment Target Options: Target | Select an option:
|
| 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 | Выберите один из следующих вариантов:
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: 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. Например: 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 You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where 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:
For more information about VM options, see the documentation for your J2SE version, such as 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:
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:
- Open the Run/Debug Configurations dialog .
- Click Add New Configuration .
- Select a configuration template .
- Type a name in the Name field.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
Start a configuration from a copy
To define a run/debug configuration starting from a copy of another configuration, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select an existing run/debug configuration in the left pane.
- Click Copy Configuration .
- Type a name in the Name field.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
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:
- Open a project in Android or Project view .
- 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.
- Open the Select Run/Debug Configuration drop-down list in the toolbar.
- 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:
- Open a project in Android or Project view .
- Open a Java file in the Code Editor.
- Select a class or method in the code, and then press Control+Shift+T (Command+Shift+T).
- Select Create New Test from the menu that appears.
- In the Create Test dialog, optionally change or set the values and click OK .
- 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.
- Нажмите ОК .
The new test appears in the Project window in the corresponding test source set.
- 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.
- Open the Select Run/Debug Configuration drop-down list in the toolbar.
- 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:
- Select the run/debug configuration from the Select Run/Debug Configuration drop-down list within the toolbar .
- Select Run > Run or Run > Debug .
The drop-down list is to the left of Run and Debug ; например, .
Alternatively, click Run or Debug .
Edit a run/debug configuration
To edit a run/debug configuration, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select a configuration in the left pane.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
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:
- Open the Run/Debug Configurations dialog .
- Click Edit configuration templates... .
- Select a configuration template.
- Modify the configuration, as needed.
- Click Apply or OK .
Be sure to correct any errors displayed at the bottom of the dialog.
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:
- Open the Run/Debug Configurations dialog .
- Select a folder that contains configurations.
- Click Sort Configurations .
- Click OK to close the dialog.
To group configurations in folders, follow these steps:
- Open the Run/Debug Configurations dialog .
- Select a folder that contains configurations.
- Click Create New Folder .
- Type a name in the Folder Name field.
- Click Apply to save the name.
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:
- 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 .
- Add more tasks as needed.
- To order the tasks, drag them or select a task and click Up and Down to move it up or down in the list.
- Select Show this page if you want to display the run/debug configuration settings before applying them.
This option is deselected by default.
- 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:
- Select a task.
- Click Remove .
To edit a task, follow these steps:
- Select a task.
- Click Edit .
- 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:
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:
|
| 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: и Default: no options. |
| Launch Options: Launch | Select an option:
|
| 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. Например: This option doesn't appear if you chose a Launch value of Nothing . Default: no options. |
| Deployment Target Options: Target | Select an option:
|
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 | Выберите один из следующих вариантов:
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: 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. Например: 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 You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where 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:
|
| 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 Default: no options |
| Deployment Target Options: Target | Select an option:
|
| 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 | Выберите один из следующих вариантов:
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: 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. Например: 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 You can change the default to gather more information. For example, the following log options gather information about a specific lldb process platform :gdb-remote packets For a complete list of log commands, enter the Android Studio places device logs in the following location, where Or, if multiple users access a device, it places the logs in the following location, where 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:
For more information about VM options, see the documentation for your J2SE version, such as 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.