Плагин Google Assistant для Android Studio, плагин Google Assistant для Android Studio, плагин Google Assistant для Android Studio, плагин Google Assistant для Android Studio

Плагин Google Assistant тестирует действия приложения в Android Studio. Во время разработки и тестирования вы используете плагин для предварительного просмотра действий вашего приложения в Ассистенте для вашей учетной записи Google. Затем вы можете проверить, как ваше действие приложения обрабатывает различные параметры, прежде чем отправлять его на развертывание.

Как это работает

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

Для каждого встроенного намерения (BII) в файле Shorts.xml инструмент отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Затем вы можете изменить эти значения, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения. Предварительные просмотры создаются, обновляются и удаляются с помощью инструмента тестирования, что позволяет вам повторять и тестировать действия приложения в безопасной среде.

После создания предварительного просмотра вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования. Для BII, доступных для запуска пользователем, вы можете использовать app name непосредственно в Ассистенте на своем устройстве, чтобы опробовать действие приложения. Например, вы можете сказать: «Окей, Google, начни мое упражнение с использованием примера приложения», чтобы запустить действие приложения, использующее actions.intent.START_EXERCISE BII.

Поддержка локали

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

Получить плагин

Плагин Google Assistant доступен для Android Studio. Информацию об установке и использовании Android Studio см. на странице Android Studio .

Чтобы установить плагин Google Assistant в Android Studio, выполните следующие действия:

1. Перейдите в «Файл» > «Настройки» ( Android Studio > «Настройки» в macOS).
2. В разделе «Плагины» перейдите на Marketplace и найдите «Плагин Google Assistant».
3. Установите инструмент и перезапустите Android Studio.

Вы также можете скачать плагин прямо из публичного репозитория Jetbrains .

Требования к настройке

Использование плагина Google Assistant требует ряда шагов настройки, чтобы обеспечить успешное тестирование вашего App Action. В частности, вы должны использовать одну и ту же учетную запись пользователя в Android Studio, на тестовом устройстве и для доступа к консоли Google Play.

Подготовьте среду разработки со следующими конфигурациями:

• Войдите в Android Studio (версия 4.0 или новее).
• Используя ту же учетную запись, войдите в приложение Google на тестовом устройстве Android.
• Используя ту же учетную запись, получите доступ Play Console к загруженному пакету приложения для тестирования.
• Откройте приложение Google на тестовом устройстве Android и завершите процесс первоначальной настройки Ассистента.
• Включите синхронизацию данных устройства на тестовом устройстве.

Ограничения

Плагин Google Assistant имеет следующие ограничения:

• Действия приложения, включающие веб-инвентаризацию и вызов приложения на переднем плане, нельзя тестировать непосредственно в инструменте тестирования или с помощью команд моста отладки Android ( adb ). Чтобы протестировать эти действия приложения, сначала создайте предварительный просмотр с помощью инструмента тестирования. Затем запустите эти действия приложения, взаимодействуя с Google Assistant на вашем физическом устройстве.
• Встроенный инвентарь для actions.intent.OPEN_APP_FEATURE BII можно тестировать только в течение шести часов после создания или обновления предварительной версии. Обновите предварительный просмотр инструмента тестирования или создайте новый предварительный просмотр, чтобы сбросить шестичасовой период времени.

Добавить дополнительных тестировщиков

Вы можете пригласить в свой проект дополнительных пользователей, чтобы они могли протестировать вашу интеграцию с App Actions. Это полезно, если вы хотите поделиться проектом с другими членами вашей команды разработчиков, чтобы все они могли его протестировать, или когда вы делитесь своим проектом с тестировщиками обеспечения качества (QA) при подготовке к запуску производства. Тестировщиков необходимо добавить в качестве тестировщиков лицензий в Google Play Store и предоставить им доступ только для чтения к Google Play Console.

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

1. Войдите в Play Console .

2. Следуйте инструкциям в разделе «Настройка лицензирования приложений» в этом разделе справки Play Console .

   

3. Пригласите учетную запись Google тестера лицензий в качестве пользователя консоли Google Play только для чтения.

   1. Выберите «Пользователь и разрешения» > «Пригласить новых пользователей» > «Добавить приложение» .
   2. В App Access убедитесь, что флажок «Администратор (все разрешения)» снят.

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

Используйте плагин Google Assistant

