테스터에게 App Bundle 출시 배포 - Codelab

1. 개요

이미지10.png

이 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 프로젝트 만들기

  1. Firebase 에 로그인합니다.
  2. Firebase 콘솔에서 프로젝트 추가를 클릭한 다음 프로젝트 이름을 "AppBundlesCodelab"으로 지정합니다. Firebase 프로젝트의 프로젝트 ID를 기억하세요. 프로젝트 ID를 수정하지 않으면 Firebase가 자동으로 프로젝트에 고유한 ID를 할당합니다.

    image8.png
  3. (선택사항) 메시지가 표시되면 Google Analytics를 활성화합니다.
  4. 나머지 단계를 완료한 후 프로젝트 만들기 를 클릭하세요.

프로젝트에 App Bundle 추가

  1. Firebase 콘솔에서 앱 추가를 클릭합니다.

    이미지5.png
  2. 앱을 등록할 때 Google Play 개발자 계정에 업로드된 앱과 동일한 패키지 이름을 사용해야 합니다. 마지막으로 앱 등록 을 클릭합니다.
  3. 앱의 Firebase 구성 파일( google-services.json )을 앱에 추가하려면 나머지 단계를 완료하세요. Android의 경우 앱 배포에는 앱에 추가할 Firebase SDK가 없습니다.
  4. 계속해서 콘솔을 클릭하세요.
  1. Firebase 콘솔에서 프로젝트 설정 으로 이동합니다.

    이미지2.png
  2. 통합 탭에서 Google Play 카드의 링크를 클릭하세요.
  3. 화면의 지시에 따라 앱 배포 통합을 활성화한 다음 새로 생성된 Firebase 앱을 선택하여 Google Play에 연결하세요.

이제 이 단계를 완료했으므로 앱의 패키지 이름이 일치하는 한 Firebase 앱이 Google Play 개발자 계정의 앱에 연결됩니다.

3. 프로젝트에 앱 배포 추가

앱 배포 Gradle 플러그인 추가

이제 Android Studio를 사용하여 앱 배포 및 Gradle 플러그인을 앱에 추가하겠습니다.

  1. 프로젝트 수준 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
    }
    
  2. 프로젝트 수준 설정 Gradle 파일( android/settings.gradle.kts )에서 Google의 Maven 저장소를 pluginManagement 블록에 추가합니다.
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. 앱 수준 Gradle 파일( android/app/build.gradle.kts )에서 앱 배포 플러그인을 plugins 블록에 추가합니다.
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. 기업 프록시 또는 방화벽 뒤에 있는 경우 앱 배포가 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. 릴리스 빌드 및 배포

  1. bundle Variant Gradle 작업을 실행하여 App Bundle 파일 빌드:
    $ ./gradlew :base:bundleRelease
    
  2. 애플리케이션의 빌드 디렉터리(기본 위치는 app/build/outputs/bundle/release )에서 번들을 찾습니다.
  3. 릴리스를 배포하려면 프로젝트의 Gradle 래퍼를 사용하여 타겟 bundleReleaseappDistributionUploadRelease 빌드하세요. Firebase 토큰(3단계: 앱에 앱 배포 추가에서 받은 토큰)을 포함합니다.
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

이제 테스터는 빌드를 다운로드하고 테스트할 수 있는 이메일 초대장을 받게 됩니다. 개발자는 이제 앱 배포 대시보드의 릴리스 탭에서 빌드를 모니터링할 수 있습니다.

6. 릴리스를 다운로드하고 테스트하세요.

이 섹션에서는 배포한 릴리스를 다운로드하기 위한 테스터로 설정됩니다. 테스터는 테스트 기기를 인증하고 Google Play 스토어 앱에서 내부 앱 공유를 활성화해야 합니다.

  1. 테스트 기기에서 테스터 이메일 계정에 로그인하고 Firebase에서 보낸 초대를 엽니다.

    이미지6.png
  2. Google 계정으로 로그인하고 초대를 수락하여 배포 릴리스를 테스트하세요. 선택적으로, 다운로드한 릴리스가 기기의 Downloads 폴더에 추가되는 것을 방지하는 Firebase App Tester를 다운로드할 수도 있습니다. 또한 다운로드 진행률, 릴리스 버전 등 릴리스에 대한 추가 정보도 표시됩니다.

    image9.png
  3. 릴리스에서 다운로드를 탭하여 Play 스토어에서 설치하세요.
  4. 메시지가 표시되면 나머지 단계를 완료하여 내부 앱 공유를 활성화합니다(지침은 테스트 장치에 표시되며 한 번만 완료하면 됩니다).

다운로드가 완료되면 릴리스가 자동으로 장치의 홈 화면에 바로가기로 표시됩니다.

7. 축하합니다!

방금 Firebase 앱 배포를 사용하여 App Bundle을 업로드하고 테스터에게 릴리스를 배포했습니다.

다음 단계