最近准备把之前用JS与原生相互调用功能整理下。顺便搜索整理了一下JS 与OC 交互的方式,目前我已知的JS 与 OC 交互的处理方式:
1.在JS 中做一次URL跳转,然后在OC中拦截跳转
2.利用WKWebView 的MessageHandler
3.利用系统库JavaScriptCore,来做相互调用(iOS 7推出的)
4.利用第三方库WebViewJavascriptBridge
5.利用第三方库EasyJSWebView(已不更新)
6.利用第三方cordova库,以前叫PhoneGap
7.利用第三方DSBridge,值得推荐.(博客里整理的有,可以去看看)
8.当下火热的React Native(还没整理)
在这里感谢Haley-Wong大神提供资源.
今天就详细的介绍一下使用UIWebView拦截URL 的方式来实现JS与OC 的交互:
创建UIWebView,并加载本地HTML
加载本地HTML的目的是便于自己写JS调用做测试,最终肯定还是加载网络HTML
self.webView = [[UIWebView alloc] initWithFrame:self.view.frame]; self.webView.delegate = self; NSURL *htmlURL = [[NSBundle mainBundle] URLForResource:@"index.html" withExtension:nil]; // NSURL *htmlURL = [NSURL URLWithString:@"http://www.baidu.com"]; NSURLRequest *request = [NSURLRequest requestWithURL:htmlURL]; // 如果不想要webView 的回弹效果 self.webView.scrollView.bounces = NO; // UIWebView 滚动的比较慢,这里设置为正常速度 self.webView.scrollView.decelerationRate = UIScrollViewDecelerationRateNormal; [self.webView loadRequest:request]; [self.view addSubview:self.webView];
本地的HTML里,我定义了几个按钮,来触发调用原生的方法,然后再将执行结果回调到js 里
<input type="button" value="扫一扫" onclick="scanClick()" /> <input type="button" value="获取定位" onclick="locationClick()" /> <input type="button" value="修改背景色" onclick="colorClick()" /> <input type="button" value="分享" onclick="shareClick()" /> <input type="button" value="支付" onclick="payClick()" /> <input type="button" value="摇一摇" onclick="shake()" /> <input type="button" value="返回" onclick="goBack()" /> // js 就列几个比较有代表性的functions: function loadURL(url) { var iFrame; iFrame = document.createElement("iframe"); iFrame.setAttribute("src", url); iFrame.setAttribute("style", "display:none;"); iFrame.setAttribute("height", "0px"); iFrame.setAttribute("width", "0px"); iFrame.setAttribute("frameborder", "0"); document.body.appendChild(iFrame); // 发起请求后这个iFrame就没用了,所以把它从dom上移除掉 iFrame.parentNode.removeChild(iFrame); iFrame = null; } function asyncAlert(content) { setTimeout(function(){ alert(content); },1); } function locationClick() { loadURL("haleyAction://getLocation"); } function setLocation(location) { asyncAlert(location); document.getElementById("returnValue").value = location; }
虽然HTML 内容很少,但是还有不少学问:
2.拦截 URL
UIWebView 有一个代理方法,可以拦截到每一个链接的Request。return YES,webView 就会加载这个链接;return NO,webView 就不会加载这个连接。我们就在这个拦截的代理方法中处理自己的URL。
这是我的示例代码:
#pragma mark - UIWebViewDelegate - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType { NSURL *URL = request.URL; NSString *scheme = [URL scheme]; if ([scheme isEqualToString:@"haleyaction"]) { [self handleCustomAction:URL]; return NO; } return YES; }
这里通过scheme,来拦截掉自定义的URL 就非常容易了,如果不同的方法使用不同的scheme,那么判断起来就非常的麻烦。
然后,看看我的处理连接的方法:
#pragma mark - private method - (void)handleCustomAction:(NSURL *)URL { NSString *host = [URL host]; if ([host isEqualToString:@"scanClick"]) { NSLog(@"扫一扫"); } else if ([host isEqualToString:@"shareClick"]) { [self share:URL]; } else if ([host isEqualToString:@"getLocation"]) { [self getLocation]; } else if ([host isEqualToString:@"setColor"]) { [self changeBGColor:URL]; } else if ([host isEqualToString:@"payAction"]) { [self payAction:URL]; } else if ([host isEqualToString:@"shake"]) { [self shakeAction]; } else if ([host isEqualToString:@"goBack"]) { [self goBack]; } }
顺便看一下如何将结果回调到JS中:
- (void)getLocation { // 获取位置信息
// 将结果返回给js NSString *jsStr = [NSString stringWithFormat:@"setLocation('%@')",@"广东省深圳市"]; [self.webView stringByEvaluatingJavaScriptFromString:jsStr]; }
当然,有时候我们在JS中调用OC 方法的时候,也需要传参数到OC 中,怎么传呢?
就像一个get 请求一样,把参数放在后面:
function shareClick() { loadURL("haleyAction://shareClick?title=测试分享的标题&content=测试分享的内容&url=http://www.baidu.com"); }
那么如果获取到这些参数呢?
所有的参数都在URL的query中,先通过&
将字符串拆分,在通过=
把参数拆分成key 和实际的值。下面有示例代码:
- (void)share:(NSURL *)URL { NSArray *params =[URL.query componentsSeparatedByString:@"&"]; NSMutableDictionary *tempDic = [NSMutableDictionary dictionary]; for (NSString *paramStr in params) { NSArray *dicArray = [paramStr componentsSeparatedByString:@"="]; if (dicArray.count > 1) { NSString *decodeValue = [dicArray[1] stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding]; [tempDic setObject:decodeValue forKey:dicArray[0]]; } } NSString *title = [tempDic objectForKey:@"title"]; NSString *content = [tempDic objectForKey:@"content"]; NSString *url = [tempDic objectForKey:@"url"]; // 在这里执行分享的操作 // 将分享结果返回给js NSString *jsStr = [NSString stringWithFormat:@"shareResult('%@','%@','%@')",title,content,url]; [self.webView stringByEvaluatingJavaScriptFromString:jsStr]; }
3. OC调用JS方法
关于将OC 执行结果返回给JS 需要注意的是:
如果回调执行的JS 方法带参数,而参数不是字符串时,不要加单引号
,否则可能导致调用JS 方法失败。比如我这样的:
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:userProfile options:NSJSONWritingPrettyPrinted error:nil]; NSString *jsonStr = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding]; NSString *jsStr = [NSString stringWithFormat:@"loginResult('%@',%@)",type, jsonStr]; [_webView stringByEvaluatingJavaScriptFromString:jsStr];
如果第二个参数用单引号包起来,就会导致JS端的loginResult不会调用。
另外,利用[webView stringByEvaluatingJavaScriptFromString:@"var arr = [3, 4, 'abc'];"];
,可以往HMTL的JS环境中插入全局变量、JS方法等。