앱 배포 문제 해결 및 FAQ

연락처 이메일 누락으로 앱 배포 불가

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

" <app-id> 에 대한 연락처 이메일을 찾을 수 없습니다. 설정하려면 Firebase 콘솔 내에서 앱 배포를 방문하세요."

가능한 경우 Firebase 콘솔에서 연락처 이메일을 설정합니다. 문제가 지속되면 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."
}

이 문제를 해결하려면 다음 단계를 따르십시오.

1. IPA의 크기를 확인합니다. 모든 바이너리의 최대 파일 크기 제한은 2048MiB로 2GB를 약간 넘습니다.

2. IPA 크기가 파일 크기 제한 내에 있고 재현 가능한 경우 다음 단계를 따르십시오.

   1. Info.plist 파일을 확인하고 CFBundleDisplayName 에 <array> 구분 기호가 포함되어 있는지 확인하십시오.

   2. <array> 구분 기호를 제거하고 앱을 다시 빌드하십시오. 업로드가 성공해야 합니다.

   3. 여전히 문제가 발생하면 Firebase 지원팀 에 문의하세요.

3. IPA 크기가 파일 크기 제한을 초과하는 경우 필요에 따라 변경하여 파일 크기를 줄이십시오.

4. IPA 파일 크기를 줄여도 문제가 해결되지 않으면 Firebase 지원팀 에 문의하여 Testflight 사용에 대해 문의하세요.

테스터에게 Google 계정이 없습니다.

사용자가 Google 계정을 만들면 자동으로 Gmail 주소를 받습니다.

테스터에게 G Suite 또는 Gmail 주소가 없거나 다른 이메일 주소를 사용하여 로그인하려는 경우 테스터에게 Gmail이 아닌 이메일 주소를 계정에 연결하고 해당 이메일을 사용하여 로그인하도록 요청하세요.

대체 이메일을 선택할 때 테스터는 다음 지침을 따라야 합니다.

• Gmail 주소를 사용하지 마세요.
• 이미 다른 Google 계정에 연결된 이메일 주소를 사용하지 마세요.
• 이 이메일 주소로 로그인할 때 Google 계정 비밀번호를 사용해야 합니다.

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

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

테스터가 초대가 전송된 이메일 주소와 다른 이메일 주소로 이메일 초대를 수락한 경우 테스터는 올바른 앱 또는 빌드를 보지 못할 수 있습니다.

개발자가 초대를 보내고 새 빌드에 추가하는 이메일(이메일 A)은 테스터가 초대를 수락하는 데 사용하는 이메일(이메일 B)과 다를 수 있습니다. 이렇게 하면 장면 뒤에 링크가 생성됩니다. 이메일 A가 새 빌드에 추가될 때마다 실제로 액세스 권한을 얻는 것은 이메일 B입니다.

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

1. Firebase 콘솔의 앱 배포 페이지에 있는 테스터 및 그룹 탭에서 테스터를 삭제합니다. 기존 초대가 제거됩니다.

2. 테스터를 다시 초대하여 앱을 테스트합니다. 테스터는 초대 이메일을 받아야 합니다.

3. 테스터가 동일한 이메일 주소로 초대를 수락하는지 확인하세요.

테스터가 이메일 알림을 받지 못하고 있습니다.

테스터는 다음 중 하나가 발생하는 경우 이메일 알림을 받지 못할 수 있습니다.

• 이메일 알림은 스팸 폴더로 전송됩니다.

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

• 초대는 하나의 이메일 계정으로 전송되었지만 테스터는 다른 이메일 계정으로 수락했습니다. 테스터는 초대가 원래 전송된 이메일 계정에 대한 새 릴리스 이메일을 받습니다.

• 테스터가 이전에 초대되었지만 초기 초대를 수락하지 않았습니다. 테스터가 후속 릴리스에 추가되면 테스터가 초기 초대를 수락하지 않았기 때문에 앱 배포는 해당 테스터에게 릴리스 알림을 자동으로 보내지 않습니다.

솔루션 1

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

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

   1. 테스터가 이전에 앱에서 받은 이메일을 찾습니다.
   2. 하단의 이메일 설정 관리 를 클릭하고 이메일 재구독 허용 을 클릭합니다.

솔루션 2

1. Firebase 콘솔의 앱 배포 페이지에 있는 테스터 및 그룹 탭에서 테스터를 삭제합니다. 이 작업은 기존 초대를 제거합니다.

2. 테스터를 다시 초대하여 앱을 테스트합니다. 테스터는 초대 이메일을 받아야 합니다. 테스터가 초대를 받은 이메일 주소와 동일한 이메일 주소로 초대를 수락했는지 확인하세요.

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

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

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

먼저 개발자 모드를 활성화하지 않고 iOS 16 이상에서 임시 프로비저닝된 iOS 앱을 실행하려고 하면 개발자 모드 필요 오류가 나타납니다.

