CocoaPods compatible versions 🍎 iOS

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 conflicting versions.

Seen on: iOS

Meaning

CocoaPods resolves all pods together. The message lists who requires what. Outdated local specs, the Podfile platform :ios being lower than a pod requires, or locked versions in Podfile.lock are the usual causes.

Common causes

  • Local spec repo out of date
  • Podfile platform / deployment target lower than the pod’s minimum
  • Two pods requiring incompatible versions of a shared dependency
  • Podfile.lock pinning old versions

⚡ Quick fix

  1. pod repo update then pod install
  2. Raise platform :ios, '13.0' (or what the pod requires)
  3. pod update PodName to move a locked pod
  4. Consider Swift Package Manager for that dependency

Detailed fix by platform

iOS

  1. Typical fix sequence:
    bash
    cd ios
pod repo update
pod install --repo-update
# still stuck on a locked version:
pod update FirebaseCore

How to diagnose

  1. Message — Which pod and which constraint?
  2. Platform — Deployment target vs pod minimum
  3. Lock — Pinned in Podfile.lock?

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