在混合開發中,原生App與H5頁面的雙向通信是常見需求。本文記錄了利用WebViewJavascriptBridge實現JS與原生互調,以及頁面離線緩存的實踐要點。
// webview每次加載之前都會呼叫這個方法,利用該代理方法截取 JS 的 href 來呼叫原生方法 - (BOOL)webView:(UIWebView*)webView shouldStartLoadWithRequest:(NSURLRequest*)request navigationType:(UIWebViewNavigationType)navigationType
然而這次的交互要求是雙向通信:JS呼叫原生App方法後,原生App要把相關參數返回給H5頁面,H5頁面接收到後再做其他處理。例如:H5頁面的「發布信息」按鈕,點擊後需在原生端判斷用戶是否登錄,若未登錄則彈出原生登錄頁,登錄成功後把用戶信息返回給H5,繼續發布流程。
重點來了!這裡推薦一個好用的第三方庫:WebViewJavascriptBridge,地址:https://github.com/marcuswestin/WebViewJavascriptBridge 。透過它能輕鬆實現JS與原生的交互。
// 初始化 WebViewJavascriptBridge 方法
_bridge = [WebViewJavascriptBridge bridgeForWebView:self.BookWebView webViewDelegate:self handler:^(id data, WVJBResponseCallback responseCallback) {
}];
// 原生與 JS 約定接口名為 "testObjcCallback",data 是 JS 傳過來的信息,responseCallback 用來把信息傳回給 JS
[_bridge registerHandler:@"testObjcCallback" handler:^(id data, WVJBResponseCallback responseCallback) {
responseCallback(@"postInfomationToJS");
}];
如今很多產品都同時有安卓版與iOS版,意味著同樣的東西要做兩套、由兩組人完成,既增加開發成本,也加劇維護負擔。聰明的開發者想到了跨平台思路:用HTML寫頁面,分別以WebView(iOS、安卓)加載,對HTML無法呼叫的硬件能力,則透過雙方交互實現方法互調與傳值——這個過程就是跨平台。
下面來說說WebViewJavascriptBridge在iOS端如何使用。首先確保有一份已配好功能的HTML文件。
1. 初始化一個WebView(viewDidLoad)
UIWebView* webView = [[UIWebView alloc] initWithFrame:self.view.bounds]; [self.view addSubview:webView];
2. 將此WebView與WebViewJavascriptBridge關聯(viewDidLoad)
if (_bridge) { return; }
[WebViewJavascriptBridge enableLogging];
_bridge = [WebViewJavascriptBridge bridgeForWebView:webView webViewDelegate:self handler:^(id data, WVJBResponseCallback responseCallback) {
NSLog(@"ObjC received message from JS: %@", data);
responseCallback(@"Response for message from ObjC");
}];
此時你的WebView就與JS「搭上橋」了,接下來便是方法互調與參數互傳。
(1)JS呼叫OC方法(可透過data給OC傳值,用responseCallback把值返回給JS)
[_bridge registerHandler:@"testObjcCallback" handler:^(id data, WVJBResponseCallback responseCallback) {
NSLog(@"testObjcCallback called: %@", data);
responseCallback(@"Response from testObjcCallback");
}];
注意這裡的testObjcCallback是方法標示,HTML那邊的命名要跟iOS一致才能呼叫到,這個名字可以兩邊商量自定,簡單明確即可。
(2)OC呼叫JS方法(透過data傳值,透過responseCallback接收JS的返回值)
id data = @{ @"greetingFromObjC": @"Hi there, JS!" };
[_bridge callHandler:@"testJavascriptHandler" data:data responseCallback:^(id response) {
NSLog(@"testJavascriptHandler responded: %@", response);
}];
// 注意這裡的 testJavascriptHandler 也是個方法標示
(3)OC給JS傳值(透過responseCallback接收返回值)
[_bridge send:@"A string sent from ObjC to JS" responseCallback:^(id response) {
NSLog(@"sendMessage got response: %@", response);
}];
(4)OC給JS傳值(無返回值)
[_bridge send:@"A string sent from ObjC after Webview has loaded."];
推薦一個好用的第三方庫 RNCachingURLProtocol,只需在AppDelegate中加入下面這行即可:
[NSURLProtocol registerClass:[RNCachingURLProtocol class]];
地址:https://github.com/rnapier/RNCachingURLProtocol
NSURLConnection提供對網絡異步加載請求的支持,並把獲取的數據回傳給代理。它提供了簡單的接口來創建和取消連接,同時用delegate方法支持連接過程的反饋與控制。實際開發中直接用得不多,但不少第三方庫是用它封裝的。
舉例一:
1. 先創建一個NSURL;
2. 透過NSURL創建NSURLRequest,可指定緩存規則與超時時間;
3. 創建NSURLConnection實例,指定NSURLRequest和一個delegate對象。若創建失敗返回nil,成功則建立一個NSMutableData實例用來存儲數據。
NSURL *url = [NSURL URLWithString:@"https://192.168.2.128:9090/ssonew/login/UserLogin.action?name=mql&psd=123456"];
NSURLRequest *request = [[NSURLRequest alloc] initWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30];
self.theConncetion = [[NSURLConnection alloc] initWithRequest:request delegate:self startImmediately:YES];
if (_theConncetion) {
self.receiveData = [[NSMutableData alloc] init];
}
NSURLConnection有三個初始化函數,只有第一個能做到「創建連接但不立即下載」,而是透過start方法開始——呼叫該初始化函數時把startImmediately傳NO:
(id)initWithRequest:(NSURLRequest *)request delegate:(id)delegate startImmediately:(BOOL)startImmediately NS_AVAILABLE(10_5, 2_0); (id)initWithRequest:(NSURLRequest *)request delegate:(id)delegate; (NSURLConnection*)connectionWithRequest:(NSURLRequest *)request delegate:(id)delegate;
當收到後兩個消息時下載會立即開始,在代理收到 connectionDidFinishLoading: 或 connection:didFailWithError: 之前,可透過給連接發送 cancel: 消息來中斷下載。
connection:willSendRequest:redirectResponse: 在請求即將發出前呼叫,返回值就是真正要發送的請求,第二個參數是被重定向處理後的請求,第三個參數是觸發重定向的響應包。默認支持跳轉。
(NSURLRequest *)connection:(NSURLConnection *)connection willSendRequest:(NSURLRequest *)request redirectResponse:(NSURLResponse *)response
{
NSURLRequest *newRequest = request;
if (response) {
NSLog(@"redirect!!!");
newRequest = nil; // 拒絕跳轉
}
return newRequest;
}
connection:didReceiveResponse: 當服務器提供足夠信息以創建NSURLResponse時呼叫。注意一個簡單連接也可能收到多次該消息(連接重置或罕見的多組mime文檔等),此時應重置進度、丟棄之前接收的數據。
(void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
// 注意這裡將 NSURLResponse 轉換成 NSHTTPURLResponse 才能使用
NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse*)response;
if ([response respondsToSelector:@selector(allHeaderFields)]) {
NSDictionary *dictionary = [httpResponse allHeaderFields];
NSLog(@"%@", dictionary);
}
[self.receiveData setLength:0];
}
connection:didReceiveData: 下載過程中每當有數據到達便會呼叫,代理應在此存儲新接收的數據,也可加入進度指示器提示用戶。
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
[self.receiveData appendData:data];
}
connection:didFailWithError: 下載出錯時呼叫,NSError對象提供具體錯誤細節,也能在使用者信息字典裡提供失敗的url請求(用NSErrorFailingURLStringKey)。收到該消息後,該連接不會再收到任何消息。
(void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
{
}
connectionDidFinishLoading: 請求成功下載後呼叫,之後代理不會再收到其他消息。
(void)connectionDidFinishLoading:(NSURLConnection *)connection
{
NSLog(@"總共請求的數據長度 = %d", [self.data length]);
}
註:從iOS 5.0起,蘋果引入了block概念,因此用NSURLConnection發送請求可寫成:
NSURL *url = [NSURL URLWithString:@"https://www.google.com"];
NSURLRequest *request = [[NSURLRequest alloc] initWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30];
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[NSURLConnection sendAsynchronousRequest:request queue:queue completionHandler:^(NSURLResponse *response, NSData *data, NSError *error) {
if (error == nil) {
NSLog(@"download success");
NSStringEncoding enc = CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000);
NSString *str = [[NSString alloc] initWithData:data encoding:enc];
NSLog(@"%@", str);
} else if (error != nil) {
NSLog(@"error");
}
}];
以上演示的都是GET請求。若未用NSMutableURLRequest的setHTTPMethod設置,默認都是GET。要走POST請求,只需:1. 把NSURLRequest換成NSMutableURLRequest;2. [request setHTTPMethod:@"POST"];3. [request setHTTPBody:postData](postData一般是JSON字符串轉換而來);4. 用NSURLConnection啟動請求。