Error map
Cannot preview in this file SwiftUI Preview: Cannot preview in this file — the preview crashed / failed to build
iOS · layer 1, On your device
Centre: this error. First ring: errors it is linked with (9). Outer ring: what those are linked with. Colours show the layer of a request each error belongs to. Click any dot to re-centre the map on it; hover to follow its connections. The centre dot opens the error page.
Directly related (9)
Xcode: Failed to prepare device for development / iPhone is not available. Please reconnect the device
Xcode couldn’t set up the device — usually the device’s iOS version is newer than Xcode supports, Developer Mode is off, or pairi…
SwiftUI: Modifying state during view update, this will cause undefined behavior
A @State/@Published value was changed while SwiftUI was computing a view’s body.
SwiftUI: Publishing changes from background threads is not allowed; make sure to publish values from the main thread
An ObservableObject’s @Published property was updated from a background thread.
ITMS-90725: SDK version issue — This app was built with the iOS 17.x SDK. All iOS apps submitted to the App Store must be built with the iOS 18 SDK or later
App Store Connect requires uploads to be built with a recent Xcode/iOS SDK (raised every spring).
Fatal error: Unexpectedly found nil while unwrapping an Optional value
Swift force-unwrapped (`!`) an optional that was nil, crashing the app.
Undefined symbol(s) for architecture arm64 — linker command failed with exit code 1
The linker can’t find the implementation of a symbol your code uses — a missing framework/library, a file not in the target, or a…
Signing for "App" requires a development team. Select a development team in the Signing & Capabilities editor
No Apple developer team is selected for the target, so Xcode can’t sign the app.
Swift: No such module 'X' (module not found)
Xcode can’t find a Swift package, pod or framework you import.
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun
The Xcode Command Line Tools are missing or broken — typical right after a macOS update.
Two steps away (26)
Provisioning profile "x" doesn't include the currently selected device
The development profile doesn’t list this iPhone’s UDID, so Xcode can’t install the build on it.
Could not launch "App": process launch failed: Security / Untrusted Developer
The app installed, but iOS won’t run it because the developer certificate hasn’t been trusted on the device (common with free/ent…
HTTP 409 Conflict
The request conflicts with the current state of the resource — e.g. a duplicate or an edit based on an outdated version.
Error: Too many re-renders. React limits the number of renders to prevent an infinite loop.
A state update runs during render, which triggers another render, which updates state again — forever.
Warning: A component is changing an uncontrolled input to be controlled
An input’s `value` started as `undefined` (uncontrolled) and later became a defined value (controlled), or vice versa.
Optimistic lock conflict: OptimisticLockException / StaleObjectStateException / version mismatch
Someone else changed the record after you read it, so your update — based on an old version — was rejected to avoid overwriting t…
API Error: Idempotency key reused with different parameters (idempotency_key_in_use)
An Idempotency-Key header was sent again with a different request body, or while the first request with that key was still runnin…
API Error: Too many concurrent requests (concurrency limit reached)
You have more requests in flight at once than the API allows for your key — even if your requests-per-minute rate is fine.
ITMS-91053: Missing API declaration — Your app's code references required reason APIs (privacy manifest)
The app (or an SDK in it) uses “required reason” APIs like UserDefaults, file timestamps or disk space without declaring reasons…
ITMS-90683: Missing purpose string in Info.plist (NSCameraUsageDescription etc.)
The binary references a privacy-sensitive API, but Info.plist lacks the matching usage description.
ITMS-4238: Redundant Binary Upload. You've already uploaded a build with build number 'x' for version number 'y'
The build number (CFBundleVersion) has already been used for that version in App Store Connect.
System.NullReferenceException: Object reference not set to an instance of an object
Code dereferenced a variable that is `null` — the .NET equivalent of Java’s NullPointerException.
TypeError: Cannot read properties of undefined (reading 'x')
You tried to access a property on a value that is `undefined` (or `null`) — usually data that hasn’t loaded yet or a wrong proper…
java.lang.NullPointerException
Code called a method or accessed a field on a reference that is `null`.
Building for iOS Simulator, but linking in object file built for iOS, for architecture arm64
A library contains device-only arm64 code; Apple Silicon simulators also run arm64 and need a separate simulator slice.
ld: library not found for -lPods-AppName / framework not found Pods_App
The linker can’t find the CocoaPods library — usually because the .xcodeproj was opened instead of the .xcworkspace, or pods were…
dyld: Library not loaded: @rpath/X.framework/X — Reason: image not found (crash on launch)
A dynamic framework the app needs at runtime isn’t embedded in the app bundle, so it crashes at launch.
Xcode: No signing certificate "iOS Development" found
Xcode can’t find a valid code-signing certificate + private key for the selected team in your keychain.
Failed to register bundle identifier: The app identifier "com.x" cannot be registered to your development team because it is not available
Another developer team already owns that bundle identifier, so Xcode can’t create it for your team.
Provisioning profile "x" doesn't include signing certificate "Apple Development: Name (ID)"
The profile was created with a different certificate than the one installed in your keychain.
CocoaPods could not find compatible versions for pod
pod install can’t satisfy the version constraints — outdated spec repo, a higher deployment target required, or two pods needing…
[!] Unable to find a specification for `X` depended upon by `Y`
CocoaPods can’t find the pod (or version) in its spec repos — stale local specs, a private spec repo not added, or a typo.
Swift: 'X' is only available in iOS 16.0 or newer
You used an API that requires a newer iOS than your deployment target.
bash: command not found
The shell can’t find an executable with that name in any directory on your PATH.
gyp: No Xcode or CLT version detected!
node-gyp on macOS can’t find the Xcode Command Line Tools to compile native modules.
macOS: zsh: command not found: brew (Homebrew not on PATH on Apple Silicon)
Homebrew is installed in /opt/homebrew on Apple Silicon Macs, which isn’t on PATH until you add its shellenv line.
Map another error
Popular: 403500400TypeErrorCritical error0xC000007BNullPointerException404