Откройте инструмент тестирования действий приложения в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Инструмент тестирования действий приложения» . Когда вы открываете инструмент, вид меняется в зависимости от того, есть ли у вас активный предварительный просмотр инструмента тестирования.

Создание, обновление и удаление превью

Вы можете использовать черновую версию приложения для тестирования. Дополнительные сведения см. в разделе Подготовка и развертывание выпуска . Протестируйте свое приложение в режиме черновика, прежде чем отправлять его на рассмотрение.

Инструмент тестирования создает предварительные просмотры на основе вашей учетной записи Google и имени пакета приложения ( идентификатора приложения ), поэтому вы можете тестировать несколько приложений с одной и той же учетной записью Google. Пока идентификатор вашего приложения разный для каждого приложения, вы можете продолжать использовать одну и ту же учетную запись Google для создания и тестирования предварительной версии. Каждая из нескольких учетных записей Google с доступом к одному и тому же пакету приложений может использовать инструмент тестирования для создания отдельных предварительных просмотров для этого приложения.

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

1. Откройте инструмент тестирования действий приложения.
2. При необходимости введите имя приложения и языковой стандарт для тестирования. Имя и локаль приложения по умолчанию — test app action и en .
3. Нажмите «Создать предварительный просмотр» . При появлении запроса просмотрите и примите политику и условия обслуживания App Actions. После создания предварительного просмотра окно инструмента тестирования обновляется и отображает информацию о BII, найденных в файле Shorts.xml .

Инструмент тестирования использует имя приложения для создания и моделирования запросов Ассистента для действий вашего приложения. Действия развернутого приложения используют для вызова имя вашего приложения Play Store, но вы можете использовать любое имя вызова в инструменте тестирования. Однако мы рекомендуем использовать имя вашего приложения в качестве имени вызова в инструменте тестирования.

Указанный вами языковой стандарт должен соответствовать языку Google Ассистента на вашем тестовом устройстве, и вы можете одновременно создавать предварительный просмотр только на одном языковом стандарте. Например, если ваш язык Ассистента — английский (США), вы можете ввести en-US , но не en-** , en-GB или en-US, en-GB . Вы можете использовать корневую локаль, например en , чтобы включить как en-GB так и en-US .

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

Чтобы обновить существующий предварительный просмотр в соответствии с файлом Shorts.xml , нажмите кнопку «Обновить» в инструменте тестирования. Информация о текущей предварительной версии находится в разделе «Действие приложения для тестирования» окна инструмента тестирования.

Настройка BII

Создав предварительную версию своего приложения, вы можете протестировать различные значения параметров для BII в плагине. Для каждого BII в файле Shorts.xml плагин отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Вы можете изменить эти значения по умолчанию, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения.

Параметры и их значения обычно соответствуют структуре свойств и описаний schema.org или schema.googleapis.com . Информацию о любом параметре BII можно найти, обратившись к описаниям типа схемы параметра и его параметров более высокого уровня.

Например, actions.intent.GET_FOOD_OBSERVATION BII поддерживает параметр намерения foodObservation.forMeal . На странице schema.googleapis.com для MealType name указано в качестве свойства. Свойство forMeal представляет собой режим передачи и ожидает значений (например, MealTypeLunch ) перечисляемого типа MealType .

В инструменте тестирования вы можете указать любое перечисление в качестве значения foodObservation.forMeal :

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

Триггерные действия приложения

После создания предварительного просмотра и настройки BII вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования.

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

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

Действия приложения, запускаемые в инструменте тестирования, используют отображаемую команду Android Debug Bridge ( adb ). Сгенерированная команда оболочки adb включает все метаданные, необходимые приложению Google для выполнения BII. Этот подход имитирует поведение вашего действия приложения после того, как Ассистент извлекает ключевые фрагменты информации из запроса.

Ведение журнала Android Studio

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

Чтобы получить доступ к файлам журналов Android Studio, выберите «Справка» > «Показать проводник входа» ( «Справка» > «Показать поиск входа в систему» ​​на macOS).

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

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

1. Получите доступ к сообщениям журнала Logcat, нажав Logcat на панели инструментов Android Studio.
2. Найдите журналы, содержащие ActivityTaskManager .

Получите поддержку и дополнительные ресурсы

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

Вы можете открыть помощника в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Справка» .

Рисунок 2. Раздел справки плагина Google Assistant.

