CTS 인증 도구 사용

Android 호환성 테스트 도구 모음 인증 도구(CTS 인증 도구)는 호환성 테스트 도구 모음(CTS)을 보완합니다. CTS가 자동화 가능한 API 및 기능을 점검하는 반면 CTS 인증 도구는 수동 입력 없이 고정된 기기에서 테스트할 수 없는 API 및 기능 테스트를 제공합니다(예: 오디오 품질, 터치스크린, 가속도계 및 카메라).

요구사항

CTS 인증 도구를 실행하기 전에 다음 장비가 있는지 확인하세요.

  • CTS를 성공적으로 통과하여 Android API 호환성이 인증된 Android 기기. 이 기기가 테스트 대상 기기(DUT)입니다.
  • USB 2.0 호환 포트가 있는 Linux 컴퓨터 DUT에 대한 모든 연결은 이 포트를 통해 이루어집니다.
  • 알려진 호환 가능한 블루투스, Wi-Fi Direct 및 NFC 호스트 카드 에뮬레이션(HCE) 구현이 이루어진 두 번째 Android 기기.
  • 액세스포인트 네임과 비밀번호가 설정된 Wi-Fi 라우터. 라우터는 인터넷 연결을 해제할 수 있지만 전원을 끌 수는 없습니다.

설정

CTS 인증 도구 테스트 환경 설정:

  1. Linux 컴퓨터:
  2. DUT를 Linux 컴퓨터에 연결합니다.
  3. Linux 컴퓨터의 터미널에서 DUT에 CtsVerifier.apk 설치를 완료합니다.
        adb install -r -g CtsVerifier.apk
        
  4. Android 10 이상의 경우 다음 명령을 실행하여 앱에 보고서를 생성할 권한을 부여합니다.
        adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
        
  5. DUT에 시스템 데이터와 시간이 올바르게 설정되어야 합니다.

실행

DUT에서 CTS 인증 도구 아이콘을 탭하여 CTS 인증 도구 애플리케이션을 실행합니다.

런처의 CTS 인증 도구 아이콘
그림 1. CTS 인증 도구 아이콘

수동 인증에 사용할 수 있는 여러 테스트 세트가 앱에 표시됩니다.

CTS 인증 도구 테스트 메뉴
그림 2. CTS 인증 도구 테스트 메뉴

각 테스트에는 화면 하단에 공통 요소(정보, 성공, 실패)가 포함되어 있습니다.

스트리밍 동영상 품질 인증 도구
그림 3. 테스트 요소
  • 정보(?). 탭하면 테스트 안내가 표시됩니다. 또한 테스트가 처음 열릴 때 자동으로 표시됩니다.
  • 성공(✓). DUT가 정보 안내에 따라 테스트 요구사항을 충족하는 경우 탭합니다.
  • 실패(!). DUT가 정보 안내에 따라 테스트 요구사항을 충족하지 않는 경우 탭합니다.

USB 액세서리 모드 및 카메라 보정 테스트와 같은 일부 테스트에서는 다음 섹션에서 자세히 설명하는 추가 테스트 설정 및 안내가 필요합니다.

8.0 이상용 USB 액세서리 모드 테스트

CTS 인증 도구 USB 액세서리 테스트
그림 4. 8.0 이상용 USB 액세서리 테스트 절차
CTS 인증 도구 USB 액세서리 테스트
그림 5. 8.0 이상용 USB 액세서리 모드 테스트

7.x 이하용 USB 액세서리 모드 테스트

USB 액세서리 테스트를 실시하려면 Linux 컴퓨터에서 USB 데스크톱 컴퓨터(호스트) 프로그램을 실행해야 합니다.

  1. DUT를 Linux 컴퓨터에 연결합니다.
  2. 컴퓨터에서 CTS 인증 도구 패키지에 있는 cts-usb-accessory 프로그램을 실행합니다.
    ./cts-usb-accessory
  3. DUT에서 팝업 메시지가 나타날 때까지 기다린 다음 OK를 선택합니다.
    CTS 인증 도구 USB 액세서리 테스트
    그림 6. USB 액세서리 테스트
  4. DUT의 CTS 인증 도구 애플리케이션에서 USB 액세서리 테스트로 이동합니다.
  5. 컴퓨터에서 콘솔의 출력을 검토합니다. 출력 예:
        CTS USB Accessory Tester
        Found possible Android device (413c:2106) - attempting to switch to accessory
        mode...
        Failed to read protocol versionfigure3
        Found Android device in accessory mode (18d1:2d01)...
        [RECV] Message from Android device #0
        [SENT] Message from Android accessory #0
        [RECV] Message from Android device #1
        [SENT] Message from Android accessory #1
        [RECV] Message from Android device #2
        [SENT] Message from Android accessory #2
        [RECV] Message from Android device #3
        [SENT] Message from Android accessory #3
        [RECV] Message from Android device #4
        [SENT] Message from Android accessory #4
        [RECV] Message from Android device #5
        [SENT] Message from Android accessory #5
        [RECV] Message from Android device #6
        [SENT] Message from Android accessory #6
        [RECV] Message from Android device #7
        [SENT] Message from Android accessory #7
        [RECV] Message from Android device #8
        [SENT] Message from Android accessory #8
        [RECV] Message from Android device #9
        [SENT] Message from Android accessory #9
        [RECV] Message from Android device #10
        [SENT] Message from Android accessory #10
        

