1. 개요
이 Codelab에서는 Firebase 앱 배포 및 Gradle 플러그인을 사용하여 테스터에게 Android App Bundle 출시를 배포하는 방법을 알아봅니다. 앱 배포는 앱의 시험판 버전과 각 릴리스에 초대하는 테스터를 관리할 수 있는 중앙 허브를 제공합니다.
무엇을 배울 것인가
- Firebase 앱을 Google Play에 연결하는 방법
- 앱을 App Bundle로 패키징하고 빌드하는 방법
- 릴리스를 생성하고 실시간 테스터와 공유하는 방법
- 테스터로서 새 릴리스를 다운로드하고 테스트하는 방법
필요한 것
- 최신 Android 스튜디오 버전
- Android Studio에서 생성한 서명된 번들 파일
- 귀하가 소유자 또는 관리자인 Google Play 개발자 계정
- Google Play의 앱은 Google Play 앱 대시보드에 설정되어 있으며 상태는 다음과 같습니다.
- 앱은 Google Play 트랙(내부 테스트, 비공개 테스트, 공개 테스트 또는 프로덕션) 중 하나에 배포됩니다.
- Google Play에서 앱 검토가 완료되고 앱이 게시됩니다. 앱 상태 열에 내부 테스트(초안 내부 테스트 아님), 비공개 테스트, 공개 테스트 또는 프로덕션 상태 중 하나가 표시되면 앱이 게시된 것입니다.
- Firebase로부터 새 빌드 초대를 받기 위해 테스터로 사용할 수 있는 이메일 주소
2. Firebase 프로젝트 만들기
- Firebase 에 로그인합니다.
- Firebase 콘솔에서 프로젝트 추가를 클릭한 다음 프로젝트 이름을 "AppBundlesCodelab"으로 지정합니다. Firebase 프로젝트의 프로젝트 ID를 기억하세요. 프로젝트 ID를 수정하지 않으면 Firebase가 자동으로 프로젝트에 고유한 ID를 할당합니다.
- (선택사항) 메시지가 표시되면 Google Analytics를 활성화합니다.
- 나머지 단계를 완료한 후 프로젝트 만들기 를 클릭하세요.
프로젝트에 App Bundle 추가
- Firebase 콘솔에서 앱 추가를 클릭합니다.
- 앱을 등록할 때 Google Play 개발자 계정에 업로드된 앱과 동일한 패키지 이름을 사용해야 합니다. 마지막으로 앱 등록 을 클릭합니다.
- 앱의 Firebase 구성 파일(
google-services.json
)을 앱에 추가하려면 나머지 단계를 완료하세요. Android의 경우 앱 배포에는 앱에 추가할 Firebase SDK가 없습니다. - 계속해서 콘솔을 클릭하세요.
구글 플레이 링크
- Firebase 콘솔에서 프로젝트 설정 으로 이동합니다.
- 통합 탭에서 Google Play 카드의 링크를 클릭하세요.
- 화면의 지시에 따라 앱 배포 통합을 활성화한 다음 새로 생성된 Firebase 앱을 선택하여 Google Play에 연결하세요.
이제 이 단계를 완료했으므로 앱의 패키지 이름이 일치하는 한 Firebase 앱이 Google Play 개발자 계정의 앱에 연결됩니다.
3. 프로젝트에 앱 배포 추가
앱 배포 Gradle 플러그인 추가
이제 Android Studio를 사용하여 앱 배포 및 Gradle 플러그인을 앱에 추가하겠습니다.
- 프로젝트 수준 Gradle 파일(
android/build.gradle.kts
)에서 앱 배포 Gradle 플러그인을plugins
블록에 추가합니다.plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false }
- 프로젝트 수준 설정 Gradle 파일(
android/settings.gradle.kts
)에서 Google의 Maven 저장소를pluginManagement
블록에 추가합니다.pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } }
- 앱 수준 Gradle 파일(
android/app/build.gradle.kts
)에서 앱 배포 플러그인을plugins
블록에 추가합니다.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- 기업 프록시 또는 방화벽 뒤에 있는 경우 앱 배포가 Firebase에 배포를 업로드할 수 있도록 다음 Java 시스템 속성을 추가하세요.
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Firebase 프로젝트 인증
Gradle 플러그인을 사용하려면 먼저 Firebase 프로젝트를 인증해야 합니다. 이 Codelab에서는 Firebase CLI를 사용하여 Google 계정에 로그인합니다.
Android 프로젝트 루트에서 다음 명령을 실행합니다.
~/your-android-project$ firebase login
참조 문서에 자세한 내용이 포함되어 있습니다.
4. Android Studio에서 번들 속성 구성
이 단계에서는 나중에 배포할 빌드의 테스터로 자신을 추가합니다. 빌드를 배포하면 테스터는 Firebase로부터 새 빌드를 테스트하도록 초대하는 이메일 알림을 받습니다.
app/build.gradle.kts
에서 firebaseAppDistribution
섹션을 추가하고 다음 매개변수를 포함합니다.
-
appID
: 앱의 Firebase 앱 ID입니다. 프로젝트 설정 의 일반 탭 에서 찾을 수 있습니다. -
artifactType
: 앱의 파일 형식(AAB
)입니다. -
testers
: 테스터의 이메일 주소입니다. 이 Codelab에서는 빌드가 배포된 후 테스트할 수 있도록 자신의 이메일을 추가하세요.
예를 들어:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
선택적으로 -PappDistribution- property-name = property-value
형식으로 명령줄 인수를 전달하여 build.gradle.kts
에 설정된 값을 재정의할 수도 있습니다.
5. 릴리스 빌드 및 배포
-
bundle Variant
Gradle 작업을 실행하여 App Bundle 파일 빌드:$ ./gradlew :base:bundleRelease
- 애플리케이션의 빌드 디렉터리(기본 위치는
app/build/outputs/bundle/release
)에서 번들을 찾습니다. - 릴리스를 배포하려면 프로젝트의 Gradle 래퍼를 사용하여 타겟
bundleRelease
및appDistributionUploadRelease
빌드하세요. Firebase 토큰(3단계: 앱에 앱 배포 추가에서 받은 토큰)을 포함합니다.export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
이제 테스터는 빌드를 다운로드하고 테스트할 수 있는 이메일 초대장을 받게 됩니다. 개발자는 이제 앱 배포 대시보드의 릴리스 탭에서 빌드를 모니터링할 수 있습니다.
6. 릴리스를 다운로드하고 테스트하세요.
이 섹션에서는 배포한 릴리스를 다운로드하기 위한 테스터로 설정됩니다. 테스터는 테스트 기기를 인증하고 Google Play 스토어 앱에서 내부 앱 공유를 활성화해야 합니다.
- 테스트 기기에서 테스터 이메일 계정에 로그인하고 Firebase에서 보낸 초대를 엽니다.
- Google 계정으로 로그인하고 초대를 수락하여 배포 릴리스를 테스트하세요. 선택적으로, 다운로드한 릴리스가 기기의
Downloads
폴더에 추가되는 것을 방지하는 Firebase App Tester를 다운로드할 수도 있습니다. 또한 다운로드 진행률, 릴리스 버전 등 릴리스에 대한 추가 정보도 표시됩니다. - 릴리스에서 다운로드를 탭하여 Play 스토어에서 설치하세요.
- 메시지가 표시되면 나머지 단계를 완료하여 내부 앱 공유를 활성화합니다(지침은 테스트 장치에 표시되며 한 번만 완료하면 됩니다).
다운로드가 완료되면 릴리스가 자동으로 장치의 홈 화면에 바로가기로 표시됩니다.
7. 축하합니다!
방금 Firebase 앱 배포를 사용하여 App Bundle을 업로드하고 테스터에게 릴리스를 배포했습니다.
다음 단계
- 릴리스의 테스터를 관리하는 방법에 대해 자세히 알아보려면 앱 배포 문서를 참조하세요.
- 앱을 배포하는 데 사용할 수 있는 다른 도구에 대한 자세한 내용은 Android App Bundle 빌드 및 테스트를 참조하세요.