이 페이지에서는 앱 배포를 이용한 앱 배포 및 테스트 작업과 관련하여 자주 묻는 질문에 대한 답변과 문제 해결 도움말을 제공합니다.
앱 설치 및 테스트
다음 도움말은 테스터가 기기에 테스트 앱을 설치하고 액세스하는 과정에서 발생하는 문제를 해결하도록 도와줍니다.
Google 계정에 테스트 앱 액세스 권한이 없음
Google 계정에 이전에 설치 또는 초대를 수락한 테스트 앱에 대한 액세스 권한이 없거나 잘못된 Google 계정에 로그인했을 가능성이 있습니다. 액세스할 수 있는 앱은 앱을 테스트하기 위한 초대를 처음으로수락하는 데 사용했던 Google 계정과 연결되어 있습니다. 이전에 초대를 수락하는 데 사용했던 Google 계정으로 로그인하여 다시 시도하세요.
테스트 앱을 실행할 때 '신뢰할 수 없는 엔터프라이즈 개발자' 오류 발생
앱을 열기 전에 테스트 기기에서 개발자 인증서를 신뢰하지 않으면 신뢰할 수 없는 엔터프라이즈 개발자 오류가 발생합니다. 설정 앱 > 프로필 및 기기 관리 화면에서 앱의 개발자 이름을 선택하고 신뢰하세요.
'개발자 대기 중'으로 인한 테스트 앱 설치 차단
임시 배포를 설치할 경우 개발자가 아직 테스트 기기에서 앱을 실행하도록 구성하지 않았으면 개발자 대기 중 버튼이 표시됩니다. 앱을 사용할 수 있게 하려면 개발자가 다음 단계를 완료해야 합니다.
Apple Developer 포털에서 테스트 기기의 UDID를 추가합니다. 기기를 Firebase에 등록하면 UDID의 이메일이 개발자에게 발송됩니다.
앱의 프로비저닝 프로필에 기기를 포함합니다.
업데이트된 프로비저닝 프로필을 사용하여 앱을 빌드합니다.
Firebase Console, CLI 또는 fastlane을 사용하여 새 빌드를 배포합니다.
앱 배포 SDK로 인앱 알림 사용 설정
개발자와 테스터가 앱 배포 SDK를 사용하여 새로운 빌드 알림을 사용 설정할 때 발생하는 문제를 해결하는 데 도움이 되는 팁은 다음과 같습니다.
테스터가 인앱 알림을 받지 못함
앱에 이미 앱 배포 SDK를 설정했는데 테스터가 인앱 알림을 받지 못하는 경우 앱이 새 출시 버전을 가져오고 있는지 확인합니다.
앱에서 디버그 모드를 사용 설정한 후(방법은 Google 애널리틱스 문서 참조) 시뮬레이터에서 앱을 실행하고 '[Firebase/AppDistribution]' 문자열을 검색합니다.
앱 출시 버전을 가져오고 있는지 확인합니다.
유효한 출시 버전 객체가 반환될 경우 뷰가 표시되기 전에 알림 대화상자가 로드되는 뷰 컨트롤러 수명 주기에 문제가 있을 가능성이 높습니다. 앱 배포 SDK는 기본적으로 알림 대화상자를 표시하지 않습니다. 앱에서 대화상자가 표시되는 방식과 위치를 지정해야 합니다(예시는 기본 알림 구성 참조).
출시 버전이 반환되지 않는다면 테스터가 아직 새 출시 버전과 연결되지 않았을 수 있습니다. Firebase Console의 앱 배포 대시보드에서 테스터가 빌드 배포에 포함되어 있고 수락됨 상태인지 확인합니다.
테스터가 여전히 알림을 받지 못하는 경우 아래 팁에 따라 앱 테스트 초대를 수락하고 테스트 기기를 올바르게 설정했는지 확인하세요.
테스트 기기에서 Firebase 앱 배포 웹 클립에 로그인합니다. 앱 테스트 초대를 수락할 때는 처음에 사용한 Google 계정을 선택해야 합니다.
웹 클립에서 새 앱 출시 버전을 사용할 수 있는지 확인하세요.
테스터에게 앱을 닫았다가 다시 로그인하라는 메시지가 표시됨
기본적으로 테스터는 Google 계정에 한 번만 로그인하면 새 빌드 알림을 사용 설정하고 새 빌드를 설치할 수 있습니다. 테스터에게 앱을 닫았다가 다시 연 후 다시 로그인하라는 메시지가 표시되면 다음 팁에 따라 앱 배포 구성이 올바르게 설정되어 있는지 확인하세요.
App Distribution Tester API를 사용 설정했는지 확인합니다(앱 배포 SDK 가이드의 안내 참조).
Google Cloud Platform Console의 키 제한사항에서 제한된 API 키를 사용하고 있지 않은지 확인합니다.
로그아웃 시 일반적으로
UserDefaults를 삭제하면 테스터의 상태가 삭제될 수 있습니다. 앱 배포는 테스터가 이미 앱에 로그인했는지 여부를 나타내는 플래그를 저장합니다(자세한 내용은 GitHub 저장소 참조).
자주 묻는 질문(FAQ)
앱에 테스터를 추가하는 데 한도가 있나요?
Firebase 앱 배포에는 다음과 같은 테스터 한도가 있습니다.
Firebase 프로젝트 하나에 최대 500명까지 테스터 추가
앱 배포 그룹 하나에 최대 200명까지 테스터 추가
배포당 최대 200명까지 테스터 추가
더 많은 테스터를 추가하려면 무료 한도 상향 조정을 요청하세요.
앱 빌드는 만료되나요?
Firebase에 앱 빌드를 업로드하면 업로드한 날로부터 150일(5개월) 동안 Firebase Console의 앱 배포 대시보드에서 사용할 수 있게 됩니다. 그러면 테스트 기기의 Firebase 앱 배포 웹 클립에서 빌드를 설치할 수 있는 테스터에게 배포할 수 있습니다. 개발자와 테스터에게 알리기 위해 만료되기 30일 전부터 빌드에 만료 알림이 표시됩니다.
150일의 기간이 지나면 빌드가 만료되고 앱 배포 대시보드 및 Firebase 앱 배포 웹 클립에서 삭제됩니다. 테스터가 빌드를 설치한 경우 앱의 로컬 버전은 계속 실행됩니다.
빌드를 더 오래 보관하려면 다음 솔루션을 사용하는 것이 좋습니다.
빌드가 만료되기 전에 IPA를 다운로드한 후 앱 배포 대시보드에서 빌드를 삭제합니다. 그런 다음 IPA를 새로운 빌드로 Firebase 앱 배포에 다시 업로드합니다.
장기적으로 보관처리하려면 빌드를 다운로드하고 Firebase용 Cloud Storage에 업로드합니다.
Firebase 프로필이란 무엇인가요?
Firebase 프로필은 앱 배포에서 다음 사항을 수행할 때 필요한 구성 프로필입니다.
기기의 고유 기기 ID(UDID)를 수집하여 테스트 기기를 등록합니다. 임시 배포를 테스트할 경우 기기에서 빌드를 테스트할 수 있도록 Firebase가 앱 개발자에게 테스트 기기의 UDID와 함께 앱의 프로비저닝 프로필에 기기를 포함하는 방법에 대한 안내를 이메일로 발송합니다.
Firebase 앱 배포 웹 클립을 기기의 홈 화면에 설치합니다. 웹 클립을 사용하면 모든 테스트 앱을 한 곳에 설치하고 액세스할 수 있습니다. 테스트하도록 초대받은 새 빌드가 자동으로 웹 클립에 추가됩니다.
iOS 기기에 구성 프로필을 설치하는 방법은 Apple 문서를 참조하세요.
기기에 설치된 테스트 앱에 액세스하려면 어떻게 해야 하나요?
테스터는 Firebase 프로필을 설치할 때 테스트 기기의 홈 화면에 자동으로 추가되는 Firebase 앱 배포 웹 클립으로 모든 테스트 앱에 액세스할 수 있습니다. 임시 배포를 테스트할 경우 먼저 프로필을 설치해야 앱을 테스트할 수 있습니다.
엔터프라이즈 배포를 테스트할 경우 프로필을 수동으로 설치할 수 있습니다.
아직 로그인하지 않았으면 Google 계정으로 로그인하여 초대를 수락합니다.
테스트 앱에서 테스트할 앱을 선택합니다.
앱 페이지 오른쪽 상단에서 mobile_screen_share를 탭합니다.
표시된 안내를 따라 Firebase 프로필을 설치합니다.
테스터 계정을 삭제하려면 어떻게 해야 하나요?
앱 배포 테스터 계정 및 관련 데이터를 삭제하려면 다음 단계를 순서대로 따르세요.
https://appdistribution.firebase.google.com을 방문하여 Google 계정으로 로그인합니다.
오른쪽 상단에서 settings(계정 관리)을 클릭합니다.
계정을 삭제합니다.
선택사항: Google 계정 권한에 있는 Firebase 앱 배포의 액세스 권한을 취소합니다. 먼저 앱 배포 계정을 삭제하지 않고 액세스 권한을 취소하면 테스터 계정 또는 데이터가 삭제되지 않습니다.