Home › Build error fixes › iOS / Xcode

Linker cannot find symbols

iOS / Xcode · last reviewed 2026-11-10

The error looks like this

ld: symbol(s) not found for architecture arm64

Why it happens

A native library is not linked, or pods were built for a different architecture/configuration.

How to fix it

  1. cd ios && pod deintegrate && pod install
  2. Clean build folder; delete ~/Library/Developer/Xcode/DerivedData.
  3. Check the library's install docs for manual linking steps.

Not sure this is your error? Let ReleaseMedic read the whole log

Build logs are long and the last line is rarely the real cause. ReleaseMedic finds the first real error, explains it and gives the steps — free, and the log never leaves your computer.

$ npx releasemedic log build.log

Or pipe a build straight in: cd android && ./gradlew bundleRelease 2>&1 | npx releasemedic log -

Catch it before you build

Most release errors come from project settings you can check in seconds — signing, SDK levels, privacy manifests, permissions, push and login setup.

$ npx releasemedic

Related iOS / Xcode errors