WebViewJavascriptBridge详细使用
前言
WebViewJavascriptBridge是支持到iOS6以前的版本的，用于支持native的iOS与javascript交互。若是须要支持到iOS6以前的app，使用它是很不错的。本篇讲讲WebViewJavascriptBridge的基本原理及详细讲讲如何去使用，包括iOS端的使用和JS端的使用。javascript
通过多番百度、Google，发现WebViewJavascriptBridge的资源讲解不是翻译官方文档就是直接说官方提供的demo。可是笔者在写这个demo时也遇到了很多问题，也想看看你们是怎么使用的，特别是JS端，弄了很久都没有回调，原来是由于log。css
写下本篇文章，但愿你们少走弯路吧！html
本Demo效果图
iOS与H5交互的方案
纵观全部iOS与H5交互的方案，有如下几种：java
- 第一种：有不少的app直接使用在webview的代理中经过拦截的方式与native进行交互，一般是经过拦截url scheme判断是不是咱们须要拦截处理的url及其所对应的要处理的功能是什么。任意版本都支持。
- 第二种：iOS7以后出了JavaScriptCore.framework用于与JS交互，可是不支持iOS6，对于还须要支持iOS6的app，就不能考虑这个了。若须要了解，看最后的推荐阅读。
- 第三种：WebViewJavascriptBridge开源库使用，本质上，它也是经过webview的代理拦截scheme，而后注入相应的JS。
- 第四种：react-native，这个没玩过（与前三种不一样）。
本篇文章专讲讲WebViewJavascriptBridge。react
WebViewJavascriptBridge的基本原理
咱们看看WebViewJavascriptBridge.m中Webview代理拦截的代码：ios
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
if (webView != _webView) { return YES; }
NSURL *url = [request URL];
__strong WVJB_WEBVIEW_DELEGATE_TYPE* strongDelegate = _webViewDelegate;
if ([_base isCorrectProcotocolScheme:url]) {
if ([_base isBridgeLoadedURL:url]) {
[_base injectJavascriptFile];
} else if ([_base isQueueMessageURL:url]) {
NSString *messageQueueString = [self _evaluateJavascript:[_base webViewJavascriptFetchQueyCommand]];
[_base flushMessageQueue:messageQueueString];
} else {
[_base logUnkownMessage:url];
}
return NO;
} else if (strongDelegate && [strongDelegate respondsToSelector:@selector(webView:shouldStartLoadWithRequest:navigationType:)]) {
return [strongDelegate webView:webView shouldStartLoadWithRequest:request navigationType:navigationType];
} else {
return YES;
}
}
|
在拦截后，经过先经过-isBridgeLoadedURL:方法判断URL是不是须要bridge的URL，如果，则经过injectJavascriptFile方法注入JS；不然判断URL是不是队列消息，如果，则执行查询命令JS并刷新消息队列；最后，URL被识别为未知的消息。git
JS端如何使用
下面是本demo的HTML完整代码：github
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
<!doctype html>
<html>
<head>
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0">
<style type='text/css'>
html { font-family:Helvetica; color:#222; }
h1 { color:steelblue; font-size:24px; margin-top:24px; }
button { margin:0 3px 10px; font-size:12px; }
.logLine { border-bottom:1px solid #ccc; padding:4px 2px; font-family:courier; font-size:11px; }
</style>
</head>
<body>
<h1>WebViewJavascriptBridge Demo</h1>
<script>
window.onerror = function(err) {
log('window.onerror: ' + err)
}
/*这段代码是固定的，必需要放到js中*/
function setupWebViewJavascriptBridge(callback) {
if (window.WebViewJavascriptBridge) { return callback(WebViewJavascriptBridge); }
if (window.WVJBCallbacks) { return window.WVJBCallbacks.push(callback); }
window.WVJBCallbacks = [callback];
var WVJBIframe = document.createElement('iframe');
WVJBIframe.style.display = 'none';
WVJBIframe.src = 'wvjbscheme://__BRIDGE_LOADED__';
document.documentElement.appendChild(WVJBIframe);
setTimeout(function() { document.documentElement.removeChild(WVJBIframe) }, 0)
}
/*与OC交互的全部JS方法都要放在此处注册，才能调用经过JS调用OC或者让OC调用这里的JS*/
setupWebViewJavascriptBridge(function(bridge) {
var uniqueId = 1
function log(message, data) {
var log = document.getElementById('log')
var el = document.createElement('div')
el.className = 'logLine'
el.innerHTML = uniqueId++ + '. ' + message + ':<br/>' + JSON.stringify(data)
if (log.children.length) {
log.insertBefore(el, log.children[0])
} else {
log.appendChild(el)
}
}
/* Initialize your app here */
/*咱们在这注册一个js调用OC的方法，不带参数，且不用ObjC端反馈结果给JS：打开本demo对应的博文*/
bridge.registerHandler('openWebviewBridgeArticle', function() {
log("openWebviewBridgeArticle was called with by ObjC")
})
/*JS给ObjC提供公开的API，在ObjC端能够手动调用JS的这个API。接收ObjC传过来的参数，且能够回调ObjC*/
bridge.registerHandler('getUserInfos', function(data, responseCallback) {
log("Get user information from ObjC: ", data)
responseCallback({'userId': '123456', 'blog': '标哥的技术博客'})
})
/*JS给ObjC提供公开的API，ObjC端经过注册，就能够在JS端调用此API时，获得回调。ObjC端能够在处理完成后，反馈给JS，这样写就是在载入页面完成时就先调用*/
bridge.callHandler('getUserIdFromObjC', function(responseData) {
log("JS call ObjC's getUserIdFromObjC function, and js received response:", responseData)
})
document.getElementById('blogId').onclick = function (e) {
log('js call objc: getBlogNameFromObjC')
bridge.callHandler('getBlogNameFromObjC', {'blogURL': 'http://www.henishuo.com'}, function(response) {
log('JS got response', response)
})
}
})
</script>
<div id='buttons'></div> <div id='log'></div>
<div>
<input type="button" value="getBlogNameFromObjC" id="blogId"/>
</div>
</body>
</html>
|
在JS端，嵌入步骤是：web
- 第一步：将下面的代码放在JS中：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
/*这段代码是固定的，必需要放到js中*/
function setupWebViewJavascriptBridge(callback) {
if (window.WebViewJavascriptBridge) { return callback(WebViewJavascriptBridge); }
if (window.WVJBCallbacks) { return window.WVJBCallbacks.push(callback); }
window.WVJBCallbacks = [callback];
var WVJBIframe = document.createElement('iframe');
WVJBIframe.style.display = 'none';
WVJBIframe.src = 'wvjbscheme://__BRIDGE_LOADED__';
document.documentElement.appendChild(WVJBIframe);
setTimeout(function() { document.documentElement.removeChild(WVJBIframe) }, 0)
}
|
这段代码是固定的，必需要放到js中。json
- 第二步：在下面的方法体里写相关JS代码：
|
1
2
3
4
5
6
|
setupWebViewJavascriptBridge(function(bridge) {
/* Initialize your app here */
全部与iOS交互的JS代码放这里！
})
|
JS如何调用iOS代码
经过bridge.callHandler来调用：
|
1
2
3
4
5
6
7
8
|
bridge.callHandler('getBlogNameFromObjC',
{'blogURL': 'http://www.henishuo.com'},
function callback(response) {
log('JS got response', response)
}
})
|
其中，各参数说明以下：
- getBlogNameFromObjC：是iOS端register的handleName，在iOS端注册后，JS就能够直接经过这个handleName与iOS交互。好比，当点击某个按钮时，就执行上面这一段代码，结果就是js端将参数传给了iOS端，iOS端收到参数，而后经过回调给js，js会收到response，而后打印出来
- {‘blogURL’: ‘http://www.henishuo.com’}：这是JSON字符串，传到iOS端会被WebViewJavascriptBridge自动转换成id对象，而后在回调处看到的就是字典对象了。
- callback：这是个js函数名，在iOS端收到回调后，拿到了参数，而后经过闭包回调反馈给js端，这个反馈就是经过callback函数来传值给js。
JS端加入WebViewJavascriptBridge代码注意事项
若是在下面的函数体内有任何错误，都不会有打印日志，也不会有任何回调：
|
1
2
3
4
5
6
|
setupWebViewJavascriptBridge(function(bridge) {
/* Initialize your app here */
全部与iOS交互的JS代码放这里！
})
|
所以，若是遇到什么也没有输出，说明你写错了。另外，上面有demo中，log函数是自定义的，不是系统的，所以若是没有加入这个函数的定义，调用它也会致使不能交互。
iOS端如何使用
- 第一步：开启日志
|
1
2
3
4
|
// 开启日志，方便调试
[WebViewJavascriptBridge enableLogging];
|
- 第二步：给ObjC与JS创建桥梁
|
1
2
3
4
5
6
7
|
// 给哪一个webview创建JS与OjbC的沟通桥梁
self.bridge = [WebViewJavascriptBridge bridgeForWebView:webView];
// 设置代理，若是不须要实现，能够不设置
[self.bridge setWebViewDelegate:self];
|
- 第三步：注册HandleName，用于给JS端调用iOS端
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
// JS主动调用OjbC的方法
// 这是JS会调用getUserIdFromObjC方法，这是OC注册给JS调用的
// JS须要回调，固然JS也能够传参数过来。data就是JS所传的参数，不必定须要传
// OC端经过responseCallback回调JS端，JS就能够获得所须要的数据
[self.bridge registerHandler:@"getUserIdFromObjC" handler:^(id data, WVJBResponseCallback responseCallback) {
NSLog(@"js call getUserIdFromObjC, data from js is %@", data);
if (responseCallback) {
// 反馈给JS
responseCallback(@{@"userId": @"123456"});
}
}];
[self.bridge registerHandler:@"getBlogNameFromObjC" handler:^(id data, WVJBResponseCallback responseCallback) {
NSLog(@"js call getBlogNameFromObjC, data from js is %@", data);
if (responseCallback) {
// 反馈给JS
responseCallback(@{@"blogName": @"标哥的技术博客"});
}
}];
|
- 第四步：直接调用JS端注册的HandleName
|
1
2
3
4
5
|
[self.bridge callHandler:@"getUserInfos" data:@{@"name": @"标哥"} responseCallback:^(id responseData) {
NSLog(@"from js: %@", responseData);
}];
|
源代码
你们能够到GITHUB下载源代码，喜欢就随手给个Star：WebViewJavascriptBridgeDemo
最后
因为不少朋友不太会使用这个库，再加上群里的小伙伴们常常问这个问题，所以决定写一篇文章来教你们如何去使用。其实在此以前，笔者也没有使用过这个东西。
使用这个库有什么缺点？最明显的就是要固定加入相关代码，并且JS代码要放在固定的函数内添加。那么安卓端是否也支持这样呢？若是不支持，那么H5端要分别判断ios、安卓？因为没有在公司使用过，所以只能带着这些疑问，到底是否通用。
若是你们在公司使用过，那么必定了解安卓是否兼容。还请你们给笔者在评论中说说！谢谢！
推荐阅读
相关文章
- 1. vue中使用WebViewJavascriptBridge
- 2. IOS-WebViewJavascriptBridge使用说明
- 3. WebViewJavascriptBridge的使用说明
- 4. WebViewJavascriptBridge使用说明（iOS）
- 5. vue项目使用WebViewJavascriptBridge
- 6. WebViewJavascriptBridge
- 7. iOS WebViewJavascriptBridge初步尝试与图文详细讲解
- 8. vue.js的h5页面与android(WebViewJavascriptBridge) / ios(window.webkit.messageHandlers)交互详细
- 9. Shiro详细使用
- 10. sed 详细使用
- 更多相关文章...
- • Spring整合Redis详细步骤 - Redis教程
- • TortoiseSVN 使用教程 - SVN 教程
- • Composer 安装与使用
- • 使用Rxjava计算圆周率
相关标签/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
欢迎关注本站公众号,获取更多信息
相关文章
- 1. vue中使用WebViewJavascriptBridge
- 2. IOS-WebViewJavascriptBridge使用说明
- 3. WebViewJavascriptBridge的使用说明
- 4. WebViewJavascriptBridge使用说明（iOS）
- 5. vue项目使用WebViewJavascriptBridge
- 6. WebViewJavascriptBridge
- 7. iOS WebViewJavascriptBridge初步尝试与图文详细讲解
- 8. vue.js的h5页面与android(WebViewJavascriptBridge) / ios(window.webkit.messageHandlers)交互详细
- 9. Shiro详细使用
- 10. sed 详细使用