이 도움말에서는 사전 출시 보고서를 설정하고 실행하는 방법을 설명합니다. 사전 출시 보고서를 실행했는데 결과를 어떻게 해석해야 할지 알아보려면 사전 출시 보고서 이해로 이동하세요.
내부용, 비공개 또는 공개 테스트에 앱을 게시하면 사전 출시 보고서가 자동으로 생성됩니다. 보고서를 통해 앱이 사용자에게 도달하기 전에 문제를 식별할 수 있습니다. 여기에는 다음에 대한 테스트가 포함됩니다.
- 안정성 문제
- Android 호환성 문제
- 성능 문제
- 접근성 문제
- 보안 취약점
- 개인 정보 보호 문제
사전 출시 보고서 생성 과정
테스트 Android App Bundle을 업로드하고 게시하면 Google에서 Test Lab의 Android 기기에 Android App Bundle을 설치합니다. 그런 다음 몇 분 동안 앱을 자동으로 실행하고 크롤링합니다. 크롤러는 입력, 탭, 스와이프와 같은 기본적인 동작을 수행합니다. 크롤러가 사용할 맞춤 테스트 또는 테스트 계정 사용자 인증 정보를 제공해주셔도 됩니다.
크롤링이 완료되면 사전 출시 보고서에 결과를 컴파일합니다. 또한 모든 기기에서 앱을 제거합니다.
앱이 사전 출시 보고서에 적합한지 평가
사전 출시 보고서는 앱을 설치하고 '크롤링'만 할 수 있으면 작동합니다. 하지만 일부 앱은 약간의 코드 수정이 필요할 수 있습니다. 일반적인 예로 국가 확인 또는 설치 확인이 필요한 앱이 있습니다. 자세한 내용은 자주 묻는 질문(FAQ)을 참고하세요.
테스트 기기는 런처, 위젯, 키보드, 시계 화면 등 기본 실행 활동이 없는 앱에서는 테스트를 실행할 수 없습니다.
사전 출시 보고서 실행
앱 테스트앱의 사전 출시 보고서를 생성하려면 비공개 또는 공개 테스트 트랙에 앱을 게시하세요.
테스트 트랙에 게시하는 앱에 대한 사전 출시 보고서는 보고서를 사용 중지하지 않는 한 자동으로 전송됩니다. 일반적으로 App Bundle을 업로드한 후 1시간 이내에 테스트 결과가 전송됩니다. 하지만 업로드하고 몇 시간 후에 결과를 받는 경우도 있습니다.
다음 단계에 따라 사용 가능한 사전 출시 보고서에 관한 이메일 알림을 받을 수 있습니다.
- Play Console > 알림을 엽니다.
- '사전 출시 보고서'까지 아래로 스크롤한 다음 그 옆에 있는 체크박스를 선택합니다. 모든 테스트와 관련된 이메일을 수신하거나 테스트에 문제가 있는 경우에만 수신하도록 선택할 수 있습니다.
사전 출시 보고서는 비공개 또는 공개 테스트 트랙에 앱을 게시하면 자동으로 생성됩니다. 앱의 모든 사전 출시 보고서를 사용 중지하려면 다음 단계를 따르세요.
- Play Console > 사전 출시 보고서 > 설정을 엽니다.
- '환경설정'까지 아래로 스크롤한 다음 '사전 출시 보고서 사용 설정' 체크박스를 선택 해제하여 앱에 대한 보고서를 사용 중지합니다.
- 저장을 클릭합니다.
테스트 맞춤설정
테스트를 맞춤설정하면 더 포괄적이며 앱과 관련성이 높은 사전 출시 보고서를 확인할 수 있습니다.
1단계: 앱에 로그인 화면이 있는 경우 테스트 계정 정보 제공
앱에 로그인 화면이 있고 크롤러가 로그인 프로세스 또는 로그인 후 제공되는 콘텐츠를 테스트하도록 하려면 계정 사용자 인증 정보를 제공해야 합니다.
참고: 앱에서 'Google 계정으로 로그인'(크롤러의 자동 로그인을 허용함)을 지원하거나 이미 앱 콘텐츠 페이지에서 사용자 인증 정보를 제공한 경우 사용자 인증 정보를 제공할 필요가 없습니다.
사용자 인증 정보를 테스트할 때 기억해야 할 몇 가지 중요한 사항은 다음과 같습니다.
- 제공하는 사용자 인증 정보는 테스트 목적으로만 사용됩니다.
- Google은 테스트용 사용자 인증 정보를 안전하게 보호하기 위해 최선을 다하지만 사전 출시 보고서에 공식 사용자 인증 정보는 추가하지 않는 것이 좋습니다. 대신 테스트 계정용 사용자 이름 및 비밀번호를 만드세요.
- 사용자 인증 정보는 표준 Android 위젯을 사용하는 Android 앱에만 자동으로 삽입될 수 있습니다. OpenGL을 사용하여 맞춤 컨트롤을 렌더링하는 앱 또는 웹 기반의 인증 절차로 WebView를 사용하는 앱에는 사용자 인증 정보를 사용할 수 없습니다.
- 앱에서 'Google 계정으로 로그인'을 지원하면 Google에서 자동으로 로그인합니다.
- Play Console을 엽니다.
- 앱을 선택합니다.
- 왼쪽 메뉴에서 테스트 > 사전 출시 보고서 > 설정을 선택합니다.
- '테스트 계정 사용자 인증 정보' 섹션에서 사용자 인증 정보 제공을 선택합니다.
- 다음 정보를 입력합니다.
- 사용자 이름: 테스트 계정의 사용자 이름입니다.
- 비밀번호: 테스트 계정의 비밀번호입니다.
- 저장을 클릭합니다. 이 사용자 인증 정보는 수정하지 않는 한 이후 모든 테스트에 사용됩니다.
- Play Console을 엽니다.
- 앱을 선택합니다.
- 왼쪽 메뉴에서 테스트 > 사전 출시 보고서 > 설정을 선택합니다.
- 원하는 대로 수정합니다.
- 사용자 인증 정보 수정: '테스트 계정 사용자 인증 정보' 섹션에서 사용자 이름 및 비밀번호 입력란에 업데이트된 사용자 인증 정보를 입력합니다.
- 사용자 인증 정보 삭제: '테스트 계정 사용자 인증 정보' 섹션에서 사용자 인증 정보 제공 안함을 선택합니다.
- 참고: 앱의 테스트용 사용자 인증 정보를 삭제하면 향후 테스트에서 앱에 로그인하기 전에 새 사용자 인증 정보를 추가해야 합니다.
- 저장을 클릭합니다. 이 사용자 인증 정보는 수정하지 않는 한 이후 모든 테스트에 사용됩니다.
2단계: Robo 스크립트 또는 게임 루프 제공
앱을 테스트할 때 크롤러가 수행하는 단계를 제어하려면 Robo 스크립트 또는 게임 루프를 제공하면 됩니다.
Robo 스크립트를 제공하여 Java 앱의 테스트 경로 맞춤설정앱을 테스트할 때 Robo 스크립트를 제공하여 일반적인 사용자 경험이나 앱의 새 섹션 테스트와 같은 특정 작업을 수행함으로써 크롤러의 테스트 단계를 제어할 수 있습니다.
첨부된 스크립트로 테스트를 실행하면 크롤러는 사전 스크립팅된 작업을 먼저 실행한 다음 평상시처럼 앱을 탐색합니다.
사전 출시 보고서에 스크립트를 업로드하려면 다음 단계를 따르세요.
- Android 스튜디오의 Firebase 도구를 사용하여 스크립트를 기록합니다(Android 스튜디오 > Tools > Firebase > Test Lab > Record Robo Script). 자세한 내용은 Firebase 고객센터를 참고하세요.
- 참고: Robo 스크립트를 만들 때 Firebase 계정은 필요하지 않습니다.
- 스크립트가 준비되면 Play Console을 엽니다.
- 앱을 선택합니다.
- 테스트 > 사전 출시 보고서 > 설정을 선택합니다. '사전 출시 보고서에서 내 앱을 탐색하는 방법 조정' 섹션에서 스크립트를 업로드합니다. 파일을 드래그 앤 드롭하거나 업로드를 선택할 수 있습니다.
- 저장을 클릭합니다.
OpenGL을 사용하는 게임이나 앱을 테스트하는 경우 좋은 사전 출시 보고서를 얻으려면 게임 루프를 제공해야 합니다. 게임 루프는 크롤러가 수행할 작업을 정의합니다. 한 앱에서 두 개 이상의 게임 루프를 테스트할 수 있습니다.
사전 출시 보고서에서 게임 루프를 사용하려면 다음 단계를 따르세요.
- 다음 단계를 따르도록 게임을 수정합니다.
- 루프 시작
- 루프 실행
- 루프를 닫습니다(선택사항). 이러한 설정은 개발 환경에서 변경합니다. 자세한 내용은 Firebase 고객센터를 참고하세요.
- 참고: 사전 출시 보고서에서 게임 루프를 사용할 때 Firebase 계정은 필요하지 않습니다.
- 게임 루프가 포함된 게임 버전을 비공개 또는 공개 테스트 트랙에 게시합니다. 크롤러는 자동으로 게임 루프를 감지하고 실행합니다.
3단계: 딥 링크로 테스트 시작점 맞춤설정
사전 출시 보고서에 최대 3개의 딥 링크를 추가하여 앱의 추가 진입점을 테스트할 수 있습니다.
크롤러는 평소처럼 몇 분 동안 작동한 후 앱을 닫고 각 딥 링크를 방문하여 30초 동안 더 크롤링합니다. 이러한 추가 크롤링 중에 발견된 모든 문제는 정상적으로 보고서에 포함됩니다.
앱의 딥 링크를 만들고 테스트하는 방법을 알아보려면 Android 개발자 사이트를 방문하세요.
4단계: 특정 언어의 테스트 보고서 보기
특정 언어의 테스트 결과를 보려면 사전 출시 보고서 설정 페이지에서 언어 환경설정을 지정하면 됩니다. 최대 5개의 언어를 선택할 수 있습니다.
도움말: 테스트 App Bundle을 업로드하면 사전 출시 보고서가 자동으로 실행되므로 초기 테스트가 완료된 후에만 언어 환경설정을 추가할 수 있습니다.
언어 환경설정- Play Console을 엽니다.
- 앱을 선택합니다.
- 왼쪽 메뉴에서 테스트 > 사전 출시 보고서 > 설정을 선택합니다.
- '특정 언어로 앱 테스트'에서 + 언어 추가를 선택합니다.
- 최대 5개의 언어를 선택합니다. 이후 테스트에서는 선택한 언어의 테스트 결과만 표시됩니다.
- 참고: 언어를 선택하지 않으면 설치수가 가장 많은 언어가 자동으로 선택됩니다.
- 저장을 클릭합니다.
사전 출시 보고서 보기
사전 출시 보고서가 제공되면 테스트 중에 발견된 오류, 경고, 사소한 문제의 개수가 포함된 테스트 요약을 확인할 수 있으며, 문제 유형별로 분류되어 있습니다. 또한 앱의 테스트 결과에 따른 출시 제안사항이 표시됩니다.
사전 출시 보고서 요약 보기사전 출시 보고서 요약을 보려면 다음 단계를 따르세요.
- Play Console을 엽니다.
- 앱을 선택합니다.
- 테스트 > 사전 출시 보고서 > 개요를 선택합니다.
- 각 섹션을 검토합니다.
- 안정성
- 성능
- 접근성
- 보안 및 신뢰
- 문제가 있는 섹션이 있는 경우 요약 표시를 선택하여 펼칩니다.
- 세부정보 보기를 선택하면 문제에 대한 자세한 정보를 볼 수 있습니다.
- 이전의 사전 출시 보고서를 보려면 페이지 하단의 '보고서 세부정보' 섹션에 있는 표로 스크롤합니다.
참고: '테스트 진행 중'이 표시되는 경우 최근에 실시한 테스트가 아직 끝나지 않은 것입니다. 최근 테스트가 실행되지 못한 경우 '테스트 실패'가 표시될 수 있습니다. 다른 테스트를 실행하려면 다른 App Bundle을 게시하세요.
사전 출시 보고서의 자세한 결과를 보려면 다음 단계를 따르세요.
- Play Console을 엽니다.
- 앱을 선택합니다.
- 테스트 > 사전 출시 보고서 > 세부정보를 선택합니다.
- 안정성, 성능, 접근성, 스크린샷, 보안 및 신뢰 탭을 검토합니다. 각 페이지에는 스택 트레이스, 스크린샷, 차트를 포함한 최근 테스트 결과의 전체 세부정보가 표시됩니다.
참고: '테스트 진행 중'이 표시되는 경우 최근에 실시한 테스트가 아직 끝나지 않은 것입니다. 최근 테스트가 실행되지 못한 경우 '테스트 실패'가 표시될 수 있습니다. 다른 테스트를 실행하려면 다른 App Bundle을 게시하세요.
자주 묻는 질문(FAQ)
앱 테스트
테스트는 얼마나 걸리나요?일반적으로 App Bundle을 업로드한 후 1시간 이내에 테스트 결과가 전송됩니다. 하지만 업로드하고 몇 시간 후에 결과를 받는 경우도 있습니다. 2일 후에도 보고서가 완료되지 않으면 아티팩트를 다시 업로드 해보세요. 이렇게 하면 새 보고서가 실행됩니다.
출시 확인을 실행하는 앱
국가 확인을 수행하는 앱의 사전 출시 보고서를 실행할 수 있나요?코드를 약간 수정해도 괜찮다면 사전 출시 보고서를 받을 수 있습니다.
테스트 기기는 미국에 있습니다. 앱이 위치정보를 사용하거나 국가에 따른 콘텐츠 제약이 있는 경우, 테스트 기기는 위치한 지역에 제공되는 콘텐츠만 표시합니다.
테스트 기기가 위치한 곳 이외 지역에서 앱을 테스트해야 할 경우 테스트를 위해 위치 요구사항을 삭제한 App Bundle을 게시하면 됩니다. Test Lab에서 사전 출시 보고서가 실행 중인지 확인할 방법은 두 가지가 있습니다.
- Firebase Test Lab 개요에 설명된 IP 주소 차단 항목을 허용 목록에 추가합니다.
- 시스템 변수를 추가하여 Test Lab의 계측 테스트 도구 작동 수정을 확인합니다.
테스트 플랫폼에서는 기기가 Android에서 특별한 제어 권한(루팅 액세스)을 갖고 있는지 확인하는 앱을 지원하지 않습니다.
광고 또는 구매 옵션이 있는 앱
앱에 광고가 표시됩니다. 사전 출시 보고서 테스트가 내 노출수나 클릭수에 영향을 주지 않는지 어떻게 확인할 수 있나요? 광고 네트워크에서 내 노출수나 클릭수를 감지하여 이를 마땅치 않게 여길 수도 있습니다.Google 광고에서는 이미 사전 출시 보고서 IP 주소 범위가 트래픽에서 제외되었습니다. 다른 광고 네트워크의 경우 제외할 IP 주소 범위를 지정해야 합니다.
자동화된 앱 테스트로 허위 광고 수익을 줄이는 방법을 자세히 알아보려면 Google Developers 사이트를 확인하시기 바랍니다.
테스트 기기는 테스트 중에 구매를 할 수 없습니다. 앱이 앱의 일부분에 액세스하는 구독이나 인앱 상품을 제공하는 경우 테스트 시나리오에 제약이 있을 수 있습니다.
기타 앱 동작
코드가 난독화(Java) 또는 제거(네이티브)되었습니다. 그래도 사전 출시 보고서를 사용할 수 있나요?예. 사전 출시 보고서 테스트는 이와 관계없이 실행됩니다.
하지만 앱이 난독화되거나 제거되면 테스트 중에 발견된 비정상 종료나 ANR에도 난독화 또는 제거된 스택 트레이스가 포함됩니다. 스택 트레이스를 더 쉽게 디버그할 수 있도록 가독화 또는 기호화 파일을 업로드하는 것이 좋습니다.
가독화 또는 기호화 파일을 업로드하는 방법을 자세히 알아보세요.
아니요. 테스트 플랫폼은 기기에 미디어 또는 사전 설치된 앱을 사전 로드하는 작업을 지원하지 않습니다.
사전 로드된 데이터와 함께 앱에서 테스트를 실행하려면 App Bundle에 미디어 파일을 삽입하여 앱의 테스트 버전을 게시하세요.
앱이 공개 테스트 중이거나 프로덕션에 게시된 경우 사전 출시 보고서 테스트에서 앱 라이선스가 있는 것처럼 작동하는 ID를 사용하게 됩니다.
앱이 공개 테스트 중이 아니거나 활성화된 App Bundle이 프로덕션에 게시되지 않은 경우 앱에서 라이선스 확인을 할 수 없습니다. 사전 출시 보고서 결과는 계속 수신되지만 앱은 라이선스가 없는 상태입니다. 이러한 앱의 테스트를 실행하려면 라이선스 서비스를 사용 중지한 상태에서 앱의 비공개 버전을 게시하면 됩니다.
테스트 기기는 기본적으로 고정된 세로 페이지 방향에서 테스트를 실행하도록 사전 설정되어 있습니다. 하지만 앱이 가로 모드로 고정되어 있으면 동영상과 스크린샷이 가로 모드로 표시됩니다.
기기 선택
앱 테스트에 사용할 기기는 어떻게 결정하나요?Google은 생태계 전반의 다양한 기기를 포함하도록 테스트 기기를 선택하며 기기 인기도, 비정상 종료 빈도, 화면 해상도, 제조업체, Android OS 버전 등을 고려합니다. 선택된 테스트 기기는 상황에 따라 다를 수 있습니다.
앱 매니페스트에서 일부 기기 타겟팅을 제외한 경우 사전 출시 보고서도 테스트에서 관련 기기를 제외합니다. 하지만 앱의 추가 기기를 타겟팅하지는 않습니다.
사전 출시 보고서는 Firebase Test Lab에서 제공합니다. 테스트 대상 기기를 맞춤설정하려면 Firebase Console에서 자체 테스트를 수행해보세요.
예, 실제 기기에서와 마찬가지로 에뮬레이터에서 앱을 실행하고 크롤링합니다.
기기 설정은 스마트폰, 태블릿, Wear OS, Chromebook과 같은 데스크톱 기기에 적용됩니다. Android Auto 또는 Android TV 기기에서 직접 앱을 테스트할 수는 없습니다.
기기 설정에는 Android 9 이상 기기가 포함됩니다.