Google Home Developer Console는 Google Home Test Suite를 사용하여 Matter 통합에 대한 테스트를 구성하고 실행할 수 있는 테스트 페이지를 제공합니다. Test Suite는 모든 통합 테스트를 처리하는 Developer Console에 내장된 별도의 애플리케이션입니다.
통합의 공급업체 ID 및 제품 ID 기기를 테스트하려면 Developer Console와 함께 사용 중인 계정의 Google Home app (GHA)에서 기기를 커미셔닝하고 사용할 수 있어야 합니다. 자세한 내용은 Matter 기기 페어링을 참고하세요.
Test Suite는 특정 Matter 프로젝트 구성에 속하는 기기 세트에서 실행할 수 있습니다. 모든 것이 제대로 작동하는지 확인하려면 통합에서 Test Suite를 실행하는 것이 매우 중요합니다.
테스트 페이지에서 완료되어 테스트할 준비가 된 Matter 통합은 테스트 준비 완료에 표시됩니다.
테스트된 Matter 통합은 테스트됨 섹션에 나열됩니다.
테스트 계획 유형
테스트 계획에는 두 가지 유형이 있습니다.
개발 테스트 계획은 Matter를 사용하여 기기 제어를 테스트하는 데 사용됩니다. 수정할 수 있지만 Matter 인증을 위해 제출할 수는 없습니다.
인증 테스트 계획은 Matter 인증 전용이며 수정할 수 없습니다. 이 옵션을 선택하면 새 버전의 Matter 통합이 생성됩니다.
Developer Console의 Test Suite를 사용하여 인증을 위한 테스트 결과를 제출합니다. 개발 중에 테스트 목적으로 Test Suite를 실행하려면 독립형 버전의 Google Home Test Suite 페이지를 참고하세요.
통합 버전
인증을 위해 테스트 계획을 만들면 새 버전의 통합이 생성됩니다. 이 번호가 지정된 버전은 테스트 탭부터 Developer Console의 모든 통합 목록에 표시됩니다.
다른 번호가 지정된 버전에서 새 버전이 생성되는 경우는 없습니다. 예를 들어 통합에 대해 만드는 첫 번째 테스트 계획은 해당 통합의 버전 v.1을 만듭니다. 다른 테스트 계획을 만들면 해당 통합의 버전 v.2가 생성되지만 이 버전은 v.1을 기반으로 하지 않습니다. 대신 이 버전은 v.1과 마찬가지로 버전이 지정되지 않은 통합 인스턴스를 기반으로 합니다.
통합의 해당 사항 없음 버전은 버전이 지정되지 않은 통합 인스턴스를 나타내며 Develop 탭에서 관리됩니다.
즉, Developer Console의 Matter > 테스트에서 다음을 실행합니다.
- 통합 버전 해당 사항 없음의 테스트를 클릭하면 새 버전이 생성됩니다. 버전 번호는 기존 번호가 지정된 버전보다 1씩 높아집니다.
- 번호가 지정된 버전이 없으면 버전 v.1이 생성됩니다.
- 버전 v.1이 있으면 버전 v.2가 생성됩니다. 버전 v.2가 있으면 버전 v.3이 생성되고,
- 번호가 지정된 통합 버전 (예: v.1)의 테스트를 클릭하면 새 버전이 생성되지 않습니다. 대신 버전 v.1이 다시 테스트됩니다.
자세한 내용은 통합 버전 관리를 참고하세요.
테스트 계획 만들기
통합 버전은 버전이 지정되지 않은 통합의 스냅샷입니다. 즉, 인증을 위한 테스트 계획과 통합 버전을 만들 때 해당 통합과 관련된 모든 메타데이터가 출시된 통합에 사용할 정보여야 합니다.
인증을 위한 테스트 계획을 만들기 전에 다음을 완료했는지 확인하세요.
통합에 대해 이 작업을 모두 완료하지 않은 경우 인증 테스트를 위해 생성된 통합 버전을 인증할 수 없습니다. 새 버전을 만들어야 합니다. 즉, 테스트, 필드 트라이얼, 인증 단계를 다시 실행해야 합니다.
통합 버전이 인증되기 전에 브랜딩을 업데이트하려면 새 버전을 만들어 다시 시작해야 합니다.
테스트 계획을 만들려면 다음 단계를 따르세요.
프로젝트 목록에서 작업할 프로젝트 옆에 있는 열기를 클릭합니다.
페이지 왼쪽의 탐색 메뉴에서 Matter > 테스트로 이동합니다.
테스트하려는 통합의 버전 해당 사항 없음에 대해 테스트를 클릭합니다. 이 작업을 수행하면 새 통합 버전이 생성됩니다.
테스트 유형으로 개발 테스트 또는 인증 테스트를 선택합니다.
- Google 생태계의 자격증을 준비하는 경우 자격증 테스트를 선택합니다.
- 개발 테스트는 인증에 사용할 수 없습니다.
테스트를 클릭합니다. 기기 없음 오류 화면이 표시되면 이 통합을 위한 기기가 아직 생태계에 커미셔닝되지 않은 것입니다. 자세한 내용은 페어링 문제 해결을 참고하세요.
테스트 구성 화면에서 테스트 이름을 지정하고 기기 목록에서 테스트할 기기를 선택합니다.
다음: 테스트 계획 버튼을 클릭합니다.
테스트 계획 만들기 페이지의 테스트 모음 섹션에서 실행할 테스트 모음을 선택합니다.
Test Suite를 종료하려면 Developer Center로 돌아가기를 클릭합니다.
테스트 계획 실행
Test Suite의 테스트 계획 만들기 페이지에서 테스트 실행을 클릭합니다. 모든 테스트의 상태와 로그가 포함된 테스트 환경 페이지가 표시됩니다.
테스트가 완료되면 테스트 결과가 표시됩니다. 각 테스트 모음 실행의 상태가 옆에 표시됩니다 (통과, 실패).
로그 창에는 각 개별 테스트 실행의 상태가 표시됩니다.
테스트 환경 페이지에서 테스트 계획을 다시 테스트하려면 테스트 실행이 완료된 후 상단의 다시 테스트를 클릭합니다.
완료되면 다음 단계를 따르세요.
- 완료를 클릭하여 테스트 기록 페이지로 이동합니다.
- 제출을 클릭하여 인증을 위한 테스트 결과를 제출합니다.
테스트 결과 보기 및 해석
Test Suite의 테스트 기록 페이지에서 테스트 계획 섹션에서 원하는 테스트 계획의 재테스트를 클릭하여 개발 계획 또는 제출되지 않은 인증 테스트 계획의 이전 테스트 결과를 볼 수 있습니다. 그러면 테스트 결과가 표시되는 테스트 환경 페이지로 이동합니다.
제출된 인증 계획의 경우 인증을 위해 저장됨 섹션에서 결과를 클릭하여 테스트 결과 보고서를 확인합니다.
Developer Console의 테스트 탭에서 통합 버전의 테스트 결과에 액세스할 수도 있습니다. 페이지에 나열된 통합 버전의 테스트 기록에 대해 보기를 클릭하면 Test Suite의 테스트 기록 페이지로 이동합니다.
콘솔 상태
테스트 단계에서 다음과 같은 Console 상태가 발생합니다.
| Section | 상태 | 설명 | 요건 | 다음 단계 |
|---|---|---|---|---|
| 테스트 준비 완료 | 준비됨 | 이 버전의 integration 은 테스트할 준비가 되었습니다. | 해당 사항 없음 | 이 버전의 integration를 테스트합니다. |
| 테스트 완료 | 준비됨 | 이 버전의 integration 는 테스트를 거쳤으며 필드 트라이얼 또는 인증을 위해 제출할 수 있습니다. |
버전이 테스트되고 저장되었습니다. 실패한 모든 테스트 사례에는 Google에서 검토할 근거가 포함되어 있습니다. |
원하는 경우 재테스트합니다. |
문제 해결
커미셔닝된 기기가 테스트 모음에 표시되지 않음
기기를 테스트 공급업체 ID (VID) 및 제품 ID (PID)와 페어링했지만 Developer Console에서 테스트 모음으로 기기를 테스트하려고 하면 기기가 표시되지 않는 경우 여러 통합에서 동일한 테스트 VID 및 PID 조합을 사용했기 때문일 수 있습니다.
문제를 해결하려면 Developer Console에서 모든 테스트 기기를 삭제하고 다시 테스트하려는 기기를 페어링합니다.
올바른 기기를 페어링했는지 확인하려면 기기의 제조업체 및 모델 정보 (CHIP_DEVICE_CONFIG_DEVICE_* 값)를 테스트 펌웨어의 고유한 값으로 설정하면 됩니다.
자세한 내용은 기기 정보를 참고하세요.
기기의 VID/PID 확인
Google과의 통합 개발을 시작하려면 Google Home 콘솔에서 프로젝트와 통합을 만들어야 합니다.
기기가 비콘으로 전송하는 VID/PID 값은 Developer Console 프로젝트에 입력된 VID/PID와 일치해야 합니다.
- VID
0xFFF1~0xFFF4는 테스트용으로 예약되어 있습니다. 기본 커미셔닝 및 제어 테스트에 사용할 수 있지만 다음과 같은 개발 단계에서는 사용할 수 없습니다.
nRF Connect for Mobile과 같은 블루투스 엔지니어링 앱을 사용하면 서비스 데이터 필드에서 비콘 기기의 VID/PID를 확인할 수 있습니다.
nRF Connect Android 버전의 스크린샷에서 VID/PID가 서비스 데이터 필드의 네 번째 바이트부터 5A23FFFE로 표시됩니다. 이는 VID가 5A23이고 PID가 FFFE임을 나타내며 둘 다 little-endian 형식입니다.
BLE 앱은 값을 리틀 엔디언으로 표시하지만 Developer Console 프로젝트에 입력하는 VID/PID 값은 빅 엔디언입니다.
블루투스 스니퍼에 표시되는 내용을 바탕으로 Actions Console 프로젝트에 올바른 값과 형식이 입력되었는지 확인합니다.
스크린샷 예시의 값을 기준으로 Developer Console의 VID와 PID는 각각 235A 및 FEFF입니다.