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

WKWebView 詳解:從 UIWebView 遷移的完整指南

編輯:iOS 技巧大全

UIWebView 已經完成了歷史使命。從 iOS 8 開始,蘋果推薦使用 WKWebView,新工程沒有理由再往舊方案上投入。

WKWebView 是現代 WebKit API 在 iOS 8 與 OS X Yosemite 中的核心組件,它取代了 UIKit 裡的 UIWebView 和 App Kit 裡的 WebView,為兩個平台提供了統一的接口。60fps 的滾動刷新率、內建手勢、高效的 App 與 Web 雙向通信通道,加上與 Safari 同源的 JavaScript 引擎——這一切都讓它在 WWDC 2014 上成為最受關注的更新之一。

UIWebView 與 WKWebView 的關鍵差異

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。

JavaScript 交互

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 的比較與取捨。

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