Плагин Google Assistant тестирует действия приложения в Android Studio. Во время разработки и тестирования вы используете плагин для предварительного просмотра действий вашего приложения в Ассистенте для вашей учетной записи Google. Затем вы можете проверить, как ваше действие приложения обрабатывает различные параметры, прежде чем отправлять его на развертывание.

Как это работает

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

Для каждого встроенного намерения (BII) в файле Shorts.xml инструмент отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Затем вы можете изменить эти значения, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения. Предварительные просмотры создаются, обновляются и удаляются с помощью инструмента тестирования, что позволяет вам повторять и тестировать действия приложения в безопасной среде.

После создания предварительного просмотра вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования. Для BII, доступных для запуска пользователем, вы можете использовать app name непосредственно в Ассистенте на своем устройстве, чтобы опробовать действие приложения. Например, вы можете сказать: «Окей, Google, начни мое упражнение с использованием примера приложения», чтобы запустить действие приложения, использующее actions.intent.START_EXERCISE BII.

Поддержка локали

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

Получить плагин

Плагин Google Assistant доступен для Android Studio. Информацию об установке и использовании Android Studio см. на странице Android Studio .

Чтобы установить плагин Google Assistant в Android Studio, выполните следующие действия:

1. Перейдите в «Файл» > «Настройки» ( Android Studio > «Настройки» в macOS).
2. В разделе «Плагины» перейдите на Marketplace и найдите «Плагин Google Assistant».
3. Установите инструмент и перезапустите Android Studio.

Вы также можете скачать плагин прямо из публичного репозитория Jetbrains .

Требования к настройке

Использование плагина Google Assistant требует ряда шагов настройки, чтобы обеспечить успешное тестирование вашего App Action. В частности, вы должны использовать одну и ту же учетную запись пользователя в Android Studio, на тестовом устройстве и для доступа к консоли Google Play.

Подготовьте среду разработки со следующими конфигурациями:

• Войдите в Android Studio (версия 4.0 или новее).
• Используя ту же учетную запись, войдите в приложение Google на тестовом устройстве Android.
• Используя ту же учетную запись, получите доступ Play Console к загруженному пакету приложения для тестирования.
• Откройте приложение Google на тестовом устройстве Android и завершите процесс первоначальной настройки Ассистента.
• Включите синхронизацию данных устройства на тестовом устройстве.

Ограничения

Плагин Google Assistant имеет следующие ограничения:

• Действия приложения, включающие веб-инвентаризацию и вызов приложения на переднем плане, нельзя тестировать непосредственно в инструменте тестирования или с помощью команд моста отладки Android ( adb ). Чтобы протестировать эти действия приложения, сначала создайте предварительный просмотр с помощью инструмента тестирования. Затем запустите эти действия приложения, взаимодействуя с Google Assistant на вашем физическом устройстве.
• Встроенный инвентарь для actions.intent.OPEN_APP_FEATURE BII можно тестировать только в течение шести часов после создания или обновления предварительной версии. Обновите предварительный просмотр инструмента тестирования или создайте новый предварительный просмотр, чтобы сбросить шестичасовой период времени.

Добавить дополнительных тестировщиков

Вы можете пригласить в свой проект дополнительных пользователей, чтобы они могли протестировать вашу интеграцию с App Actions. Это полезно, если вы хотите поделиться проектом с другими членами вашей команды разработчиков, чтобы все они могли его протестировать, или когда вы делитесь своим проектом с тестировщиками обеспечения качества (QA) при подготовке к запуску производства. Тестировщиков необходимо добавить в качестве тестировщиков лицензий в Google Play Store и предоставить им доступ только для чтения к Google Play Console.

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

1. Войдите в Play Console .

2. Следуйте инструкциям в разделе «Настройка лицензирования приложений» в этом разделе справки Play Console .

   

3. Пригласите учетную запись Google тестера лицензий в качестве пользователя консоли Google Play только для чтения.

   1. Выберите «Пользователь и разрешения» > «Пригласить новых пользователей» > «Добавить приложение» .
   2. В App Access убедитесь, что флажок «Администратор (все разрешения)» снят.

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

Используйте плагин Google Assistant

Откройте инструмент тестирования действий приложения в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Инструмент тестирования действий приложения» . Когда вы открываете инструмент, вид меняется в зависимости от того, есть ли у вас активный предварительный просмотр инструмента тестирования.

Создание, обновление и удаление превью

