앱 배포 문제 해결 및 FAQ

이 페이지에서는 App Distribution을 사용한 앱 배포와 테스트와 관련하여 자주 묻는 질문(FAQ)에 대한 답변과 문제 해결 도움말을 제공합니다.

앱 배포

다음 팁을 사용하여 테스터들에게 앱을 배포할 때 발생할 수 있는 문제를 해결할 수 있습니다.

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

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

'<app-id> 앱의 연락처 이메일을 찾을 수 없습니다. Firebase Console 내에서 App Distribution으로 이동하여 설정하세요.'

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

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

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

IPA를 업로드할 수 없음

다음은 브라우저 네트워크 응답의 예시입니다.

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

이 문제를 해결하려면 다음 단계를 따르세요.

IPA의 크기를 확인합니다. 모든 바이너리의 최대 파일 크기 한도는 2GB보다 약간 더 큰 2,048MiB입니다.
IPA 크기가 파일 크기 한도 내에 있고 재현 가능한 경우에는 다음 단계를 수행합니다.
1. Info.plist 파일을 확인하고 CFBundleDisplayName에 <array> 구분자가 포함되어 있는지 확인합니다.
  
  참고: 앱 배포에서는 배열인 CFBundleDisplayName 값이 수락되지 않습니다.
2. <array> 구분자를 삭제하고 앱을 다시 빌드하면 업로드가 성공합니다.
3. 문제가 계속되면 Firebase 지원팀에 문의하세요.
IPA 크기가 파일 크기 한도를 초과하면 파일 크기를 줄일 수 있도록 필요한 변경 작업을 수행합니다.
IPA 파일 크기를 줄여도 문제가 해결되지 않으면 Firebase 지원팀에 문의하고 Testflight 사용을 문의하세요.

앱 설치 및 테스트

다음 팁을 사용하여 앱을 설치 및 테스트할 때 발생할 수 있는 문제를 해결할 수 있습니다.

테스터에게 Google 계정이 없음

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

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

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

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

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

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

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

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

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

Firebase Console의 App Distribution 페이지에 있는 테스터 및 그룹 탭의 모든 테스터 보기 섹션에서 테스터를 삭제합니다. 기존 초대가 삭제됩니다.
앱을 테스트하도록 테스터를 다시 초대합니다. 테스터에게 초대 이메일이 전송됩니다.
테스터가 동일한 이메일 주소를 사용하여 초대를 수락하는지 확인합니다.

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

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

이메일 알림이 스팸 폴더로 전송되었습니다.
이메일 필터가 설정되었습니다.
초대가 하나의 이메일 계정에 전송되었지만 테스터가 다른 이메일 계정을 사용하여 수락했습니다. 초대가 처음 전송된 이메일 계정에 대해 새로운 출시 이메일이 테스터에게 수신됩니다.
테스터가 이전에 초대되었지만 처음 초대를 수락하지 않았습니다. 테스터가 후속 출시 버전에 추가된 경우 테스터가 처음 초대를 수락하지 않았으므로 App Distribution에서 출시 알림을 해당 테스터로 자동 전송하지 않습니다.

솔루션 1

테스터에게 스팸 폴더 및 이메일 서비스에 설정된 이메일 필터를 확인하도록 요청합니다.
테스터가 이메일을 구독 취소한 경우 테스터에게 다음을 수행하도록 요청합니다.
1. 테스터가 이전에 앱에서 받은 이메일을 찾습니다.
2. 아래에 있는 이메일 설정 관리를 클릭하고 이메일 허용을 클릭하여 다시 구독합니다.

솔루션 2

테스터는 이메일 알림을 받는 데 관심이 없고 앱 초대를 수락만 하려는 경우 Firebase App Distribution 웹 클립(appdistribution.firebase.google.com)에서 대기 중인 앱 초대를 직접 볼 수 있습니다.

솔루션 3

Firebase Console의 App Distribution 페이지에 있는 테스터 및 그룹 탭의 모든 테스터 보기 섹션에서 테스터를 삭제합니다. 이 작업을 수행하면 기존 초대가 삭제됩니다.
앱을 테스트하도록 테스터를 다시 초대합니다. 테스터에게 초대 이메일이 전송됩니다. 테스터가 초대가 전송된 것과 동일한 이메일 주소를 사용하여 초대를 수락하는지 확인합니다.

테스트 앱을 실행할 때 '신뢰할 수 없는 엔터프라이즈 개발자' 오류 발생

앱을 열기 전에 테스트 기기에서 개발자 인증서를 신뢰하지 않으면 신뢰할 수 없는 엔터프라이즈 개발자 오류가 발생합니다. 설정 앱 > 프로필 및 기기 관리 화면에서 앱의 개발자 이름을 선택하고 신뢰하세요.

