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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 или шаблон 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 и более ранние версии имели шаблон собственного приложения, которого нет в более новых версиях. Если в проекте есть шаблон собственного приложения, Android Studio преобразует его в приложение Android при загрузке проекта. Диалоговое окно «Преобразовать проект» проведет вас через весь процесс.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    и

    -d -r

    По умолчанию: без опций.

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

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

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

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

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

    -W

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

    По умолчанию: без опций.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    lldb process:gdb-remote packets

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

    lldb process platform :gdb-remote packets

    Чтобы получить полный список команд журнала, введите команду log list из окна оболочки LLDB в Android Studio.

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

    /data/data/ ApplicationId /lldb/log

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

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

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

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

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

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

    Android-тесты

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

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

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

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

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

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

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

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

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

    По умолчанию: без опций

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Добавьте команды 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

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

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

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

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