Google Home Developer Console은(는) 테스트 페이지를 제공하며, 이 페이지에서 Matter 통합에 대해 Google Home Test Suite를 사용하여 테스트를 구성하고 실행할 수 있습니다. Test Suite는 모든 통합 테스트를 처리하는 Developer Console에 내장된 별도의 애플리케이션입니다.
테스트를 실행하려면 통합의 제공업체 ID 및 제품 ID 기기를 Google Home app (GHA)에서 개발자 콘솔에서 사용 중인 계정의 Developer Console에서 커미셔닝하고 사용할 수 있어야 합니다. 자세한 내용은 Matter 기기 페어링을 참고하세요.
Test Suite는 특정 Matter 프로젝트 구성에 속한 기기 집합에서 실행할 수 있습니다. 모든 것이 제대로 작동하는지 확인하려면 통합에서 Test Suite를 실행하는 것이 매우 중요합니다.
테스트 페이지의 테스트 준비 완료 에 Matter 통합이 완료되고 테스트할 준비가 된 상태로 나열됩니다.
Matter 통합은 테스트되었습니다. 테스트됨 섹션에 나열됩니다.
테스트 계획 유형
다음과 같은 테스트 계획 유형을 사용할 수 있습니다.
개발 테스트 계획은 Matter를 사용하여 기기 제어를 테스트하는 데 사용됩니다 Matter. 수정할 수 있지만 Matter 인증을 위해 제출할 수는 없습니다.
인증 테스트 계획은 Matter 인증 전용이며 수정할 수 없습니다. 이 옵션을 선택하면 Matter 통합의 새 버전이 생성됩니다.
CSA Interop 테스트 계획을 사용하면 테스트 단계를 건너뛰고 Connectivity Standards Alliance (Alliance) Interop Test Lab 결과를 사용할 수 있습니다. 이 테스트 옵션은 지원되는 모든 기기 유형에 사용할 수 있습니다.
인증을 위한 테스트 결과를 제출하려면 Developer Console의 Test Suite을(를) 사용합니다. 개발 중에 테스트 목적으로 Test Suite를 실행하려면 독립형 버전의 Google Home Test Suite 페이지를 참고하세요.
통합 버전
인증을 위한 테스트 계획을 만들면 통합의 새 버전이 생성됩니다. 이 번호가 매겨진 버전은 테스트 탭부터 시작하여 Developer Console 의 모든 통합 목록에 나열됩니다.
새 버전은 다른 번호가 매겨진 버전에서 생성되지 않습니다. 예를 들어 통합을 위해 만드는 첫 번째 테스트 계획은 해당 통합의 v.1 버전을 만듭니다. 다른 테스트 계획을 만들면 해당 통합의 v.2 버전이 생성되지만 이 버전은 v.1 을 기반으로 하지 않습니다. 대신 이 버전은 v.1 과 마찬가지로 버전이 지정되지 않은 통합 인스턴스를 기반으로 합니다.
통합의 해당 사항 없음 버전은 개발 탭에서 관리되는 버전이 지정되지 않은 통합 인스턴스를 나타냅니다.
즉, Matter > 테스트에서 다음을 실행할 수 있습니다.Developer Console
- 통합의 해당 사항 없음 버전에 대해 테스트 를 클릭하면 새 버전이 생성됩니다. 버전 번호는 기존의 번호가 매겨진 버전보다 1씩 증가합니다.
- 번호가 매겨진 버전이 없으면 v.1 버전이 생성됩니다.
- v.1 버전이 있으면 v.2 버전이 생성됩니다. v.2 버전이 있으면 v.3 버전이 생성되는 방식입니다.
- 번호가 매겨진 통합 버전 (예: v.1)에 대해 테스트 를 클릭하면 새 버전이 생성되지 않습니다. 대신 v.1 버전이 다시 테스트됩니다.
자세한 내용은 통합 버전 관리를 참고하세요.
테스트 계획 만들기
통합 버전은 버전이 지정되지 않은 통합의 스냅샷입니다. 즉, 인증을 위한 테스트 계획을 만들 때 통합 버전이 생성되므로 해당 통합과 관련된 모든 메타데이터는 출시된 통합에 사용하려는 정보여야 합니다.
인증을 위한 테스트 계획을 만들기 전에 다음 작업을 완료했는지 확인하세요.
통합에 대해 이러한 모든 작업을 완료하지 않은 경우 인증 테스트를 위해 생성된 통합 버전은 인증할 수 없습니다. 새 버전을 만들어야 하므로 테스트, 현장 테스트, 인증 단계를 다시 실행해야 합니다.
통합 버전이 인증되기 전에 브랜딩을 업데이트하려면 새 버전을 만들고 다시 시작해야 합니다.
테스트 계획을 만들려면 다음 단계를 따르세요.
프로젝트 목록에서 작업하려는 프로젝트 옆에 있는 열기 를 클릭합니다.
페이지 왼쪽의 탐색 메뉴에서 Matter > 테스트 로 이동합니다.
테스트하려는 통합의 해당 사항 없음 버전에 대해 테스트 를 클릭합니다. 이 작업은 새 통합 버전을 만듭니다.
테스트 유형을 선택하고 테스트 를 클릭합니다.
- Google 생태계에서 인증을 준비하는 경우 인증 테스트 를 선택합니다.
- 개발 테스트 는 인증에 사용할 수 없습니다.
- Alliance Interop Test Lab 결과를 사용하여 Matter 통합 흐름에서 테스트 및 현장 테스트 단계를 건너뛰려면 CSA Interop 테스트 를 선택합니다.Alliance
테스트 구성 화면에서 테스트 이름을 제공하고 기기 자동 페어링 을 클릭하여 페어링할 기기를 선택합니다.
Android 기기의 경우:
- 휴대전화에 GHA를 설치했는지 확인합니다.
- USB 케이블을 사용하여 휴대전화를 호스트 머신에 연결합니다.
- 기기에서 USB 디버깅을
사용 설정해야 합니다.
APKcom.chip.interop.moblysnippet이 자동으로 다운로드 되고 설치됩니다. - 휴대전화가 연결되면 페어링 코드 와 기기 이름 을 입력하여 기기를 자동 페어링합니다.
iOS 기기의 경우:
- 기기를 수동으로 페어링해야 합니다. 수동 페어링에 관한 안내는 Google Home 앱 섹션 을 참고하세요.
- 기존 기기가 있는 경우 기기를 페어링 해제하고 다시 페어링하거나 새 기기를 페어링하라는 메시지가 표시될 수 있습니다.
다음: 테스트 계획 버튼을 클릭합니다.
테스트 계획 만들기 페이지의 테스트 모음 섹션에서 실행할 테스트 모음을 선택합니다.
Test Suite를 종료하려면
개발자
센터로 돌아가기를 클릭합니다.
테스트 계획 실행
Test Suite에서 테스트 계획 만들기 페이지의 테스트 실행을 클릭합니다. 모든 테스트의 상태와 로그가 포함된 테스트 환경 페이지가 표시됩니다.
테스트가 완료되면 테스트 결과가 표시됩니다. 각 테스트 모음 실행의 상태가 옆에 표시됩니다 (통과, 실패).
로그 창에는 각 개별 테스트 실행의 상태가 표시됩니다.
**테스트 환경** 페이지에서 테스트 계획을 다시 테스트하려면 테스트 실행이 완료된 후 상단에서
다시 테스트를 클릭합니다.
완료되면 다음 중 하나를 실행합니다.
- 완료 를 클릭하여 테스트 기록 페이지로 이동하거나
- 제출 을 클릭하여 인증을 위한 테스트 결과를 제출합니다.
테스트 결과 보기 및 해석
Test Suite의 테스트 기록 페이지에서 테스트 계획 섹션의 원하는 테스트 계획에 대해 다시 테스트를 클릭하여 개발 계획 또는 제출되지 않은 인증 테스트 계획의 이전 테스트 결과를 볼 수 있습니다. 이렇게 하면 해당 테스트의 결과를 표시하는 테스트 환경 페이지로 이동합니다.
제출된 인증 계획의 경우 인증을 위해 저장됨 섹션에서 결과 를 클릭하여 테스트 결과 보고서를 확인합니다.
개발자 콘솔의 테스트 탭에서 통합 버전의 테스트 결과에 액세스할 수도 있습니다.Developer Console 해당 페이지에 나열된 통합 버전의 테스트 기록 에 대해 보기 를 클릭하면 Test Suite의 테스트 기록 페이지로 이동합니다.
콘솔 상태
테스트 단계에서 다음과 같은 콘솔 상태가 발생합니다.
| 섹션 | 상태 | 설명 | 요구사항 | 다음 단계 |
|---|---|---|---|---|
| 테스트 준비 완료 | 준비됨 | 이 버전은 integration 테스트할 준비가 되었습니다. | 해당 사항 없음 | 테스트 이 버전의 integration. |
| 테스트됨 | 준비됨 | 이 버전의 integration 가 테스트되었으며 Field Trial 또는 인증을 위해 제출할 수 있습니다. |
버전이 테스트되고 저장되었습니다. 실패한 모든 테스트 케이스에는 Google에서 검토할 수 있는 근거가 포함되어 있습니다. |
원하는 경우 다시 테스트합니다. |
다시 테스트합니다.
인증
인증을 위해 다시 테스트해야 하는 경우 다시 테스트를 시작한 후 기기를 페어링해야 합니다.
개발
개발을 위해 다시 테스트해야 하는 경우 다시 페어링하지 않고 기존 기기를 사용할 수 있습니다.
문제 해결
커미셔닝된 기기가 Test Suite에 표시되지 않음
테스트 제공업체 ID (VID) 및 제품 ID (PID)로 기기를 페어링했지만 Test Suite에서 기기를 테스트하려고 할 때 기기가 표시되지 않는 경우 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임을 나타냅니다. 둘 다 리틀 엔디언 형식 입니다.
BLE 앱은 리틀 엔디언으로 값을 표시하지만 VID/PID 값 개발자 콘솔 프로젝트에 입력하는 값은 빅 엔디언입니다.Developer Console
블루투스 스니퍼에 표시되는 내용을 기반으로 작업 콘솔 프로젝트에 올바른 값과 형식이 입력되었는지 확인합니다.
예시 스크린샷의 값의 경우
Developer Console의 VID와 PID는 각각 235A와 FEFF입니다.