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 .
Используйте Test Suite в Developer Console , чтобы отправить результаты тестов на сертификацию. Если вы хотите запустить Test Suite для целей тестирования во время разработки, см. страницу Google Home Test Suite для автономной версии.
Версии интеграции
При создании плана тестирования для сертификации создается новая версия интеграции. Эта пронумерованная версия указана во всех списках интеграции в Developer Console , начиная с вкладки «Тест».
Новые версии никогда не создаются из других пронумерованных версий. Например, первый план тестирования, который вы создадите для интеграции, создаст версию v.1 для этой интеграции. Создание другого плана тестирования приведет к созданию версии v.2 для этой интеграции, но эта версия не будет основана на версии v.1 . Вместо этого эта версия основана на неверсированном экземпляре интеграции, как и версия 1 .
Версия интеграции «Н/Д» представляет собой неверсированный экземпляр интеграции, управление которым осуществляется на вкладке «Разработка» .
Другими словами, в разделе Matter > «Тест» в Developer Console :
- Если вы нажмете «Проверить версию N/A интеграции», будет создана новая версия. Номер версии будет на единицу выше, чем у всех существующих пронумерованных версий.
- Если пронумерованных версий не существует, создается версия v.1 .
- Если версия v.1 существует, создается версия v.2 . Если существует версия v.2 , создается версия v.3 и т. д.
- Если вы нажмете Проверить для пронумерованной версии интеграции (например, v.1 ), новая версия не будет создана. Вместо этого снова тестируется версия v.1 .
Дополнительные сведения см. в разделе Управление версиями интеграции .
Создайте план тестирования
Версии интеграции представляют собой снимок неверсионной интеграции. Это означает, что когда вы создаете план тестирования для сертификации и, следовательно, версию интеграции, все метаданные, связанные с этой интеграцией, должны представлять собой информацию, которую вы хотите использовать для запущенной интеграции .
Прежде чем создавать план тестирования для сертификации, убедитесь, что вы выполнили следующее:
- Создал профиль компании .
- Введен производственный идентификатор поставщика (VID) для интеграции .
- Настроенная настройка и брендинг .
Если вы не выполнили все эти действия для интеграции, версия интеграции, созданная для сертификационного тестирования, не может быть сертифицирована . Вам придется создать новую версию, что означает повторение этапов тестирования, полевых испытаний и сертификации.
Вам также придется создать новую версию и начать все сначала , если вы хотите обновить свой бренд до сертификации интеграционной версии.
Чтобы создать план тестирования:
Зайдите в консоль разработчика
- В списке проектов нажмите «Открыть» рядом с проектом, с которым вы хотите работать.
- В меню навигации в левой части страницы выберите Matter > «Тест» .
- Нажмите «Протестировать» для версии N/A интеграции, которую вы хотите протестировать. Это действие создает новую версию интеграции .
- Выберите тип теста «Разработочный тест» или «Сертификационный тест» и нажмите «Тест» .
- Выберите Сертификационный тест, если вы готовитесь к сертификации в экосистеме Google.
- Тест развития не может использоваться для сертификации.
На экране «Настройка теста» укажите имя теста и нажмите «Автоматическое сопряжение устройства» , чтобы выбрать устройство для сопряжения.
- Для устройства Android:
- Убедитесь, что вы установили GHA на свой телефон.
- Подключите телефон к хост-компьютеру с помощью USB-кабеля.
- Вы должны включить отладку по USB на своем устройстве.
APKcom.chip.interop.moblysnippetбудет автоматически загружен и установлен. - После подключения телефона введите код сопряжения и имя устройства , чтобы выполнить автоматическое сопряжение вашего устройства.
- Для устройства iOS: вам потребуется вручную выполнить сопряжение устройства. Инструкции по сопряжению вручную см. в разделе «Приложение Google Home» .
- Если у вас есть существующее устройство, вас могут попросить отключить его и выполнить сопряжение снова или подключить новое устройство.
Нажмите кнопку «Далее: план тестирования» .
На странице Создание плана тестирования в разделе Наборы тестов выберите наборы тестов, которые вы хотите запустить.
Если вы хотите выйти из Test Suite , нажмите Вернуться в центр разработчиков .Запустите план тестирования
В Test Suite на странице «Создание плана тестирования» нажмите «Выполнить тест» . Появится страница «Тестовая среда» со статусом и журналами всех тестов.
Результаты теста появятся после завершения тестов. Рядом с ним отображается статус выполнения каждого набора тестов (пройдено, не пройдено).
На панели «Журналы» отображается состояние выполнения каждого отдельного теста.
Чтобы повторно протестировать план тестирования на странице «Среда тестирования» , нажмите «Повторное тестирование» вверху после завершения выполнения теста.После завершения:
- Нажмите «Готово» , чтобы перейти на страницу истории тестов , или
- Нажмите «Отправить» , чтобы отправить результаты теста на сертификацию .
Просмотр и интерпретация результатов теста
На странице «История тестов» в Test Suite вы можете просмотреть результаты предыдущих тестов для плана разработки или неотправленного плана сертификационного тестирования, нажав «Повторно протестировать» для нужного плана тестирования в разделе «Планы тестирования» . Вы перейдете на страницу «Тестовая среда» , на которой отображаются результаты этого теста.
Для отправленного плана сертификации нажмите «Результаты» в разделе «Сохранено для сертификации», чтобы просмотреть отчет о результатах тестирования.
Результаты тестирования также можно получить для версии интеграции на вкладке «Тест» в Developer Console . Нажмите «Просмотреть» , чтобы просмотреть историю тестов любой версии интеграции, указанной на этой странице, чтобы перейти на страницу «История тестов» в Test Suite .
Статусы консоли
На этапе тестирования встречаются следующие состояния консоли:
| Раздел | Статус | Описание | Требование | Что делать дальше |
|---|---|---|---|---|
| Готов к тестированию | Готовый | Эта версия integration готов к тестированию. | Н/Д | Протестируйте эту версию integration. |
| Протестировано | Готовый | Эта версия integration был протестирован и может быть отправлен на Field Trial или сертификацию. | Версия была протестирована и сохранена. Все неудачные тестовые случаи включают обоснования для проверки Google. | При желании повторите тест . |
Повторное тестирование
Сертификация
Если вам необходимо пройти повторное тестирование для сертификации, вам необходимо выполнить сопряжение устройства после начала повторного тестирования.
Разработка
Если вам необходимо провести повторное тестирование для разработки, вы можете использовать существующее устройство без повторного сопряжения.
Поиск неисправностей
Введенное в эксплуатацию устройство не отображается в наборе тестов.
Если вы связали устройство с тестовым идентификатором поставщика (VID) и идентификатором продукта (PID), но он не отображается при попытке протестировать устройство с помощью набора тестов в Developer Console , это, скорее всего, вызвано использованием одной и той же комбинации тестовых VID и PID в нескольких интеграциях.
Для устранения неполадок удалите все тестовые устройства из Developer Console и снова подключите устройство, которое вы хотите протестировать.
Чтобы убедиться, что вы подключили правильное устройство, вы можете установить уникальные значения для информации о производителе и модели (значения CHIP_DEVICE_CONFIG_DEVICE_* ) устройства в вашей тестовой прошивке.
Дополнительную информацию см. в разделе Информация об устройстве .
Проверьте VID/PID вашего устройства
Если вы хотите начать разработку интеграции с Google, вам необходимо создать проект и интеграцию в домашней консоли Google.
Значение VID/PID, которое передает ваше устройство, должно соответствовать значению VID/PID, введенному в ваш проект Developer Console .
- VID
0xFFF1—0xFFF4зарезервированы для тестирования. Их можно использовать для базовых пусконаладочных и контрольных испытаний, но их нельзя использовать на следующих этапах разработки:
Используя инженерное приложение Bluetooth, такое как nRF Connect for Mobile , вы можете увидеть VID/PID маякового устройства в поле «Служебные данные» .
На этом снимке экрана из версии nRF Connect Android вы увидите, что VID/PID указан как 5A23FFFE , начиная с четвертого байта поля служебных данных . Это указывает на VID 5A23 и PID FFFE — оба в формате с прямым порядком байтов .
Приложение BLE отображает значения с прямым порядком байтов, но значения VID/PID, которые вы вводите в проект Developer Console имеют обратный порядок байтов.
Убедитесь, что в ваш проект консоли действий были введены правильные значения и формат на основе того, что показывает анализатор Bluetooth.
Для значений на скриншоте примера VID и PID в Developer Console будут 235A и FEFF соответственно.