Как создать сборку и запустить приложение

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

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

Базовая сборка и запуск

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

  1. На панели инструментов выберите приложение в меню конфигураций запуска.
  2. В меню целевых устройств выберите устройство, на котором вы хотите запустить приложение.

    Меню целевых устройств на панели инструментов Android Studio.

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

  3. Нажмите Выполнить .

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

Как отслеживать процесс сборки

Чтобы посмотреть подробные сведения о процессе сборки, выберите View (Вид) > Tool Windows (Окна инструментов) > Build (Сборка) или нажмите Build (Сборка) на панели окон инструментов. В окне инструмента Build (Сборка) отображаются задачи, которые Gradle выполняет для сборки приложения, как показано на рисунке 1.

Рисунок 1. Окно инструмента Build (Сборка) в Android Studio.
  1. Вкладка Sync (Синхронизация). Здесь показаны задачи, которые Gradle выполняет для синхронизации с файлами проекта. Как и на вкладке Build Output (Вывод сборки), если вы столкнулись с ошибкой синхронизации, выберите элементы в дереве, чтобы получить дополнительную информацию об ошибке. Также вы увидите сводку о влиянии скачивания, которая поможет определить, не сказывается ли скачивание зависимостей отрицательно на сборке.
  2. Вкладка Build Output (Выходные данные сборки). На ней в виде дерева показаны задачи, которые выполняет Gradle. Каждый узел представляет собой этап сборки или группу зависимостей задач. Если вы получаете ошибки во время сборки или компиляции, проверьте дерево и выберите элемент, чтобы прочитать вывод ошибки, как показано на рисунке 2.
    Рисунок 2. Проверьте вкладку Build Output (Выходные данные сборки) на наличие сообщений об ошибках.
  3. Вкладка Build Analyzer. Содержит информацию об эффективности сборки. Подробнее о том, как устранять неполадки с производительностью сборки с помощью Build Analyzer…
  4. Перезапустить. Повторить последнее действие сборки. Если вы в последний раз запускали Build > Make Selected Module (Сборка > Собрать выбранный модуль), будет собран текущий модуль. Если вы в последний раз запускали Build > Make Project (Сборка > Создать проект), будут созданы промежуточные файлы сборки для всех модулей в проекте.
  5. Фильтры. Позволяют отфильтровать предупреждения, задачи или и то, и другое, которые были успешно выполнены. Это упрощает поиск проблем в выходных данных.

Если в вариантах сборки используются версии продукта, Gradle также вызывает задачи для сборки этих версий. Чтобы посмотреть список всех доступных задач сборки, нажмите View (Вид) > Tool Windows (Окна инструментов) > Gradle или выберите Gradle на панели окон инструментов.

Если во время сборки произойдет ошибка, Gradle может порекомендовать параметры командной строки, которые помогут решить проблему, например --stacktrace или --debug. Чтобы использовать параметры командной строки в процессе сборки, выполните следующие действия:

  1. Откройте диалоговое окно Настройки.
    • В Windows или Linux выберите File (Файл) > Settings (Настройки) в строке меню.
    • В macOS выберите Android Studio > Preferences (Android Studio > Настройки) в строке меню.
  2. Перейдите в раздел Build, Execution, Deployment > Compiler (Сборка, выполнение, развертывание > Компилятор).
  3. В текстовом поле рядом с пунктом Параметры командной строки введите нужные параметры.
  4. Нажмите ОК, чтобы сохранить изменения и выйти.

Gradle применит эти параметры командной строки при следующей попытке сборки приложения.

Как создать и запустить приложение с помощью ИИ-агента

У ИИ-агента в Android Studio есть доступ к инструментам, которые позволяют ему создавать и развертывать ваше приложение, а затем проверять его состояние от вашего имени. В режиме агента Gemini может выполнять такие задачи, как:

  • Разверните приложение на подключенном физическом устройстве или эмуляторе.
  • Проверьте экран и сделайте скриншоты, чтобы подтвердить изменения в интерфейсе.
  • Проверьте Logcat на наличие ошибок выполнения или определенных сообщений в журнале.
  • Взаимодействуйте с приложением, используя команды adb shell для навигации или ввода данных.

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

Инструменты для взаимодействия с устройствами в Android Studio.
Рисунок 3. ИИ-агент может помочь вам протестировать и проверить изменения на устройстве.

Расширенные функции сборки и запуска

