앱 배포 문제 해결 & 자주 묻는 질문(FAQ)

누락된 연락처 이메일로 인해 앱을 배포할 수 없음

앱을 업로드할 때 다음 오류가 발생할 수 있습니다.

'<app-id> 앱의 연락처 이메일을 찾을 수 없습니다. 다음 페이지를 방문하세요. Firebase 콘솔 내의 App Distribution로 이동하여 설정하세요."

가능한 경우 Firebase 콘솔에서 연락처 이메일을 설정합니다. 문제가 문제가 계속되면 Firebase 지원팀에 문의하세요.

앱을 프로비저닝하는 동안 오류 발생(400, 409, 500 오류)

프로비저닝하는 동안 400, 409, 500 오류가 반복적으로 발생하면 Firebase 지원팀에 문의하세요. Firebase 프로젝트 번호와 앱 식별자를 지원팀에 제공하세요.

APK 파일을 업로드할 수 없음

1. APK 크기를 확인합니다. 모든 바이너리의 최대 파일 크기 한도는 2GB보다 약간 더 큰 2,048MiB입니다.

2. APK 크기가 파일 크기 한도 내에 있고 재현 가능한 경우에는 Firebase 지원팀에 문의하세요.

APK를 Fastlane에 업로드할 수 없습니다. APK가 서명되지 않았습니다.

다음을 사용하여 APK가 서명되었는지 확인합니다.

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

소셜 로그인/타사 API 공급업체 오류 수신

App Distribution에 AAB를 업로드하면 Google Play에서 자동으로 서명합니다. 생성된 APK에 대해 테스트 앱 서명 키 인증서를 사용합니다. 메시지가 표시된 후 타사 서비스를 계속 사용하려면 API 제공업체에 앱을 등록해야 합니다. 서명이 완료되면 앱의 테스트 인증서에서 Firebase 콘솔에서 확인할 수 있습니다.

업로드하는 AAB가 Google Play에도 표시되나요?

App Distribution에 업로드하는 AAB 빌드가 Google Play에 표시되지 않습니다. 개발자 계정 (App Bundle 탐색기 및 내부 앱 공유 포함)

Google Play에서 Firebase 연결을 해제하면 어떻게 되나요?

Firebase Android 앱이 Google Play에서 연결 해제되면 다음 결과가 발생합니다.

• 새 App Bundle을 App Distribution에 업로드하고 내보낼 수 없게 됩니다. Google Play와의 App Distribution 통합을 통해 Google Play에 추가해야 합니다.

• 기존 빌드는 다음에서 계속 사용할 수 있습니다. Firebase App Distribution 대시보드와 테스터에게 게시됩니다.

• 이전에 Firebase와 Google Play 간에 내보낸 데이터는 두 제품에서 계속 액세스할 수 있습니다.

Google Play에 앱 연결을 다시 시도할 수 있나요?

App Distribution 및 업로드된 AAB를 Firebase 프로젝트와 Google Cloud 다음 요구사항을 충족하는지 확인하세요.

• Google Play 개발자 계정에 소유자 또는 관리자의 액세스 수준이 포함되어 있습니다.

• Firebase 프로젝트의 경우 소유자 또는 Firebase 관리자 역할 중 하나가 있습니다.

• 앱이 Firebase 및 Google Play 개발자 계정에 등록되어 있습니다. 즉, Firebase Android 앱과 Google Play 앱이 모두 있습니다.

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

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

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

이전에 위에 나열된 연결 기준을 충족하지 않는 앱을 업로드했지만 지금은 기준을 충족할 경우에는 Google Play에 Firebase Android 앱 연결을 재시도할 수 있습니다.

테스터에게 Google 계정이 없음

사용자가 Google 계정을 만들면 자동으로 Gmail 주소가 부여됩니다.

테스터에게 Google Workspace 또는 Gmail 주소가 없거나 다른 이메일 주소를 사용하여 로그인하길 원할 때는 Gmail 이외의 이메일 주소를 계정에 연결하고 이 이메일을 사용해서 로그인하도록 요청합니다.

테스터가 대체 이메일을 선택할 때 다음 안내를 따라야 합니다.

• Gmail 주소를 사용하지 않습니다.
• 다른 Google 계정에 이미 연결된 이메일 주소를 사용하지 않습니다.
• 이 이메일 주소로 로그인할 때 Google 계정 비밀번호를 사용한다는 것을 기억합니다.