Вы можете использовать черновую версию приложения для тестирования. Дополнительные сведения см. в разделе Подготовка и развертывание выпуска . Протестируйте свое приложение в режиме черновика, прежде чем отправлять его на рассмотрение.

Инструмент тестирования создает предварительные просмотры на основе вашей учетной записи Google и имени пакета приложения ( идентификатора приложения ), поэтому вы можете тестировать несколько приложений с одной и той же учетной записью Google. Пока идентификатор вашего приложения разный для каждого приложения, вы можете продолжать использовать одну и ту же учетную запись Google для создания и тестирования предварительной версии. Каждая из нескольких учетных записей Google с доступом к одному и тому же пакету приложений может использовать инструмент тестирования для создания отдельных предварительных просмотров для этого приложения.

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

1. Откройте инструмент тестирования действий приложения.
2. При необходимости введите имя приложения и языковой стандарт для тестирования. Имя и локаль приложения по умолчанию — test app action и en .
3. Нажмите «Создать предварительный просмотр» . При появлении запроса просмотрите и примите политику и условия обслуживания App Actions. После создания предварительного просмотра окно инструмента тестирования обновляется и отображает информацию о BII, найденных в файле Shorts.xml .

Инструмент тестирования использует имя приложения для создания и моделирования запросов Ассистента для действий вашего приложения. Действия развернутого приложения используют для вызова имя вашего приложения Play Store, но вы можете использовать любое имя вызова в инструменте тестирования. Однако мы рекомендуем использовать имя вашего приложения в качестве имени вызова в инструменте тестирования.

Указанный вами языковой стандарт должен соответствовать языку Google Ассистента на вашем тестовом устройстве, и вы можете одновременно создавать предварительный просмотр только на одном языковом стандарте. Например, если ваш язык Ассистента — английский (США), вы можете ввести en-US , но не en-** , en-GB или en-US, en-GB . Вы можете использовать корневую локаль, например en , чтобы включить как en-GB так и en-US .

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

Чтобы обновить существующий предварительный просмотр в соответствии с файлом Shorts.xml , нажмите кнопку «Обновить» в инструменте тестирования. Информация о текущей предварительной версии находится в разделе «Действие приложения для тестирования» окна инструмента тестирования.

Настройка BII

Создав предварительную версию своего приложения, вы можете протестировать различные значения параметров для BII в плагине. Для каждого BII в файле Shorts.xml плагин отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Вы можете изменить эти значения по умолчанию, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения.

Параметры и их значения обычно соответствуют структуре свойств и описаний schema.org или schema.googleapis.com . Информацию о любом параметре BII можно найти, обратившись к описаниям типа схемы параметра и его параметров более высокого уровня.

Например, actions.intent.GET_FOOD_OBSERVATION BII поддерживает параметр намерения foodObservation.forMeal . На странице schema.googleapis.com для MealType name указано в качестве свойства. Свойство forMeal представляет собой режим передачи и ожидает значений (например, MealTypeLunch ) перечисляемого типа MealType .

В инструменте тестирования вы можете указать любое перечисление в качестве значения foodObservation.forMeal :

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

Триггерные действия приложения

После создания предварительного просмотра и настройки BII вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования.

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

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

Действия приложения, запускаемые в инструменте тестирования, используют отображаемую команду Android Debug Bridge ( adb ). Сгенерированная команда оболочки adb включает все метаданные, необходимые приложению Google для выполнения BII. Этот подход имитирует поведение вашего действия приложения после того, как Ассистент извлекает ключевые фрагменты информации из запроса.

Ведение журнала Android Studio

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

Чтобы получить доступ к файлам журналов Android Studio, выберите «Справка» > «Показать проводник входа» ( «Справка» > «Показать поиск входа в систему» ​​на macOS).

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

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

1. Получите доступ к сообщениям журнала Logcat, нажав Logcat на панели инструментов Android Studio.
2. Найдите журналы, содержащие ActivityTaskManager .

Получите поддержку и дополнительные ресурсы

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

Вы можете открыть помощника в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Справка» .

Рисунок 2. Раздел справки плагина Google Assistant.

Плагин Google Assistant тестирует действия приложения в Android Studio. Во время разработки и тестирования вы используете плагин для предварительного просмотра действий вашего приложения в Ассистенте для вашей учетной записи Google. Затем вы можете проверить, как ваше действие приложения обрабатывает различные параметры, прежде чем отправлять его на развертывание.

