Google Home UI Automator поможет вам автоматизировать Google Home app (GHA) для ввода в эксплуатацию, вывода из эксплуатации Matter или проведения регрессионного тестирования вашего заказа.
Предпосылки
Чтобы использовать Google Home UI Automator , подготовьте следующее:
Питон 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 , введите следующую команду:
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 , заполните нашу Форму обратной связи .
Сообщить о проблемах
Сообщайте о возникших проблемах с помощью системы отслеживания ошибок .