자세한 내용은 다른 이메일 주소로 Google 계정에 로그인을 참조하세요.

테스터가 올바른 앱 또는 빌드를 확인할 수 없음

테스터가 초대로 전송된 것과 다른 이메일 주소를 사용하여 이메일 초대를 수락한 경우 테스터가 올바른 앱 또는 빌드를 확인하지 못할 수 있습니다.

개발자가 초대를 전송하고 새 빌드에 추가하는 이메일(이메일 A)은 테스트가 초대를 수락하기 위해 사용하는 이메일(이메일 B)과 다를 수 있습니다. 이 경우에는 백그라운드 연결이 생성됩니다. 이메일 A가 새 빌드에 추가될 때마다 실제로는 이메일 B가 여기에 액세스합니다.

테스터가 다른 이메일 주소로 이메일 초대를 수락한 경우 다음 단계에 따라 문제를 해결합니다.

1. 테스터 및 App Distribution의 그룹스 탭 Firebase 콘솔의 페이지입니다. 기존 초대가 삭제됩니다.

2. 앱을 테스트하도록 테스터를 다시 초대합니다. 테스터에게 초대 이메일이 전송됩니다.

3. 테스터가 동일한 이메일 주소를 사용하여 초대를 수락하는지 확인합니다.

테스터에게 이메일 알림이 수신되지 않음

다음 중 하나가 발생하면 테스터에게 이메일 알림이 수신되지 않을 수 있습니다.

• 이메일 알림이 스팸 폴더로 전송되었습니다.

• 이메일 필터가 설정되었습니다.

• 초대가 하나의 이메일 계정에 전송되었지만 테스터가 다른 이메일 계정을 사용하여 수락했습니다. 초대가 처음 전송된 이메일 계정에 대해 새로운 출시 이메일이 테스터에게 수신됩니다.

• 테스터가 이전에 초대되었지만 처음 초대를 수락하지 않았습니다. 테스터가 후속 출시에 추가되면 App Distribution는 테스터가 출시 알림을 자동으로 전송합니다. 사용자가 최초 초대를 수락하지 않았습니다.

솔루션 1

1. 테스터에게 스팸 폴더 및 이메일 서비스에 설정된 이메일 필터를 확인하도록 요청합니다.

2. 테스터가 이메일을 구독 취소한 경우 테스터에게 다음을 수행하도록 요청합니다.

   1. 테스터가 이전에 앱에서 받은 이메일을 찾습니다.
   2. 아래에 있는 이메일 설정 관리를 클릭하고 이메일 허용을 클릭하여 다시 구독합니다.

솔루션 2

테스터가 이메일 알림을 원하지 않지만 앱 초대를 수락하려는 경우 App Tester 앱(다운로드 안내)에서 직접 대기 중인 앱 초대를 볼 수 있습니다.

솔루션 3

1. 테스터 및 App Distribution의 그룹스 탭 Firebase 콘솔에서 확인하세요. 이 작업을 수행하면 기존 초대가 삭제됩니다.

2. 앱을 테스트하도록 테스터를 다시 초대합니다. 테스터에게 초대 이메일이 전송됩니다. 테스터가 초대가 전송된 것과 동일한 이메일 주소를 사용하여 초대를 수락하는지 확인합니다.

앱이 설치된 것으로 표시되지 않음

테스터가 출시 버전을 다운로드하고 설치하지만 앱 세부정보 사용자 인터페이스에 앱이 설치된 것으로 표시되지 않는 경우, 이것은 알려진 문제입니다. 일부 경우 Firebase 앱의 번들 ID가 APK의 번들 ID와 일치하지 않습니다.

APK의 번들 ID가 배포 업로드에 사용된 Firebase 앱의 번들 ID와 일치하는지 확인합니다.

기기에 알 수 없는 앱을 설치할 수 없다는 Android 알림이 표시됨

실행 중인 앱 또는 브라우저에 아직 Google Play 외부의 앱을 설치할 권한이 없으면 Android 알림이 표시됩니다. 권한을 부여하려면 다음 안내를 따르세요.

• Android 버전 8 이상: 설정 앱에서 이 소스에서 허용을 탭합니다.

• Android 버전 7 이하: 설정 앱에서 보안을 탭한 후 알 수 없는 소스를 선택합니다. 메시지가 표시되면 확인 > 신뢰를 탭합니다.

