Skip to content

[DOCS] iOS 릴리즈·앱 심사 함정 3종 기록 (#382) - #383

Open
IISweetHeartII wants to merge 1 commit into
developfrom
fix/ios-release-notes-#382
Open

IISweetHeartII wants to merge 1 commit into
developfrom
fix/ios-release-notes-#382

Conversation

@IISweetHeartII

Copy link
Copy Markdown
Contributor

Closes #382

2026-08-29 App Store 리젝 3건을 되짚으니 원인이 전부 «알았으면 안 밟았을 함정» 이었다.
CLAUDE.md 의 「네이티브(Capacitor) 주의사항」에 3줄 추가한다. 코드 변경 없음.

기록한 것

1. iOS 아카이브 전 pnpm cap:sync:ios 필수

capacitor.config.ts 에 server.url 이 없다 → 웹 자산이 바이너리에 통째로 구워진다.
웹을 배포해도 앱은 안 바뀌고, Xcode 에서 빌드번호만 올려 아카이브하면 이전 JS 가 그대로 심사에 올라간다.

2. Info.plist 권한 문구 누락 = 즉시 크래시 (Guideline 2.1a 리젝 원인)

NSCameraUsageDescription 이 없어 「사진수다 → Take Photo」 에서 앱이 죽었다.
권한 거부 다이얼로그가 아니라 OS 의 즉시 프로세스 종료다.
<input type="file" accept="image/*"> 도 WKWebView 가 카메라를 열므로 대상이다. (#378 에서 수정)

3. Sign in with Apple 버튼 규격 (Guideline 4 리젝 원인)

bg-[#040505] 버튼이 #131313 배경(body 의 --color-neutral-900)에 묻혀
«버튼으로 식별되지 않는다» 고 리젝됐다. 대비 약 1.08:1.
Apple 허용 스타일은 black / white / white-outline 셋뿐이다. (#369 에서 흰색으로 교체)
어두운 테마에서 검은 버튼으로 되돌리면 같은 리젝이 재발한다.

왜 새 문서를 안 만들었나

CLAUDE.md 의 네이티브 섹션은 이미 하드윈 함정(WebView origin, R8, JDK21, 카카오 intent-filter 등)이
쌓여 있고 실제로 읽히는 문서다. 별도 런북 파일은 갱신되지 않고 방치될 가능성이 높다고 판단했다.

검증

  • 문서만 변경 (CLAUDE.md +3줄). 빌드 영향 없음
  • 현재 develop 로그인 화면을 렌더링해 흰색 SIWA 버튼이 배경과 명확히 구분되는 것 확인

2026-08-29 App Store 리젝 3건의 원인이 전부 «알았으면 안 밟았을 함정» 이었다.

- iOS 아카이브 전 `pnpm cap:sync:ios` 필수. capacitor.config.ts 에 server.url 이 없어
  웹 자산이 바이너리에 구워진다. 빌드번호만 올려 아카이브하면 옛 JS 가 심사에 올라간다.
- Info.plist 권한 문구 누락은 권한 거부가 아니라 OS 의 즉시 프로세스 종료다.
  NSCameraUsageDescription 누락으로 「사진수다 → Take Photo」 크래시 리젝(2.1a).
- SIWA 버튼은 배경과 구분돼야 한다. bg-[#040505] 가 #131313 배경에 묻혀 리젝(G4).
  대비 약 1.08:1 이었다. 어두운 테마에서 검은 버튼으로 되돌리지 말 것.
@vercel

vercel Bot commented Sep 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
finders Ready Ready Preview Sep 4, 2026 7:05am UTC

This branch was successfully deployed

1 active deployment
Preview — e3a8d4bf Deployed Sep 4, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

iOS 릴리즈·앱 심사 함정 3종 문서화 (cap sync / 권한 문구 / SIWA 버튼)

1 participant