Путешествия для Android Studio

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

Напишите путешествие

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

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

1. На панели «Проект» в Android Studio щелкните правой кнопкой мыши модуль приложения, для которого вы хотите написать путешествие.
2. Выберите Новый > Тест > Файл путешествия .
3. В появившемся диалоговом окне укажите название и описание вашего путешествия.
4. Нажмите OK . Android Studio создает XML-файл для вашего путешествия с выбранным вами именем. Вы можете использовать либо представление кода для непосредственного редактирования XML, либо представление дизайна для улучшенного редактирования.
5. При просмотре вашего путешествия в представлении Design используйте текстовое поле для описания каждого шага вашего путешествия. Каждый шаг может включать описательные действия, которые вы хотите, чтобы Gemini выполнил, или утверждения, которые вы хотите, чтобы Gemini оценил.
6. Нажмите Enter на клавиатуре, чтобы начать новую подсказку в том же путешествии. Вы можете повторять это по мере необходимости для каждого шага путешествия, который вы хотите определить.

Советы по написанию путешествий

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

• Избегайте явных одиночных действий: Gemini может превратить каждый шаг вашего пути в несколько действий. Избегайте написания подсказок, которые являются явными одиночными действиями, такими как «нажмите на X», потому что модель обучена достигать сложных целей.
• Отдельные утверждения от действий: Gemini постоянно оценивает состояние вашего приложения, чтобы определить, находится ли оно в «правильном» состоянии для продолжения пути. Однако вам может потребоваться определить более сложные утверждения как отдельный шаг. Кроме того, начинайте каждую подсказку с ключевых фраз, таких как «Проверьте, что», «Утвердите, что» или «Проверьте, что», чтобы дать Gemini знать, что этот шаг должен быть утверждением.
• Direct Gemini с помощью свайпов: в дополнение к базовым взаимодействиям, таким как нажатие или ввод с клавиатуры, Gemini поддерживает действия, требующие проведения по экрану в определенных направлениях. Например, чтобы прокрутить содержимое или закрыть некоторые элементы пользовательского интерфейса, просто опишите направление и цель вашего действия свайпа. По умолчанию Gemini проводит свайпом из центра экрана, но вы можете направить его на проведение свайпом по другой части экрана устройства.
• Избегайте других сложных взаимодействий и изменений конфигурации: в настоящее время Gemini не поддерживает все взаимодействия и изменения конфигурации, такие как жесты несколькими пальцами, повороты экрана или действия по складыванию. Команда работает над улучшением возможностей Gemini.

Проложите свой путь

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

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

1. Выберите целевое устройство на главной панели инструментов, как при запуске инструментального теста.
2. Перейдите к XML-файлу путешествия, который вы хотите протестировать, и откройте его в редакторе.
3. В редакторе выполните одно из следующих действий:
   1. Если вы находитесь в представлении «Дизайн» , нажмите Беги, Путешествие .
   2. Если вы находитесь в представлении кода , нажмите Бегать в поле рядом с тем местом, где в XML определено название поездки.

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

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

Посмотреть результаты

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

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

• Панель «Тесты» разбивает путешествие на отдельные шаги. Вы можете нажать на каждый шаг, чтобы узнать больше информации о том, как Gemini его выполнил.
• Панель результатов отображает подробную информацию, которая поможет вам понять, как Gemini поняли и рассуждали о вашем путешествии, и как оно было реализовано.
• Скриншоты, отправленные в Gemini, показаны для наглядности на каждом этапе действия.
• Рядом с каждым снимком экрана описывается каждое предпринятое действие и обоснование Gemini, побудившее его совершить.
• Каждое действие на шаге пронумеровано.

Известные проблемы

• При тестировании путешествия все разрешения для вашего приложения предоставляются по умолчанию.
• При тестировании путешествия на устройстве под управлением Android 15 (уровень API 35) вы можете увидеть предупреждение на устройстве с надписью «Небезопасное приложение заблокировано» для «AndroidX Crawler». Вы можете нажать «Установить в любом случае» , чтобы обойти эту проверку. Кроме того, вы можете настроить параметры разработчика на устройстве и отключить параметр « Проверять приложения через USB» .
• Файлы Journey в настоящее время не отображаются в представлении Android на панели Projects . Чтобы увидеть файлы journey в вашем проекте, используйте представление Project .
• Если несколько действий в рамках путешествия используют один и тот же запрос, результаты теста, отображаемые в редакторе путешествия, могут быть неверными. В частности, все действия с дублирующим запросом будут показывать результаты теста, связанные с последним обновленным экземпляром этого запроса. Чтобы обойти это, убедитесь, что каждое действие имеет уникальный запрос, например, добавив отдельный префикс или суффикс.
• Всплывающее окно со стилусом появляется при второй загрузке клавиатуры на новом эмуляторе. Это всплывающее окно обычно приводит к сбою тестов, взаимодействующих с текстовыми полями. Когда это происходит, закройте всплывающее окно и повторите путешествие.
• Артефакты сканера приложений могут иногда появляться в обосновании агента.
• Выполнение Journey иногда завершается ошибкой IllegalStateException . Когда это происходит, вы можете нажать на Test Results, чтобы увидеть полную ошибку.

• Если плагин Android Gradle ( com.android.application ) не определен в файле build.gradle верхнего уровня, при запуске путешествия может возникнуть следующая ошибка:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Чтобы решить эту проблему, убедитесь, что плагин определен в файле build.gradle верхнего уровня. Для получения дополнительной информации см. раздел Настройка системы сборки Android .