很多 Swift 3 時代的開源庫都寫明了:CocoaPods 1.1.0 以上才能正常構建。比如 SnapKit 3.0 就是典型例子。而我機器上的 CocoaPods 還停留在 0.39.0:
$ pod --version 0.39.0
確實跟不上時代了。下面記錄一次完整升級過程。
先確認當前版本,如果已經夠新就可以跳過這一步:
$ ruby -v
$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc $ source ~/.bash_profile
$ rvm list known

這裡選 2.2.4 即可。
$ rvm install 2.2.4

$ ruby -v
這一步可能需要回車並輸入本機密碼授權。另外提醒一句:如果機器上還沒裝 Xcode,建議先裝好,後面編譯相關環節會用到。

過程中可能會要求輸入本機密碼。
先移除舊源。如果之前用的是官方源:
$ gem sources --remove https://rubygems.org/
如果之前用的是舊的淘寶源:
$ gem sources --remove https://ruby.taobao.org/
接著做一次系統更新:
$ sudo gem update --system
然後添加新源:
$ gem source -a https://gems.ruby-china.org

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

看到安裝成功後驗證一下:
$ pod --version
能打印出新版本號,說明標題裡的目標已經達成了。
最後一步容易被忽略,但少了它後續 pod install 會出問題:
$ pod setup
等待時間取決於網速,直到出現 "Setup completed"。

到這裡,Swift 3.0 之後的框架就可以正常引入了。
升級完如果發現 Xcode 裡的庫仍然報錯,先執行 pod deintegrate 再重新 pod install,多數情況下是舊版 CocoaPods 生成的工程配置殘留所致。
另外,--pre 參數會安裝預發佈版本,若你希望穩定版,去掉這個參數即可。ruby-china 這個鏡像源在國內網絡環境下比官方源快很多,值得長期保留。