Undefined symbols for architecture iOS Origin: On your device Last updated 13 Oct 2026

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 an architecture mismatch.

Exact message you may see Undefined symbols for architecture arm64Undefined symbollinker command failed with exit code 1 (use -v to see invocation)ld: symbol(s) not found for architecture
Explore the map of this error Full error map →
Seen on: iOS

Meaning

Classes defined in files not added to the target, static libraries missing from Link Binary With Libraries, Objective-C categories without -ObjC, or libraries built without arm64 simulator slices cause this.

Common causes

  • Source file not a member of the target
  • Framework/library not linked
  • Library missing the needed architecture slice
  • C++ / Objective-C symbol name issues (-ObjC, -lc++)

⚡ Quick fix

  1. Check Target Membership of the file defining the symbol
  2. Add the framework to Link Binary With Libraries
  3. Use XCFrameworks with simulator arm64 slices

Detailed fix by platform

Shell

  1. swift
    lipo -info libThirdParty.a
nm -gU libThirdParty.a | grep MissingSymbol

How to diagnose

  1. Symbol — Which one?
  2. Membership — File in target?
  3. Arch — lipo -info shows arm64?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: On your device. Errors that are often confused with or caused by this one (click to open):

built for iOS, linking for simulator — Building for iOS Simulator, but linking in object file built for iOS, for architecture arm64 (iOS)built for iOS, linkin…Cannot preview in this file — SwiftUI Preview: Cannot preview in this file — the preview crashed / failed to build (iOS)Cannot preview in thi…dyld: Library not loaded — dyld: Library not loaded: @rpath/X.framework/X — Reason: image not found (crash on launch) (iOS)dyld: Library not loa…Failed to prepare device for development — Xcode: Failed to prepare device for development / iPhone is not available. Please reconnect the device (iOS)Failed to prepare dev…ITMS-90725 — 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 (iOS)ITMS-90725library not found for -lPods — ld: library not found for -lPods-AppName / framework not found Pods_App (iOS)library not found for…No such module — Swift: No such module 'X' (module not found) (iOS)No such moduleSigning requires a development team — Signing for "App" requires a development team. Select a development team in the Signing & Capabilities editor (iOS)Signing requires a de…Undefined…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.