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

升級 Xcode 7 後 CocoaPods 失效的三個錯誤與解法

編輯:iOS 7 技巧

升級 Xcode 7 之後做真機除錯,常常會發現 CocoaPods 管理的第三方庫怎麼樣都編不過。以下把最常遇到的三個錯誤依序整理出來,因為它們通常會一個接一個出現。

錯誤一:the sandbox is not in sync with the Podfile.lock

原因:Podfile.lock 記錄的內容與目前 Pods 專案的實際狀態不一致,多半是切換分支、合併或手動改動 Podfile 造成的。

解法:刪掉 workspace 後重新安裝。

rm -rf MyProject.xcworkspace
pod install

注意是刪 .xcworkspace,不是 .xcodeproj——後者是 Xcode 自己維護的專案檔,刪掉就麻煩了。

錯誤二:Assertion failed: _initializationCompletedSuccessfully

執行上一步時又冒出這個錯誤。這是 xcodeproj 這個 gem 的版本與新版 Xcode 不相容所致。

解法:更新 gem。

gem install xcodeproj

錯誤三:Could not find a valid gem 'cocoapods'

安裝 CocoaPods 時若出現「Unable to download data from https://rubygems.org/」,通常是網路無法連上官方 RubyGems 主機導致的逾時。

解法:換用鏡像來源。CocoaPods 以 Ruby 撰寫,套件發佈在 rubygems.org 上,從某些地區存取容易逾時,可以改用國內鏡像:

# 移除官方來源
gem sources --remove https://rubygems.org/

# 加入鏡像來源
gem sources -a https://mirrors.tuna.tsinghua.edu.cn/rubygems/

# 確認目前來源清單
gem sources -l

# 安裝 CocoaPods
sudo gem install cocoapods

接著定位到含有 Podfile 的專案目錄執行 pod install 即可。

如果還是不行,試試這些

1. 清除快取。先執行 pod deintegrate 移除所有整合痕跡,刪除 Podfile.lock 與 Pods 目錄,再重新 pod install。

2. 用 Bundler 鎖定版本。團隊協作時,與其依賴各人機器上全域安裝的 CocoaPods 版本,不如在專案中建立 Gemfile 鎖定版本,再透過 bundle exec pod install 執行,能避免「我這邊可以跑你那邊不行」的問題。

3. 檢查 Ruby 環境。系統自帶的 Ruby 寫入權限受限,容易遇到 permission denied。可考慮用 rbenv 或 rvm 管理 Ruby 版本,避開需要 sudo 修改系統位置的狀況。

最後提醒,升級 Xcode 後若 Pods 中的第三方庫本身還不支援新 SDK,無論怎麼重裝都無法編譯,這時只能等作者更新,或自己 fork 後修掉錯誤再指向自己的 repo。

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