iOS 앱 심사 1024 아이콘 누락 오류

의외의 범인은 ‘빌드 타겟’이었다

iOS 앱을 App Store 심사에 제출할 때 가장 사람을 지치게 만드는 오류 중 하나가 있습니다.

Asset Catalog에 분명히 넣었고,

TestFlight에서는 로고가 정상 표시되는데,

정작 App Store 배포 빌드만 추가하면 ‘격자무늬’ 아이콘으로 바뀌며 심사 거절.

왜 이런 일이 발생할까요?

우리가 먼저 의심하는 것들 (하지만 범인이 아니었던 것들)

대부분 아래 항목부터 점검합니다.

• 파일명에 공백/특수문자 존재 여부

• PNG 알파 채널(투명도) 포함 여부

• Info.plist의 CFBundleIconName 설정

• assetutil로 Assets.car 내부 확인

• Asset Catalog 내 1024 아이콘 슬롯 채움 여부

이 모든 걸 다 맞췄는데도:

• TestFlight에서는 정상

• App Store 심사에서는 1024 누락

그렇다면 이제 빌드 레벨 문제를 의심해야 합니다.

진짜 원인: Simulator로 빌드된 Assets.car

핵심 원인은 의외로 단순합니다.

맥에 실제 아이폰을 연결하지 않은 상태에서,

Xcode 상단 타겟을

iPhone 16 Pro (Simulator) 등으로 두고 빌드하면

생성되는 Assets.car는 시뮬레이터 전용 아키텍처(x86_64 / macOS arm64) 기준으로 구워집니다.

왜 문제가 되는가?

• TestFlight는 비교적 관대하게 처리

• 하지만 App Store 심사 서버는 실제 iOS 디바이스 기준 번들 구조를 검사

• 시뮬레이터 기반으로 생성된 Assets.car는

• 내부 1024 아이콘을 심사 로직이 인식하지 못하는 경우가 발생

결과적으로:

해결 방법: Any iOS Device로 빌드

해결 방법은 간단하지만 매우 중요합니다.

① Xcode 상단 타겟 변경

Simulator가 아닌:

Any iOS Device (arm64)

선택

② 다시 Build

이 상태에서 생성된 Assets.car를 사용

③ 패키징 후 재업로드

실제 디바이스용으로 컴파일된 결과물을 포함해야 합니다.

기술적으로 보면 왜 이런 일이 생기는가?

Assets.car는 단순 이미지 모음이 아닙니다.

• 타겟 아키텍처

• 플랫폼 조건

• 컴파일 시점 설정

이 모두가 반영된 컴파일 결과물입니다.

즉, 동일한 아이콘이라도:

• Simulator 빌드 결과물

• Device 빌드 결과물

은 내부 메타데이터가 다를 수 있습니다.

App Store 심사 시스템은

Device 기준 번들 구조를 전제로 파싱합니다.

이 차이를 간과하면

아이콘이 있어도 “없는 것”이 됩니다.

​

증상:

• TestFlight에서는 로고 정상

• App Store 심사에서 1024 아이콘 누락

원인:

• Assets.car가 Simulator 타겟으로 빌드됨

해결:

• Any iOS Device (arm64) 선택 후 재빌드

이 오류는 이론 문제가 아니라 빌드 환경 문제입니다.

Info.plist, PNG, 알파채널을 아무리 수정해도

빌드 타겟이 잘못되면 계속 반복됩니다.

수십 번의 빌드 번호를 올리며 고생하기 전에

먼저 확인해야 할 것:

같은 문제로 시간을 낭비하는 분들이 줄어들기를 바랍니다.