이 가이드에서는 Android App Bundle(AAB)을 App Distribution에 업로드하고 Firebase Console을 사용하여 생성된 APK를 배포하는 방법을 설명합니다.
App Distribution은 Google Play의 내부 앱 공유 서비스와 통합되어 업로드한 AAB를 처리하고 테스터 기기 구성에 최적화된 APK를 제공합니다. AAB를 배포하면 다음을 수행할 수 있습니다.
- 테스터의 기기에 최적화된 APK(Google Play에서 제공)를 실행합니다. 
- 기기별 문제를 발견하고 디버깅합니다. 
- Play Feature Delivery 및 Play Asset Delivery와 같은 App Bundle 기능을 테스트합니다. 
- 테스터를 위해 다운로드 크기를 줄입니다. 
필수 권한
AAB를 App Distribution에 업로드하려면 Firebase 앱을 Google Play의 앱에 연결해야 합니다. 이 작업을 수행하려면 필요한 수준의 액세스 권한이 있어야 합니다.
필요한 Firebase 액세스 권한이 없으면 Firebase 프로젝트 소유자에게 Firebase Console IAM 설정을 통해 관련 역할을 할당해 달라고 요청할 수 있습니다. 소유자 찾기 또는 할당을 포함한 Firebase 프로젝트에 액세스하는 방법에 대한 궁금한 점이 있으면 'Firebase 프로젝트의 권한 및 액세스' FAQ를 참조하세요.
다음 표는 Firebase 앱을 Google Play의 앱에 연결하고 AAB를 업로드하는 데 적용됩니다.
| Firebase Console의 작업 | 필수 IAM 권한 | 기본적으로 필요한 권한이 포함된 IAM 역할 | 추가로 필요한 역할 | 
|---|---|---|---|
| Firebase 앱을 Google Play의 앱에 연결 | firebase.playLinks.update | 다음 역할 중 하나: | 관리자로 Google Play 개발자 계정에 액세스 | 
| App Distribution에 AAB 업로드 | firebaseappdistro.releases.update | 다음 역할 중 하나: | –– | 
시작하기 전에
- 아직 추가하지 않았으면 Android 프로젝트에 Firebase를 추가합니다. 이 워크플로를 완료하면 Firebase 프로젝트에 Firebase Android 앱이 등록됩니다. - 다른 Firebase 제품을 사용하지 않는 경우 프로젝트를 만들고 앱을 등록하기만 하면 됩니다. 추가 제품을 사용할 경우에는 Android 프로젝트에 Firebase 추가의 모든 단계를 완료해야 합니다. 
- Google Play에 대한 Firebase 링크를 만들고 AAB를 업로드하려면 앱이 다음 요구사항을 충족하는지 확인합니다. - Google Play의 앱과 Firebase Android 앱은 모두 동일한 패키지 이름을 사용하여 등록되어 있습니다. 
- Google Play의 앱은 앱 대시보드에 설정되어 Google Play 트랙(내부 테스트, 비공개 테스트, 공개 테스트 또는 프로덕션) 중 하나에 배포되어 있습니다. 
- Google Play에서 앱 검토가 완료되고 앱이 게시되어 있습니다. 앱 상태 열에 내부 테스트(초안 내부 테스트 아님), 비공개 테스트, 공개 테스트 또는 프로덕션 상태 중 하나가 표시되면 앱이 게시됩니다. 
 
- Firebase Android 앱을 Google Play 개발자 계정에 연결합니다. - Firebase Console에서 - 프로젝트 설정 으로 이동한 후 통합 탭을 선택합니다.
- Google Play 카드에서 연결을 클릭합니다. 
 이미 Google Play 링크가 있다면 관리를 클릭합니다.
- 화면에 표시된 안내에 따라 App Distribution 통합을 사용 설정하고 Google Play에 연결할 Firebase Android 앱을 선택합니다. 
 - Google 애널리틱스 연결에 대해 자세히 알아보세요. 
1단계: 앱 빌드
앱의 출시 전 버전을 테스터에게 배포할 준비가 되면 AAB를 빌드합니다. 자세한 내용은 Android 스튜디오 문서를 참조하세요.
2단계: 테스터에게 앱 배포
앱을 테스터에 배포하려면 Firebase Console을 사용하여 AAB 파일을 업로드합니다.
- Firebase Console의 App Distribution 페이지를 엽니다. 메시지가 표시되면 Firebase 프로젝트를 선택합니다. 
- 출시 페이지의 드롭다운 메뉴에서 배포할 앱을 선택합니다. 
- 앱의 AAB 파일을 Console로 드래그하여 업로드합니다. 
- 업로드가 완료되면 빌드를 수신할 테스터 그룹과 개별 테스터를 지정합니다. 그런 다음 빌드에 대한 출시 노트를 추가합니다. - 테스터 그룹을 만드는 방법에 대한 자세한 내용은 테스터 관리를 참조하세요. 
- 테스터가 빌드를 사용할 수 있게 하려면 배포를 클릭합니다. 테스터는 앱을 테스트하라는 이메일 초대를 자동으로 수신하게 됩니다. 
- (선택사항) 특정 출시 버전의 링크를 해당 출시 버전에 대한 액세스 권한이 있는 테스터와 공유하려면 링크 아이콘을 클릭하여 출시 버전의 링크를 클립보드에 복사합니다. 
빌드를 배포한 후에는 Firebase Console의 App Distribution 대시보드에서 150일(5개월) 동안 사용할 수 있습니다. 빌드가 만료되기 30일 전부터 Console 및 테스트 기기의 빌드 테스트 목록 모두에 만료 알림이 표시됩니다.
신규 테스터는 앱 테스트를 시작할 수 있는 이메일 초대를 받으며 기존 테스터는 새 빌드가 테스트될 준비가 완료되었다는 이메일 알림을 받습니다. 테스트 앱을 설치하는 방법은 App Distribution을 사용하여 테스터로 설정을 참조하세요. Firebase Console에서 각 테스터 상태(초대 수락 여부, 앱 다운로드 여부 등)를 모니터링할 수 있습니다.
테스터는 초대 유효 기간(30일) 만료 전에 앱 테스트를 수락해야 합니다. 초대 유효 기간이 만료되기 5일 전부터 Firebase Console의 출시 버전 테스터 옆에 만료 알림이 표시됩니다. 테스터 행의 드롭다운 메뉴를 사용하여 초대를 재전송하면 갱신할 수 있습니다.
다음 단계
- 테스터가 앱에 대한 의견(스크린샷 포함)을 쉽게 보낼 수 있도록 인앱 의견을 구현하세요. 
- 앱의 새 빌드를 설치할 수 있게 될 때 테스터에게 인앱 알림을 표시하는 방법을 알아보세요. 
- CI/CD를 사용하여 Android 앱을 QA 테스터에 배포할 때의 권장사항을 알아보세요.