테스트 앱을 실행하려고 할 때 '개발자 모드 필요' 오류 발생

개발자 모드 필요 오류는 먼저 개발자 모드를 사용 설정하지 않고 iOS 16 이상에서 임시 프로비저닝된 iOS 앱을 실행하려고 할 때 표시됩니다.

개발자 모드를 사용 설정하고 이 오류를 해결하려면 다음 단계를 수행합니다.

iPhone에서 설정 앱을 열고 개인정보 보호 및 보안을 탭합니다.
보안까지 아래로 스크롤한 후 개발자 모드를 탭합니다.
개발자 모드 슬라이더를 탭합니다.
다시 시작을 탭합니다.
기기가 다시 시작되면 기기를 잠금 해제합니다. '개발자 모드를 사용 설정하시겠습니까?' 대화상자가 표시됩니다.
사용을 탭합니다. 이제 앱을 실행하고 테스트를 시작할 수 있습니다.

'기기가 등록되었으며 이제 준비가 끝났습니다. 앱을 테스트할 준비가 되면 이메일이 전송됩니다.'

임시 배포를 설치할 경우 개발자가 아직 테스트 기기에서 앱을 실행하도록 구성하지 않았으면 이 메시지가 표시됩니다. 앱을 사용할 수 있게 하려면 개발자가 추가 기기 등록의 안내를 완료해야 합니다.

Google 계정에 이전에 설치 또는 초대를 수락한 테스트 앱에 대한 액세스 권한이 없거나 잘못된 Google 계정에 로그인했을 가능성이 있습니다. 액세스할 수 있는 앱은 앱을 테스트하기 위한 초대를 처음으로 수락하는 데 사용했던 Google 계정과 연결되어 있습니다. 이전에 초대를 수락하는 데 사용했던 Google 계정으로 로그인하여 다시 시도하세요.

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

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

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

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

App Distribution iOS SDK로 인앱 알림 사용 설정

다음 팁을 따라 App Distribution iOS SDK를 사용하여 새로운 인앱 빌드 알림을 사용 설정할 때 발생하는 문제를 해결할 수 있습니다.

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

앱에 이미 App Distribution iOS SDK를 설정했지만 테스터에서 인앱 알림을 받지 못하면 앱에서 새 출시 버전을 가져오고 있는지 확인합니다.

앱에서 디버그 모드를 사용 설정합니다. 방법은 Google 애널리틱스 문서를 참조하세요.
시뮬레이터에서 앱을 실행하고 '[Firebase/AppDistribution]' 문자열을 검색합니다.
테스터가 새 출시 버전에 액세스할 수 있는지 확인합니다.
- 유효한 출시 버전 객체가 반환될 경우 뷰가 표시되기 전에 알림 대화상자가 로드되는 뷰 컨트롤러 수명 주기에 문제가 있을 가능성이 높습니다.
  
  참고: App Distribution iOS SDK는 기본적으로 알림 대화상자를 표시하지 않습니다. 앱에서 대화상자가 표시되는 방식과 위치를 지정해야 합니다. 자세한 내용은 기본 알림 구성을 참조하세요.
- 출시 버전이 반환되지 않는다면 테스터가 아직 새 출시 버전과 연결되지 않았을 수 있습니다. Firebase Console의 App Distribution 대시보드에서 테스터가 빌드 배포에 포함되어 있고 수락됨 상태인지 확인합니다.
  
  테스터가 여전히 업데이트를 받지 못하는 경우 아래 팁에 따라 앱 테스트를 위해 초대를 수락했고 테스트 기기를 올바르게 설정했는지 확인합니다.
  1. 테스트 기기에서 Firebase 앱 배포 웹 클립에 로그인합니다. 앱 테스트 초대를 받았을 때 처음 사용한 Google 계정을 선택해야 합니다.
  2. 웹 클립에서 새 앱 출시 버전을 사용할 수 있는지 확인합니다.

기본적으로 테스터는 Google 계정에 한 번만 로그인하면 새 빌드 알림을 사용 설정하고 새 빌드를 설치할 수 있습니다. 테스터에 앱을 닫았다가 다시 연 후 다시 로그인하라는 메시지가 표시되면 다음 팁을 수행하여 App Distribution 구성이 올바르게 설정되어 있는지 확인합니다.

