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.10.1.6이상인지 확인합니다. - 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를 사용하여 발생한 문제를 보고합니다.