一. 修改默認(rèn)User-Agent
在使用原生的API和JavaScript進(jìn)行交互的時(shí)候, 前端需要通過(guò)User-Agent字段來(lái)判斷請(qǐng)求頁(yè)面展示的來(lái)源( 這個(gè)H5頁(yè)面會(huì)在公眾號(hào)和APP端進(jìn)行展示), 這就需要我們?cè)诩虞dHTML頁(yè)面的時(shí)候去修改User-Agent的內(nèi)容, 或者在其中添加一個(gè)標(biāo)識(shí):
1.1 全局修改--覆蓋原有的值(不建議使用)
如果只是想修改User-Agent的內(nèi)容, 其原來(lái)的默認(rèn)值被覆蓋不會(huì)影響使用的話, 可以在應(yīng)用啟動(dòng)的時(shí)候, 按照如下的方式來(lái)全局修改, 很簡(jiǎn)單, 只需:
let dic = ["UserAgent": "ios-app"]
UserDefaults.standard.register(defaults: dic)
UserDefaults.standard.synchronize()
注意: 這樣操作會(huì)覆蓋User-Agent原有的默認(rèn)值, 其默認(rèn)值, 再不同設(shè)備/操作系統(tǒng)版本會(huì)略有不同, 大致長(zhǎng)這個(gè)樣子:
Mozilla/5.0 (iPhone; CPU iPhone OS 11_1_2 like Mac OS X) AppleWebKit/604.3.5 (KHTML, like Gecko) Mobile/15B202
如下圖所示, 這樣修改后, 直接是ios-app了:
1.2 全局修改--在原有值后面追加字段(建議使用)
如果只是想在原有值后面追加一個(gè)值作為標(biāo)識(shí), 不想覆蓋原有的值, 就需要先獲取原有的值, 然后在其后追加一個(gè)字段, 重新賦值給User-Agent:
1.2.1 使用UIWebView
在使用UIWebView的時(shí)候, 可以這樣來(lái)設(shè)置:
// 獲取默認(rèn)值
if let oldAgent = UIWebView().stringByEvaluatingJavaScript(from: "navigator.userAgent") {
var newAgent = oldAgent
// 添加自定義的內(nèi)容
if oldAgent.hasSuffix("/ios-app") == false {
newAgent += "/ios-app"
}
// 設(shè)置global User-Agent
let dic = ["UserAgent": newAgent]
UserDefaults.standard.register(defaults: dic)
UserDefaults.standard.synchronize()
}
這里還是設(shè)置的全局值, 抓包之后查看這個(gè)值, 如下圖所示:
這里結(jié)尾處是追加的自定義的字段, 前面是保留的原有的內(nèi)容;
1.2.2 使用WKWebView
使用WKWebView和使用UIWebView一樣, 只是調(diào)用的方法不同:
WKWebView().evaluateJavaScript("navigator.userAgent") { (info, error) in
// 獲取默認(rèn)值
if var userAgent = info as? String {
// 添加自定義的內(nèi)容
if userAgent.hasSuffix("/ios-app") == false {
userAgent += "/ios-app"
}
// 設(shè)置global User-Agent
let dic = ["UserAgent": userAgent]
UserDefaults.standard.register(defaults: dic)
UserDefaults.standard.synchronize()
}
}
使用這個(gè)方法的時(shí)候, 有個(gè)地方需要注意, 按照這種寫法, 雖然和使用UIWebView的原理一樣, 但是因?yàn)檫@兒是異步執(zhí)行的, 所以這樣寫, 會(huì)獲取不到userAgent, 并報(bào)如下的錯(cuò)誤:
Error Domain=WKErrorDomain Code=3 "WKWebView 已失效" UserInfo={NSLocalizedDescription=WKWebView 已失效}
具體原因請(qǐng)參看使用WKWebView獲取UserAgent遇到的問(wèn)題; 所以建議如果在AppDelegate中設(shè)置可使用UIWebView替換, 或者在使用WKWebView的地方進(jìn)行設(shè)置, 在使用的地方進(jìn)行設(shè)置的時(shí)候需要注意: load(request)方法一定要在回調(diào)完成之后, 具體可參考下文: 1.3.2 的內(nèi)容;
以上方法, 都是全局修改的, 建議將代碼寫在AppDelegate中, 所有的webView加載網(wǎng)頁(yè)的時(shí)候, 其User-Agent值都會(huì)被修改, 如果想只修改某一個(gè)的webView的User-Agent的值, 可以單獨(dú)設(shè)置某個(gè)webView, 單個(gè)設(shè)置只能使用WKWebView, UIWebView沒(méi)有單獨(dú)設(shè)置的方法.
1.3 局部修改
1.3.1 覆蓋原有值(不建議使用)
如果是僅僅覆蓋原有的值, 可以在WKWebView初始化完成后, 設(shè)置屬性customUserAgent:
if #available(iOS 9.0, *) {
webView.customUserAgent = "ios-app"
} else {
// Fallback on earlier versions
}
不過(guò), 這個(gè)屬性在iOS 9之后才有效.
1.3.2 在原有值后追加(建議使用)
同樣, 如果不想覆蓋原有的值, 可以這樣:
webView.evaluateJavaScript("navigator.userAgent") {[weak webView] (info, error) in
// 獲取默認(rèn)值
if var userAgent = info as? String {
// 添加自定義的內(nèi)容
if userAgent.hasSuffix("/ios-app-cgyc") == false {
userAgent += "/ios-app"
}
if #available(iOS 9.0, *) {
webView?.customUserAgent = userAgent
} else {
// Fallback on earlier versions
}
}
}
這里你會(huì)遇到一個(gè)問(wèn)題: 明明這樣設(shè)置了, 但是獲取到的User-Agent的值還是默認(rèn)的, 這是因?yàn)檫@個(gè)方法是異步執(zhí)行的, 加載HTML的方法, 一定要在給customUserAgent賦值之后:
webView.evaluateJavaScript("navigator.userAgent") {[weak webView] (info, error) in
// 獲取默認(rèn)值
if var userAgent = info as? String {
// 添加自定義的內(nèi)容
if userAgent.hasSuffix("/ios-app-cgyc") == false {
userAgent += "/ios-app"
}
if #available(iOS 9.0, *) {
webView?.customUserAgent = userAgent
} else {
// Fallback on earlier versions
}
// let dic = ["UserAgent": userAgent]
// UserDefaults.standard.register(defaults: dic)
// UserDefaults.standard.synchronize()
// 加載網(wǎng)頁(yè)
let request = URLRequest(url: ul)
webView?.load(request)
}
}
這樣, 再去查看, 就會(huì)發(fā)現(xiàn)已經(jīng)是修改之后的了.
同樣這里也可以使用下面的方法解注釋來(lái)全局設(shè)置:
let dic = ["UserAgent": userAgent]
UserDefaults.standard.register(defaults: dic)
UserDefaults.standard.synchronize()
二. JavaScript與原生交互
在使用WKWebView與JavaScript進(jìn)行交互的時(shí)候, 需要遵循協(xié)議: WKScriptMessageHandler, 此協(xié)議只有一個(gè)方法:
func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage)
然后創(chuàng)建WKUserContentController對(duì)象, 完整的代碼為:
let user = WKUserContentController()
// 向js中注入?yún)f(xié)議, 作為ios和js交互的依據(jù)
user.add(self, name: "appProtocol")
let config = WKWebViewConfiguration()
config.userContentController = user
let webView = WKWebView(frame: self.view.bounds, configuration: config)
let url = Bundle.main.url(forResource: "appToJSTest", withExtension: "html")
guard let ul = url else {
return
}
let request = URLRequest(url: ul)
webView.load(request)
然后實(shí)現(xiàn)代理方法:
func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
// 通過(guò)message的name屬性來(lái)區(qū)分我們注入的協(xié)議, 分別處理
// 通過(guò)message的body屬性來(lái)獲取js端傳過(guò)來(lái)的數(shù)據(jù), 可能是String, Number, Array, Dictionary
if message.name == "appProtocol" {
print(message.body)
}
}
最后, 在js中使用下面方法來(lái)使用這個(gè)協(xié)議:
window.webkit.messageHandlers.appProtocol.postMessage({body: 'Alert', num: '123456788', price: '100'});
其中appProtocol 為iOS端注入的協(xié)議名稱, postMessage內(nèi)的參數(shù), 即為js端需要發(fā)送給iOS的內(nèi)容, 這里是一個(gè)字典.
這樣就實(shí)現(xiàn)了iOS端與js端的交互.
坑---這里有一點(diǎn)需要注意:
postMessage里的參數(shù), 如果沒(méi)有參數(shù)需要傳遞給iOS端, 不能這樣寫postMessage(), 可以寫成這樣postMessage({}); 不然, 收不到事件!
需要注意, 在頁(yè)面的deinit方法中, 要移除注入的協(xié)議:
webView.configuration.userContentController.removeScriptMessageHandler(forName: "appProtocol")
一個(gè)完整的交互, 就完成.
這里有一個(gè)嚴(yán)重的問(wèn)題, 頁(yè)面的deinit方法沒(méi)有被調(diào)用, 這是因?yàn)樵谑褂孟旅娴姆椒ǖ臅r(shí)候, 出現(xiàn)了內(nèi)存泄露:
user.add(self, name: "appProtocol")
解決的方法是另外寫一個(gè)類, 將這個(gè)代理使用中間者轉(zhuǎn)換一下:
import UIKit
import WebKit
class LQScriptMessageDelegate: NSObject, WKScriptMessageHandler {
weak var delegate: WKScriptMessageHandler?
init(_ delegate: WKScriptMessageHandler) {
super.init()
self.delegate = delegate
}
func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
self.delegate?.userContentController(userContentController, didReceive: message)
}
}
然后這樣使用這個(gè)類:
// 向js中注入?yún)f(xié)議, 作為ios和js交互的依據(jù)
user.add(LQScriptMessageDelegate.init(self), name: "appProtocol")
這樣即可解決內(nèi)存泄露的問(wèn)題, 正常釋放了頁(yè)面.
三. HTTPs權(quán)限認(rèn)證
使用WKWebView進(jìn)行HTTPS的權(quán)限認(rèn)證簡(jiǎn)單了許多, 只需要實(shí)現(xiàn)WKNavigationDelegate代理中的下面這個(gè)方法:
// HTTPS安全認(rèn)證
func webView(_ webView: WKWebView, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust {
if challenge.previousFailureCount == 0 {
let credential = URLCredential(trust: challenge.protectionSpace.serverTrust!)
completionHandler(URLSession.AuthChallengeDisposition.useCredential, credential)
} else {
completionHandler(URLSession.AuthChallengeDisposition.cancelAuthenticationChallenge, nil)
}
} else {
completionHandler(URLSession.AuthChallengeDisposition.cancelAuthenticationChallenge, nil)
}
}
需要注意的是, 這個(gè)方法在iOS8中有個(gè)bug: 自建證書的HTTPS鏈接系洛，不調(diào)用此代理方法; 好在iOS 9中做了修復(fù), 但是在iOS8上使用還是會(huì)有問(wèn)題.
