Устранение неполадок

При разработке App Actions вы можете столкнуться с проблемами, связанными с настройкой или инструментом тестирования App Actions. На этой странице описаны некоторые распространённые проблемы и способы их устранения.

Общий

Ошибка: «Приложение для открытия URL не найдено» появляется во всплывающем уведомлении.

Проверьте urlTemplate выполнения в файле actions.xml , чтобы убедиться, что он настроен правильно. При использовании URL-адресов ссылок приложений убедитесь, что вы можете вручную активировать URL-адрес с помощью ACTION_VIEW и URL-адреса. При использовании URL-адресов на основе намерений убедитесь, что ваша активность правильно настроена для запуска с использованием предоставленных параметров.

Ошибка: «Приложение не установлено»

Эта ошибка может означать, что фильтр <intent-filter> в файле AndroidManifest.xml не фильтрует глубокую ссылку, указанную в файле actions.xml . Перед отправкой сообщения об ошибке обязательно проверьте это.

Ошибка: «Найдена ссылка на набор сущностей, не содержащая ни идентификатора набора сущностей, ни фильтра URL». В Android Studio появляется сообщение об ошибке

Это состояние вызвано известной проблемой линтера для тега <entity-set-reference> . Вы можете спокойно игнорировать это сообщение. В качестве обходного решения можно отключить проверку линтера для этого тега, добавив к нему атрибут tools:ignore="ValidActionsXml" .

Вот пример ссылки на набор сущностей с отключенной проверкой lint:

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Ошибка: «Недопустимое расположение» для документа схемы действий при загрузке APK

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

Чтобы решить эту проблему, попробуйте отключить инструмент для файла actions.xml вашего приложения (например, с помощью белого списка).

В консоли Google Play появляется ошибка: «Активный APK-файл или набор приложений Android содержит файл actions.xml. Чтобы продолжить, примите Условия использования Actions on Google».

Эта ошибка может возникнуть при создании версии приложения в Play Console. Чтобы принять Условия использования Actions on Google, выполните следующие действия:

  1. Выберите свое приложение в Play Console.
  2. Перейдите в раздел Настройка > Дополнительные параметры .
  3. Откройте вкладку Действия в Google .
  4. Установите флажок Интегрировать мои службы с действиями приложений с помощью действий Google и следуйте инструкциям.

Кнопка «Принять» в форме «Условия обслуживания Play» отключена.

Это может означать, что у вошедшего в систему пользователя нет необходимого уровня доступа для принятия этих условий. Убедитесь, что первая отправка сделана администратором профиля Play Console.

Инструмент тестирования действий приложения

Прежде чем приступать к выполнению любого из следующих действий, обновите установленный вами тестовый инструмент App Actions до последней версии.

Плагин инструмента тестирования App Actions не может найти мой файл actions.xml .

Убедитесь, что вы добавили правильный тег <meta-data> в файл AndroidManifest.xml .

Предварительный просмотр моего действия в приложении не соответствует моему текущему файлу actions.xml .

Предварительный просмотр не обновляется динамически в соответствии с содержимым файла actions.xml . После изменения файла actions.xml вручную или переключения вариантов сборки в Android Studio сохраните файл actions.xml и нажмите «Обновить предварительный просмотр» в инструменте тестирования.

Плагин инструмента тестирования App Actions перестал работать или выдает ошибки.

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

Если ошибка все еще сохраняется, сообщите об ошибке и отправьте в Google следующую информацию:

  • Подробности диалогового окна об ошибке
  • Журналы Android Studio. Выберите «Справка» > «Показать журнал» в Finder . Это покажет вам расположение файла idea.log в Finder. Найдите «Submit Actions Request Body:» в файле журнала и вставьте ответы сервера (должно быть два результата по запросу «actions»).

Инструмент тестирования App Actions генерирует UnknownHostException или другие сетевые ошибки

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

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

  • Перед созданием предварительных версий убедитесь, что у вас есть активное подключение к Интернету.

  • Если ваше интернет-соединение активно и ваша локальная сеть использует прокси-сервер, проверьте следующее:

    • Проверьте конфигурацию прокси-сервера IDE. Подробнее см. в инструкциях по настройке прокси-сервера для Android Studio или IntelliJ .
    • Если для вашего прокси-сервера требуется список управления доступом (ACL), обновите ACL, разрешив следующий шаблон URL: https://actions.googleapis.com/** .

При вызове действия приложения с помощью тестового плагина помощник сообщает: «Извините, я не смог его найти».

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

  1. Войдите в Android Studio, Play Console и на тестовое устройство, используя одну и ту же учетную запись Google.
  2. Включить синхронизацию данных устройства .
  3. Установите язык устройства и Google Assistant на en-US .
  4. Проверьте, что имя пакета приложения в Google Play Console совпадает с именем пакета в тестовом приложении.
  5. В определении urlTemplate выполнения в файле actions.xml убедитесь, что значения android:host и android:scheme соответствуют значениям, объявленным в файле AndroidManifest .
  6. Удалите все предыдущие установки вашего приложения с тестового устройства и установите новую сборку.
  7. Удалите предварительный просмотр из инструмента тестирования App Actions и создайте новый предварительный просмотр еще раз.
  8. Проверьте Logcat на наличие ошибок, связанных с выполнением запросов Google Ассистента. Вы должны увидеть намерение, запущенное в вашем приложении.
  9. Включите настройку «Информация о приложениях для ваших устройств» для учетной записи.
  10. Откройте Google Ассистент и убедитесь, что настройка завершена. (Обычно индикатор выполнения настройки отображается в виде синей полосы внизу экрана, но в некоторых случаях он может выглядеть иначе.)
  11. При использовании Google Assistant для запуска действия приложения убедитесь, что имя вызова соответствует предварительному просмотру, созданному инструментом тестирования действий приложения.
  12. Попробуйте использовать текстовый ввод вместо голосового, чтобы избежать ошибок транскрипции.
  13. Настройте тестовую сборку так, чтобы applicationId точно соответствовал APK или AAB-файлу, загруженному в Google Play Console. Обратите внимание, что необязательные свойства applicationIdSuffix могут изменить конечный applicationId сборок для определённых версий продукта и вариантов сборки. В этом примере applicationId для макета версии продукта — com.example.android.architecture.blueprints.master.mock , а не com.example.android.architecture.blueprints .
  14. Настройте предварительный просмотр так, чтобы использовать уникальное имя для вызова. Попробуйте использовать уникальное слово, которое снизит вероятность конфликтов с другими приложениями.
  15. Чтобы изолировать проблемы при устранении неполадок в общей кодовой базе, попробуйте запустить пример приложения «Фитнес» . Убедитесь, что приложение «Фитнес» работает без сбоев. Затем постепенно добавляйте дополнительные функции поверх этого приложения, чтобы проверить, сможете ли вы воспроизвести проблемы.
  16. При использовании учётных записей G Suite убедитесь, что администратор включил Google Assistant. В качестве временного решения мы рекомендуем создать тестовую учётную запись, не связанную с G Suite, и настроить её в качестве лицензированного тестировщика через Play Маркет . С помощью этой учётной записи тестировщики смогут создавать предварительные версии своих приложений и успешно тестировать их на своих устройствах.
  17. Если вы скачали Google Ассистент как отдельное приложение, попробуйте принудительно остановить его на своём устройстве. Обычно принудительно остановить приложение можно через настройки телефона.
  18. Если ни один из этих шагов не помог, сообщите о проблеме в системе отслеживания проблем App Action .