테스트 APK 설치 실패

테스터 기기에서 테스트 APK가 설치되지 않으면 다음을 수행합니다.

• 새 버전의 인증서가 테스터 기기에 설치된 버전과 일치하는지 확인합니다. Android 시스템에서는 인증서가 일치할 경우에만 앱 업데이트가 허용됩니다. 자세한 내용은 서명 고려사항을 참조하세요.
• 테스터 기기의 OS 버전이 앱에서 지원되는지 확인하세요(minSdkVersion 확인).

Android App Tester 앱에 로그인할 수 없음

App Tester 앱에서 로그인이 수행되지 않고 로그인 화면으로 리디렉션되면 제한 설정이 포함된 Google Workspace(이전의 G Suite)를 사용 중인 것일 수 있습니다.

제한 설정을 삭제하려면 다음 안내를 따르세요.

1. 앱의 앱 탭에서 Google Workspace에서 Firebase App Distribution이 다음과 같이 설정되지 않도록 합니다. 액세스: 차단됨

2. 서비스 탭에서 Cloud Platform이 제한되지 않았는지 확인합니다.

3. 설정이 삭제된 다음 다시 로그인을 시도합니다.

AAB 설치 중 오류 발생: '앱을 설치할 수 없음'

이 오류는 설치 중인 앱이 기기에 이미 설치된 앱과 충돌할 때 발생할 수 있습니다. 예를 들어 동일한 커스텀 권한이나 ContentProvider 이름을 가진 동일한 앱의 다른 변형일 수 있습니다.

문제가 발생한 직후에 테스터에게 버그 신고를 수집하도록 요청하고 신고를 살펴본 다음 원인에 관한 자세한 정보를 확인할 수 있습니다. 새 앱을 설치하려면 먼저 테스터가 충돌하는 앱을 삭제해야 합니다.

403 오류: '액세스하려면 관리자에게 문의하세요'

403 오류가 발생하면 사용 중인 계정에 앱 설치 및 테스트 권한이 없기 때문일 수 있습니다. 액세스는 Google Workspace에서 계정 도메인의 관리자에 의해 결정됩니다.

앱 설치 및 테스트 권한이 필요하면 Google Workspace 계정 관리자에게 계정 설정 변경을 요청합니다. 관리자는 개별적으로 제어되지 않는 서비스 액세스 관리의 안내를 따라야 합니다.

여러 계정이 있으면 앱 설치 및 테스트가 제한되지 않는 다른 계정을 사용하여 로그인해보세요.

새 Android 기기에서 테스트

처음 테스트하는 테스터인 경우 테스터로 설정을 참조하세요.

기존 App Distribution 테스터이며 새 테스터 플로우 전체를 다시 거치지 않고 단계:

1. Android 기기에서 appdistribution.firebase.google.com으로 이동합니다.

2. 기존 테스터 계정으로 로그인하고 앱 다운로드 Android App Tester를 설치하려면 화면 하단의 테스터 버튼을 클릭합니다. 있습니다.

테스터가 앱에서 의견 보내기를 시작할 수 없음

앱에서 App Distribution Android SDK를 이미 설정한 경우 테스터가 의견을 제출할 수 없는 경우 단계:

1. 앱에서 App Distribution Android SDK에 상세 로깅을 사용 설정합니다.

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. 'FirebaseAppDistribution'을 필터링하여 앱 로그에서 오류 메시지를 확인합니다.

3. 테스터가 설치된 출시 버전에 액세스할 수 있는지 확인합니다.

   1. 로그에 '테스터에 이 리소스에 대한 액세스 권한이 없음'이라고 표시되면 테스터가 앱에 초대되지 않았거나 출시 버전에 대한 액세스 권한이 없을 수 있습니다.

   2. Firebase 콘솔의 App Distribution 대시보드에서 정확한 출시 버전을 사용하고 테스터는 출시 카드의 테스터 탭에 나열되며 수락된 상태입니다.

   여전히 의견을 받지 못하는 경우 다음 단계를 따르세요.

   1. 테스트 기기에서 앱을 사용하여 Firebase App Distribution에 로그인합니다. 테스터 또는 테스터 웹 앱 Google 계정을 선택해야 합니다. 앱 테스트 초대를 수락할 때 처음 사용하셨습니다.

   2. App Tester 또는 테스트 웹 앱을 사용하여 앱을 다시 설치하여 테스터가 출시 버전에 액세스할 수 있는지 확인합니다.

   3. 의견을 다시 제출하되 같은 Google 계정으로 로그인해야 합니다.

