Android 앱 자동 테스트

이 가이드에서는 Firebase Console에서 App Distribution 자동 테스터 기능을 사용하여 빌드를 자동으로 테스터에 배포하는 방법을 설명합니다. 자동 테스터 기능은 앱에 항상 사용할 수 있고 사용하기 쉬운 스모크 테스트 도구를 제공합니다.

시작하기 전에

아직 추가하지 않았다면 Android 프로젝트에 Firebase를 추가합니다.

다른 Firebase 제품을 사용하지 않는 경우 프로젝트를 만들고 앱을 등록하기만 하면 됩니다. 그러나 이후에 추가 제품을 사용할 경우에는 Firebase Console을 사용하여 Firebase 추가의 모든 단계를 완료해야 합니다.

앱의 출시 전 버전을 테스터에게 배포할 준비가 되면 일반적인 프로세스에 따라 APK를 빌드합니다. 디버그 키 또는 앱 서명 키를 사용하여 APK를 서명해야 합니다.

Firebase Console을 사용하여 자동 테스터에 앱 배포

앱을 자동 테스터에 배포하려면 Firebase Console을 사용하여 APK 파일을 업로드합니다.

Firebase Console의 App Distribution 페이지를 엽니다. 메시지가 표시되면 Firebase 프로젝트를 선택합니다.
출시 페이지의 드롭다운 메뉴에서 배포할 앱을 선택합니다.
앱의 APK 파일을 Console로 드래그하여 업로드합니다.
업로드가 완료되면 테스터 또는 그룹 추가 검색창에서 자동 테스터를 선택합니다.
자동 테스트를 맞춤설정하려면 수정 아이콘을 클릭하고 자동 테스트 맞춤설정 대화상자에서 맞춤설정을 선택합니다.
(선택사항) 기기 구성 대화상자에서 테스트 사양을 충족하는 API 수준, 기기 방향, 언어를 선택합니다.
(선택사항) 앱에서 로그인 사용자 인증 정보가 필요한 경우 로그인 사용자 인증 정보 드롭다운 메뉴를 클릭하여 테스트 중에 사용할 수 있는 커스텀 사용자 이름과 비밀번호를 만듭니다.
배포를 클릭합니다. 앱의 선택적 출시 노트를 추가할 수도 있습니다.

Firebase CLI를 사용하여 자동 테스터에 앱 배포

appdistribution:distribute 명령어를 실행하여 앱을 업로드하고 테스터에게 배포합니다. 다음 파라미터를 사용하여 자동 테스터 기능에 대한 배포를 구성합니다.

appdistribution:distribute 옵션
`--test-devices` 또는 `--test-devices-file`	빌드를 자동 테스터 기능에 배포하려는 테스트 기기입니다. 테스트 기기를 세미콜론으로 구분된 테스트 기기 목록으로 지정할 수 있습니다. `--test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` 또는 세미콜론으로 구분된 테스트 기기 목록이 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. `--test-devices-file: "/path/to/test-devices.txt"`
`--test-username`	자동 테스트 중에 사용할 자동 로그인의 사용자 이름입니다.
`--test-password` 또는 `--test-password-file`	자동 테스트 중에 사용할 자동 로그인 비밀번호입니다. 또는 비밀번호가 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. `--test-password-file: "/path/to/test-password.txt"`
`--test-username-resource`	자동 테스트 중에 사용할 자동 로그인 사용자 이름 필드의 리소스 이름입니다.
`--test-password-resource`	자동 테스트 중에 사용할 자동 로그인 비밀번호 필드의 리소스 이름입니다.
`--test-non-blocking`	자동 테스트를 비동기식으로 실행합니다. Firebase Console로 이동하여 자동 테스트 결과를 확인합니다.

Firebase CLI를 시작하는 방법과 배포를 구성하는 다양한 방법에 대한 자세한 내용은 Firebase CLI를 사용하여 테스터에 Android 앱 배포를 참조하세요.

Gradle을 사용하여 자동 테스터에 앱 배포

