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에서 사용할 계정입니다. | [email protected] |
Matter 기기 서비스 해제
Matter 기기를 폐기하려면 다음 명령어를 입력합니다.
ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
| 입력 값 | 설명 | 예 |
|---|---|---|
DEVICE_NAME |
GHA에 커미셔닝된 Matter 기기의 이름을 표시합니다. | m5stack |
GOOGLE_ACCOUNT |
GHA에서 사용할 계정입니다. | [email protected] |
회귀 테스트 실행
회귀 테스트를 실행하려면 다음 코드를 입력합니다. 회귀 테스트를 실행하려면 --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에서 사용할 계정입니다. | [email protected] |
회귀 테스트는 프로비저닝 및 프로비저닝 해제 주기만 지원합니다. 기본적으로 회귀 테스트는 사용자가 키보드를 사용하여 프로세스를 중지할 때까지 실행됩니다.
다음 항목을 추가하여 더 자세한 테스트 결과를 확인할 수 있습니다.
| 값 | 입력 값 | 설명 | 예 |
|---|---|---|---|
--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를 사용하여 발생한 문제를 신고하세요.