4. Firebase App Testers API를 사용 설정했는지 확인합니다. 자세한 내용은 App Distribution Tester API 사용 설정을 참조하세요.

5. 키 제한사항 아래에서 Firebase App Testers API가 허용되는 API 목록에 포함되어 있는지 확인합니다.

앱에 제출된 의견을 받지 못함

1. 의견을 제출할 때 '의견을 보내려고 했으나 개발 모드로 인해 전송되지 않음'이라는 메시지가 표시되면 다음 명령어를 실행하여 기기에서 개발자 모드를 사용 중지합니다.

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. google-services.json 파일을 검토하여 제출되는지 확인하세요. 의견을 수렴할 수 있습니다.

3. 앱에서 App Distribution Android SDK에 상세 로깅을 사용 설정합니다.

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. 'FirebaseAppDistribution'을 필터링하여 앱 로그에서 오류 메시지를 확인합니다.

테스터가 인앱 알림을 받지 못함

이미 앱에 App Distribution Android SDK를 설정한 경우 테스터에게 인앱 알림이 수신되지 않는다면 다음 단계를 따르세요.

1. 작업에 OnFailureListener를 연결하여 오류 메시지를 확인합니다. Firebase App Distribution API에서 반환합니다.

   자바

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. 테스터가 새 출시 버전에 액세스할 수 있는지 확인합니다.

   1. 앱에서 디버그 모드를 사용 설정합니다. 방법은 Google 애널리틱스 문서를 참조하세요.

   2. 시뮬레이터에서 앱을 실행하고 'FirebaseAppDistribution' 문자열을 검색합니다.

      로그에 출시 버전을 찾을 수 없거나 테스터에게 액세스가 없다고 표시되면 테스터가 새 출시 버전에 연결되지 않았을 수 있습니다.

   3. App Distribution 대시보드 Firebase 콘솔에서 테스터가 빌드에 포함되어 있는지 확인 수락됨 상태입니다.

      테스터가 여전히 알림을 받지 못하는 경우 아래 팁에 따라 앱 테스트 초대를 수락하고 테스트 기기를 올바르게 설정했는지 확인합니다.

      1. 테스트 기기에서 App Tester 또는 테스터 웹 앱을 통해 Firebase 앱 배포에 로그인합니다. 앱 테스트 초대를 받았을 때 처음 사용한 Google 계정을 선택해야 합니다.

      2. App Tester 또는 테스터 웹 앱에서 새 앱 출시 버전을 사용할 수 있는지 확인합니다.

테스터에게 앱을 닫았다가 다시 로그인하라는 메시지가 표시됨

기본적으로 테스터는 Google 계정에 한 번만 로그인하면 테스트 기능을 사용 설정할 수 있습니다. 테스터가 앱을 닫았다가 다시 연 후 다시 로그인하라는 메시지가 표시되면 App Distribution 구성이 제대로 설정되었는지 확인하기 위한 팁:

• Firebase App Testers API를 사용 설정했는지 확인합니다. 자세한 내용은 App Distribution Tester API 사용 설정을 참조하세요.

• 키 제한사항 아래에서 Firebase App Testers API가 허용되는 API 목록에 포함되어 있는지 확인합니다.

• 로그아웃 시 일반적으로 SharedPreferences를 삭제하는 경우 테스터 상태가 삭제될 수 있습니다. App Distribution는 테스터가 이미 앱에 로그인했습니다. 자세한 내용은 GitHub 저장소.

앱에 테스터를 추가하는 데 한도가 있나요?

Firebase App Distribution에는 다음과 같은 테스터 한도가 있습니다.

• Firebase 프로젝트 하나에 최대 500명의 테스터 추가

• App Distribution 그룹 하나에 최대 200명의 테스터 추가

더 많은 테스터를 추가하려면 무료로 제공되는 한도 상향 조정을 요청하세요.

테스터 초대의 유효 기간이 정해져 있나요?

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

앱 출시 버전은 얼마 동안 사용할 수 있나요?

다음 조건 중 하나에 해당하는 경우 App Distribution에서 앱 버전이 삭제됩니다. 발생:

