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 앱
- Android 휴대전화에 GHA 앱을 설치하세요.
GHA의 버전이
3.1.1.14
및3.24.1.4
인지 확인합니다. - GHA에서 Google 계정에 로그인합니다.
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
입력 값 | 설명 | 예 |
---|---|---|
DEVICE_NAME |
기기 Matter대가 선택되었습니다. | m5stack |
PAIRING_CODE |
Matter 기기의 페어링 코드입니다. | 34970112332 |
ROOM_NAME |
회의실이 할당되었습니다. | Office |
Matter 기기 사용 중지하기
Matter 기기를 지원 중단하려면 다음 명령어를 입력합니다.
ui-automator --decommission DEVICE_NAME
입력 값 | 설명 | 예 |
---|---|---|
DEVICE_NAME |
GHA에 커미셔닝된 Matter 기기의 이름이 표시됩니다. | m5stack |
회귀 테스트 실행
회귀 테스트를 실행하려면 다음 코드를 입력합니다. 회귀 테스트를 실행하려면 플래그 --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]
회귀 테스트는 커미셔닝 및 사용 중단 주기만 지원합니다. 기본적으로 회귀 테스트는 사용자가 키보드를 사용하여 프로세스를 중지할 때까지 실행됩니다.
다음을 추가하여 더 심층적인 테스트 결과를 확인할 수 있습니다.
값 | 입력 값 | 설명 | 예 |
---|---|---|---|
--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님, 의견 양식.
문제 신고
다음을 사용하여 문제 신고: Issue Tracker를 참조하세요.