Google Home UI Automator поможет вам автоматизировать Google Home app (GHA), чтобы вводить в эксплуатацию и выводить из нее Matter, а также проводить регрессионное тестирование.
Требования
Чтобы использовать Google Home UI Automator, вам понадобится:
Python 3
Для запуска скрипта рекомендуется использовать среду Python 3.
Для Google Home UI Automator требуется Python 3.11 или более поздней версии.
Телефон Android
- Включите режим отладки на телефоне Android. Чтобы включить отладку, ознакомьтесь с инструкциями в статье Как включить режим разработчика.
- Подключите телефон Android к компьютеру.
Приложение Google Home
- Установите приложение "GHA" на телефон Android.
Убедитесь, что версия GHA –
3.1.1.14и3.32.126.2. - Войдите в аккаунт Google в GHA.
Установите Google Home UI Automator
Установить Google Home UI Automator можно двумя способами: с помощью PyPI или из исходного кода. Рекомендуем использовать PyPI.
PyPI (рекомендуется)
pip install google-home-ui-automator
Сборка из исходного кода
Чтобы выполнить сборку из исходного кода, выполните в терминале следующие действия:
Клонируйте это хранилище:
git clone https://testsuite-smarthome-matter.googlesource.com/ui-automatorПерейдите в клонированное хранилище:
cd ui-automatorВыполните следующую команду:
pip install .
Как настроить устройство Matter
Чтобы ввести устройство Matter в эксплуатацию, введите следующую команду:
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
| Ввод значения | Описание | Пример |
|---|---|---|
DEVICE_NAME |
Выбрано Matter устройство. | m5stack |
PAIRING_CODE |
Код подключения устройства Matter. | 34970112332 |
ROOM_NAME |
Назначенная комната. | Office |
GOOGLE_ACCOUNT |
Аккаунт для использования в приложении "GHA". | test@gmail.com |
Как деинициализировать устройство Matter
Чтобы вывести устройство Matter из эксплуатации, введите следующую команду:
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| Ввод значения | Описание | Пример |
|---|---|---|
DEVICE_NAME |
Показывает отображаемое название подключенного устройства Matter на устройстве GHA. | m5stack |
GOOGLE_ACCOUNT |
Аккаунт для использования в приложении "GHA". | test@gmail.com |
Как выполнить регрессионное тестирование
Чтобы запустить регрессионное тестирование, введите следующий код. Чтобы запустить регрессионное тестирование, необходимо добавить флаги --regtest и --commission.
ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE] [--google_account GOOGLE_ACCOUNT]
| Ввод значения | Описание | Пример |
|---|---|---|
DEVICE_NAME |
Выбрано Matter устройство. | m5stack |
PAIRING_CODE |
Код подключения устройства Matter. | 34970112332 |
ROOM_NAME |
Назначенная комната. | Office |
GOOGLE_ACCOUNT |
Аккаунт для использования в приложении "GHA". | test@gmail.com |
Регрессионное тестирование поддерживает только цикл ввода в эксплуатацию и вывода из эксплуатации. По умолчанию регрессионное тестирование будет выполняться до тех пор, пока пользователь не остановит его с помощью клавиатуры.
Чтобы получить более подробные результаты тестирования, можно добавить следующее:
| Значение | Ввод значения | Описание | Пример |
|---|---|---|---|
--repeat |
REPEAT_TIMES |
Выполнять регрессионное тестирование ограниченное и повторяющееся количество раз. | 5 |
--hub |
HUB_VERSION |
Версия контроллера для управления устройствами в GHA. | 15.20221210.3.1 |
--dut |
Тестируемое устройство. | ||
MODEL |
Модель устройства. | X123123 |
|
TYPE |
тип устройства; | LIGHT |
|
PROTOCOL |
Протокол устройства. | MATTER |
|
--fw |
DEVICE_FIRMWARE |
Встроенное ПО устройства. | 2.2.0 |
Как оставить отзыв
Если вы хотите поделиться своим мнением о Google Home UI Automator или предложить, как улучшить этот инструмент, заполните форму обратной связи.
Как сообщить о проблеме
Сообщайте о проблемах, используя систему отслеживания ошибок.