Google Home UI 자동화기

Matter    기기 SDK

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 휴대전화

1. Android 휴대전화에서 사용자 디버깅 모드를 사용 설정합니다. 디버깅 설정을 사용 설정하려면 개발자 옵션 사용 설정을 참고하세요.
2. Android 휴대전화를 컴퓨터에 연결합니다.

Google Home 앱

1. Android 휴대전화에 GHA를 설치합니다. GHA의 버전이 3.1.1.14 및 3.25.1.4인지 확인합니다.
2. GHA에서 Google 계정에 로그인합니다.

Google Home UI Automator 설치

Google Home UI Automator를 설치하는 방법에는 PyPI와 소스 코드의 두 가지가 있습니다. PyPI를 사용하여 설치하는 것이 좋습니다.

PyPI (권장)

pip install google-home-ui-automator

소스 코드에서 빌드

소스 코드에서 빌드하려면 터미널에서 다음 단계를 따르세요.

1. 이 저장소를 클론합니다.

   git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
   

2. 클론된 저장소로 이동합니다.

   cd ui-automator
   

3. 다음 명령어를 실행합니다.

   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를 사용하여 발생한 문제를 신고합니다.