Gradle을 사용하여 Android 앱 배포

App Distribution Gradle 플러그인을 사용하여 App Distribution을 Android 빌드 프로세스에 통합할 수 있습니다. 플러그인을 사용하면 앱의 Gradle 파일에 테스터와 출시 노트를 지정하여 앱의 다양한 빌드 유형과 변형에 대한 배포를 구성할 수 있습니다.

이 가이드에서는 App Distribution Gradle 플러그인을 사용하여 Android App Bundle(AAB)을 테스터에 배포하는 방법을 설명합니다.

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를 업로드하는 데 적용됩니다.

시작하기 전에

1. 아직 추가하지 않았으면 Android 프로젝트에 Firebase를 추가합니다. 이 워크플로를 완료하면 Firebase 프로젝트에 Firebase Android 앱이 등록됩니다.

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

2. Google Play에 대한 Firebase 링크를 만들고 AAB를 업로드하려면 앱이 다음 요구사항을 충족하는지 확인합니다.

   • Google Play의 앱과 Firebase Android 앱은 모두 동일한 패키지 이름을 사용하여 등록되어 있습니다.

   • Google Play의 앱은 앱 대시보드에 설정되어 Google Play 트랙(내부 테스트, 비공개 테스트, 공개 테스트 또는 프로덕션) 중 하나에 배포되어 있습니다.

   • Google Play에서 앱 검토가 완료되고 앱이 게시되어 있습니다. 앱 상태 열에 내부 테스트(초안 내부 테스트 아님), 비공개 테스트, 공개 테스트 또는 프로덕션 상태 중 하나가 표시되면 앱이 게시됩니다.

3. Firebase Android 앱을 Google Play 개발자 계정에 연결합니다.

   1. Firebase Console에서 settings 프로젝트 설정으로 이동한 후 통합 탭을 선택합니다.

   2. Google Play 카드에서 연결을 클릭합니다.
      이미 Google Play 링크가 있다면 관리를 클릭합니다.

   3. 화면에 표시된 안내에 따라 App Distribution 통합을 사용 설정하고 Google Play에 연결할 Firebase Android 앱을 선택합니다.

   Google 애널리틱스 연결에 대해 자세히 알아보세요.

1단계: Android 프로젝트 설정

1. 루트 수준(프로젝트 수준) Gradle 파일(<project>/build.gradle.kts 또는 <project>/build.gradle)에서 App Distribution Gradle 플러그인을 종속 항목으로 추가합니다.

   Kotlin

   plugins {
       // ...
       id("com.android.application") version "7.3.0" apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.2" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "5.0.0" apply false
   }

   Groovy

   plugins {
       // ...
       id 'com.android.application' version '7.3.0' apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.2' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '5.0.0' apply false
   }

2. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 App Distribution Gradle 플러그인을 추가합니다.

   Kotlin

   plugins {
     id("com.android.application")
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution")
   }

   Groovy

   plugins {
     id 'com.android.application'
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the App Distribution Gradle plugin
     id 'com.google.firebase.appdistribution'
   }

3. 회사에서 프록시나 방화벽을 사용할 경우 App Distribution에서 Firebase에 배포 항목을 업로드할 수 있도록 다음 Java 시스템 속성을 추가합니다.

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

2단계: Firebase로 인증

Gradle 플러그인을 사용하려면 먼저 다음 방법 중 하나로 Firebase 프로젝트로 인증해야 합니다. 다른 인증 방법을 사용하지 않는 경우 기본적으로 Gradle 플러그인은 Firebase CLI에서 사용자 인증 정보를 찾습니다.

3단계: 배포 속성 구성

모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 firebaseAppDistribution 섹션을 최소 하나 이상 추가하여 App Distribution을 구성합니다.

예를 들어 release 빌드를 테스터에게 배포하려면 다음 안내를 따르세요.

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("release") {
          firebaseAppDistribution {
              artifactType = "AAB"
              releaseNotesFile = "/path/to/releasenotes.txt"
              testers = "ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      release {
          firebaseAppDistribution {
              artifactType="AAB"
              releaseNotesFile="/path/to/releasenotes.txt"
              testers="ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

빌드 유형 및 제품 버전에 App Distribution을 구성할 수 있습니다.

예를 들어 'demo' 및 'full' 제품 버전에 debug 및 release 빌드를 배포하려면 다음 안내를 따르세요.

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("debug") {...}
      getByName("release") {...}
  }

  flavorDimensions += "version"
  productFlavors {
      create("demo") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for demo version"
              testers = "demo@testers.com"
          }
      }
      create("full") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for full version"
              testers = "full@testers.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      debug {...}
      release {...}
  }

  flavorDimensions "version"
  productFlavors {
      demo {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for demo version"
              testers="demo@testers.com"
          }
      }
      full {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for full version"
              testers="full@testers.com"
          }
      }
  }

  // ...
}

다음 매개변수를 사용하여 배포를 구성합니다.

appId="1:1234567890:android:321abc456def7890"

testers="ali@example.com, bri@example.com, cal@example.com"

testersFile="/path/to/testers.txt"

groups="qa-team, android-testers"

groupsFile="/path/to/tester-groups.txt"

