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 詳細使用