UIWebView无缝转WKWebView,使交互方式保持一致

demo传送门
H5一份代码同时支持两个webView,H5无须改代码!!!本文主要是为了避免前端需要适配两套交互事件,使iOS的WKWebView的交互方式与UIWebView、安卓保持一致。极大的简化了WKWebView与JS的交互步骤。

2020-04-06新增

封装了一个Web交互管理类TKJSMethodManager,简化了WKWebView与JS交互步骤。直接上代码

@interface TKJSMethodManager : NSObject
/// 创建一个userScript
/// @param obj 实现交互事件的对象
/// @param key 在js里面对象的name
- (WKUserScript *)createUserScript: (id)obj forKeyedSubscript:(NSString *)key;
/// 执行收到的H5事件 在wkwebview UIDelegate方法runJavaScriptTextInputPanelWithPrompt里面调用此方法
- (void)exeMethodWithPrompt:(NSString *)prompt defaultText:(nullable NSString *)defaultText completionHandler:(void (^)(NSString * _Nullable result))completionHandler;
@end
@interface WKWebView (tk)
/// 添加一个userScropt
/// @param obj 实现交互事件的对象
/// @param key 在js里面对象的name
- (TKJSMethodManager *)tk_addUserScript:(id)obj forKeyedSubscript:(NSString *)key;
@end

使用示例

   //实现交互事件的对象,原UIWebView交互里面实现JSExport协议的对象
   let obj = TKWebMethodOC() 
   obj.webView = webView
   // TKJSMethodManager, 在uiDelegate需要用
   manager = webView.tk_addUserScript(obj, forKeyedSubscript: "TKApp")

// uiDelegate代理方法中调用manager的exeMethod方法
func webView(_ webView: WKWebView, runJavaScriptTextInputPanelWithPrompt prompt: String, defaultText: String?, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (String?) -> Void) {
       manager?.exeMethod(withPrompt: prompt, defaultText: defaultText, completionHandler: completionHandler)
}

至此,UIWebView转WKWebView已经完成,H5无需改代码,之前UIWebView交互的对象方法也可以可以继续使用。

原理

WKWebviewUIWebview在原生交互方面最大差别就是交互方式差异很大。先来看一下这些差异!

UIWebview是原生给H5注入了一个JS对象,比如注入一个TKApp对象,H5可以使用这个对象调用原生已经实现好的方法,这个调用时同步的,可以有返回值。

 //js代码
var phoneNum = TKApp.getUserPhone();
alert(phoneNum)

WKWebview是H5发送一个消息给原生,原生通过这个消息的名字来执行对应的方法。类似于原生的Notification,可以传参,但是没有返回值。

// js代码
func getUserPhoneClick() {
   var param = {"callback": "getUserPhoneCallback"};
   window.webkit.messageHandlers.getUserPhoneNum.postMessage(param)
}
function getUserPhoneCallback(phoneNum) {
   alert(phoneNum)
}

通过原生代码分析一下产生差异化的原因

看下UIWebView交互主要步骤代码

 let con = webView.value(forKeyPath: "documentView.webView.mainFrame.javaScriptContext") as? JSContext

 con?.setObject(jsInstance, forKeyedSubscript: "TKApp" as NSCopying & NSObjectProtocol)

从代码可以分析出来我们为UIWebView注入了一个对象TKApp,然后H5可以通过这个对象来调用原生的方法。

WKWebView是通过userContentController.add(handler, name: "getUserPhone")来进行交互,使原生可以处理message名字为getUserPhone的事件。

正是这两种注入方式的不同,使得调用方式也发生了很大的改变


手动给WKWebView注入一个JS对象

WKWebView没有提供注入对象的方法,但是可以为WKWebview 注入一段JS代码!!!在这段JS代码里实现要注入的对象

WKWebview代码
 let configuration = WKWebViewConfiguration()
  // 添加TKApp替代方法 getJSString为js代码
 let tkapp = WKUserScript.init(source: getJSString(), injectionTime: WKUserScriptInjectionTime.atDocumentStart, forMainFrameOnly: false)
 // 添加js
 configuration.userContentController.addUserScript(tkapp)
 webView = WKWebView(frame: self.view.frame, configuration: configuration)
js代码 (上面getJSString()方法获取到的代码)
var TKApp = {
    // 获取用户手机号
    getUserPhone: function () {
       return window.prompt("getUserPhone")
    },
    showShare: function(param, callback) {
        var data = {"param": param, "callback": callback}
        window.prompt("showShare", JSON.stringify(data))
    }
}

window.prompt()是H5调用系统输入框的方法,原生会走WKUIDelegate的代理方法

func webView(_ webView: WKWebView, runJavaScriptTextInputPanelWithPrompt prompt: String, defaultText: String?, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (String?) -> Void)

在这个代理方法中来处理H5的交互事件!
这个方法H5可以传过来两个字符串参数,第一个必传,第二个为可选类型。我们可以定义第一个为方法名,第二个为H5要传过来的参数。completionHandler回调一个String?类型,在H5里面相当于此方法的返回值。

需要注意的是,此方法接受的参数和返回值都是字符串, 如果之前H5用Bool或者Int接受的,我们在注入的JS方法里面可以自己修改成相应的类型。
demo传送门

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,898评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,401评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,058评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,539评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,382评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,319评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,706评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,370评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,664评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,715评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,476评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,326评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,730评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,003评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,275评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,683评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,877评论 2 335

推荐阅读更多精彩内容