iOS中实现JS和OC的交互(Hybrid App)

Hybrid.png

在项目开发中,我们常常遇到这种情况,一个功能性界面需要分享到其他平台,或者是一个较复杂,原生框架不易实现,需要经常变动的界面,处理这种功能,最优的处理办法就是交给H5来完成了。像这种介于web-app、native-app这两者之间的app,兼具“Native App良好用户交互体验的优势”和“Web App跨平台开发的优势”的应用就被成为Hybrid App

在iOS端涉及的知识就是JS和OC之间的交互,下面我们逐步学习如何处理这两者交互的问题。

##目录 >

  • 使用JavaScriptCore与JS交互
    • JavaScriptCore了解
    • 获取JS点击事件(JS调用OC)
    • OC调用JS方法
    • 使用WebViewJavascriptBridge与JS交互
    • 引入WebViewJavascriptBridge
    • JS调用OC
    • OC调用JS

##使用JavaScriptCore与JS交互

###JavaScriptCore了解 JavaScript和OC交互常用的框架就是这个了,首先我们了解几个概念:

  • JSValue: 代表一个JavaScript实体,一个JSValue可以表示很多JavaScript原始类型例如boolean, integers, doubles,甚至包括对象和函数。
    • JSContext: 代表JavaScript的运行环境,你需要用JSContext来执行JavaScript代码。所有的JSValue都是捆绑在一个JSContext上的。
    • JSExport: 这是一个协议,可以用这个协议来将原生对象导出给JavaScript,这样原生对象的属性或方法就成为了JavaScript的属性或方法,非常神奇。 JavaScriptCore了解

###网页内容

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>
    <div style="margin-top: 20px">
        <h2>JavaSript与OC交互</h2>
        <input type="button" value="Native传值" onclick="Native.call('Native调用')">
    </div>
    <div>
        <input type="button" value="传值测试" onclick="passValue('test')">
    </div>
    <script>
        var alertShow = function(str)
        {
        alert(str);
        }
    </script>
</body>
</html> 

HTML运行结果: screen shot.png

###获取JS点击事件

我们目的是获取点击方法

第一步 导入JavaScriptCore

#import <JavaScriptCore/JavaScriptCore.h> 第二步 加载HTML文件

NSString

  • path = [[NSBundle mainBundle] pathForResource:@"index" ofType:@"html"]; NSURL
    • url = [NSURL fileURLWithPath:path]; NSURLRequest
      • request = [NSURLRequest requestWithURL:url] ; [self.webView loadRequest:request];
      第三步 获取当前页面JSContxt对象
      有两种添加点击事件的方式
      • 直接调用的函数

        <input type="button" value="传值测试" onclick="passValue('test')">
        

        如果是第一种情况,比较简单。在代理- (void)webViewDidFinishLoad:(UIWebView *)webView 中加上

        self.context[@"passValue"] = ^(NSString *str){
            NSLog(@"%@",str);
        };
        

        如果点击传值按钮,就会调用此block,输出test

        • 第二种:通过native调用的方式

        <input type="button" value="Native传值" onclick="Native.call('Native调用')"> 
        

        这种方式需要声明一个JSExport的协议,协议中声明供JS使用的方法:
        `ObjectiveC

        #import <UIKit/UIKit.h>

        #import <JavaScriptCore/JavaScriptCore.h>

        @protocol JSObjcDelegate <JSExport> - (void)call:(NSString *)str; @end

        
        然后还要以JSExport协议关联Native方法,
        
        

        ObjectiveC self.content[@"Native"] = self;

        
        在实现文件中实现这个方法
        
        

        ObjectiveC - (void)call:(NSString *)str{ NSLog(@"call"); }

        
        此时点击一下Native传值,就会输出`Native调用`
        还有一个需要注意的地方是,在JS调用的方法里实现页面跳转时,要回到主线程执行。可以使用GCD方法
        
        

        ObjectiveC dispatchasync(dispatchgetmainqueue(), ^{ [self.navigationController pushViewController:vc animated:YES]; });

        
        至此,获取JS点击事件的功能就完成了。
        
        ###OC调用JS方法
        在上面那段HTML里有一个函数`alertShow()`,是调用弹框并将`str`值显示出来。那么我们如何调用这个方法呢?
        第一步、获取这个函数,有两种方法
        
            JSValue *Callback = self.context[@"alertShow"];//第一种方式
            JSValue *Callback = [self.context objectForKeyedSubscript:@"alertShow"];//第二种方式
        
        第二步、向JS传参
        
        

        ObjectiveC [Callback callWithArguments:@[@"OC调用JS方法"]];//出现一个弹框,OC调用JS方法

        
        如果想直接使用JS的方法可以
        
        

        ObjectiveC NSString *str = @"alert('OC添加JS提示成功')"; [self.context evaluateScript:str];

        
        
        ###加载新的URL
        WebView有一个代理方法,每当需要去加载一个request,就会回调这个方法,让上层决定是否加载。常常一个H5页面会进行不同url之间的跳转,这里截获,进行本地处理。
        
        

        ObjectiveC - (BOOL)webView:(UIWebView )webView shouldStartLoadWithRequest:(NSURLRequest )request navigationType:(UIWebViewNavigationType)navigationType{ NSString *url = request.URL.absoluteString; NSLog(@"%@",url); if(![self isNetwork]){ //无网情况的一个处理 }else if([url hasSuffix:@"ios/test"]){ //do something you want return NO; } return YES; }

        
        ##使用WebViewJavascriptBridge与JS交互
        [WebViewJavascriptBridge](https://github.com/marcuswestin/WebViewJavascriptBridge)是一个轻量的用于OC与JS交互的第三方库,使用它可以用CocoaPods导入:
        `pod 'WebViewJavascriptBridge', '~> 5.0'`
        也可以在Github上下载示例工程,将工程文件`WebViewJavascriptBridge`拖入自己项目中。本节主要介绍使用方法,关于实现原理网上介绍也比较多,感兴趣的同学可以自行了解。
        
        **引入WebViewJavascriptBridge**
        
        

        ObjectiveC //设置能够进行桥接 [WebViewJavascriptBridge enableLogging]; //注册handler在Object-C,如果有self.webView.delegate = self。应注释掉,否则注册方法不执行 self.bridge = [WebViewJavascriptBridge bridgeForWebView:self.webView];

        //如果想执行UIWebView的代理方法,需设置 [self.bridge setWebViewDelegate:self];

        
        **JS调用OC**
        JS调用原生方法`getUsername`,可以使用如下方式注册。JS需要返回值的可以用responseCallback将返回值传过去
        
        

        ObjectiveC [self.bridge registerHandler:@"getUsername" handler:^(id data, WVJBResponseCallback responseCallback) { NSLog(@"%@",data); responseCallback([self getUsername]); }];

        
        **OC调用JS**
        OC调用JS可以使用如下方法实现,如果需要传参,可以写到参数`data:`里,如果没有参数就传`nil`
        
        

        ObjectiveC //OC调JS的方法 [self.bridge callHandler:@"testJavascriptHandler" data:nil responseCallback:^(id responseData) {

        NSLog(@"ObjC received response: %@", responseData); }];

        
        
        ****
        常见的处理JS与OC之间交互的问题,基本就这些了。希望对大家有所帮助,Demo在这里[传送门](https://github.com/zhangferry/JavaScript-O
        
        iOS10本地通知UserNotifications快速入门蓝牙固件升级