testDevices="model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

testDevicesFile="/path/to/testDevices.txt"

testPasswordFile="/path/to/testPassword.txt"

4단계: 테스터에 앱 배포

1. 마지막으로 테스트 앱을 패키징하고 테스터를 초대하려면 BUILD-VARIANT 및 appDistributionUploadBUILD-VARIANT 대상을 프로젝트의 Gradle 래퍼를 사용하여 빌드합니다. 여기서 BUILD-VARIANT는 이전 단계에서 구성한 선택적 제품 버전과 빌드 유형입니다. 제품 버전에 대한 자세한 내용은 빌드 변형 구성을 참조하세요.

   예를 들어 release 빌드 변형을 사용하여 앱을 배포하려면 다음 명령어를 실행합니다.

   ./gradlew bundleRelease appDistributionUploadRelease
   

   또는 Google 계정을 사용하여 인증했거나 Gradle 빌드 파일에 사용자 인증 정보를 제공하지 않은 경우에는 FIREBASE_TOKEN 변수를 포함합니다.

   export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
   ./gradlew --stop // Only needed for environment variable changes
   ./gradlew bundleRelease appDistributionUploadRelease
   

2. 또한 --<property-name>=<property-value> 형식으로 명령줄 인수를 전달하여 build.gradle 파일에 설정된 값을 재정의할 수 있습니다. 예를 들면 다음과 같습니다.

   • 디버그 빌드를 App Distribution에 업로드하려면 다음 안내를 따르세요.

     ./gradlew bundleDebug appDistributionUploadDebug
         --artifactType="AAB"

   • 추가 테스터를 초대하거나 Firebase 프로젝트에서 기존 테스터를 삭제하려면 다음 안내를 따르세요.

     ./gradlew appDistributionAddTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     ./gradlew appDistributionRemoveTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"

     Firebase 프로젝트에 테스터를 추가한 후 개별 출시 버전에 테스터를 추가할 수 있습니다. 삭제된 테스터는 더 이상 프로젝트의 출시 버전에 대한 액세스 권한을 가지지 않지만 일정 기간 동안 출시 버전에 계속 액세스할 수 있습니다.

   또한 --emails 대신 --file="/path/to/testers.txt"를 사용하여 테스터를 지정할 수도 있습니다.

   appDistributionAddTesters 및 appDistributionRemoveTesters 태스크도 다음 인수가 허용됩니다.

   • projectNumber: Firebase 프로젝트 번호입니다.

   • serviceCredentialsFile: Google 서비스 사용자 인증 정보 파일의 경로입니다. 업로드 작업에 사용되는 동일한 인수입니다.

출시 버전 업로드 후 Gradle 플러그인은 다음 링크를 출력합니다. 다음 링크를 사용하면 바이너리를 관리하고 테스터 및 다른 개발자가 올바른 출시 버전을 사용할 수 있습니다.

• firebase_console_uri - 단일 출시 버전을 표시하는 Firebase Console 링크입니다. 이 링크를 조직의 다른 개발자와 공유할 수 있습니다.
• testing_uri - 테스터가 출시 노트를 보고 기기에 앱을 설치할 수 있는 테스터 환경(Android 네이티브 앱)의 출시 버전 링크입니다. 테스터가 링크를 사용하려면 출시 버전에 액세스할 수 있어야 합니다.
• binary_download_uri - 앱 바이너리(APK 또는 AAB 파일)를 직접 다운로드하고 설치하는 서명된 링크입니다. 링크는 1시간 후에 만료됩니다.

빌드를 배포한 후에는 Firebase Console의 App Distribution 대시보드에서 150일(5개월) 동안 사용할 수 있습니다. 빌드가 만료되기 30일 전부터 Console 및 테스트 기기의 빌드 테스트 목록 모두에 만료 알림이 표시됩니다.

신규 테스터는 앱 테스트를 시작할 수 있는 이메일 초대를 받으며 기존 테스터는 새 빌드가 테스트될 준비가 완료되었다는 이메일 알림을 받습니다(테스트 앱 설치 방법에 대한 안내는 테스터 설정 가이드 참조). Firebase Console에서 각 테스터 상태(초대 수락 여부, 앱 다운로드 여부 등)를 모니터링할 수 있습니다.

테스터는 초대 유효 기간(30일) 만료 전에 앱 테스트를 수락해야 합니다. 초대 유효 기간이 만료되기 5일 전부터 Firebase Console의 출시 버전 테스터 옆에 만료 알림이 표시됩니다. 테스터 행의 드롭다운 메뉴를 사용하여 초대를 재전송하면 갱신할 수 있습니다.

다음 단계

• 테스터가 앱에 대한 의견(스크린샷 포함)을 쉽게 보낼 수 있도록 인앱 의견을 구현하세요.

• 앱의 새 빌드를 설치할 수 있게 될 때 테스터에게 인앱 알림을 표시하는 방법을 알아보세요.

• Android App Bundle Codelab을 방문하여 App Bundle 출시 버전을 단계별로 배포하는 방법을 자세히 알아보세요.

• CI/CD를 사용하여 Android 앱을 QA 테스터에 배포할 때의 권장사항을 알아보세요.