Для тестирования приложения должно быть достаточно стандартного способа сборки и запуска в Android Studio. Однако вы можете использовать эти функции сборки и запуска для более сложных сценариев:

  • Чтобы развернуть приложение в режиме отладки, нажмите Debug (Отладка) . В режиме отладки вы можете устанавливать точки останова в коде, проверять переменные и оценивать выражения во время выполнения, а также запускать инструменты отладки. Подробнее об отладке приложения…

  • Если у вас большое и сложное приложение, используйте функцию "Применить изменения" вместо кнопки Запустить . Это экономит время, поскольку вам не нужно перезапускать приложение каждый раз, когда вы хотите развернуть изменение. Подробнее о функции "Применить изменения" рассказывается в разделе Постепенное развертывание с помощью функции "Применить изменения".

  • Если вы используете Jetpack Compose, то можете включить экспериментальную функцию Live Edit, которая позволяет обновлять composable-функции в реальном времени, не нажимая кнопку Run (Запустить) . Это позволяет вам сосредоточиться на написании кода пользовательского интерфейса с минимальными перерывами. Подробную информацию вы найдете в разделе Live Edit (экспериментальная функция).

  • Если у вас есть приложение с несколькими вариантами сборки или версиями, вы можете выбрать, какой вариант сборки развернуть, в окне инструмента Варианты сборки. Подробнее о том, как запустить определенный вариант сборки…

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

  • Для разработки мы рекомендуем использовать Android Studio, но вы также можете развернуть приложение на виртуальном или физическом устройстве из командной строки. Подробнее о том, как создать приложение из командной строки…

Постепенное развертывание с помощью функции "Применить изменения"

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

Функция "Применить изменения" использует возможности реализации JVMTI в Android, которые поддерживаются на устройствах с Android 8.0 (уровень API 26) или более поздней версии. Подробнее о том, как работает функция «Применение изменений», рассказывается в статье Android Studio Project Marble: Apply Changes.

Требования

Действия по применению изменений доступны только при соблюдении следующих условий:

  • Вы создаете APK-файл приложения, используя вариант отладочной сборки.
  • Вы развертываете приложение на целевом устройстве или в эмуляторе с Android 8.0 (уровень API 26) или более поздней версии.

Как использовать функцию "Применить изменения"

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

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

Вы также можете нажать Ctrl + Alt + F10 (Ctrl + Command + Shift + R на macOS).

Apply Code Changes (Применить изменения кода) Значок "Применить изменения кода". Попытка применить только изменения кода без перезапуска. Как правило, этот вариант можно использовать, если вы изменили код в теле метода, но не меняли ресурсы. Если вы изменили и код, и ресурсы, используйте функцию Применить изменения и перезапустить действие.

Вы также можете нажать Ctrl + F10 (Ctrl + Command + R на macOS).

Run . Развертывает все изменения и перезапускает приложение. Используйте этот вариант, если изменения нельзя применить с помощью вариантов Применение изменений. Чтобы узнать больше о типах изменений, требующих перезапуска приложения, ознакомьтесь с разделом Ограничения применения изменений.

Включить резервный запуск для применения изменений

Когда вы нажимаете Apply Changes and Restart Activity (Применить изменения и перезапустить Activity) или Apply Code Changes (Применить изменения кода), Android Studio создает новый APK-файл и определяет, можно ли применить изменения. Если изменения не могут быть применены и это приведет к сбою функции Применение изменений, Android Studio предложит вам снова запустить приложение.

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

  1. Откройте диалоговое окно Настройки.

    • В Windows или Linux выберите в меню File (Файл) > Settings (Настройки).
    • В macOS выберите в меню Android Studio > Preferences (Android Studio > Настройки).
  2. Перейдите в раздел Build, Execution, Deployment (Сборка, выполнение, развертывание) > Deployment (Развертывание).

  3. Установите флажки, чтобы включить автоматический запуск резервного варианта для одного или обоих действий Apply Changes.

  4. Нажмите ОК.

Изменения, зависящие от платформы

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

Ограничения функции Применение изменений

Функция "Применить изменения" предназначена для ускорения процесса развертывания приложения. Однако есть некоторые ограничения на его использование.

Изменения кода, требующие перезапуска приложения

Некоторые изменения в коде и ресурсах вступают в силу только после перезапуска приложения. К ним относятся:

  • добавление или удаление поля;
  • Удаление способа
  • Изменение сигнатур методов
  • Изменение модификаторов методов или классов.
  • Изменение наследования классов
  • Изменение значений в перечислениях
  • добавление или удаление ресурса;
  • Изменение манифеста приложения
  • Изменение нативных библиотек (SO-файлов)
Библиотеки и плагины

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

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

Чтобы избежать этих ограничений, отключите все автоматические обновления для вариантов отладочной сборки.

Например, Firebase Crashlytics обновляет ресурсы приложения с уникальным идентификатором сборки во время каждой сборки, что не позволяет использовать Применить изменения кодаЗначок "Применить изменения кода" и требует перезапуска действия приложения, чтобы увидеть изменения. Отключите эту функцию, чтобы использовать Apply Code Changes (Применить изменения кода) вместе с Crashlytics в отладочных сборках.