Firebase App Testers API를 사용 설정했는지 확인합니다. 자세한 내용은 App Distribution Tester API 사용 설정을 참조하세요.
키 제한사항 아래에서 Firebase App Testers API가 허용되는 API 목록에 포함되어 있는지 확인합니다.
로그아웃 시 일반적으로 UserDefaults를 지우는 경우 테스터 상태가 삭제될 수 있습니다. App Distribution에는 테스터가 이미 앱에 로그인되었는지 여부를 나타내는 플래그가 저장되어 있습니다. 자세한 내용은 GitHub 저장소를 참조하세요.

자주 묻는 질문(FAQ)

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

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

Firebase 프로젝트 하나에 최대 500명의 테스터 추가
App Distribution 그룹에 테스터를 최대 200개까지 추가

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

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

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

iOS 업로드에 대한 새 출시 버전은 언제 생성되나요?

추가 기기 등록을 참조하세요.

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

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

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

자세한 내용은 App Distribution에서 출시 버전을 최대 1,000개까지 지원을 참조하세요.

앱이 150일 만료 한도나 출시 버전 1,000개 한도에 도달하거나 초과하면 출시 버전이 App Distribution 대시보드와 App Distribution 테스터 웹 앱에서 삭제됩니다. 테스터에서 출시 버전을 설치한 경우에는 로컬 앱 버전이 계속 실행됩니다.

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

앱 출시 버전의 출시 버전 한도가 만료되거나 초과되기 전에 IPA를 다운로드하고 App Distribution 대시보드에서 출시 버전을 삭제합니다. 그런 다음 IPA를 새 빌드로 App Distribution에 다시 업로드합니다.
장기간 보관하려면 출시 버전을 다운로드하여 Cloud Storage에 업로드합니다.

150일 후 앱 출시 버전 만료

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

출시 버전의 만료 날짜가 30일 남았으면 앱 출시 버전 만료 알림이 Firebase Console의 App Distribution 페이지와 App Distribution 테스터 웹 앱의 출시 버전에 표시됩니다.

App Distribution에서 출시 버전 최대 1,000개까지 지원

App Distribution에서는 출시 버전을 앱당 최대 1,000개까지 허용합니다. 앱이 앱 출시 버전 한도 1,000개에 도달하면 App Distribution에서 한도를 초과하는 가장 오래된 출시 버전을 자동으로 삭제합니다.

앱 출시 버전을 수동으로 관리하려면 App Distribution REST API를 사용하여 앱 출시 버전을 대량으로 나열하고 삭제합니다.

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

Firebase 프로필이란 무엇인가요?

Firebase 프로필은 App Distribution에서 다음 작업을 할 수 있는 구성 프로필입니다.

기기의 고유 기기 ID(UDID)를 수집하여 테스트 기기를 등록합니다. 임시 배포를 테스트할 경우 기기에서 빌드를 테스트할 수 있도록 Firebase가 앱 개발자에게 테스트 기기의 UDID와 함께 앱의 프로비저닝 프로필에 기기를 포함하는 방법에 대한 안내를 이메일로 발송합니다.
Firebase App Distribution 웹 클립을 기기의 홈 화면에 설치합니다. 웹 클립을 사용하면 모든 테스트 앱을 한 곳에 설치하고 액세스할 수 있습니다. 테스트하도록 초대받은 새 빌드가 자동으로 웹 클립에 추가됩니다.

iOS 기기에 구성 프로필을 설치하는 방법은 Apple 문서를 참조하세요.

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

테스터는 Firebase 프로필을 설치할 때 테스트 기기의 홈 화면에 자동으로 추가되는 Firebase App Distribution 웹 클립으로 모든 테스트 앱에 액세스할 수 있습니다. 임시 배포를 테스트할 경우 먼저 프로필을 설치해야 앱을 테스트할 수 있습니다.

엔터프라이즈 배포를 테스트할 경우 프로필을 수동으로 설치할 수 있습니다.

아직 로그인하지 않았으면 Google 계정으로 로그인하여 초대를 수락합니다.
테스트 앱에서 테스트할 앱을 선택합니다.
앱 페이지 오른쪽 상단에서 를 탭합니다.
표시된 안내를 따라 Firebase 프로필을 설치합니다.

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

App Distribution 테스터 계정과 관련 데이터를 삭제하려면 다음 단계를 순서대로 수행합니다.

https://appdistribution.firebase.google.com을 방문하여 Google 계정으로 로그인합니다.
오른쪽 상단에서 (계정 관리)을 클릭합니다.

계정을 삭제합니다.
선택사항: Google 계정 권한에서 Firebase App Distribution의 액세스 권한을 취소합니다. 먼저 App Distribution 계정을 삭제하지 않고 액세스 권한을 취소하면 테스터 계정이나 데이터가 삭제되지 않습니다.