UIWebView 已經完成了歷史使命。從 iOS 8 開始,蘋果推薦使用 WKWebView,新工程沒有理由再往舊方案上投入。
WKWebView 是現代 WebKit API 在 iOS 8 與 OS X Yosemite 中的核心組件,它取代了 UIKit 裡的 UIWebView 和 App Kit 裡的 WebView,為兩個平台提供了統一的接口。60fps 的滾動刷新率、內建手勢、高效的 App 與 Web 雙向通信通道,加上與 Safari 同源的 JavaScript 引擎——這一切都讓它在 WWDC 2014 上成為最受關注的更新之一。
WKWebView 更快,內存佔用大約只有 UIWebView 的三分之一到四分之一;它沒有那套傳統的緩存機制;同時把原本擠在 UIWebViewDelegate 裡的方法更細緻地拆分到了多個協議中。
過去的通行做法是同時兼容 iOS 7 和 iOS 8,於是「兩套 WebView 一起維護太麻煩」成了繼續用 UIWebView 的理由。但隨著 iOS 8 及以上版本的市場佔比持續攀升,iOS 7 及更早系統的份額已經收窄到可以忽略的程度,這個理由不再成立。
如果產品的覆蓋率要求並不極端苛刻,只兼容 iOS 8 以上是完全合理的選擇。各版本佔比可以參考 Apple 官方在開發者網站上公布的統計數據。
WKWebView 把 UIWebViewDelegate 與 UIWebView 重構為 14 個類和 3 個協議。下面列出幾個高頻方法的對應關係:
// 準備加載頁面
UIWebViewDelegate: - webView:shouldStartLoadWithRequest:navigationType
WKNavigationDelegate: - webView:didStartProvisionalNavigation:
// 已開始加載,可以在這一步加入過渡動畫
UIWebViewDelegate: - webViewDidStartLoad:
WKNavigationDelegate: - webView:didCommitNavigation:
// 頁面加載完成,可以在這一步移除過渡動畫
UIWebViewDelegate: - webViewDidFinishLoad:
WKNavigationDelegate: - webView:didFinishNavigation:
// 加載失敗
UIWebViewDelegate: - webView:didFailLoadWithError:
WKNavigationDelegate: - webView:didFailNavigation:withError:
WKNavigationDelegate: - webView:didFailProvisionalNavigation:withError:
如果你之前只用到上面這幾個方法,那麼遷移成本很低:把 ViewController 改為遵循 WKNavigationDelegate,換上對應的方法名即可。想了解更多,可以在 Xcode 中按住 Cmd 點擊 WKNavigationDelegate 直接查看聲明。
有一處容易漏改:原來的 webview.delegate = self 需要改成 webview.navigationDelegate = self。
UIWebView 時代,一句 stringByEvaluatingJavaScriptFromString() 就能用 JS 腳本操作頁面。WKWebView 的通信模型更規範,需要用到 WKScriptMessageHandler 協議中的方法:
func userContentController(userContentController: WKUserContentController, didReceiveScriptMessage message: WKScriptMessage)
下面的示例展示如何從網頁中取出正文文本:
let js = "window.webkit.messageHandlers.observe.postMessage(document.body.innerText);"
// 注意 observe 這個字段是自行定義的名字,不是固定寫法,需要與第 6 行保持一致
let script = WKUserScript(source: js,
injectionTime: WKUserScriptInjectionTime.AtDocumentEnd,
forMainFrameOnly: true)
// AtDocumentEnd 表示等網頁內容加載完畢後再注入腳本;
// 也可以選 AtDocumentStart,在 document 剛創建時就注入,具體看需求
let config = WKWebViewConfiguration()
config.userContentController.addUserScript(script)
config.userContentController.addScriptMessageHandler(self, name: "observe")
// 對應第一行 JS 腳本中的 observe 字段
// 初始化 WKWebView
let webview = WKWebView(frame: CGRectMake(0, 0, self.view.frame.width, self.view.frame.height),
configuration: config)
webview.navigationDelegate = self
self.view.addSubview(webview)
// 加載網頁
webview.loadRequest(NSURLRequest(URL: NSURL(string: "https://www.jianshu.com")!))
這裡有個容易忽略的前提:注入 JS 的途徑是在初始化 WebView 時通過 configuration 傳入的,所以你必須在創建 WebView 之前就把腳本準備好。如果不需要 JS 交互,直接用 frame 初始化、去掉 configuration 參數即可。
那麼抓到的文本怎麼取回來?讓 ViewController 在遵循 WKNavigationDelegate 的基礎上再遵循 WKScriptMessageHandler,然後實現它唯一的方法:
func userContentController(userContentController: WKUserContentController,
didReceiveScriptMessage message: WKScriptMessage) {
let str: NSString = message.body as! NSString
// 這裡抓取的是文本,所以強制轉換為 NSString;
// 如果通過 JS 拿到的是其他類型,按需轉換即可
print(str)
}
仔細看可能會有疑惑:我們綁定的明明是 WKNavigationDelegate,而 WKScriptMessageHandler 並沒有提供代理方法。實際的關聯點在上一段代碼裡——config.userContentController.addScriptMessageHandler(self, name: "observe") 這一句,正是它把消息回調掛到了當前對象上。
NSHipster 的 WKWebView 專題:https://nshipster.cn/wkwebkit/
簡書上的實踐總結:https://www.jianshu.com/p/f94cad074196
延伸閱讀:H5 容器的選型探討——UIWebView 與 WKWebView 的比較與取捨。