Error map
Undefined symbols for architecture Undefined symbol(s) for architecture arm64 — linker command failed with exit code 1
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)
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: 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…
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…
C/C++: undefined reference to `function' — collect2: error: ld returned 1 exit status
The linker can’t find the definition of a function or variable that was declared and used.
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…
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.
Two steps away (25)
Fatal error: Unexpectedly found nil while unwrapping an Optional value
Swift force-unwrapped (`!`) an optional that was nil, crashing the app.
error while loading shared libraries: libX.so.N: cannot open shared object file: No such file or directory
The program needs a shared library (.so) that isn’t installed or isn’t on the loader’s search path.
The application was unable to start correctly (0xc0000142)
A DLL the program loads failed to initialise — often after an update, with corrupt runtimes, or when a desktop heap/session limit…
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…
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.
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.
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.
npm ERR! code ELIFECYCLE / Command failed with exit code 1
An npm script (build, start, test, postinstall) exited with an error. ELIFECYCLE is only the wrapper — the real error is printed…
gyp ERR! build error / node-gyp rebuild failed
A dependency with native C/C++ code couldn’t compile — missing build tools, Python, or an unsupported Node version.
COPY failed: file not found in build context / "/app/x": not found
The Dockerfile COPY refers to a path outside the build context, excluded by .dockerignore, or relative to the wrong directory.
exec /usr/local/bin/docker-entrypoint.sh: exec format error
The container tried to run a binary built for a different CPU architecture (arm64 vs amd64) — or a script with a broken shebang /…
no matching manifest for linux/arm64/v8 in the manifest list entries
The image has no build for your CPU architecture — typically pulling an amd64-only image on an Apple Silicon Mac or ARM server.
cannot execute binary file: Exec format error
The program was built for a different CPU architecture or OS — e.g. an x86_64 binary on an ARM machine (Raspberry Pi, Graviton, A…
Xcode: Command PhaseScriptExecution failed with a nonzero exit code
A Run Script build phase (CocoaPods, React Native, Flutter, SwiftLint, Crashlytics…) failed. The real error is above this line in…
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…
[!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/...
CocoaPods couldn’t reach its CDN spec repo — network/proxy issues, rate limiting, or an outdated CocoaPods.
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.
[!] 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.
Map another error
Popular: 4035004000xC000007BTypeErrorCritical error404NullPointerException