下面來看一篇關於 Swift 2.3 / 3.0 如何添加第三方庫的文章,希望能幫助各位 iOS 開發者理清這其中的關鍵步驟。
Swift 3 的 beta 版已經問世,Chris Lattner 此前也在郵件列表中提到,Swift 3 大約會在八月基本完工。
大家在寫小 demo 或把項目遷移到 Swift 3.0 時,遇到的最大難題,往往就是第三方庫的引入。
Swift 社區一直熱情高漲,諸如 Alamofire、Decodable 等第三方庫都提供了 Swift 3.0 的分支,但如果導入時不加處理,總會冒出各種莫名其妙的問題。這裡分享一下我自己的解決思路。
實際上需要處理的核心問題只有兩個:
指定第三方庫的某個特定分支
指定工程文件內 Swift 的編譯版本
CocoaPods
這裡以 Alamofire 為例,主要需要在 Podfile 裡多寫幾行。
指定分支
先說指定分支。CocoaPods 本身只支援 name 與 version 兩個參數,但我們可以通過指定 git 倉庫、再指定 branch 來實現,具體格式如下:
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'swift3'
指定編譯版本
再來是指定 Swift 的版本,只需在項目末尾加上下面這幾句即可。這裡的代碼會遍歷項目中的所有 target,統一修改它們的 Swift 編譯版本:
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['SWIFT_VERSION'] = '3.0'
end
end
end
不過這樣寫有個缺點:對於 Objective-C 與 Swift 混編的項目,如果想引入 OC 的庫,就不能這麼做;但一個一個去設置編譯版本又太麻煩。我覺得最省事的辦法,還是直接進項目裡把 SWIFT_VERSION 這一項刪掉即可。
完整的 Podfile 如下:
project 'sample.xcodeproj'
platform :ios, '9.0'
target 'sample' do
use_frameworks!
pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => 'swift3'
end
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['SWIFT_VERSION'] = '3.0'
end
end
end
Carthage
Carthage 的具體用法這裡就不展開了。就我個人而言反而更偏好 Carthage,親手操作一遍,基本就能理解第三方庫導入的整個過程。
指定分支
由於 Carthage 本身就是去中心化的包管理器,所以只需在 Cartfile 裡選擇分支即可:
github "Alamofire/Alamofire" "swift3"
指定編譯版本
Carthage 的編譯很簡單:如果是 Swift 3,直接 carthage update 就行;在 xcodebuild 指向 Xcode 8 的前提下,默認就是 Swift 3。而 Swift 2.3 則需要指定一下版本,如下:
TOOLCHAINS=com.apple.dt.toolchain.Swift_2_3 carthage update --platform ios
另外編譯時有一點要留意:Carthage 默認會調用 xcode build 去編譯,如果我們電腦上同時裝了兩個版本的 Xcode,就需要確認一下 xcodebuild 的版本。
如果不是 Xcode 8,運行下面這條命令切換即可:
sudo ./xcode-select -switch /Applications/Xcode-beta.app/