Error map
Failed to prepare device for development Xcode: Failed to prepare device for development / iPhone is not available. Please reconnect the device
iOS · layer 1, On your device
Centre: this error. First ring: errors it is linked with (8). 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 (8)
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).
SwiftUI Preview: Cannot preview in this file — the preview crashed / failed to build
Xcode Previews couldn’t build or run the view — compile errors elsewhere, a crash in preview data, or preview-specific environmen…
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…
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…
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.
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 (22)
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.
Fatal error: Unexpectedly found nil while unwrapping an Optional value
Swift force-unwrapped (`!`) an optional that was nil, crashing the app.
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.
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.
adb: device unauthorized. This adb server's $ADB_VENDOR_KEYS is not set
The phone hasn’t accepted your computer’s RSA key for USB debugging yet.
adb: no devices/emulators found / error: device not found
adb can’t see any connected device or running emulator.
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.
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.
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.
Command CodeSign failed with a nonzero exit code (errSecInternalComponent / resource fork, Finder information not allowed)
codesign failed — the keychain is locked (CI/SSH), the private key is inaccessible, or files carry extended attributes that can’t…
Unable to Install "App": This app cannot be installed because its integrity could not be verified
iOS rejected the app because its signature doesn’t validate for this device — expired/revoked certificate, ad-hoc profile without…
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: 4035004000xC000007BTypeErrorCritical error404NullPointerException