Как это работает

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

Для каждого встроенного намерения (BII) в файле Shorts.xml инструмент отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Затем вы можете изменить эти значения, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения. Предварительные просмотры создаются, обновляются и удаляются с помощью инструмента тестирования, что позволяет вам повторять и тестировать действия приложения в безопасной среде.

После создания предварительного просмотра вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования. Для BII, доступных для запуска пользователем, вы можете использовать app name непосредственно в Ассистенте на своем устройстве, чтобы опробовать действие приложения. Например, вы можете сказать: «Окей, Google, начни мое упражнение с использованием примера приложения», чтобы запустить действие приложения, использующее actions.intent.START_EXERCISE BII.

Поддержка локали

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

Получить плагин

Плагин Google Assistant доступен для Android Studio. Информацию об установке и использовании Android Studio см. на странице Android Studio .

Чтобы установить плагин Google Assistant в Android Studio, выполните следующие действия:

1. Перейдите в «Файл» > «Настройки» ( Android Studio > «Настройки» в macOS).
2. В разделе «Плагины» перейдите на Marketplace и найдите «Плагин Google Assistant».
3. Установите инструмент и перезапустите Android Studio.

Вы также можете скачать плагин прямо из публичного репозитория Jetbrains .

Требования к настройке

Использование плагина Google Assistant требует ряда шагов настройки, чтобы обеспечить успешное тестирование вашего App Action. В частности, вы должны использовать одну и ту же учетную запись пользователя в Android Studio, на тестовом устройстве и для доступа к консоли Google Play.

Подготовьте среду разработки со следующими конфигурациями:

• Войдите в Android Studio (версия 4.0 или новее).
• Используя ту же учетную запись, войдите в приложение Google на тестовом устройстве Android.
• Используя ту же учетную запись, получите доступ Play Console к загруженному пакету приложения для тестирования.
• Откройте приложение Google на тестовом устройстве Android и завершите процесс первоначальной настройки Ассистента.
• Включите синхронизацию данных устройства на тестовом устройстве.

Ограничения

Плагин Google Assistant имеет следующие ограничения:

• Действия приложения, включающие веб-инвентаризацию и вызов приложения на переднем плане, нельзя тестировать непосредственно в инструменте тестирования или с помощью команд моста отладки Android ( adb ). Чтобы протестировать эти действия приложения, сначала создайте предварительный просмотр с помощью инструмента тестирования. Затем запустите эти действия приложения, взаимодействуя с Google Assistant на вашем физическом устройстве.
• Встроенный инвентарь для actions.intent.OPEN_APP_FEATURE BII можно тестировать только в течение шести часов после создания или обновления предварительной версии. Обновите предварительный просмотр инструмента тестирования или создайте новый предварительный просмотр, чтобы сбросить шестичасовой период времени.

Добавить дополнительных тестировщиков

Вы можете пригласить в свой проект дополнительных пользователей, чтобы они могли протестировать вашу интеграцию с App Actions. Это полезно, если вы хотите поделиться проектом с другими членами вашей команды разработчиков, чтобы все они могли его протестировать, или когда вы делитесь своим проектом с тестировщиками обеспечения качества (QA) при подготовке к запуску производства. Тестировщиков необходимо добавить в качестве тестировщиков лицензий в Google Play Store и предоставить им доступ только для чтения к Google Play Console.

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

1. Войдите в Play Console .

2. Следуйте инструкциям в разделе «Настройка лицензирования приложений» в этом разделе справки Play Console .

   

3. Пригласите учетную запись Google тестера лицензий в качестве пользователя консоли Google Play только для чтения.

   1. Выберите «Пользователь и разрешения» > «Пригласить новых пользователей» > «Добавить приложение» .
   2. В App Access убедитесь, что флажок «Администратор (все разрешения)» снят.

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

Используйте плагин Google Assistant

Откройте инструмент тестирования действий приложения в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Инструмент тестирования действий приложения» . Когда вы открываете инструмент, вид меняется в зависимости от того, есть ли у вас активный предварительный просмотр инструмента тестирования.

Создание, обновление и удаление превью

Вы можете использовать черновую версию приложения для тестирования. Дополнительные сведения см. в разделе Подготовка и развертывание выпуска . Протестируйте свое приложение в режиме черновика, прежде чем отправлять его на рассмотрение.

