Article App Crashes on Launch — iOS 17

Summary: The FieldPulse mobile app crashes immediately upon launch for users on iOS 17.0 through 17.1.2.

Symptoms

  • App launches to splash screen, then closes without error message
  • Crash occurs within 1–2 seconds of tapping the app icon
  • Issue persists after force-quitting and relaunching
  • Reinstalling the app does not resolve the crash

Affected Versions

PlatformVersions
iOS17.0 – 17.1.2
FieldPulse App3.1.0 – 3.1.4

Cause

A WebKit rendering regression introduced in iOS 17.0 causes the app's initial view controller to fail during layout calculation. The crash occurs in WKWebView initialization when the authentication session attempts to render the login screen.

Resolution

  1. Update iOS to version 17.2 or later. Apple resolved the underlying WebKit issue in 17.2.
  2. Update FieldPulse to version 3.1.5 or later, which includes a defensive workaround for the WebKit regression.

Workaround

If you cannot update iOS immediately:

  1. Open SettingsSafariAdvancedExperimental Features
  2. Disable CSS Custom Properties and Values API
  3. Force-quit and relaunch FieldPulse

Note: This setting may affect other web content in Safari and third-party apps.

Status

Resolved in FieldPulse 3.1.5. The app now initializes WebKit components asynchronously to avoid the layout race condition. Users on iOS 17.0–17.1.2 should update the app via the App Store.

For related guidance on keeping the mobile app current, see What's New in the Mobile App — Q3 Update.