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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. Выберите Выполнить > Выполнить или Выполнить > Отладка .
  4. Или нажмите «Выполнить». или отладка .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Поле Описание
    Модуль Выберите модуль , к которому нужно применить эту конфигурацию.
    Варианты установки: Развертывание

    Выберите вариант:

    • Default APK — создание и развертывание APK для выбранного вами варианта .
    • APK из пакета приложений — сборка и развертывание приложения из пакета приложений Android App Bundle . Это означает, что Android Studio сначала преобразует ваш проект приложения в пакет приложений, включающий весь скомпилированный код и ресурсы приложения. Затем из этого пакета Android Studio генерирует только те APK-файлы, которые необходимы для развертывания приложения на подключенном устройстве. Обычно этот вариант следует использовать при тестировании пакета приложений, который вы собираетесь загрузить в Google Play, поскольку развертывание из пакета приложений увеличивает общее время сборки.
    • Пользовательский артефакт — не поддерживается в Android Studio.
    • Ничего — не устанавливайте APK на устройство. Например, если вы предпочитаете установить APK вручную, вам не понадобится Android Studio.
    Варианты установки: Развернуть как мгновенное приложение Если ваше приложение поддерживает мгновенный запуск (то есть вы либо добавляете поддержку мгновенных приложений при создании нового проекта , либо создаете один или несколько модулей функций с поддержкой мгновенного запуска ), вы можете развернуть эти модули с поддержкой мгновенного запуска, установив флажок рядом с опцией Развернуть как мгновенное приложение .
    Варианты установки: функции для развертывания Если ваше приложение включает модули функций , установите флажок рядом с каждой функцией, которую вы хотите включить при развертывании приложения. Этот параметр отображается только в том случае, если ваше приложение включает модули функций.

    Примечание: Если вы хотите протестировать загрузку и установку модулей функций по запросу, это необходимо сделать после публикации комплекта приложений, а затем использовать внутреннюю тестовую версию Play Console. Подробнее см. в статье «Загрузка комплекта приложений в Play Console» .

    Варианты установки: Установка флагов Введите любые нужные параметры adb pm install . Форматируйте параметры так же, как в командной строке, но без пути. Вот несколько примеров:

    -i foo.bar.baz -r /path/to/apk

    и

    -d -r

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

    Параметры запуска: Запуск

    Выберите вариант:

    • Ничего — не запускайте ничего при выборе «Запустить» или «Отладить» . Однако, если ваше приложение уже запущено и вы выбираете «Отладить» , Android Studio подключает отладчик к процессу вашего приложения.
    • Default Activity — запуск активности, которую вы отметили как стартовую в манифесте. Например:
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    • Указанное действие — запуск определённого действия приложения в вашем модуле. При выборе этого параметра ниже появляется поле « Действие» , в котором можно ввести название действия, которое нужно запустить, или нажать «Дополнительно» , чтобы выбрать действие из списка.
    • URL — запуск URL, соответствующего фильтру намерений в манифесте вашего приложения. При выборе этого параметра ниже появляется поле URL , в которое можно ввести URL.

      Необходимо заполнить это поле для запуска приложения Android Instant App . Вы также можете использовать его для тестирования ссылок на приложения Android .

    Параметры запуска: Флаги запуска Введите любые нужные вам параметры adb am start . Форматируйте параметры так же, как в командной строке, но без указания намерения. Например:

    -W

    Эта опция не отображается, если для параметра Launch выбрано значение Nothing .

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

    Параметры цели развертывания: Цель

    Выберите вариант:

    • Открыть диалоговое окно «Выбор цели развертывания» — открыть диалоговое окно «Выбор цели развертывания» , чтобы выбрать виртуальное или аппаратное устройство.
    • USB-устройство — используйте устройство, подключенное к компьютеру разработчика через USB-порт. Если устройств несколько, появится диалоговое окно для выбора нужного устройства.
    • Эмулятор — использование виртуального устройства. В конфигурации можно выбрать AVD; в противном случае будет использоваться первое AVD в списке.

    Параметры цели развертывания: использовать то же устройство для будущих запусков

    По умолчанию этот параметр отключен, поэтому при каждом запуске приложения будет появляться диалоговое окно «Выбор развертывания» для выбора устройства. Если выбрать этот параметр и запустить приложение, появится диалоговое окно «Выбор развертывания» для выбора устройства. После этого приложение будет запускаться на выбранном устройстве без отображения диалогового окна «Выбор развертывания» . Чтобы запустить приложение на другом устройстве, снимите флажок «Использовать то же устройство для будущих запусков» или остановите приложение, выбрав «Выполнить» > «Остановить app или «Остановить». , а затем запустите его снова. Откроется диалоговое окно «Выбор развертывания» , в котором вы сможете выбрать устройство.
    Перед запуском См. Определение операций перед запуском .

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

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

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

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

    Этот параметр работает совместно с предыдущим, который определяет, будет ли установлен APK-файл. Для обоих полей «Параметры установки» оставьте значения по умолчанию, если вы явно не хотите принудительно запускать установку каждый раз.

    В некоторых случаях может потребоваться снять этот флажок. Например, если вы пишете редактор методов ввода (IME), принудительная остановка приложения отменит его выбор в качестве текущей клавиатуры, что может быть нежелательным.

    По умолчанию: выбрано

    Перед запуском См. Определение операций перед запуском .

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

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

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

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

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

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

    Поле Описание
    Тип отладки

    Выберите один из следующих вариантов:

    • Только Java — отладка только кода Java.
    • Автоматическое определение — позвольте Android Studio выбрать лучший тип отладки для вашего проекта.
    • Только собственный код — отладка собственного кода C или C++.
    • Dual (Java + Native) — отладка Java и собственного кода в двух отдельных сеансах отладки.

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

    Каталоги символов

    Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию о C или C++, сгенерированную вне Android Studio, вы можете добавить здесь один или несколько каталогов. Android Studio отдаёт предпочтение файлам из этих каталогов, а не файлам, сгенерированным плагином Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдёт нужные. Поиск выполняется рекурсивно по файлам в каталоге. Для оптимизации списка и экономии времени размещайте наиболее часто используемые каталоги в начале списка.

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

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

    Команды запуска LLDB

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

    settings set target.max-memory-read-size 2048

    LLDB выполняет команды по порядку сверху вниз.

    Команды присоединения постов LLDB

    Добавьте команды LLDB, которые вы хотите выполнить сразу после подключения отладчика к процессу. Например:

    process handle SIGPIPE -n true -p true -s false

    LLDB выполняет команды по порядку сверху вниз.

    Рабочий каталог хоста Укажите рабочий каталог LLDB.
    Ведение журнала: целевые каналы

    Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию, основываясь на опыте команды, чтобы журнал не был слишком медленным, но содержал необходимую информацию для устранения неполадок. Журнал часто запрашивается для отчётов об ошибках Android Studio. Значение по умолчанию:

    lldb process:gdb-remote packets

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

    lldb process platform :gdb-remote packets

    Для получения полного списка команд журнала введите команду log list в окне оболочки LLDB в Android Studio.

    Android Studio размещает журналы устройства в следующем месте, где ApplicationId — уникальный идентификатор приложения, который используется в вашем манифесте APK и идентифицирует ваше приложение на вашем устройстве и в магазине Google Play:

    /data/data/ ApplicationId /lldb/log

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

    /data/user/ AndroidUserId / ApplicationId /lldb/log

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

    Перед запуском См. Определение операций перед запуском .

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

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

    Тесты Android

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

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

    Ниже приведены описания вкладок и полей шаблона теста Android Instrumented. Сведения о вкладках и полях шаблона теста Android JUnit см. на странице IntelliJ Run/Debug Configuration: JUnit .

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

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

    Поле Описание
    Модуль Выберите модуль , к которому нужно применить эту конфигурацию.
    Тест

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

    • Все в модуле — запуск всех тестов из выбранного модуля.
    • Все тесты из пакета — запуск всех тестов из пакета, указанного в поле «Пакет» . Введите имя или нажмите «Ещё» , чтобы выбрать пакет в диалоговом окне.
    • Класс — запуск тестов класса, указанного в поле «Класс» . Введите имя или нажмите « Ещё» , чтобы выбрать класс в диалоговом окне.
    • Метод — запуск тестового метода. В поле «Класс» укажите класс, содержащий метод. В поле «Метод» укажите метод. Введите имя или нажмите «Дополнительно» , чтобы выбрать класс или метод в диалоговом окне.
    Специальный инструментальный блок (опционально) Введите местоположение инструментария ; нажмите «Подробнее» , чтобы открыть диалоговое окно. Файл build.gradle определяет местоположение инструментария; это значение переопределяет его. Значение по умолчанию обычно — класс AndroidJUnitRunner из AndroidX Test .
    Дополнительные опции

    Введите любые нужные вам параметры am instrument . Не вводите название компонента. Например, если вы используете AndroidJUnitRunner из AndroidX Test , вы можете использовать это поле для передачи дополнительных параметров в средство запуска, например, -e size small .

    По умолчанию: без параметров

    Параметры цели развертывания: Цель

    Выберите вариант:

    • Открыть диалоговое окно «Выбор цели развертывания» — открыть диалоговое окно «Выбор цели развертывания» , чтобы выбрать виртуальное или аппаратное устройство.
    • USB-устройство — используйте устройство, подключенное к компьютеру разработчика через USB-порт. Если устройств несколько, появится диалоговое окно для выбора нужного устройства.
    • Эмулятор — использование виртуального устройства. В конфигурации можно выбрать AVD; в противном случае будет использоваться первое AVD в списке.
    • Матрица устройств Firebase Test Lab — см. раздел Выполнение тестов с помощью Firebase Test Lab .
    Параметры цели развертывания: использовать то же устройство для будущих запусков Если вы хотите автоматически использовать устройство, выбранное в диалоговом окне «Выбор цели развертывания» , в будущем, выберите этот параметр. Если устройство недоступно, появится диалоговое окно. Значение по умолчанию: не выбрано.
    Перед запуском См. Определение операций перед запуском .

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

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

    Поле Описание
    Logcat: очистить журнал перед запуском Выберите этот параметр, чтобы Android Studio удаляла данные предыдущих сеансов из файла журнала перед запуском приложения. По умолчанию: не выбрано.
    Варианты установки: Пропустить установку, если APK не изменился Если этот параметр выбран, Android Studio не будет повторно развертывать APK-файл, если обнаружит, что он не изменился. Если вы хотите, чтобы Android Studio принудительно установила APK-файл, даже если он не изменился, снимите этот флажок. Значение по умолчанию: выбрано.
    Варианты установки: Принудительная остановка запущенного приложения перед запуском активности

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

    Этот параметр работает совместно с предыдущим, который управляет установкой APK. Для обоих полей «Параметры установки» оставьте значения по умолчанию, если вы явно не хотите принудительно запускать установку каждый раз.

    В некоторых случаях может потребоваться снять этот флажок. Например, если вы пишете редактор методов ввода (IME), принудительная остановка приложения отменит его выбор в качестве текущей клавиатуры, что может быть нежелательным.

    По умолчанию: выбрано

    Перед запуском См. Определение операций перед запуском .

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

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

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

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

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

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

    Поле Описание
    Тип отладки

    Выберите один из следующих вариантов:

    • Только Java — отладка только кода Java.
    • Автоматическое определение — позвольте Android Studio выбрать лучший тип отладки для вашего проекта.
    • Только собственный код — отладка собственного кода C или C++.
    • Dual (Java + Native) — отладка Java и собственного кода в двух отдельных сеансах отладки.

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

    Каталоги символов

    Если вы хотите добавить файлы символов, чтобы предоставить отладчику информацию о C или C++, сгенерированную вне Android Studio, вы можете добавить здесь один или несколько каталогов. Android Studio отдаёт предпочтение файлам из этих каталогов, а не файлам, сгенерированным плагином Android для Gradle . Отладчик просматривает каталоги сверху вниз по порядку, пока не найдёт нужные. Поиск выполняется рекурсивно по файлам в каталоге. Для оптимизации списка и экономии времени размещайте наиболее часто используемые каталоги в начале списка.

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

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

    Команды запуска LLDB

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

    settings set target.max-memory-read-size 2048

    LLDB выполняет команды по порядку сверху вниз.

    LLDB POST ATTH

    Добавьте команды LLDB, которые вы хотите выполнить сразу после того, как отладчик присоединяется к процессу. Например:

    process handle SIGPIPE -n true -p true -s false

    LLDB выполняет команды в порядке сверху вниз.

    Хозяин рабочий каталог Укажите рабочий каталог LLDB.
    Регистрация: целевые каналы

    Укажите параметры журнала LLDB. Android Studio устанавливает параметры по умолчанию на основе опыта команды - так что это не слишком медленно, но содержит необходимую информацию для проблем с устранением неполадок. Журнал часто требуется для отчетов об ошибках Android Studio. Это по умолчанию

    lldb process:gdb-remote packets

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

    lldb process platform :gdb-remote packets

    Для получения полного списка команд журнала введите команду log list из окна оболочки LLDB в Android Studio.

    Android Studio помещает журналы устройств в следующем месте, где ApplicationId - это уникальный идентификатор приложения, который используется в вашем застроенном манифесте APK, и идентифицирует ваше приложение на вашем устройстве и в магазине Google Play:

    /data/data/ ApplicationId /lldb/log

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

    /data/user/ AndroidUserId / ApplicationId /lldb/log

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

    Перед запуском См. Определение перед операциями запуска .

    App Engine Devappserver

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

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

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

    Укажите параметры командной строки, которые вы хотите передать в виртуальную машину для запуска Devappserver. При указании параметров:

    • Используйте пространства, чтобы разделить разные параметры.
    • Для вариантов, которые имеют места, приложите пространство в кавычки ( " " ).
    • Если вариант включает в себя кавычки, добавьте Backslash перед кавычками ( \" ).

    Для получения дополнительной информации о вариантах виртуальной машины см. Документацию для вашей версии J2SE, такой как java JDK 7 и java JDK 8 .

    По умолчанию: нет параметров

    Адрес сервера Введите адрес хоста для использования для сервера. Возможно, вам придется предоставить адрес, чтобы иметь возможность получить доступ к серверу разработки с другого компьютера в вашей сети. Адрес 0.0.0.0 позволяет как доступ к Localhost, так и на имя хоста. По умолчанию: Localhost
    Порт сервера Введите номер порта для использования для сервера. По умолчанию: 8080
    Отключить проверку для приложения Engine SDK обновления Если будет дан, сервер разработки не будет связываться с App Engine, чтобы проверить наличие нового выпуска SDK. По умолчанию сервер проверяет новую версию по запуску и печатает сообщение, если доступна новая версия.
    Перед запуском См. Определение перед операциями запуска .

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

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

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

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

    Запустите кнопку в желобе рядом с классом WatchFaceService.
    Рисунок 1. Запустите поверхность износа ОС непосредственно, используя значок желоба.