CocoaPods 管理 SDWebImage 庫常見問題與解決方案

在 iOS 開發中，使用 CocoaPods 整合第三方庫是常態。本文記錄一次引入 SDWebImage 進行網路圖片載入時遇到的編譯錯誤與警告，並提供最終解決方案，幫助開發者快速排除類似問題。

問題一：未指定 iOS 部署版本導致編譯錯誤

初始 Podfile 內容如下：

platform :ios
pod 'SDWebImage'

由於未在 platform :ios 後指定版本號，專案部署目標為 iOS 9 時，編譯階段即報錯。錯誤截圖如下：

問題二：指定版本後出現棄用警告

修改 Podfile 指定最低支援 iOS 9.0：

platform :ios, '9.0'
pod 'SDWebImage'

並將專案 Deployment Target 設為 iOS 9.0：

編譯雖然通過，但出現大量「棄用」警告：

若改設為 iOS 8.0，警告更多：

最終解決方案

將 Podfile 修改為：

platform :ios, '8.0'
pod 'SDWebImage'

關鍵提示： 每次修改 Podfile 後，無需執行 pod install，只需執行 pod update 即可。pod install 僅在首次使用時執行一次。

修改完成後重新編譯，專案無論部署在 iOS 8.x 或 9.x 環境，均不再出現任何錯誤或警告，問題徹底解決。