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

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

Общие

Ошибка "Не найдено приложение, чтобы открыть URL" во всплывающем уведомлении

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

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

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

В Android Studio появляется ошибка "Обнаружена ссылка на набор объектов, в которой не указан ни идентификатор набора, ни фильтр URL"

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

Пример ссылки на набор объектов с отключенной проверкой:

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

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

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

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

Ошибка: "В одном из активных APK или наборов Android App Bundle есть файл actions.xml. Чтобы продолжить, примите Условия использования Actions on Google".

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

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

Кнопка "Принять" в форме Условий использования Google Play неактивна.

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

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

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

Плагин App Actions Test Tool не может найти файл actions.xml.

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

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

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

Плагин App Actions Test Tool перестал работать или генерирует ошибки.

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

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

  • Сведения о диалоговом окне с ошибкой
  • Журналы Android Studio. Выберите Help (Справка) > Show Log in Finder (Показать журнал в Finder). Вы увидите, где находится idea.log в Finder. Найдите в файле журнала строку "Submit Actions Request Body:" и вставьте ответы сервера (должно быть два результата для действий).

Инструмент тестирования действий в приложении генерирует ошибку UnknownHostException или другие ошибки сети

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

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

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

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

При вызове действия в приложении с помощью тестового плагина Ассистент говорит: "Извините, я не могу это найти".

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

  1. Войдите в Android Studio, Play Console и на тестовом устройстве, используя один и тот же аккаунт Google.
  2. Включите синхронизацию данных устройства.
  3. Установите на устройстве и в Google Ассистенте язык "en-US".
  4. Убедитесь, что название пакета приложения в Google Play Console совпадает с названием пакета в тестовом приложении.
  5. Убедитесь, что значения android:host и android:scheme в определении urlTemplate выполнения в файле actions.xml совпадают с тем, что указано в файле AndroidManifest.
  6. Удалите все предыдущие версии приложения с тестового устройства и установите новую сборку.
  7. Удалите предварительную версию из инструмента тестирования действий в приложениях и создайте новую.
  8. Проверьте в инструменте Logcat, есть ли сбои, связанные с выполнением запросов для Google Ассистента. Вы должны увидеть намерение, запущенное в вашем приложении.
  9. Включите настройку "Информация о приложениях с ваших устройств" для аккаунта.
  10. Откройте Google Ассистента и убедитесь, что настройка завершена. Обычно индикатор выполнения настройки выглядит как синяя полоса внизу экрана, но в некоторых случаях он может выглядеть иначе.
  11. При использовании Google Ассистента для запуска действия в приложении убедитесь, что название вызова совпадает с предварительной версией, созданной инструментом тестирования действий в приложении.
  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 Ассистент включен администратором. Рекомендуем создать тестовый аккаунт, не связанный с G Suite, и настроить его как лицензированный аккаунт для тестирования в Google Play. В этом аккаунте тестировщики должны иметь возможность создавать предварительные версии приложения и тестировать его на своем устройстве.
  17. Если вы скачали Google Ассистента как отдельное приложение, попробуйте принудительно остановить его на устройстве. Как правило, остановить приложение принудительно можно в настройках телефона.
  18. Если ни один из этих шагов не помог, сообщите о проблеме в системе отслеживания ошибок действий в приложении.