개발자 모드를 활성화하고 이 오류를 해결하려면 다음 단계를 따르십시오.

1. iPhone에서 설정 앱을 연 다음 개인 정보 및 보안 을 탭합니다.
2. 보안까지 아래로 스크롤하고 개발자 모드 를 탭합니다.
3. 개발자 모드 슬라이더를 누릅니다.
4. 다시 시작 을 탭합니다.
5. 장치가 다시 시작되면 장치 잠금을 해제하십시오. 개발자 모드를 켜시겠습니까? 대화 상자가 나타납니다.
6. 켜기 를 탭합니다. 이제 앱을 실행하고 테스트를 시작할 수 있습니다.

"기기가 등록되었습니다. 모든 설정이 완료되었습니다! 앱을 테스트할 준비가 되면 이메일이 전송됩니다."

Ad Hoc 배포를 설치하는 경우 개발자가 테스트 기기에서 실행되도록 앱을 아직 구성하지 않은 경우 이 메시지가 나타납니다. 앱을 사용할 수 있게 하려면 개발자가 추가 장치 등록 의 지침을 완료해야 합니다.

Google 계정에 테스트 앱에 대한 액세스 권한이 없습니다.

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

403 오류: "액세스하려면 관리자에게 문의하십시오."

403 오류가 발생하면 사용 중인 계정에 앱을 설치하고 테스트할 수 있는 권한이 없음을 의미합니다. 액세스 권한은 Google Workspace의 계정 도메인 관리자가 결정합니다.

앱을 설치하고 테스트할 수 있는 권한이 필요하다고 생각되면 Google Workspace 계정 관리자에게 계정 설정을 변경해 달라고 요청하세요. 관리자는 개별적으로 제어되지 않는 서비스에 대한 액세스 관리 의 지침을 따라야 합니다.

계정이 여러 개인 경우 앱 설치 및 테스트에 제한이 없는 다른 계정으로 로그인해 보세요.

테스터가 인앱 알림을 수신하지 않음

앱에서 이미 앱 배포 iOS SDK를 설정했고 테스터가 인앱 알림을 받지 못하는 경우 앱이 새 릴리스를 가져오는지 확인하세요.

1. 앱에서 디버그 모드를 활성화합니다. 방법을 알아보려면 Google Analytics 설명서 를 참조하십시오.

2. 시뮬레이터에서 앱을 실행하고 "[Firebase/AppDistribution]" 문자열을 검색합니다.

3. 테스터가 새 릴리스에 액세스할 수 있는지 확인합니다.

   • 유효한 릴리스 개체가 반환되면 보기가 나타나기 전에 경고 대화 상자가 로드되는 보기 컨트롤러 수명 주기에 문제가 있을 수 있습니다.

   • 릴리스가 반환되지 않으면 테스터가 아직 새 릴리스와 연결되지 않았을 수 있습니다. Firebase 콘솔의 앱 배포 대시보드에서 테스터가 빌드 배포에 포함되어 있고 수락됨 상태인지 확인합니다.

     테스터가 여전히 업데이트를 받지 못하는 경우 아래 도움말에 따라 앱 테스트 초대를 수락하고 테스트 기기를 올바르게 설정했는지 확인하도록 요청하세요.

     1. 테스트 기기에서 Firebase 앱 배포 웹 클립에 로그인합니다. 앱 테스트 초대를 수락했을 때 처음 사용한 Google 계정을 선택해야 합니다.

     2. 웹 클립에서 새로운 앱 릴리스를 사용할 수 있는지 확인하십시오.

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

기본적으로 테스터는 새 빌드 알림을 활성화하고 새 빌드를 설치하기 위해 Google 계정에 한 번만 로그인하면 됩니다. 앱을 닫았다가 다시 연 후 테스터에게 다시 로그인하라는 메시지가 표시되면 다음 팁에 따라 앱 배포 구성이 제대로 설정되었는지 확인하세요.

• Firebase App Testers API를 사용하도록 설정했는지 확인하세요. 자세한 내용 은 App Distribution Tester API 활성화 를 참조하십시오.

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

• 일반적으로 로그아웃 시 UserDefaults를 지우는 경우 테스터의 상태를 지우는 것일 수 있습니다. 앱 배포는 테스터가 이미 앱에 로그인했는지 여부를 나타내는 플래그를 저장합니다. 자세한 내용은 GitHub 리포지토리 를 참조하십시오.

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

Firebase 앱 배포에는 다음과 같은 테스터 제한이 있습니다.

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

• 앱 배포 그룹에 최대 200명의 테스터 추가

더 많은 테스터를 추가하려면 무료 한도 증가 를 요청하세요.

내 테스터 초대가 만료됩니까?

