앱 빌드 중 오류가 발생할 경우, 아래 두 가지 유형으로 나뉩니다.
에러 구분
사용자 에러: 대시보드 내 설정 미완료로 사용자가 직접 수정 가능한 오류
시스템 에러: 시스템 또는 환경 문제로, 내부 점검이 필요한 오류
이 오류는 주로 대시보드 내 필수 설정이 완료되지 않아 발생합니다.아래 항목을 모두 확인하고 설정을 완료한 뒤, 다시 빌드를 시도해주세요.
항목 | 안내 문구(영문) | 원인 | 설정 가이드 |
푸시 기능 | Push settings have not been configured. | 푸시 기능을 포함하지만, 푸시 환경 설정(FCM 또는 APNs)이 완료되지 않았습니다. | |
탭바 기능 | Tabbar settings have not been configured. | 탭바 기능을 포함하지만, 탭 구성이 완료되지 않았습니다. | |
인앱결제 | In-app purchase settings have not been configured. | 인앱결제 기능을 포함하지만, 인앱결제 설정이 완료되지 않았습니다. | |
카카오 로그인 | Kakao native key has not been set. | 카카오 로그인 기능을 포함하지만, 카카오 설정이 완료되지 않았습니다. | |
페이스북 로그인 | Facebook native settings have not been configured. | 페이스북 로그인 기능을 포함하지만, 페이스북 로그인 설정이 완료되지 않았습니다. | |
앱스플라이어 | Appsflyer settings have not been configured. | 앱스플라이어 기능을 포함하지만, 앱스플라이어 설정이 완료되지 않았습니다. | |
광고 권한 | Appsflyer requires ad settings to be enabled. | 앱스플라이어를 사용하기 위한 광고 권한 설정이 완료되지 않았습니다. | 앱스플라이어 설정 완료 시 자동으로 광고 권한이 활성화됩니다. 문제 발생 시 문의 부탁드립니다. |
구글 로그인 (푸시) | Google Login requires push settings to be enabled. | 구글 로그인을 사용하기 위한 푸시 설정이 완료되지 않았습니다. | |
구글 로그인 (서비스 파일) | 안드로이드: There is no Google login setting in google-services.json file. iOS: There is no Google login setting in GoogleService-Info.plist file. | 구글 로그인 기능을 포함하지만, Google 서비스 설정 파일에 로그인 데이터가 없습니다. |
Bundle Identifier 미등록
Apple Developer 계정에 동일한 Bundle Identifier가 등록되어 있어야 합니다.Certificates, Identifiers & Profiles > Identifiers 메뉴에서 새 App ID를 생성하고,나쵸코드 대시보드의 앱 식별자(패키지명 / Bundle ID)와 동일하게 입력해주세요.
인증 정보 불일치 (Team ID, Issuer ID, Key ID, Key File)
Apple Developer 계정에서 각 정보를 다시 확인하고 대시보드에 올바르게 입력해주세요.업로드한 Key File의 권한이 올바르게 설정되지 않았거나 접근 제한이 걸려 있는 경우에도 빌드가 실패할 수 있습니다. 필요 시 Key File을 다시 생성하거나, 올바른 접근 권한으로 재업로드해주세요.
필수 권한(Capabilities) 누락
Apple developer - Identifiers 탭 - 식별키 선택 - Capabilities 탭 - 체크 박스 활성화
App ID에 다음 Capabilities가 활성화되어 있는지 확인하세요.
푸시 기능 사용 시 : Push Notifications 활성화
애플 로그인 기능 사용 시 : Sign in with Apple 활성화
유니버설 링크 사용 시 : Associated Domains 활성화
Apple 계정 승인 미완료
Apple Developer 계정의 Agreements, Tax, and Banking 항목에서계약 미승인 또는 만료된 조항이 없는지 확인해주세요.
빌드 환경이나 서버 상태, 또는 인증서 문제로 인해 빌드가 중단될 수 있습니다.
이 경우 사용자가 직접 대응하기 어렵기 때문에, 나쵸코드에게 문의해주세요.
채널톡 또는 info@nachocode.io로 문의주세요.