Инструмент тестирования создает предварительные просмотры на основе вашей учетной записи Google и имени пакета приложения ( идентификатора приложения ), поэтому вы можете тестировать несколько приложений с одной и той же учетной записью Google. Пока идентификатор вашего приложения разный для каждого приложения, вы можете продолжать использовать одну и ту же учетную запись Google для создания и тестирования предварительной версии. Каждая из нескольких учетных записей Google с доступом к одному и тому же пакету приложений может использовать инструмент тестирования для создания отдельных предварительных просмотров для этого приложения.

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

1. Откройте инструмент тестирования действий приложения.
2. При необходимости введите имя приложения и языковой стандарт для тестирования. Имя и локаль приложения по умолчанию — test app action и en .
3. Нажмите «Создать предварительный просмотр» . При появлении запроса просмотрите и примите политику и условия обслуживания App Actions. После создания предварительного просмотра окно инструмента тестирования обновляется и отображает информацию о BII, найденных в файле Shorts.xml .

Инструмент тестирования использует имя приложения для создания и моделирования запросов Ассистента для действий вашего приложения. Действия развернутого приложения используют для вызова имя вашего приложения Play Store, но вы можете использовать любое имя вызова в инструменте тестирования. Однако мы рекомендуем использовать имя вашего приложения в качестве имени вызова в инструменте тестирования.

Указанный вами языковой стандарт должен соответствовать языку Google Ассистента на вашем тестовом устройстве, и вы можете одновременно создавать предварительный просмотр только на одном языковом стандарте. Например, если ваш язык Ассистента — английский (США), вы можете ввести en-US , но не en-** , en-GB или en-US, en-GB . Вы можете использовать корневую локаль, например en , чтобы включить как en-GB так и en-US .

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

Чтобы обновить существующий предварительный просмотр в соответствии с файлом Shorts.xml , нажмите кнопку «Обновить» в инструменте тестирования. Информация о текущей предварительной версии находится в разделе «Действие приложения для тестирования» окна инструмента тестирования.

Настройка BII

Создав предварительную версию своего приложения, вы можете протестировать различные значения параметров для BII в плагине. Для каждого BII в файле Shorts.xml плагин отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Вы можете изменить эти значения по умолчанию, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения.

Параметры и их значения обычно соответствуют структуре свойств и описаний schema.org или schema.googleapis.com . Информацию о любом параметре BII можно найти, обратившись к описаниям типа схемы параметра и его параметров более высокого уровня.

Например, actions.intent.GET_FOOD_OBSERVATION BII поддерживает параметр намерения foodObservation.forMeal . На странице schema.googleapis.com для MealType name указано в качестве свойства. Свойство forMeal представляет собой режим передачи и ожидает значений (например, MealTypeLunch ) перечисляемого типа MealType .

В инструменте тестирования вы можете указать любое перечисление в качестве значения foodObservation.forMeal :

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

Триггерные действия приложения

После создания предварительного просмотра и настройки BII вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования.

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

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

Действия приложения, запускаемые в инструменте тестирования, используют отображаемую команду Android Debug Bridge ( adb ). Сгенерированная команда оболочки adb включает все метаданные, необходимые приложению Google для выполнения BII. Этот подход имитирует поведение вашего действия приложения после того, как Ассистент извлекает ключевые фрагменты информации из запроса.

Ведение журнала Android Studio

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

Чтобы получить доступ к файлам журналов Android Studio, выберите «Справка» > «Показать проводник входа» ( «Справка» > «Показать поиск входа в систему» ​​на macOS).

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

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

1. Получите доступ к сообщениям журнала Logcat, нажав Logcat на панели инструментов Android Studio.
2. Найдите журналы, содержащие ActivityTaskManager .

Получите поддержку и дополнительные ресурсы

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

Вы можете открыть помощника в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Справка» .

Рисунок 2. Раздел справки плагина Google Assistant.

Плагин Google Assistant тестирует действия приложения в Android Studio. Во время разработки и тестирования вы используете плагин для предварительного просмотра действий вашего приложения в Ассистенте для вашей учетной записи Google. Затем вы можете проверить, как ваше действие приложения обрабатывает различные параметры, прежде чем отправлять его на развертывание.

Как это работает

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