테스터는 앱이 만료되기 전에 30일 이내에 앱 테스트 초대를 수락해야 합니다. 초대가 만료되기까지 5일이 지나면 Firebase 콘솔에서 릴리스의 테스터 옆에 만료 알림이 표시됩니다. 테스터 행의 드롭다운 메뉴를 통해 다시 보내 초대를 갱신할 수 있습니다.

iOS 업로드용 새 릴리스는 언제 생성되나요?

추가 장치 등록 을 참조하십시오.

앱 릴리스는 얼마나 오래 사용할 수 있나요?

다음 조건 중 하나가 발생하면 앱 배포에서 앱 릴리스가 제거됩니다.

• 앱 릴리스가 150일보다 오래되었습니다.
• 1,000개의 앱 릴리스 제한을 초과했으며 앱 릴리스가 가장 최근의 1,000개 앱 릴리스보다 오래된 것입니다.

자세한 내용은 앱 배포에서 최대 1,000개의 릴리스 지원을 참조하세요.

앱이 150일 만료 제한 또는 1,000개 앱 릴리스 제한에 도달하거나 초과하면 앱 배포 대시보드 및 앱 배포 테스터 웹 앱에서 릴리스가 제거됩니다. 테스터가 릴리스를 설치한 경우 앱의 로컬 버전이 계속 실행됩니다.

앱 릴리스를 더 오래 사용할 수 있도록 하려면 다음 권장 사항 중 하나를 사용하세요.

• 앱 릴리스가 만료되거나 릴리스 제한을 초과하기 전에 IPA를 다운로드하고 앱 배포 대시보드에서 릴리스를 삭제하십시오. 그런 다음 IPA를 앱 배포에 새 빌드로 다시 업로드합니다.
• 출시 버전을 다운로드하고 장기 보관처리를 위해 Cloud Storage 에 업로드하세요.

앱 릴리스는 150일 후에 만료됩니다.

Firebase에 앱 버전을 업로드하면 업로드 날짜로부터 150일 동안 앱 배포 대시보드 에 해당 버전이 표시됩니다. 릴리스를 업로드한 후 테스트 장치에 앱 배포 테스터 웹 앱에서 릴리스를 설치하는 테스터에게 배포할 수 있습니다.

릴리스가 만료일로부터 30일이 되면 Firebase 콘솔의 앱 배포 페이지와 앱 배포 테스터 웹 앱의 릴리스에 앱 릴리스 만료 알림이 표시됩니다.

앱 배포는 최대 1,000개의 릴리스를 지원합니다.

앱 배포는 앱당 최대 1,000개의 릴리스를 허용합니다. 앱이 1,000개의 앱 릴리스 제한에 도달하면 앱 배포는 제한을 초과하는 가장 오래된 릴리스를 자동으로 삭제합니다.

앱 릴리스를 수동으로 관리하려면 앱 배포 REST API를 사용하여 앱 릴리스를 대량으로 나열 하고 삭제 하세요.

질문이 있는 경우 Firebase 지원팀 에 문의하세요.

Firebase 프로필이 무엇인가요?

Firebase 프로필은 앱 배포를 허용하는 구성 프로필입니다.

• 디바이스 고유 디바이스 ID(UDID)를 수집하여 테스트 디바이스를 등록합니다. Ad Hoc 배포를 테스트하는 경우 Firebase는 기기에서 빌드를 테스트할 수 있도록 앱의 프로비저닝 프로필에 기기를 포함하는 방법에 대한 지침과 함께 테스트 기기의 UDID가 포함된 이메일을 앱 개발자에게 보냅니다.

• 기기의 홈 화면에 Firebase 앱 배포 웹 클립을 설치합니다. 웹 클립을 사용하면 한 곳에서 모든 테스트 앱을 설치하고 액세스할 수 있습니다. 테스트하도록 초대받은 새 빌드는 웹 클립에 자동으로 추가됩니다.

iOS 장치에 구성 프로파일을 설치하는 방법에 대한 도움말은 Apple 설명서 를 참조하십시오.

내 장치에 설치한 테스트 앱에 액세스하려면 어떻게 해야 합니까?

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

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

1. 아직 하지 않았다면 Google에 로그인하고 초대를 수락하세요.

2. 테스트 앱 에서 테스트할 앱을 선택합니다.

3. 앱 페이지의 오른쪽 상단에서 mobile_screen_share 를 탭합니다.

4. 표시되는 안내에 따라 Firebase 프로필을 설치하세요.

테스터 계정은 어떻게 삭제합니까?

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

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

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

   계정 삭제 .

3. 선택 사항: Google 계정 권한 에서 Firebase 앱 배포에 대한 액세스 권한을 취소합니다. 앱 배포 계정을 먼저 삭제하지 않고 액세스 권한을 취소해도 테스터 계정이나 데이터는 삭제 되지 않습니다 .