原文地址:swift4.0 適配
一疯汁、前言
在我們的工程中處于swift和OC混編的狀態(tài)娩践,使用swift已經(jīng)有一年半的時間了三妈,隨著Xcode9的更新陪腌,swift3.2和swift4.0也隨之到來辱魁,swift3.2相較于Xcode8的swift3.1變動極小烟瞧,適配沒遇到問題,主要關(guān)注swift4.0的適配染簇。
三、使用 Xcode 將工程轉(zhuǎn)換到 swift4.0
Xcode9.1
當(dāng)前swift版本 3.2
選中要轉(zhuǎn)換的target
Edit -> Convert -> To Current Swift Syntax
勾選需要轉(zhuǎn)換的target(pod引用不用勾選),Next
選擇轉(zhuǎn)換選項青灼,Next
這兩個選項是關(guān)于swift的@objc推斷特性的暴心,如果使用了swift4.0顯式的@objc屬性,能減少整體代碼的大小杂拨。此時我們選 Minimize Inference(recommend)专普,
關(guān)于兩個選項:
Minimize Inference(recommend)
根據(jù)靜態(tài)推斷,僅在需要的地方添加@objc屬性弹沽。使用此選項后檀夹,需要按照Completing a Swift 4 minimize inference migration來完成轉(zhuǎn)換。
Match Swift 3 Behavior
在編譯器隱式推斷的任何地方向代碼添加一個@objc屬性策橘。這個選項不會改變你的二進(jìn)制文件的大小炸渡,因為被Swift 3隱式推斷在所有的地方都添加了顯式的@objc屬性。
預(yù)覽轉(zhuǎn)換代碼丽已,沒問題蚌堵,Save。
完成上述5步之后辰斋,看一下swift版本,已經(jīng)是4.0了:
至此打完收工瘸味,適配結(jié)束。然而并沒有够挂,當(dāng)你運(yùn)行的時候會看到這個:
是否欲哭無淚旁仿,居然這么多錯誤,不用怕孽糖,其實要改動的地方并不多枯冈,有些都是重復(fù)的,可以直接全局替換就行办悟。
舉個栗子:
- class dynamic func
// 轉(zhuǎn)換前
class dynamic func bookMoneyToUpController() -> MPBookMoneyToUpController {
??? let vc = MPBookMoneyToUpController.init(nibName: "MPBookMoneyToUpController", bundle: Bundle.main)
??? return vc
}
// 轉(zhuǎn)換后
class @objc dynamic func bookMoneyToUpController() -> MPBookMoneyToUpController {
??? let vc = MPBookMoneyToUpController.init(nibName: "MPBookMoneyToUpController", bundle: Bundle.main)
??? return vc
}
// 問題 @objc 修飾符需要前置
// 修改成下面即可
@objc class dynamic func bookMoneyToUpController() -> MPBookMoneyToUpController {
??? let vc = MPBookMoneyToUpController.init(nibName: "MPBookMoneyToUpController", bundle: Bundle.main)
??? return vc
}
// 全局替換即可
class @objc dynamic func? -> @objc class dynamic func
注:
上面使用dynamic修飾符是由于以前使用JSPatch來做hotfix尘奏,需要用到原來OC的運(yùn)行時特性。
swift4.0最大的特性之一就是@objc修飾符的變化了炫加,它主要處理OC和swift混編時一些方法的調(diào)用以及屬性獲取問題瑰煎,swift4.0將在swift3.x中一些隱式類型推斷的特性去除以后,需要我們來手動管理@objc修飾符俗孝。
在上文中使用Xcode轉(zhuǎn)換swift4.0時我們勾選了Minimize Inference選項酒甸,那么我們就需要手動處理相關(guān)的@objc修飾符,來保證OC和swift代碼能正常相互調(diào)用赋铝。
使用“最小化”轉(zhuǎn)換代碼后,需要處理構(gòu)建和運(yùn)行時的問題革骨,在完成初始的swift4.0轉(zhuǎn)換后农尖,需要按照下面步驟來處理其它問題。
1. 運(yùn)行你的工程
2. 修復(fù)編譯器提示需要添加@objc的地方
3. 測試你的代碼良哲,并修復(fù)編譯器提示使用了不推薦的隱式@objc引用的警告卤橄。直到?jīng)]有警告發(fā)生。
打開工程的build settings.
將Swift 3 @objc inference設(shè)置為Default.
編譯警告
swift 中編譯的警告
#selector參數(shù)指定的實例方法必須使用@objc修飾窟扑,因為swift4中棄用了@objc屬性推斷。
// 下面的代碼會有警告
class MyClass : NSObject {
??? func foo() {
??? }
???
??? func bar() {
??????? self.perform(#selector(MyClass.foo)
??? }
}
warning: argument of ‘#selector’ refers to instance method ‘foo’ in ‘MyClass’ that depends
Objective-C 編譯時警告
在OC中調(diào)用的swift方法漏健,在swift中需要追加@objc修飾嚎货,swift4廢棄了該類型推斷。
// 下面的代碼會有警告
@implementation MyClass (ObjCMethods)
- (void)other {
??? [self foo];
}
@end
warning: Swift method MyClass.foo uses @objc inference deprecated in Swift 4; add @objc to provide an Objective-C entrypoint
修復(fù)編譯時警告
// 通過追加 @objc 來消除警告
class MyClass : NSObject {
??? @objc func foo() {
??? }
???
??? func bar() {
??????? self.perform(#selector(MyClass.foo)
??? }
}
查看所有需要添加@objc的編譯警告
直接選中定位到相應(yīng)位置蔫浆,追加@objc修飾即可殖属。
運(yùn)行時警告
運(yùn)行時警告會打印在控制臺:
***Swift runtime:
ClassName.swift:lineInFile:columnInLine:
entrypoint -[ClassName methodName] generated by implicit @objc inference is deprecated and will be removed in Swift 4;
add explicit @objc to the declaration to emit the Objective-C entrypoint in Swift 4 and suppress this message
在Xcode9.1中讯蒲,運(yùn)行時警告在這里也能看到:
想要修復(fù)運(yùn)行時警告固耘,需要添加@objc修飾符到對應(yīng)的方法或者符號蜜另。
運(yùn)行時警告的常見原因:
在OC中使用SEL
在swift中使用了perform methods
在OC中使用了performSelector methods
使用了@IBOutlet或者@IBAction
class MyClass : NSObject {
??? func foo() {
??? }
???
??? func bar() {
??????? let selectorName = "foo"
??????? self.perform(Selector(selectorName)
??? }
}
***Swift runtime: MyClass.swift:7:7: entrypoint -[MyClass foo] generated by implicit @objc inference is deprecated and will be removed in Swift 4; add explicit @objc to the declaration to emit the Objective-C entrypoint in Swift 4 and suppress this message
NSAttributedString的初始化方法變化:
// swift3.x
public init(string str: String, attributes attrs: [AnyHashable : Any]? = nil)
// swift4.0
public init(string str: String, attributes attrs: [NSAttributedStringKey : Any]? = nil)
示例:
// 轉(zhuǎn)換前
let attributes = [NSForegroundColorAttributeName: RGB(128, g: 134, b: 146),
????????????????? NSParagraphStyleAttributeName: paragraph,
????????????????? NSFontAttributeName: UIFont.systemFont(ofSize: 14)] as [String : Any]
var tipAttrText = NSAttributedString.init(string: tipText, attributes: attributes)
// 轉(zhuǎn)換后
let attributes = [NSAttributedStringKey.foregroundColor.rawValue: RGB(128, g: 134, b: 146),
????????????????? NSAttributedStringKey.paragraphStyle: paragraph,
????????????????? NSAttributedStringKey.font: UIFont.systemFont(ofSize: 14)] as! [String : Any]
var tipAttrText = NSAttributedString(string: tipText, attributes: attributes)
// tipAttrText 初始化報錯提示
Cannot convert value of type '[String : Any]' to expected argument type '[NSAttributedStringKey : Any]?'
// 修改
NSAttributedStringKey.foregroundColor.rawValue -> NSAttributedStringKey.foregroundColor
去掉 as! [String : Any]
String的characters屬性被廢棄了
let string = "abc" var count = string.characters.count // 第二行報錯 'characters' is deprecated: Please use String or Substring directly // 對應(yīng)新方法 count = string.count
String的addingPercentEscapes方法被廢棄了
// swift3.x
var url = @"http://www.example.com?username=姓名"
url = url.addingPercentEscapes(using: String.Encoding.utf8)!
// 報錯
'addingPercentEscapes(using:)' is unavailable: Use addingPercentEncoding(withAllowedCharacters:) instead, which always uses the recommended UTF-8 encoding, and which encodes for a specific URL component or subcomponent since each URL component or subcomponent has different rules for what characters are valid.
// 修改
uri = uri.addingPercentEncoding(withAllowedCharacters: CharacterSet.urlQueryAllowed)!
substring(to:)被廢棄了
let index = tagText.index(tagText.startIndex, offsetBy: MPMultipleStyleListItemTagMaxLength)
// 警告:'substring(to:)' is deprecated: Please use String slicing subscript with a 'partial range upto' operator.
let b = tagText.substring(to: index)
// 新 API
// 注意:a 的類型是 Substring婚脱,不是 String
let a = tagText.prefix(upTo: index)
Swift3.x 繼續(xù) Method Swizzling這篇文章里面介紹了一種解決思路嘱吗。
4玄组、swift3使用#selector指定的方法,只有當(dāng)方法權(quán)限為private時需要加@objc修飾符谒麦,swift4.0都要加@objc修飾符
// 示例代碼
func startMonitor() {
NotificationCenter.default.addObserver(self, selector: #selector(self.refreshUserLoginStatus), name: NSNotification.Name.XSLUserLogin, object: nil)
}
func refreshUserLoginStatus() {
// some code
}
// 第二行警告
Argument of '#selector' refers to instance method 'refreshUserLoginStatus()' in 'MPUnreadMessageCountManager' that depends on '@objc' inference deprecated in Swift 4
// 追加 private
func startMonitor() {
NotificationCenter.default.addObserver(self, selector: #selector(self.refreshUserLoginStatus), name: NSNotification.Name.XSLUserLogin, object: nil)
}
private func refreshUserLoginStatus() {
// some code
}
// 第二行報錯
Argument of '#selector' refers to instance method 'refreshUserLoginStatus()' that is not exposed to Objective-C
swift4.0不再允許重載extension中的方法(包括instance俄讹、static、class方法)
// 示例代碼
class TestSuperClass: NSObject {
}
extension TestSuperClass {
??? func test() {
??????? // some code
??? }
}
class TestClass: TestSuperClass {
??? // 報錯:Declarations from extensions cannot be overridden yet
??? override func test() {
??????? // some code
??? }
}
添加以下內(nèi)容到Podfile患膛。
post_install do |installer|
installer.pods_project.targets.each do |target|
if ['WTCarouselFlowLayout', 'XSLRevenue', 'OHHTTPStubs/Swift'].include? target.name
target.build_configurations.each do |config|
config.build_settings['SWIFT_VERSION'] = '3.2'
end
end
end
end
UITableViewDelegate協(xié)議方法名變更耻蛇,沒有錯誤提示:
// swift3.x
func tableView(_ tableView: UITableView, heightForRowAtIndexPath indexPath: IndexPath) -> CGFloat
// swift4.0
func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat