Берегись! Скоро будут запущены новые программы Developer Preview. Подайте заявку здесь и станьте одним из первых, кто опробует новые инструменты и оставит отзыв.

Протестируйте интеграцию Matter

Google Home Developer Console предоставляет тестовую страницу, на которой вы можете настраивать и запускать тесты для вашей интеграции Matter с помощью Google Home Test Suite . Test Suite — это отдельное приложение, встроенное в Developer Console , которое обрабатывает все интеграционные тесты.

Устройства для идентификатора поставщика и идентификатора продукта интеграции должны быть введены в эксплуатацию и доступны в Google Home app (GHA) для учетной записи, используемой с Developer Console , чтобы их можно было протестировать. Дополнительные сведения см. в разделе Сопряжение устройства Matter .

Test Suite можно запустить на наборе устройств, принадлежащих к определенной конфигурации проекта Matter . Очень важно запустить Test Suite для ваших интеграций, чтобы убедиться, что все работает правильно.

На странице Тест завершенные и готовые к тестированию интеграции Matter перечислены в разделе Готово к тестированию .

Протестированные интеграции Matter перечислены в разделе «Протестированные» .

Тип планов тестирования

Существует два типа планов тестирования:

  • Планы тестирования разработки используются для тестирования управляющих устройств с помощью Matter . Их можно редактировать, но нельзя отправить на сертификацию Matter .

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

Версии интеграции

При создании плана тестирования для сертификации создается новая версия интеграции. Эта пронумерованная версия указана во всех списках интеграции в Developer Console , начиная с вкладки «Тест».

Новые версии никогда не создаются из версий с другими номерами. Например, первый план тестирования, который вы создаете для интеграции, создаст версию v.1 для этой интеграции. При создании другого плана тестирования будет создана версия v.2 для этой интеграции, но эта версия не будет основана на v.1 . Вместо этого эта версия основана на неверсионном экземпляре интеграции, как и версия 1 .

Версия интеграции N/A представляет собой неверсионный экземпляр интеграции, управление которым осуществляется на вкладке «Разработка» .

Другими словами, в Matter > Test в Developer Console :

  • Если вы нажмете Test для версии N/A интеграции, будет создана новая версия. Номер версии будет на единицу выше, чем любые существующие пронумерованные версии.
    • Если пронумерованных версий не существует, создается версия v.1 .
    • Если версия v.1 существует, создается версия v.2 . Если существует версия v.2 , создается версия v.3 и так далее.
  • Если вы нажмете Test для пронумерованной версии интеграции (например, v.1 ), новая версия не будет создана. Вместо этого снова тестируется версия v.1 .

Дополнительные сведения см. в разделе Управление версиями интеграции .

Создать план тестирования

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

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

  1. Создан профиль компании .
  2. Введен производственный идентификатор поставщика (VID) для интеграции .
  3. Настроенная установка и брендинг .

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

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

Чтобы создать план тестирования:

Перейти в консоль разработчика

  1. В списке проектов нажмите «Открыть» рядом с проектом, с которым вы хотите работать.

  2. В меню навигации в левой части страницы выберите Matter > Test .

  3. Нажмите Test для версии N/A интеграции, которую вы хотите протестировать. Это действие создает новую версию интеграции .

  4. Выберите тип теста Тест разработки или Сертификационный тест . Создание нового плана тестирования

    • Выберите Сертификационный тест, если вы готовитесь к сертификации в экосистеме Google.
    • Тест развития не может быть использован для сертификации.
  5. Щелкните Тест . Если вы видите экран с ошибкой «Устройство не найдено» , это означает, что устройство для этой интеграции еще не введено в эксплуатацию в экосистеме. Дополнительную информацию см. в разделе Устранение неполадок сопряжения .

  6. На экране «Настроить тест» укажите имя для теста и выберите устройства, которые вы хотите протестировать, из списка устройств.

  7. Нажмите кнопку Далее: план тестирования .

  8. На странице Создание плана тестирования в разделе Наборы тестов выберите наборы тестов, которые вы хотите запустить.

Создать план тестирования

Если вы хотите выйти из Test Suite , нажмите Вернуться в Центр разработчиков .

Запустите план тестирования

В Test Suite на странице «Создать план тестирования» нажмите «Выполнить тест» . Появится страница тестовой среды со статусом и журналами всех тестов.

Результаты теста появятся после завершения тестов. Рядом с ним отображается статус выполнения каждого набора тестов (пройдено, не пройдено).

На панели «Журналы» отображается состояние выполнения каждого отдельного теста.

Результаты теста

Чтобы повторно протестировать план тестирования на странице Тестовая среда , нажмите Повторить тестирование вверху после завершения выполнения теста.

После завершения:

Просмотр и интерпретация результатов теста

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

История испытаний

Для отправленного плана сертификации нажмите «Результаты» в разделе «Сохранено для сертификации» , чтобы просмотреть отчет о результатах тестирования.

Результаты тестирования также можно просмотреть для версии интеграции на вкладке «Тест» в Developer Console . Нажмите «Просмотр» , чтобы просмотреть историю тестирования любой версии интеграции, указанной на этой странице, чтобы перейти на страницу «История тестирования» в Test Suite .

Статусы консоли

На этапе тестирования встречаются следующие состояния консоли:

Раздел Положение дел Описание Требование Что делать дальше
Готов к тесту Готовый Эта версия интеграции готова к тестированию. Н/Д Протестируйте эту версию интеграции.
Готов к сертификации Готовый Эта версия интеграции была протестирована и может быть отправлена ​​на пробную версию или сертификацию.

Версия проверена и сохранена.

Все неудачные тестовые случаи содержат обоснования для проверки Google.

Повторите тест , если хотите.

Поиск неисправностей

Введенное в эксплуатацию устройство не отображается в Test Suite

Если вы связали устройство с тестовым идентификатором поставщика (VID) и идентификатором продукта (PID), но он не отображается при попытке протестировать устройство с помощью Test Suite в Developer Console , это, вероятно, вызвано использованием одного и того же протестируйте комбинацию VID и PID в нескольких интеграциях.

Чтобы устранить неполадки, удалите все тестовые устройства из Developer Console и снова подключите устройство, которое хотите протестировать.

Чтобы убедиться, что вы выполнили сопряжение с правильным устройством, вы можете установить для информации о производителе и модели (значения CHIP_DEVICE_CONFIG_DEVICE_* ) устройства уникальные значения в тестовой прошивке.

Дополнительные сведения см. в разделе Информация об устройстве .

Проверьте VID/PID вашего устройства

Если вы хотите начать разработку интеграции с Google, вам необходимо создать проект и интеграцию в Google Home Console.

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

Значение VID/PID, которое отправляет ваше устройство, должно совпадать с VID/PID, введенным в ваш проект Developer Console .

  • VID 0xFFF10xFFF4 зарезервированы для тестирования. Их можно использовать для основных пуско-наладочных и контрольных испытаний, но их нельзя использовать на следующих этапах разработки:

Используя инженерное приложение Bluetooth, такое как nRF Connect for Mobile , вы можете увидеть VID/PID устройства-маяка в поле Service Data .

На этом снимке экрана из версии nRF Connect Android вы увидите, что VID/PID указан как 5A23FFFE , начиная с четвертого байта поля служебных данных . Это указывает на VID 5A23 и PID FFFE — оба в формате с прямым порядком байтов .

Приложение BLE отображает значения с прямым порядком байтов, но значения VID/PID, которые вы вводите в свой проект Developer Console имеют прямой порядок байтов.

Убедитесь, что в проект Actions Console были введены правильные значения и формат на основе того, что показывает анализатор Bluetooth.

Для значений на снимке экрана примера VID и PID в Developer Console будут 235A и FEFF соответственно.