iOS与H5交互 H5与App原生交互,一般会是前端页面中的JavaScript与App使用的原生开发语言的交互。技术方案应能达到以下要求: 在js与原生进行交互的时候能保证正常的正向调用逻辑返回

来源:互联网 发布:淘宝神笔下载 编辑:程序博客网 时间:2024/05/15 07:59

iOS与H5交互

转自:http://www.cnblogs.com/fengmin/p/6558109.html

H5与App原生交互,一般会是前端页面中的JavaScript与App使用的原生开发语言的交互。技术方案应能达到以下要求:

  • 在js与原生进行交互的时候能保证正常的正向调用逻辑返回,反向可以处理异步回调,因为对js来说,大部分逻辑都是回调与监听。
  • 要保证H5与Native App通讯效率高、安全性强,能有效防止通过H5页面进行App注入、中间人攻击或者钓鱼。
  • 方便测试阶段,H5嵌入到App当中,开发人员方便调试与Debug。

在iOS控制器中加载UIWebView,设置代理,遵守UIWebViewDelegate协议。

复制代码
self.webView = [[UIWebView alloc] initWithFrame:self.view.frame];    _webView.delegate = self;    _webView.scalesPageToFit = YES;    [self.view addSubview:_webView];    NSURL * url = [NSURL URLWithString:@"file:///Users/feng/Desktop/11.html"];    NSURLRequest * request = [NSURLRequest requestWithURL:url];    [_webView loadRequest:request];
复制代码

1、iOS调用JS方法

通过iOS调用JS代码实现起来比较方便直接调用UIWebView的方法- (nullable NSString *)stringByEvaluatingJavaScriptFromString:(NSString *)script;

复制代码
 1.查询标签      // 查询标签      NSString *str = @"var word = document.getElementById('word');"                             @"alert(word.innerHTML)";      [webView stringByEvaluatingJavaScriptFromString:str];   2.为网页添加标签:      NSString *str = @"var img = document.createElement('img');"                      "img.src = 'icon5.jpg';"                      "img.width = 300;"                      "img.heigth = 100;"                      "document.body.appendChild(img);";     [webView stringByEvaluatingJavaScriptFromString:str];   3.删除网页标签:      // 删除标签      NSString *str1 = @"var word = document.getElementById('word');"                                @"word.remove();";      [webView stringByEvaluatingJavaScriptFromString:str1];   4.更改标签:      // 更改      NSString *str2 = @"var change = document.getElementsByClassName('change')[0];"                                "change.innerHTML = 'hello';";      NSString *result =  [webView stringByEvaluatingJavaScriptFromString:str2];    HTML端代码:     <!DOCTYPE html>     <html lang="en">     <head>            <meta charset="UTF-8">            <title>iOS和H5交互</title>     </head>     <body>            <p id="word">6666666666</p>            <ul>                 <li class="change">111111</li>                 <li class="haha">222222</li>                 <li>333333</li>                 <li>444444</li>            </ul>            <input class="name" placeholder="请输入密码">            <button onclick="buttonClick()">提交信息</button>    <script type="text/javascript">            alert('这个一个弹框');    </script>    </body>    </html>
复制代码
复制代码
//获取网页地址NSString * currentURL = [_webView stringByEvaluatingJavaScriptFromString:@"document.location.href"];    NSLog(@"%@",currentURL);//获取标题    NSString * title = [_webView stringByEvaluatingJavaScriptFromString:@"document.title"];    NSLog(@"%@",title);//插入js代码    [_webView stringByEvaluatingJavaScriptFromString:@"var script = document.createElement('script');"     "script.type = 'text/javascript';"     "script.text = \"function myFunction(){"     "var field = document.getElementsByName('q')[0];"     "field.value = 'dfjlsajfljsdkl';"     "document.forms[0].submit();"     "}\";"     "document.getElementsByTagName('head')[0].appendChild(script);"];    NSLog(@"js:%@",[_webView stringByEvaluatingJavaScriptFromString:@"myFunction();"]);        //提交表单    NSString * res = [_webView stringByEvaluatingJavaScriptFromString:@"document.forms[0].submit();"];    NSLog(@"%@",res);
复制代码

2、JS调用iOS方法

目前主流的技术方案:

在iOS7以前,在UIWebView中实现一些代理方法拦截带有约定好的protocol的Url,从Url上获取get方式的参数传递,映射成本地原生方法,如下:

1)第一种方法比较简单,通过字符串的比对。这种方式iOS端代码比较简单,网页加载完成后后台需要重新定义网页url,将移动端需要的参数拼接到url上返回,或者按照和后台约定好的字段来进行字符串比对以达到调用iOS方法的目的。下面贴代码。

