이 도움말에서는 보고서에서 확인할 수 있는 오류, 경고, 문제에 관한 개요가 제공되므로 사전 출시 보고서를 이해하는 데 유용합니다. 사전 출시 보고서를 설정하고 실행하는 방법을 알아보려면 사전 출시 보고서를 사용하여 문제 확인하기로 이동하세요.
사전 출시 보고서가 제공되면 테스트 중에 발견된 오류, 경고, 사소한 문제의 개수가 포함된 테스트 요약을 확인할 수 있으며, 문제 유형별로 분류되어 있습니다. 또한 앱의 테스트 결과에 따른 제안사항이 표시됩니다.
참고: 사전 출시 보고서는 앱을 개선하는 데 도움이 되는 실용적이고 강력한 도구지만, Google에서는 테스트를 통해 모든 문제를 파악한다고 보장하지 않습니다. 최대한 포괄적이며 관련성이 높은 결과를 확인하려면 사전 출시 보고서 설정을 검토하고 업데이트하시기 바랍니다.
사전 출시 보고서 개요
사전 출시 보고서 개요 페이지에는 테스트 중에 발견된 고유한 오류, 경고, 사소한 문제가 요약되어 있으며 안정성, 성능, 접근성, 보안 및 신뢰라는 네 가지 카테고리로 분류되어 있습니다. 이 카테고리는 아래에 자세히 설명되어 있습니다.
또한 앱 테스트를 실시한 기기 수와 더불어 테스트 결과에 따라 앱 개선에 도움이 되는 통계 및 제안사항도 표시됩니다.
다음은 테스트 중 발견되는 문제의 예입니다.
- 오류: 비정상 종료, ANR, 결함이 있는 라이브러리 사용, 제한된 미지원 API 사용
- 경고: 시작 및 로드 시간 느림, 로그인 또는 크롤링 문제, 메모리 문제, 아직 제한은 되지 않은 미지원 API 사용
- 사소한 문제: 콘텐츠 라벨 누락됨, 색상 대비 문제, 터치 대상 크기 작음, 구현 문제
사전 출시 보고서 세부정보
안정성안정성 탭의 각 섹션에는 테스트 중에 발견된 문제가 다음과 같이 자세히 설명되어 있습니다.
- 문제 유형 및 아이콘:
- 빨간색은 오류를 나타냄
- 노란색은 경고를 나타냄
- 녹색은 테스트 결과 문제가 없음을 나타냄
- 문제가 감지된 기기 수
- 문제와 관련된 스택 트레이스
- 관련 API(관련이 있는 경우)
- 테스트 중에 문제가 감지된 횟수(관련이 있는 경우)
각 문제 옆에서 더보기를 선택하면 기기 이름, 화면 크기, Android 버전, RAM, Application Binary Interface(ABI), 언어 등 문제에 관한 자세한 정보를 확인할 수 있습니다. 각 기기 모델을 선택하면 기기 사양과 더불어 테스트의 스크린샷 및 동영상, 데모 루프 결과, 스택 트레이스(다운로드도 가능함)도 표시됩니다. 일부 세부정보는 제공되지 않을 수도 있음에 유의하세요.
참고: 테스트 기기에서 사전 출시 보고서가 생성되는 동안 비정상 종료가 발생하기 때문에 비정상 종료 통계에는 영향을 미치지 않습니다.
문제가 없는 테스트 기기 보기
안정성 탭의 하단에 있는 문제가 없는 테스트 기기 표에서 어떠한 문제도 발생하지 않은 테스트에 관한 정보를 확인할 수 있습니다.
각 행에는 테스트 기기의 이름과 기기의 Android 버전, 앱에 테스트 문제가 있었는지를 알려주는 아이콘이 표시됩니다.
앱이 공개 Android SDK에 포함되어 있지 않은 인터페이스('지원되지 않는 인터페이스' 또는 'SDK가 아닌 인터페이스'라고도 함)를 하나 이상 사용하는 경우 사전 출시 보고서의 개요 및 안정성 탭에 오류 및 경고가 표시됩니다.
개별 문제 보기
사용 중인 인터페이스 중 지원되지 않는 것이 있는지 확인하려면 사전 출시 보고서에서 'OS 호환성' 오류 및 경고 옆에 있는 '문제 보기' 링크를 클릭하세요. 앱에서 특정 인터페이스가 어디에서 호출되었는지 확인하려면 인터페이스 옆에 있는 아래쪽 화살표를 클릭하여 스택 트레이스를 살펴보세요. 한 번의 테스트에서 단일 인터페이스가 여러 번 호출될 수 있습니다.
지원되지 않는 인터페이스는 심각도별로 분류됩니다. 안정성 문제를 방지하려면 지원되지 않는 인터페이스를 아예 사용하지 않는 것이 가장 좋습니다. 대신 카테고리를 활용하면 어떤 문제를 가장 먼저 해결해야 하는지 우선순위를 정할 수 있습니다.
권장 우선순위는 다음과 같습니다.
- 제한됨: 일부 또는 모든 Android 버전에서 작동하지 않는 인터페이스입니다.
- 지원되지 않지만 곧 제한됨: 작동이 보장되지 않으며 다음 Android 버전에서 제한될 인터페이스입니다.
- 지원되지 않으며 곧 제한되지 않음: 작동 여부가 보장되지 않는 인터페이스입니다.
참고: 각 카테고리에서 실행 빈도를 기준으로 인터페이스가 정렬되어 어떤 문제를 먼저 해결해야 할지 우선순위를 정하는 데 도움이 될 수 있습니다.
각 기기 모델에 따라 성능 테스트 요약에 다음과 같은 측정항목이 포함됩니다.
- 평균 초당 프레임 수: 프레임이 표시되는 평균 속도입니다.
- 참고: 평균 초당 프레임 수는 게임 루프를 사용하는 테스트에서만 확인할 수 있습니다.
- 평균 CPU: 특정 기기 모델에서 앱의 평균 CPU 사용량 백분율입니다.
- 전송된 평균 네트워크: 특정 기기 모델에서 네트워크 연결을 통해 앱이 전송한 초당 평균 바이트 수입니다.
- 수신된 평균 네트워크: 특정 기기 모델에서 네트워크 연결을 통해 앱에 수신된 초당 평균 바이트 수입니다.
- 평균 메모리: 특정 기기 모델에서 선택된 기간에 앱에서 사용한 평균 메모리입니다.
참고: 일부 이전 버전의 Android를 실행하는 테스트 기기에서는 성능 데이터를 생성하지 못할 수 있습니다.
개별 보고서 보기
각 기기 모델을 선택해 기기 사양, 성능 통계, 시간 경과에 따른 성능을 확인하고 테스트의 스크린샷과 동영상을 살펴봅니다. 또한 테스트를 통해 시간에 따라 표시된 각 측정항목의 그래프 및 기록을 확인할 수도 있습니다.
예를 들어, 테스트가 진행됨에 따라 앱의 CPU 백분율이 어떻게 변화하는지 볼 수 있습니다. CPU 사용량이 급증한 시점이 있었다면 해당 시간에 크롤러가 실행한 작업을 검토하여 문제를 해결할 수 있습니다.
일부 세부정보는 제공되지 않을 수도 있음에 유의하세요.
각 접근성 테스트 요약에는 테스트 중에 발견된 접근성 오류, 경고, 사소한 문제의 개수가 다음 카테고리별로 구분되어 있습니다.
- 콘텐츠 라벨 지정: 스크린 리더용으로 라벨이 제대로 지정되지 않은 앱 요소입니다.
- 터치 대상 크기: 권장 터치 대상 크기를 충족하지 않는 앱 요소입니다.
- 구현: 운동 장애가 있는 사용자가 사용에 어려움을 겪게 만들 수 있는 앱 레이아웃 문제입니다.
- 저대비: 앱 내 저대비 색상 문제입니다.
카테고리별로 보고서 보기
접근성 탭 상단에 있는 요약의 아래쪽으로 스크롤하면 카테고리가 지정된 섹션이 있는데 여기에는 앱에서 접근성 문제가 발견된 위치를 보여주는 화면 클러스터가 포함되어 있습니다.
- 오류가 발견되면 빨간색 아이콘이 표시됩니다.
- 경고가 발견되면 노란색 아이콘이 표시됩니다.
- 사소한 문제만 발견되면 파란색 아이콘이 표시됩니다.
- 아무 문제도 발견되지 않으면 녹색 체크표시가 나타납니다.
개별 문제 보기
화면 클러스터를 선택하면 제안사항과 함께 해당 기기 모델 이름, 운영 체제, 화면 크기, 화면 밀도 및 언어가 포함된 예제 스크린샷을 볼 수 있습니다.
앱의 접근성 개선
- 접근성 검사기를 사용하여 접근성 제안사항을 확인하는 방법을 알아보세요.
- Android 개발자 사이트에서 Android 접근성에 관한 문서를 확인하세요.
스크린샷 테스트 요약에서는 다음 항목을 확인할 수 있습니다.
- 여러 언어로 된 테스트 기기에서 앱이 어떻게 표시되는지 보여주는 이미지
- 테스트 기기의 메타데이터(모델 이름, Android 버전, 언어, 화면 해상도 및 DPI 포함)
- 스크린샷이 있는 기기 수
- Android App Bundle로 테스트할 수 없는 기기 수
- 사용할 수 없는 기기: App Bundle이 이러한 기기와 호환되지만 테스트 중 문제가 발생한 경우입니다. 테스트에 사용할 수 없는 기기가 있었다면 다른 App Bundle을 업로드하고 다시 테스트하는 것이 좋습니다.
- 호환되지 않는 기기: App Bundle이 특정 테스트 기기와 호환되지 않습니다. 다시 테스트하면 호환되지 않는 기기의 결과는 받지 못합니다.
참고: 데모 루프를 사용하여 테스트를 실행 중일 때는 스크린샷 탭에 아무런 데이터도 표시되지 않습니다.
스크린샷 보는 방법
스크린샷 탭의 오른쪽 상단에 있는 그룹화 기준 선택도구를 사용해 스크린샷 테스트 결과를 그룹화할 수 있습니다. 스크린샷을 그룹화하는 방법에는 다음 두 가지가 있습니다.
- 화면 클러스터: 화면 클러스터를 선택하여 비슷한 스크린샷이 다른 기기에 표시되는 방식을 확인합니다. 여기서는 사전 출시 보고서가 화면의 요소 또는 위젯에 따라 이미지를 그룹화합니다. 화면 클러스터가 기본적으로 선택되어 있습니다.
- 기기: 기기를 선택하여 특정 기기와 관련된 모든 스크린샷을 확인합니다. 여기서는 테스트 중에 시간 순서대로 캡처된 스크린샷을 볼 수 있습니다.
스크린샷을 선택하면 기기 사양 및 추가 정보가 표시됩니다.
언어 환경설정
특정 언어의 스크린샷을 보려면 설정 탭에서 언어 환경설정을 지정하세요.
각 테스트 요약에는 App Bundle에서 발견된 보안 취약점의 이름과 설명이 나와 있습니다.
참고: 프로덕션에 App Bundle을 게시하기 전에 발견된 모든 보안 취약점을 해결하는 것이 좋습니다.
Firebase Test Lab으로 맞춤 테스트 만들기
앱 또는 게임에 전문 테스트가 추가로 필요하다면 Firebase Test Lab을 사용하는 것이 좋습니다. Firebase 프로젝트를 만든 후 더 많은 기기 및 테스트 방법에서 기기 유형을 선택하여 맞춤 테스트를 만들 수 있습니다. 그런 다음 Firebase Console에서 맞춤 테스트를 실행하고 결과를 확인하세요. 매일 처음으로 실행하는 5~15개 테스트는 무료입니다.
관련 콘텐츠
- Play 아카데미에서 사전 출시 보고서를 사용하여 문제를 파악하는 방법을 자세히 알아보세요.