카메라 시야 보정

시야 보정 절차를 사용하여 적당한 정확도로 기기 시야를 빠르게 결정합니다.

  1. 테스트 환경 설정:
    1. calibration-pattern.pdf 대상 파일을 11인치 x 17인치 또는 A3 크기로 인쇄합니다.
    2. 인쇄된 패턴을 견고한 뒷면에 놓습니다.
    3. 아래 그림과 같이 카메라 기기와 인쇄 대상의 방향을 설정합니다.
      카메라 인쇄 대상
      그림 7. 카메라 인쇄 대상
  2. 대상 너비 설정:
    1. 대상 패턴의 실선 사이 거리(센티미터 단위)를 측정하여 인쇄 부정확성(~38cm)을 확인합니다.
    2. 보정 애플리케이션을 시작합니다.
    3. 설정 버튼을 누르고 마커 거리를 선택합니다.
    4. 대상 패턴까지의 거리를 측정하고 입력합니다(~100cm).
    5. 뒤로 버튼을 눌러 보정 미리보기로 돌아갑니다.
  3. 기기와 대상이 그림과 같은 위치인지 확인하고 설정 대화상자에 올바른 거리가 입력되었는지 확인합니다. 미리보기에 수직선이 겹쳐진 이미지가 표시되며, 이 수직선은 대상 패턴의 중심선과 정렬되어야 합니다. 투명 그리드를 다른 수직선에 사용하여 광학 축이 대상과 수직인지 확인할 수 있습니다.
  4. 보정 테스트 실행:
    1. 이미지 해상도를 선택(왼쪽 하단의 선택기 사용)한 다음 화면을 탭하여 사진을 찍습니다. 테스트가 보정 모드로 전환되어 이미지에 수직선 2개가 겹쳐진 사진이 표시됩니다.
    2. 정확도 결정:
      • 선이 대상 패턴의 수직선과 몇 센티미터 이내로 정렬되는 경우 선택한 해상도에서 보고된 시야가 정확한 것입니다.
      • 선이 정렬되지 않으면 보고된 시야가 부정확한 것입니다. 이를 수정하려면 오버레이가 대상 패턴과 최대한 가깝게 정렬될 때까지 화면 하단의 슬라이더를 조정합니다. 오버레이 및 대상 패턴 이미지가 정렬되었을 때 표시되는 시야는 올바른 값에 근접합니다. 보고된 시야는 보정 값의 +/-1도 이내여야 합니다.
    3. 뒤로 버튼을 누르고 DUT에서 지원하는 모든 이미지 해상도의 보정 테스트를 반복합니다.

결과 내보내기

모든 테스트가 완료되면 결과를 보고서로 저장하고 컴퓨터로 다운로드할 수 있습니다. DUT 시스템 시간에 따라 자동으로 보고서 이름에 타임스탬프가 들어갑니다.

  1. 저장(디스크) 아이콘을 탭합니다.
    CTS 인증 도구 저장 아이콘
    그림 8. CTS 인증 도구 저장 아이콘
  2. 저장된 경로(예: /sdcard/verifierReports/ctsVerifierReport-date-time.zip)를 표시하는 팝업 메시지가 표시되기를 기다린 다음 경로를 기록합니다.
    CTS 인증 도구 저장된 보고서 경로
    그림 9. CTS 인증 도구 저장된 보고서 경로
  3. DUT를 Linux 컴퓨터에 연결합니다.
  4. Linux 컴퓨터의 Android SDK 설치에서 adb shell content read 또는 adb pull CTSVerifierReportPath 사용을 통해 연결된 기기에서 보고서를 다운로드합니다.
    • Android 7.x 이상의 경우 다음을 사용하여 모든 보고서를 다운로드합니다.
          adb pull /sdcard/verifierReports
          
    • Android 6.0 이하의 경우 다음을 사용하여 모든 보고서를 다운로드합니다.
          adb pull /mnt/sdcard/ctsVerifierReports/
          
    • 보조 사용자로 실행되는 자동차 및 기기를 구현한 Android 10 이상의 경우 다음을 사용하여 최신 보고서를 다운로드합니다.

          adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip

      연결된 기기에서 사용 가능한 모든 보고서를 나열:

          adb shell content query --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports

      목록에서 보고서를 다운로드하려면 행 ID 또는 파일 이름을 지정합니다. 예:

          adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
      adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
  5. 성공/실패 결과를 지우려면 CTS 인증 도구 앱에서 결과를 선택하고 메뉴 > 지우기를 선택합니다.