firebaseAppDistribution 섹션을 최소 하나 이상 추가하여 App Distribution을 구성하고 다음 파라미터를 사용하여 자동 테스터 기능에 대한 배포를 구성할 수 있습니다.

App Distribution 빌드 파라미터
`testDevices` 또는 `testDevicesFile`	자동 테스트를 사용하기 위해 빌드를 배포할 테스트 기기입니다. 테스트 기기를 세미콜론으로 구분된 기기 사양 목록으로 지정할 수 있습니다. `testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` 또는 세미콜론으로 구분된 기기 사양 목록이 포함된 파일의 경로를 지정할 수 있습니다. `testDevicesFile="/path/to/testDevices.txt"`
`testUsername`	자동 테스트 중에 사용할 자동 로그인의 사용자 이름입니다.
`testUsernameResource`	자동 테스트 중에 사용할 자동 로그인 사용자 이름 필드의 리소스 이름입니다.
`testPassword` 또는 `testPasswordFile`	자동 테스트 중에 사용할 자동 로그인 비밀번호입니다. 또는 비밀번호가 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. testPasswordFile="/path/to/testPassword.txt"
`testPasswordResource`	자동 테스트 중에 사용할 자동 로그인 비밀번호 필드의 리소스 이름입니다.
`testNonBlocking`	자동 테스트를 비동기식으로 실행합니다. Firebase Console로 이동하여 자동 테스트 결과를 확인합니다.

Gradle을 시작하는 방법과 배포를 구성하는 다양한 방법에 대한 자세한 내용은 Gradle을 사용하여 테스터에 Android 앱 배포를 참조하세요.

fastlane을 사용하여 자동 테스터에 앱 배포

./fastlane/Fastfile 레인에서 firebase_app_distribution 블록을 추가합니다. 다음 파라미터를 사용하여 자동 테스터 기능에 대한 배포를 구성합니다.

firebase_app_distribution 매개변수
`test_devices` 또는 `test_devices_file`	빌드를 자동 테스터 기능에 배포하려는 테스트 기기입니다. 테스트 기기를 세미콜론으로 구분된 테스트 기기 목록으로 지정할 수 있습니다. `test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` 또는 세미콜론으로 구분된 테스트 기기 목록이 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. `test_devices_file: "/path/to/test-devices.txt"`
`test_username`	자동 테스트 중에 사용할 자동 로그인의 사용자 이름입니다.
`test_password` 또는 `test_password_file`	자동 테스트 중에 사용할 자동 로그인 비밀번호입니다. 또는 비밀번호가 포함된 일반 텍스트 파일의 경로를 지정할 수 있습니다. `test_password_file: "/path/to/test-password.txt"`
`test_username_resource`	자동 테스트 중에 사용할 자동 로그인 사용자 이름 필드의 리소스 이름입니다.
`test_password_resource`	자동 테스트 중에 사용할 자동 로그인 비밀번호 필드의 리소스 이름입니다.
`test_non_blocking`	자동 테스트를 비동기식으로 실행합니다. Firebase Console로 이동하여 자동 테스트 결과를 확인합니다.

fastlane을 시작하는 방법과 배포를 구성하는 다양한 방법에 대한 자세한 내용은 fastlane을 사용하여 테스터에 Android 앱 배포를 참조하세요.

자동 테스트 크롤링 상태

테스트 결과를 해석하는 데 도움이 되도록 자동 테스트 결과 탭에는 테스트 문제, 앱 스크린샷, 각 기기의 테스트 크롤링 동영상이 표시됩니다. 테스트 결과 페이지에서 테스트 상태를 확인할 수 있습니다.

크롤링 상태	설명
대기 중	자동 테스트가 아직 실행 중이며 곧 결과를 확인할 수 있습니다.
통과	자동 테스트에서 앱을 성공적으로 크롤링했으며 비정상 종료가 발견되지 않았습니다.
실패	테스트 중에 앱이 비정상 종료되어 자동 테스트가 실패했습니다.
완료되지 않음	인프라 오류로 인해 자동 테스트가 실패했습니다.