library not found for -lPods 🍎 iOS

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 weren’t built.

Seen on: iOS

Meaning

CocoaPods integrates via the workspace. Building the bare project, missing pod install after cloning, or a mismatched Pods configuration leaves the Pods library absent.

Common causes

  • Opened .xcodeproj instead of .xcworkspace
  • pod install not run after clone/branch switch
  • Deployment target/architecture settings excluding Pods

⚡ Quick fix

  1. Open .xcworkspace
  2. pod deintegrate && pod install
  3. Clean build folder (Shift+Cmd+K)

Detailed fix by platform

Shell

  1. swift
    pod deintegrate && pod install
open MyApp.xcworkspace

How to diagnose

  1. File — Workspace opened?
  2. Pods — Pods/ folder and Pods.xcodeproj exist?

🔧 Still not fixed?

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

🧠 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.