Для каждого встроенного намерения (BII) в файле Shorts.xml инструмент отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Затем вы можете изменить эти значения, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения. Предварительные просмотры создаются, обновляются и удаляются с помощью инструмента тестирования, что позволяет вам повторять и тестировать действия приложения в безопасной среде.

После создания предварительного просмотра вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования. Для BII, доступных для запуска пользователем, вы можете использовать app name непосредственно в Ассистенте на своем устройстве, чтобы опробовать действие приложения. Например, вы можете сказать: «Окей, Google, начни мое упражнение с использованием примера приложения», чтобы запустить действие приложения, использующее actions.intent.START_EXERCISE BII.

Поддержка локали

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

Получить плагин

Плагин Google Assistant доступен для Android Studio. Информацию об установке и использовании Android Studio см. на странице Android Studio .

Чтобы установить плагин Google Assistant в Android Studio, выполните следующие действия:

1. Перейдите в «Файл» > «Настройки» ( Android Studio > «Настройки» в macOS).
2. В разделе «Плагины» перейдите на Marketplace и найдите «Плагин Google Assistant».
3. Установите инструмент и перезапустите Android Studio.

Вы также можете скачать плагин прямо из публичного репозитория Jetbrains .

Требования к настройке

Использование плагина Google Assistant требует ряда шагов настройки, чтобы обеспечить успешное тестирование вашего App Action. В частности, вы должны использовать одну и ту же учетную запись пользователя в Android Studio, на тестовом устройстве и для доступа к консоли Google Play.

Подготовьте среду разработки со следующими конфигурациями:

• Войдите в Android Studio (версия 4.0 или новее).
• Используя ту же учетную запись, войдите в приложение Google на тестовом устройстве Android.
• Используя ту же учетную запись, получите доступ Play Console к загруженному пакету приложения для тестирования.
• Откройте приложение Google на тестовом устройстве Android и завершите процесс первоначальной настройки Ассистента.
• Включите синхронизацию данных устройства на тестовом устройстве.

Ограничения

Плагин Google Assistant имеет следующие ограничения:

• Действия приложения, включающие веб-инвентаризацию и вызов приложения на переднем плане, нельзя тестировать непосредственно в инструменте тестирования или с помощью команд моста отладки Android ( adb ). Чтобы протестировать эти действия приложения, сначала создайте предварительный просмотр с помощью инструмента тестирования. Затем запустите эти действия приложения, взаимодействуя с Google Assistant на вашем физическом устройстве.
• Встроенный инвентарь для actions.intent.OPEN_APP_FEATURE BII можно тестировать только в течение шести часов после создания или обновления предварительной версии. Обновите предварительный просмотр инструмента тестирования или создайте новый предварительный просмотр, чтобы сбросить шестичасовой период времени.

Добавить дополнительных тестировщиков

Вы можете пригласить в свой проект дополнительных пользователей, чтобы они могли протестировать вашу интеграцию с App Actions. Это полезно, если вы хотите поделиться проектом с другими членами вашей команды разработчиков, чтобы все они могли его протестировать, или когда вы делитесь своим проектом с тестировщиками обеспечения качества (QA) при подготовке к запуску производства. Тестировщиков необходимо добавить в качестве тестировщиков лицензий в Google Play Store и предоставить им доступ только для чтения к Google Play Console.

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

1. Войдите в Play Console .

2. Следуйте инструкциям в разделе «Настройка лицензирования приложений» в этом разделе справки Play Console .

   

3. Пригласите учетную запись Google тестера лицензий в качестве пользователя консоли Google Play только для чтения.

   1. Выберите «Пользователь и разрешения» > «Пригласить новых пользователей» > «Добавить приложение» .
   2. В App Access убедитесь, что флажок «Администратор (все разрешения)» снят.

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

Используйте плагин Google Assistant

Откройте инструмент тестирования действий приложения в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Инструмент тестирования действий приложения» . Когда вы открываете инструмент, вид меняется в зависимости от того, есть ли у вас активный предварительный просмотр инструмента тестирования.

Создание, обновление и удаление превью

Вы можете использовать черновую версию приложения для тестирования. Дополнительные сведения см. в разделе Подготовка и развертывание выпуска . Протестируйте свое приложение в режиме черновика, прежде чем отправлять его на рассмотрение.

