1. 개요
Android 앱 Codelab에 Firebase 앱 배포 SDK 통합에 오신 것을 환영합니다. 이 코드랩에서는 새 빌드를 다운로드할 수 있을 때 테스터에게 인앱 알림을 표시하기 위해 앱 배포 Android SDK를 앱에 추가합니다. 기본 구성과 사용자 지정 구성을 모두 사용하여 테스터가 업데이트를 수신하도록 로그인하게 하는 방법을 배웁니다. 그런 다음 앱 배포에 새 릴리스를 푸시하고 앱에서 바로 새 빌드 경고를 트리거합니다.
배울 내용
- 앱 배포를 사용하여 시험판 앱을 테스터에게 배포하는 방법
- 앱 배포 Android SDK를 앱에 통합하는 방법
- 설치할 준비가 된 새로운 시험판 빌드가 있을 때 테스터에게 경고하는 방법
- 테스트 요구 사항에 맞게 SDK를 사용자 지정하는 방법
필요한 것
- Android 스튜디오 버전 3.4 이상.
- 샘플 코드.
- Android 2.3 이상 및 Google Play 서비스 9.8 이상이 설치된 테스트 기기 또는 Google Play 서비스 9.8 이상이 설치된 에뮬레이터.
- 장치를 사용하는 경우 연결 케이블.
이 튜토리얼을 어떻게 사용하시겠습니까?
Android 앱 구축 경험을 평가해 주세요.
2. 샘플 코드 받기
명령줄에서 GitHub 리포지토리를 복제합니다.
$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git
git이 설치되어 있지 않은 경우 GitHub 페이지에서 또는 이 링크 를 클릭하여 샘플 프로젝트를 다운로드할 수도 있습니다.
3. 스타터 앱 가져오기
Android 스튜디오에서 codelab-appdistribution-android/start
디렉토리( ) 샘플 코드 다운로드( 파일 > 열기 > .../codelab-appdistribution-android/start).
이제 Android Studio에서 시작 프로젝트가 열려 있어야 합니다.
4. Firebase 콘솔 프로젝트 생성
새 Firebase 프로젝트 추가
- Firebase 콘솔 을 엽니다.
- 프로젝트 추가 를 선택한 다음 프로젝트 이름을 'Firebase Codelab'으로 지정합니다.
이 프로젝트에 대해 Google Analytics를 활성화할 필요가 없습니다.
- 프로젝트 만들기 를 클릭합니다.
Firebase에 앱 추가
Firebase에 앱을 등록합니다 . 패키지 이름으로 "com.google.firebase.appdistributioncodelab"을 사용합니다.
앱에 google-services.json 파일 추가
패키지 이름을 추가하고 등록을 선택한 후 다음 단계에 따라 앱에 google-services.json을 추가합니다.
- google-services.json 다운로드 를 클릭하여 Firebase Android 구성 파일을 가져옵니다.
- google-services.json 파일을 프로젝트의
app
디렉토리에 복사합니다. - 파일을 다운로드한 후 콘솔에 표시된 다음 단계를 건너뛸 수 있습니다(이 단계는 build-android-start 프로젝트에서 이미 완료되었습니다).
Firebase 앱과 일치하도록 애플리케이션 ID 업데이트
- 왼쪽 메뉴(프로젝트 탭)에서 "Android" 보기에 있는지 확인하고 "Gradle 스크립트" 탭을 찾은 다음 모듈(앱 수준) Gradle 파일(일반적으로
app/build.gradle
)을 엽니다. - Firebase 앱의 애플리케이션 ID와 일치하도록
applicationId
속성을 변경합니다. "com.google.firebase.appdistributioncodelab"이어야 합니다.
프로젝트를 Gradle 파일과 동기화
앱에서 모든 종속성을 사용할 수 있도록 하려면 Android 스튜디오 도구 모음에서 파일 > Gradle 파일 과 프로젝트 동기화를 선택하여 프로젝트를 Gradle 파일과 동기화합니다.
5. 앱 배포 Android SDK로 인앱 새 빌드 알림 설정
이 단계에서는 Firebase 앱 배포 Android SDK를 앱에 추가하고 앱의 새 빌드를 설치할 수 있을 때 테스터에게 인앱 알림을 표시합니다. 이렇게 하려면 "Firebase Codelab" 프로젝트(Google Cloud Console에서)에 Firebase App Testers API 를 사용 설정했는지 확인하세요. 동일한 계정으로 로그인하고 상단의 드롭다운 메뉴에서 올바른 프로젝트를 선택해야 합니다.
인앱 알림 구성
앱 배포 Android SDK는 테스터를 위한 인앱 빌드 알림을 설정하는 두 가지 방법을 제공합니다.
- 테스터에게 표시할 사전 빌드된 대화 상자와 함께 제공되는 기본 경고 구성입니다.
- 사용자 인터페이스(UI)를 사용자 지정할 수 있는 고급 경고 구성입니다.
기본 경고 구성부터 시작하겠습니다. updateIfNewReleaseAvailable
을 사용하여 아직 경고를 활성화하지 않은 테스터에게 미리 빌드된 경고 활성화 대화 상자를 표시한 다음 새 빌드를 사용할 수 있는지 확인할 수 있습니다. 테스터는 앱 배포에서 앱에 액세스할 수 있는 계정에 로그인하여 알림을 활성화합니다. 호출되면 메서드는 다음 시퀀스를 적용합니다.
- 테스터가 경고를 활성화했는지 확인합니다. 그렇지 않은 경우 메서드는 테스터에게 Google 계정으로 앱 배포에 로그인하라는 메시지를 표시하는 사전 구축된 대화 상자를 표시합니다.
경고 활성화는 앱 업데이트 간에 지속되는 테스트 장치의 일회성 프로세스입니다. 앱이 제거되거나 signOutTester
메서드가 호출될 때까지 테스트 장치에서 경고가 활성화된 상태로 유지됩니다.
- 테스터가 설치할 새로 사용 가능한 빌드를 확인합니다.
- 테스터에게 최신 릴리스를 다운로드하도록 미리 작성된 경고를 표시합니다.
- 업데이트를 진행하기 전에 새 빌드 유형을 확인합니다.
- 새 빌드가 App Bundle(AAB)인 경우 테스터를 Play 스토어로 리디렉션하여 업데이트 프로세스를 완료합니다.
- 새 빌드가 APK인 경우 SDK는 백그라운드에서 새 빌드를 다운로드하고 다운로드가 완료되면 테스터에게 새 빌드를 설치하라는 메시지를 표시합니다. SDK는
NotificationManager.
onProgressUpdate
핸들러를updateIfNewReleaseAvailable
작업에 연결하여 고유한 진행률 표시기를 추가할 수 있습니다.
앱의 어느 지점에서나 updateIfNewReleaseAvailable()
을 호출할 수 있습니다. 예를 들어 MainActivity의 onResume()
메서드 중에 updateIfNewReleaseAvailable()
을 호출할 수 있습니다.
MainActivity.kt 를 열고 다음과 같이 onResume()
메서드를 만듭니다.
MainActivity.kt
override fun onResume() {
super.onResume()
checkForUpdate()
}
이제 checkForUpdate()
메서드를 구현해 보겠습니다.
MainActivity.kt
private fun checkForUpdate() {
firebaseAppDistribution.updateIfNewReleaseAvailable()
.addOnProgressListener { updateProgress ->
// (Optional) Implement custom progress updates in addition to
// automatic NotificationManager updates.
}
.addOnFailureListener { e ->
if (e is FirebaseAppDistributionException) {
// Handle exception.
}
}
}
6. 테스터를 빌드하고 초대하여 앱을 다운로드하도록 합니다.
이 단계에서는 Firebase 콘솔을 사용하여 테스터 에게 빌드를 배포 하여 앱을 빌드하고 구현을 테스트합니다.
앱 빌드
테스터에게 앱의 시험판 버전을 배포할 준비가 되면 일반적인 프로세스를 사용하여 APK를 빌드하세요. 디버그 키 또는 앱 서명 키로 APK에 서명해야 합니다.
테스터에게 앱 배포
테스터에게 앱을 배포하려면 Firebase 콘솔을 사용하여 APK 파일을 업로드하세요.
- Firebase 콘솔의 앱 배포 페이지 를 엽니다. 메시지가 표시되면 Firebase 프로젝트를 선택합니다.
- 릴리스 페이지의 드롭다운 메뉴에서 배포할 앱을 선택합니다.
- 시작하기 클릭
- 앱의 APK 파일을 콘솔로 드래그하여 업로드합니다.
- 업로드가 완료되면 빌드를 받을 테스터 그룹과 개별 테스터를 지정합니다. (초대를 받으려면 이메일을 추가하십시오.) 그런 다음 빌드에 대한 릴리스 정보를 추가하십시오. 테스터 그룹 생성에 대한 자세한 내용은 테스터 추가 및 제거 를 참조하십시오.
- 배포 를 클릭하여 테스터가 빌드를 사용할 수 있도록 합니다.
Firebase 콘솔에서 이제 앱 릴리스에 추가한 테스터를 볼 수 있습니다.
이메일 주소를 포함했으므로 Firebase 앱 배포에서 앱 테스트를 초대하는 이메일을 받게 됩니다. 당신은 이제 첫 번째 테스터입니다! 초대 수락의 지침에 따라 테스트 장치에서 테스터로 설정합니다.
초대를 수락하다
릴리스를 다운로드하고 테스트하려면 먼저 초대를 수락해야 합니다.
- Android 테스트 기기에서 Firebase 앱 배포에서 보낸 이메일을 열고 시작하기 를 탭합니다.
- 표시되는 Firebase 앱 배포 테스터 웹 앱에서 Google 계정으로 로그인하고 초대 수락을 탭합니다. 이제 테스트에 초대된 릴리스를 볼 수 있습니다.
테스트 장치에서 릴리스 다운로드
AppDistribution Codelab 앱으로 이동하면 릴리스를 다운로드할 준비가 되었음을 알 수 있습니다.
- 다운로드 를 탭한 다음 앱을 설치하고 실행하세요!
- 앱이 시작되면 새 빌드 알림을 활성화하라는 메시지가 표시됩니다. 켜기를 탭합니다.
- 테스터 계정으로 로그인하세요..
앱으로 돌아갑니다. 다음에 앱을 실행할 때 로그인하거나 알림을 수락할 필요가 없습니다.
테스터에게 업데이트 배포
- 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에서 versionName을 "1.1"로, versionCode를 2로 업데이트합니다.
- 일반적인 프로세스를 사용하여 APK를 빌드합니다. 디버그 키 또는 앱 서명 키로 APK에 서명해야 합니다.
- Firebase 콘솔에 이 새 APK를 업로드하고 이메일을 다시 테스터로 추가하고 배포 를 클릭합니다.
빌드 알림 테스트
- 앱이 열려 있는 경우 앱을 닫았는지 확인합니다.
- 앱을 다시 시작합니다.
- 앱이 다시 시작되면 새 버전 사용 가능 알림이 수신됩니다.
- 최신 버전을 받으려면 업데이트 를 클릭하십시오.
- 메시지가 표시되면 알 수 없는 소스에서 설치를 활성화하는 옵션을 선택합니다.
- 다음 화면에서 설치 (또는 업데이트 )를 클릭합니다.
- 축하합니다! 내장된 알림으로 앱을 업데이트할 수 있었습니다.
7. 테스터 로그인 사용자 지정
signInTester/signOutTester 및 isTesterSignedIn 메서드를 사용하면 테스터의 로그인 환경을 보다 유연하게 사용자 지정할 수 있으므로 앱의 모양과 느낌에 더 잘 맞을 수 있습니다.
다음 예에서는 테스터가 Firebase 앱 배포 테스터 계정에 이미 로그인했는지 확인하므로 아직 로그인하지 않은 테스터에 대해서만 로그인 UI를 표시하도록 선택할 수 있습니다. 테스터가 로그인한 후 다음을 수행할 수 있습니다. 테스터가 새 빌드에 액세스할 수 있는지 확인하려면 checkForUpdate 를 호출하세요.
checkForUpdate() 호출을 주석 처리하여 onResume 에서 자동으로 업데이트 확인을 비활성화합시다.
MainActivity.kt
override fun onResume() {
super.onResume()
//checkForupdate()
}
대신 checkForUpdate() 가 이미 updatebutton의 OnClickListener에 추가되어 있습니다.
이제 사용자가 로그아웃된 경우 로그인하고 사용자가 이미 로그인한 경우 로그아웃하는 signIn() 메서드를 구현해 보겠습니다.
MainActivity.kt
private fun signIn() {
if (isTesterSignedIn()) {
firebaseAppDistribution.signOutTester()
configureUpdateButton()
configureSigninButton()
} else {
firebaseAppDistribution.signInTester()
}
}
마지막으로 isTesterSignedIn 메서드를 구현해 보겠습니다.
MainActivity.kt
private fun isTesterSignedIn() : Boolean {
return firebaseAppDistribution.isTesterSignedIn
}
구현 빌드 및 테스트
8. 축하합니다!
Firebase 앱 배포 Android SDK를 사용하여 앱에 "인앱 알림 표시" 기능을 구축했습니다.
우리가 다룬 내용
- Firebase 앱 배포
- Firebase 앱 배포 새로운 알림 Android SDK
다음 단계
더 알아보기
질문이있다?
문제 보고