• 앱 출시 버전이 150일 이상 지났습니다.
• 앱 출시 한도 1,000개가 초과되었고 해당 앱 출시 버전이 1,000개의 최근 앱 출시 버전보다 오래 되었습니다.

자세한 내용은 App Distribution는 최대 1,000개의 출시 버전을 지원합니다.

앱이 150일 만료 한도(1,000일)에 도달하거나 초과한 후 출시 버전 한도에 도달하면 해당 출시 버전이 App Distribution 대시보드에서 삭제되고 Firebase App Tester 앱 테스터가 출시 버전을 설치한 경우 로컬 계속 실행되는지 확인할 수 있습니다.

앱 출시 버전을 더 오래 유지하려면 다음 권장사항 중 하나를 따르세요.

• 앱 버전이 출시 버전 한도를 초과하거나 만료되기 전에 APK 또는 AAB를 다시 시작하고 App Distribution 대시보드에서 출시 버전을 삭제합니다. 그런 다음 APK 또는 AAB를 새 빌드로 App Distribution에 다시 업로드합니다.
• 출시 버전을 다운로드하여 Cloud Storage에 업로드합니다. 장기 보관처리가 가능합니다

150일 후 앱 출시 버전 만료

앱 출시 버전을 Firebase에 업로드하면 출시 버전이 App Distribution 대시보드 업로드 날짜로부터 150일 동안 출시 버전을 업로드한 후에는 이를 테스터에 배포할 수 있고, 테스터가 자신의 테스트 기기에서 Firebase App Tester 앱으로부터 출시 버전을 설치할 수 있습니다.

출시 버전의 만료 날짜가 30일 남았으면 앱 출시 버전 만료 알림이 Firebase App Tester 앱의 출시 버전에 표시됩니다.

App Distribution는 최대 1,000개의 출시 버전을 지원합니다.

App Distribution에서 허용되는 최대 앱당 버전 1,000개 앱이 출시 버전 한도 1,000개에 도달하면 App Distribution에서 가장 오래된 항목 자동 삭제 확인할 수 있습니다

앱 출시를 수동으로 관리하려면 App Distribution REST API를 사용하세요. 목록에 및 delete 앱 출시를 일괄적으로 진행할 수 있습니다

질문이 있으면 Firebase 지원팀에 문의하세요.

기기에 설치된 테스트 앱에 액세스하려면 어떻게 해야 하나요?

테스터는 모든 테스트 빌드를 한 곳에서 액세스할 수 있는 앱인 Firebase App Tester를 다운로드하는 것이 좋습니다.

자동 테스터 기능에 할당량 한도가 있나요?

Firebase App Distribution에서 Firebase Test Lab 인프라 및 할당량을 사용합니다. 한도 및 가격은 동일합니다. 테스트 할당량은 자동으로 테스트됩니다 테스트 할당량 및 결제에 대한 자세한 내용은 사용량 Test Lab의 등급, 할당량, 가격 책정을 확인할 수 있습니다.

자동 테스터 기능의 할당량 재시도 한도는 어떻게 되나요?

할당량을 초과하면 할당량 초과 오류가 발생합니다. 할당량은 약 24시간 시간(단위: 시간)을 재설정하므로 할당량이 해제될 때까지 재시도를 피해야 합니다. 그러나 자동 테스터 인프라와 관련된 오류가 발생하는 경우가 많으며, 확인할 수 있습니다.

자동 테스터 베타 기능을 실행하려면 어떤 권한이 필요한가요?

실행하려면 Firebase 프로젝트에 대한 편집자 액세스 권한이 있어야 합니다. 자동 테스터 기능으로 테스트를 수행할 수도 있습니다

테스터 계정을 삭제하려면 어떻게 해야 하나요?

App Distribution 테스터 계정 및 관련 데이터를 삭제하려면 다음 단계를 따르세요. 다음 단계를 순서대로 따르세요.

1. https://appdistribution.firebase.google.com을 방문하여 Google 계정으로 로그인합니다.

2. 오른쪽 상단에서 settings(계정 관리)을 클릭합니다.

   계정을 삭제합니다.

3. 선택사항: Google 계정 권한에서 Firebase App Distribution님의 액세스 권한을 취소합니다. 참고: 먼저 App Distribution 계정을 삭제해도 테스터가 삭제되지 않습니다. 데이터를 수집할 수 있습니다.