Инструмент тестирования создает предварительные просмотры на основе вашей учетной записи Google и имени пакета приложения ( идентификатора приложения ), поэтому вы можете тестировать несколько приложений с одной и той же учетной записью Google. Пока идентификатор вашего приложения разный для каждого приложения, вы можете продолжать использовать одну и ту же учетную запись Google для создания и тестирования предварительной версии. Каждая из нескольких учетных записей Google с доступом к одному и тому же пакету приложений может использовать инструмент тестирования для создания отдельных предварительных просмотров для этого приложения.

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

1. Откройте инструмент тестирования действий приложения.
2. При необходимости введите имя приложения и языковой стандарт для тестирования. Имя и локаль приложения по умолчанию — test app action и en .
3. Нажмите «Создать предварительный просмотр» . При появлении запроса просмотрите и примите политику и условия обслуживания App Actions. После создания предварительного просмотра окно инструмента тестирования обновляется и отображает информацию о BII, найденных в файле Shorts.xml .

Инструмент тестирования использует имя приложения для создания и моделирования запросов Ассистента для действий вашего приложения. Действия развернутого приложения используют для вызова имя вашего приложения Play Store, но вы можете использовать любое имя вызова в инструменте тестирования. Однако мы рекомендуем использовать имя вашего приложения в качестве имени вызова в инструменте тестирования.

Указанный вами языковой стандарт должен соответствовать языку Google Ассистента на вашем тестовом устройстве, и вы можете одновременно создавать предварительный просмотр только на одном языковом стандарте. Например, если ваш язык Ассистента — английский (США), вы можете ввести en-US , но не en-** , en-GB или en-US, en-GB . Вы можете использовать корневую локаль, например en , чтобы включить как en-GB так и en-US .

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

Чтобы обновить существующий предварительный просмотр в соответствии с файлом Shorts.xml , нажмите кнопку «Обновить» в инструменте тестирования. Информация о текущей предварительной версии находится в разделе «Действие приложения для тестирования» окна инструмента тестирования.

Настройка BII

Создав предварительную версию своего приложения, вы можете протестировать различные значения параметров для BII в плагине. Для каждого BII в файле Shorts.xml плагин отображает соответствующий объект JSON-LD и предоставляет значения параметров по умолчанию. Вы можете изменить эти значения по умолчанию, чтобы протестировать действия приложения с помощью значимых комбинаций параметров и убедиться, что они выполняют правильные функции приложения.

Параметры и их значения обычно соответствуют структуре свойств и описаний schema.org или schema.googleapis.com . Информацию о любом параметре BII можно найти, обратившись к описаниям типа схемы параметра и его параметров более высокого уровня.

Например, actions.intent.GET_FOOD_OBSERVATION BII поддерживает параметр намерения foodObservation.forMeal . На странице schema.googleapis.com для MealType name указано в качестве свойства. Свойство forMeal представляет собой режим передачи и ожидает значений (например, MealTypeLunch ) перечисляемого типа MealType .

В инструменте тестирования вы можете указать любое перечисление в качестве значения foodObservation.forMeal :

• https://schema.googleapis.com/MealTypeSnack
• https://schema.googleapis.com/MealTypeBrunch
• https://schema.googleapis.com/MealTypeLunch
• https://schema.googleapis.com/MealTypeBreakfast
• https://schema.googleapis.com/MealTypeDinner
• https://schema.googleapis.com/MealTypeDesert

Триггерные действия приложения

После создания предварительного просмотра и настройки BII вы можете запустить действие приложения на тестовом устройстве непосредственно из окна инструмента тестирования.

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

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

Действия приложения, запускаемые в инструменте тестирования, используют отображаемую команду Android Debug Bridge ( adb ). Сгенерированная команда оболочки adb включает все метаданные, необходимые приложению Google для выполнения BII. Этот подход имитирует поведение вашего действия приложения после того, как Ассистент извлекает ключевые фрагменты информации из запроса.

Ведение журнала Android Studio

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

Чтобы получить доступ к файлам журналов Android Studio, выберите «Справка» > «Показать проводник входа» ( «Справка» > «Показать поиск входа в систему» ​​на macOS).

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

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

1. Получите доступ к сообщениям журнала Logcat, нажав Logcat на панели инструментов Android Studio.
2. Найдите журналы, содержащие ActivityTaskManager .

Получите поддержку и дополнительные ресурсы

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

Вы можете открыть помощника в Android Studio, выбрав «Инструменты» > «Google Ассистент» > «Справка» .

Рисунок 2. Раздел справки плагина Google Assistant.