Код, который напрямую ссылается на контент в установленном APK.

Если ваш код напрямую ссылается на контент из APK-файла приложения, установленного на устройстве, то после нажатия на значок Применить изменения в коде Значок "Применить изменения кода" могут возникнуть сбои или ошибки. Это происходит потому, что при нажатии кнопки Apply Code Changes (Применить изменения кода) базовый APK-файл на устройстве заменяется во время установки. В таких случаях можно нажать Apply Changes and Restart Activity (Применить изменения и перезапустить действие) Значок "Применить изменения и перезапустить действие" или Run (Запустить) .

Если при использовании функции "Применить изменения" у вас возникнут другие проблемы, сообщите об ошибке.

Изменения в реальном времени

Live Edit – это экспериментальная функция в Android Studio, которая позволяет обновлять composable-функции в эмуляторах и на физических устройствах в режиме реального времени. Эта функция сводит к минимуму переключение контекста между написанием и сборкой приложения, позволяя вам дольше сосредоточиться на написании кода без перерывов.

Подробнее о Live Edit…

Как изменить вариант сборки

По умолчанию Android Studio создает отладочную версию приложения, предназначенную для использования только во время разработки, когда вы нажимаете Run (Запустить) Кнопка
интерфейса.

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

  • В меню выберите Build (Сборка) > Select Build Variant (Выбрать вариант сборки).
  • В меню выберите View (Вид) > Tool Windows (Окна инструментов) > Build Variants (Варианты сборки).
  • На панели окон инструментов нажмите на вкладку Варианты сборки.

Если в проекте нет нативного кода или кода C++, на панели Варианты сборки будет два столбца: Модуль и Активный вариант сборки. Значение Active Build Variant (Активный вариант сборки) для модуля определяет, какой вариант сборки IDE развертывает на подключенном устройстве и показывает в редакторе.

Рисунок 4. Если в проекте нет нативного кода или кода на C++, на панели Варианты сборки будет два столбца.

Чтобы переключиться между вариантами, нажмите на ячейку Active Build Variant (Активный вариант сборки) для модуля и выберите нужный вариант из списка.

Для проектов с нативным кодом или кодом на C++ на панели Варианты сборки есть три столбца:

  • Модуль
  • Active Build Variant (Активный вариант сборки)
  • Активный ABI

Значение Active Build Variant (Активный вариант сборки) для модуля определяет вариант сборки, который IDE развертывает на вашем устройстве и который виден в редакторе. Для нативных модулей значение Active ABI (Активный ABI) определяет ABI, который использует редактор, но не влияет на развертывание.

Рисунок 5. На панели Варианты сборки появится столбец Активный ABI для проектов с нативным кодом или кодом C++.

Чтобы изменить вариант сборки или ABI, нажмите на ячейку в столбце Активный вариант сборки или Активный ABI и выберите нужный вариант из списка. После изменения выбора IDE автоматически синхронизирует ваш проект. Изменение любого столбца для модуля приложения или библиотеки применяется ко всем зависимым строкам.

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

Конфликты в диалоговом окне вариантов сборки Android Studio

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

Окно Build Variant (Вариант сборки) с ошибками конфликта вариантов.

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

Например, если у вас есть модуль M1, который зависит от варианта v1 модуля M2, но в IDE выбран вариант v2 модуля M2, в IDE будут неразрешенные символы. Предположим, что M1 зависит от класса, который доступен только в v1. Если выбрана версия v2, этот класс не будет распознан IDE. Поэтому он не может распознать имя класса и показывает ошибки в коде модуля M1.

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

Как изменить конфигурацию выполнения/отладки

При первом запуске приложения Android Studio использует конфигурацию запуска по умолчанию. В конфигурации запуска указывается, как развертывать приложение (из APK-файла или набора Android App Bundle), а также модуль для запуска, пакет для развертывания, действие для запуска, целевое устройство, настройки эмулятора, параметры Logcat и т. д.

Конфигурация выполнения/отладки по умолчанию создает APK-файл, запускает операцию проекта по умолчанию и использует диалоговое окно Select Deployment Target (Выбор целевого устройства) для выбора целевого устройства. Если настройки по умолчанию не подходят для вашего проекта или модуля, вы можете настроить конфигурацию выполнения/отладки или создать новую на уровне проекта, по умолчанию и на уровне модуля.

Чтобы изменить конфигурацию выполнения/отладки, выберите Run (Выполнить) > Edit Configurations (Изменить конфигурации). Подробнее о том, как создавать и редактировать конфигурации выполнения/отладки…