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.32.126.2인지 확인합니다. - 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 [--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 |
GHA에 커미셔닝된 Matter 기기의 이름을 표시합니다. | 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 사용 경험을 개선하는 방법에 대한 의견을 제출하려면 의견 양식을 작성하세요.
문제 신고
Issue Tracker를 사용하여 발생한 문제를 신고하세요.