The Rejection Reason (Guideline 2.1 - Performance)
When an Apple tester opens your app and it unexpectedly quits (crashes) or shows an infinite white screen, the review stops immediately. This is one of the most common reasons for rejection.
Why do Capacitor apps crash during review?
- IPv6 Network: Apple always tests apps on an IPv6-only Wi-Fi network. If your backend or a third-party plugin doesn't support IPv6, the app will crash.
- iPad (Guideline 2.4.1): Even if you only target the iPhone, your app must work correctly on iPad in compatibility mode (without crashing, and at the right ratio).
- Missing permissions on launch: Requesting the camera in the very first second without handling the user's refusal.
The Solution
- Test on TestFlight: Before submitting, distribute your app via TestFlight. Apple automatically collects crash reports (Crashlogs) if your testers encounter any.
- Analyze Apple's Crashlogs: In the Resolution Center, Apple provides you with a
.txtor.crashfile. Open it in Xcode to see exactly which line of native code crashed. - Add a Splash Screen: Ensure the
@capacitor/splash-screenplugin hides the white screen while your JS (React/Vue/Angular) starts up and gets ready.