复制代码
oc代码:(需要实现webView的协议)     // 拦截协议头,调取系统摄像头     #pragma mark UIWebViewDelegate     - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:            (UIWebViewNavigationType)navigationType    {        NSString *str = request.URL.absoluteString;        if ([str containsString:@"wxd://"]) {             [self getImage];         }        return YES;     }    - (void)getImage   {        if([UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypePhotoLibrary]) { //调用相册            //实例化控制器            UIImagePickerController *picker = [[UIImagePickerController alloc] init];            picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary;            picker.delegate = self;            // 是否有图片选取框            picker.allowsEditing = YES;            [self presentViewController:picker animated:YES completion:nil];        }    }   HTML端代码:   <!DOCTYPE html>   <html lang="en">          <head>          <meta charset="UTF-8">          <title>在html中调用oc的方法</title>          </head>          <body>                  <button onclick="getImage()">访问相册</button>          <script type="text/javascript">                  function getImage(){                        window.location.href = "wxd://getImage";                  }          </script>          </body>   </html>
复制代码

 

 

复制代码
-(BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType{  NSString *urlString = request.URL.absoluteString;  if ([urlString rangeOfString:@"js-call://"].location != NSNotFound) {      NSString * host = [self sliceHost:urlString];      NSDictionary * params = [self sliceParams:urlString];      if ([host isEqualToString:@"openOrderDetail"]) {          [self openOrderDetail:params];      }      return NO;  }  return YES;}
复制代码

这仅仅解决了js调用原生方法的问题,至于调用的结果与调用完之后要进行一些页面的回调,在这个拦截的过程中根本没有办法进行,不过有一些蹩脚的补偿措施,如下:

复制代码
-(void)webViewDidFinishLoad:(UIWebView *)webView{  self.orderDetailCallBackFuncName = [webView stringByEvaluatingJavaScriptFromString:@"orderCallbackfuncName()"];}
复制代码

会在页面加载完毕后主动去取页面上设置的回调方法的名称,然后在原生方法中处理完逻辑再进行回调。

复制代码
-(void)OpenOrderDetail:(NSDictionary *)params{  //do someting  [self.webView stringByEvaluatingJavaScriptFromString:[NSString stringWithFormat:@"%@()",self.orderDetailCallBackFuncName ]];}
复制代码

iOS7以后,大家都使用JavaScriptCore这个官方的WebKit 的 JavaScript 引擎,实现oc与JavaScript的语言穿梭。

 

2)第二种方法,JS直接用oc方法名来调用oc方法

头文件需要导入#import <JavaScriptCore/JavaScriptCore.h>。

首先创建一个继承自NSObject的类,在这里我命名为JSTestObjext,.h代码如下:

复制代码
import <Foundation/Foundation.h>#import <JavaScriptCore/JavaScriptCore.h>@protocol JSTestObjectProtocol <JSExport>- (void)CallOCFunction;- (void)CallOCFunctionFirstParameter:(NSString *)parameter;- (void)CallOCFunctionFirstParameter:(NSString *)parameter1 SecondParameter:(NSString *)parameter2;@end@interface JSTestObjext : NSObject <JSTestObjectProtocol>@end
复制代码
复制代码
//.m中实现协议方法,代码如下:
#import
"JSTestObjext.h"@implementation JSTestObjext- (void)CallOCFunction { NSLog(@"CallOCFunction");}- (void)CallOCFunctionFirstParameter:(NSString *)parameter { NSLog(@"CallOCFunctionFirstParameter:%@",parameter);}- (void)CallOCFunctionFirstParameter:(NSString *)parameter1 SecondParameter:(NSString *)parameter2 { NSLog(@"CallOCFunctionFirstParameter:%@ SecondParameter:%@",parameter1,parameter2);}@end
复制代码

之后在加载webView的控制器中调用:

复制代码
#import "ViewController.h"#import <JavaScriptCore/JavaScriptCore.h>#import "JSTestObjext.h"@interface ViewController ()<UIWebViewDelegate>@property (nonatomic, strong) UIWebView * webView;@end@implementation ViewController- (void)viewDidLoad {    [super viewDidLoad];    self.webView = [[UIWebView alloc] initWithFrame:self.view.frame];    _webView.delegate = self;    _webView.scalesPageToFit = YES;    [self.view addSubview:_webView];    NSURL * url = [NSURL URLWithString:@"file:///Users/feng/Desktop/11.html"];    NSURLRequest * request = [NSURLRequest requestWithURL:url];    [_webView loadRequest:request];            JSContext * context = [_webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];    JSTestObjext * test = [JSTestObjext new];    context[@"testObject"] = test;}
复制代码

到此为止,oc代码就已经写完了,我们只需告诉JS端使用testobject类,就可以调oc的方法了。下面附上JS调用的代码:

复制代码
<!DOCTYPE html>   <html lang="en">          <head>          <meta charset="UTF-8">          <title>在html中调用oc的方法</title>          <script type="text/javascript">            testObject.CallOCFunction();            testObject.CallOCFunctionFirstParameter('参数1');            testObject.CallOCFunctionFirstParameterSecondParameter('参数A','参数');          </script>          </head>          <body>                  <button type="button" onclick="secondClick">Click Me!</button>          </body>   </html>
复制代码

iOS与H5交互遇到的坑

 3、iOS7以后,大家都使用JavaScriptCore这个官方的WebKit 的 JavaScript 引擎,实现oc与JavaScript的语言穿梭。

复制代码
-(void)configJsCallBack{  WeakSelf;  self.jsContext = [self.webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];  self.jsContext.exceptionHandler = ^(JSContext * con,JSValue * exception){      NSLog(@"JS Error:%@",exception);  };  Coordinator * coordinator = [[Coordinator alloc]init];  self.jsContext[@"mobileCoordinator"] = coordinator;  self.jsContext[@"console"] = coordinator;}
复制代码

这里我们使用一些技巧,将所有的App开放给js的方法都由一个叫Coordinator的调度器来调度,而这个调度器实现了JSExport协议:

复制代码
#import <Foundation/Foundation.h>#import <JavaScriptCore/JavaScriptCore.h>@protocol CoordinatorExport <JSExport>-(void)log:(NSString *)msg;-(BOOL)callNativeModule:(NSString *)url;/*  js调用原生分享  shareOpinion为json对象  {      "type":"share",      "title":"share title",      "content":"share content",      "imgUrl":"",      "clickUrl":""  }  其中类型type有以下几种:  share(只有朋友圈和微信好友),doubleShare(包含所有分享渠道),allShare(分享全部渠道)*/JSExportAs(showShareMenu, -(BOOL)showShareMenu:(NSString *)url opinion:(NSString *)opinion);@end@interface Coordinator : NSObject< CoordinatorExport >@property(nonatomic,copy)BOOL (^openShareCallBack)(NSDictionary * opinion);@end
复制代码

  上面的做法就是我们会在合适的实际向JavaScript的运行的环境中注入一个叫做mobileCoordinator的对象,这个对象会注入到JavaScript环境中的window对象上,全局可用。为什么要封装到一个对象上,是因为js没有命名空间的概念并且有变量提升向上查找,会引起命名冲突,所以我们把对外暴露的方法都进行一个对象封装。还有一个好处就是JavaScript的开发者与app的开发者都会像编写各自语言的代码一样书写代码,没有语法损失,js同步调用原生方法,原生实现的时候具备返回值,js的调用者就可以获取返回值,如果是异步回调,那可以对外暴露方法的时候提供一个callback的入参,在异步完成后进行回调。

4、其他方案例如JavaScriptBridge等与第二种方案类似。

方案比较:

方案1的流程如下:
交互方式为单向
H5调用Native:

H5页面 —>发起Url Redirect(Url上携带带有动作语义的参数)->Native App->拦截Url Redirect->解析动作语义参数->调用相关Native代码

Native调用H5页面:

Native App—>获取页面上预留参数和解析动作语义参数->调用相关JavaScript代码

这样使得一个简单的方法调用变得非常割裂,而且双端维护成本非常高,不易debug。

方案2的流程如下:
交互为双向:

H5页面(Native App)<->调用Native代码(调用JavaScript代码)<->Native App执行被调用Native代码返回调用结果(H5页面执行被调用JavaScript代码并返回调用结果)

方案2优势比较明显,一般会采用第二种。

实现细节

细节上有一些需要注意的东西:
1.oc方法是带有参数标签的,js的方法并没有,注意使用JSExportAs这个宏来将oc原生语言转换为js语法风格的代码。
2.注意获取jscontext上下文并注入方法与对象的时机,这取决于H5页面上的js引用时机,如果H5页面上使用require来进行顺序引用,就不会出现问题,如果与原生交互的js的代码加载与原生注入的注入顺序混乱,则调用不到原生暴露的方法会引起js执行异常。建议结合拦截url的方式让H5决定何时注入,或者是前端工程师梳理规范,在H5引用js的时候做顺序控制。

防止注入与钓鱼

  其实这个不太算是技术方案,不过可以提一下。有时候手机在危险的网络环境中比方说链接在不安全的路由器中,DNS进行恶意中转到钓鱼网站上,如果页面调用已知的原生暴露出来的方法,同步数据或者是调用关键业务,就会有注入攻击的风险。一般需要做的是,H5在调用app原生关键业务的时候,需要在调用原生方法的时候传入票据,原生通过服务端的认证中心验证票据,通过才可以处理页面调用请求,在同步数据与状态的时候,比方说将app中的用户登录状态同步到H5页面上,一般app会同步cookie,不过这种方式维护成本较高。对于同步状态与数据,app应该使用业务票据来传递给H5,H5通过票据中心置换出真正的用户状态或者是关键业务数据。更高级别的方案还有H5与App临时握手等。

H5在WebView中的Debug

这个是一个比较恶心的事情,不过我们可以替换js的window对象上的console对象,将log函数转接到原生,再通过一些其他方式进行输出,JavaScriptCore中提供了exceptionHandler

context.exceptionHandler = ^(JSContext *context, JSValue *exception) { NSLog(@"JS Error: %@", exception);};

 


阅读全文
0 0
原创粉丝点击