您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 7 技巧

解決 ruby.taobao.org 失效導致 CocoaPods 無法使用

編輯:iOS 7 技巧

AFNetworking 等常見庫都支援 CocoaPods,用 pod 指令整合第三方套件本該輕鬆省事。但當鏡像來源失效時,pod install 就會卡住不動或直接失敗。本文記錄一次因 taobao 鏡像下線而導致 CocoaPods 無法使用的排查與修復過程。

如何確認是鏡像問題

如果你執行下面任一指令都遲遲無法完成:

pod install --verbose --no-repo-update
pod update --verbose --no-repo-update

那麼很可能就是 gem 來源(source)出了問題,而非專案設定有誤。

修復步驟

1. 移除舊的來源網址

gem sources --remove https://rubygems.org/

2. 加入新的鏡像網址

gem sources -a https://gems.ruby-china.org/

3. 確認目前生效的來源清單

gem sources -l

執行後應能看到只剩新的鏡像網址,代表切換成功。

4. 重新安裝 CocoaPods

sudo gem install -n /usr/local/bin cocoapods

如果你最近升級過 macOS,這個步驟是必要的。系統版本更新後,原本安裝在舊路徑的可執行檔可能已失效,需要重新安裝一次。這裡的 -n 參數用來指定二進位檔的安裝位置,避免 Apple Silicon 或新版系統下的路徑問題。

5. 更新第三方庫資料

pod update --verbose --no-repo-update

補充說明

  • 為何要加 --no-repo-update?它會跳過更新本地的 spec repo,速度大幅提升。若你確定本地 repo 已經是最新的,加上這個參數能省下大量等待時間。
  • 権限問題。若 gem install 出現權限錯誤,除了 sudo,也可以考慮用 rbenv 或 RVM 管理 Ruby 版本,從根本避免系統 Ruby 的權限限制。
  • 值得評估的替代方案。近年的 iOS 專案越來越多改用 Swift Package Manager 或 Carthage。SPM 由 Apple 官方維護、已內建於 Xcode,長期來看維護成本更低。
  • 鏡像網址會變動。本文的網址寫於當時,若日後連線失敗,建議查閱 Ruby China 官方公告取得最新可用的鏡像位址。

整體流程就是:確認來源 → 換掉失效的鏡像 → 重裝 CocoaPods → 重新更新依賴。走完這四步,pod 相關指令通常就能恢復正常。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved