iOS Native JS 交互流程总结

1. URL拦截

WebView 与 WKWebView 都可使用。

1.1 JS调用oc
  • 首先跟后端协定好协议,如:iosprotocolname://back 表示点击返回按钮
  • 在 shouldStartLoadWithRequest 方法中处理
  • 当拦截到后,处理自己事务,并return NO
1.2 OC调用 JS
  • 在网页加载完成后。webViewDidFinishLoad
  • 使用方法 : stringByEvaluatingJavaScriptFromString进行调用
关键代码
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType{
    // jS  调用  OC
    NSString *reqStr = request.URL.absoluteString;
    NSLog(@"request:%@",reqStr);
    if ([reqStr isEqualToString:@"protocolname://back"]) {
        [self back];
        return NO;
        
    }else if ([reqStr hasPrefix:@"protocolname://"]) {
        //在这里做JavaScript调用Objective-C的事。
        //需要传的值放在url后面的参数里如:ProtocolName://www.xxxxcom?{"title":"标题","id":"123","des":"描述内容"}
        

        //1.  对制定的协议进行数据解析。里面可能包含调用地址,参数等等。
        //2.  处理自身事务(可能用到解析到的数据,比如参数)
        //3.  可能需要回调,将数据回传给JS
        
        [webView stringByEvaluatingJavaScriptFromString:@"alert('seccess')"];
        return NO;
    }
    return YES;
    
}

2. MessageHandler

WKWebView 初始化时,有一个参数叫configuration,它是WKWebViewConfiguration类型的参数,

WKWebViewConfiguration有一个属性叫userContentController,它又是WKUserContentController类型的参数。

WKUserContentController对象有一个方法- addScriptMessageHandler:name:,我把这个功能简称为MessageHandler

流程
  1. 初始化 WKWebView ,需配置 configuration(WKWebViewConfiguration)

  2. 初始化WKWebViewConfiguration ,配置userContentController(WKUserContentController)

  3. 初始化WKUserContentController,并通过- addScriptMessageHandler:name:,注册js中的方法, 并设置处理接收JS方法的对象

    handel: id <WKScriptMessageHandler> 代理对象
    name: js中的方法名称

  4. 在代理回调中进行事件捕获处理

    - (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message{
       //WKScriptMessage message
       //message中包含有name: 方法名, body:参数等信息
    }
    
注意点

WKWebView 在 addScriptMessageHandler 时,应注意循环引用的问题。例如:直接在控制器中添加: [userController addScriptMessageHandler:self name:@"jsToOcNoPrams"];

循环原因:

控制器 --->WKWebView(configuration) --> WKWebViewConfiguration(userContentController)--> WKUserContentController(addScriptMessageHandler:设置为self) --> 控制器

解决办法:

  1. 在viewWillDisappear中 移除之前添加的MessageHandle
  2. 声明一个中间变量,设置其代理 为 weak 弱引用。

弱引用示例:

// WKWebView 内存不释放的问题解决
@interface WeakWebViewScriptMessageDelegate : NSObject<WKScriptMessageHandler>

//WKScriptMessageHandler 这个协议类专门用来处理JavaScript调用原生OC的方法
@property (nonatomic, weak) id<WKScriptMessageHandler> scriptDelegate;

- (instancetype)initWithDelegate:(id<WKScriptMessageHandler>)scriptDelegate;

@end


@implementation WeakWebViewScriptMessageDelegate
- (instancetype)initWithDelegate:(id<WKScriptMessageHandler>)scriptDelegate {
    self = [super init];
    if (self) {
        _scriptDelegate = scriptDelegate;
    }
    return self;
}
//遵循WKScriptMessageHandler协议,必须实现如下方法,然后把方法向外传递
- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message {
    
    if ([self.scriptDelegate respondsToSelector:@selector(userContentController:didReceiveScriptMessage:)]) {
        [self.scriptDelegate userContentController:userContentController didReceiveScriptMessage:message];
    }
}

@end

3. JavaScriptCore

首先需要导入JavaScriptCore.framework框架

//为JavaScript的执行提供运行环境,上下文,
#import "JSContext.h"
//JSValue都是通过JSContext返回或者创建的,通过JSValue对OC、JS进行类型转换
#import "JSValue.h"
//主要用途是解决JSValue对象在Objective-C 堆上的安全引用问题,一般不用
#import "JSManagedValue.h"
//JS 虚拟机 ,一般不需要手动创建,在创建JSContext会帮我们自动创建,是线程安全的
#import "JSVirtualMachine.h"  
//JSExport是一个协议类
#import "JSExport.h"

流程:

JS 调用 native
  1. 在webViewDidFinishLoad 中,注册native要调用的JS方法。

    比如js中的方法名称为callFunc有一个参数

    - (void)webViewDidFinishLoad:(UIWebView *)webView{
         //通过webview绑定js上下文
        JSContext * jsContext = [webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
      
        // 注册js方法
        jsContext[@"callFunc"] =^(id obj){
               //在这里处理js传递过来的信息
            };
         //异常信息处理
        jsContext.exceptionHandler = ^(JSContext *context, JSValue *exceptionValue) {
            context.exception = exceptionValue;
                 //比如把js中的方法名改掉,OC找不到相应方法,这里就会打印异常信息
            NSLog(@"异常信息:%@", exceptionValue);
        };
    }
    

    这样当js内,调用callFunc方法时,就会在这里被捕获到进行处理。

native 调用js
  1. 获取js上下文

       //通过webview绑定js上下文
      JSContext * jsContext = [self.webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
    
  2. 调用JS方法

    方法1: 使用JSContext的方法-evaluateScript

     //showAlert 为 js中的方法, yoyoyo为传递过去的参数
     NSString *jsStr = @"showAlert('yoyoyo')";
      [jsContext evaluateScript:jsStr];
    

方式2: 使用JSValue的方法-callWithArguments

- (void)ocCallJS2{//直接调用该方法实现OC调用JS,并传参
  //获取方法1
 JSValue *ocCallJS = [self.jsContext objectForKeyedSubscript:@"showAlert"];
   //获取方法2,与上面获取方式一样
  JSValue *ocCallJS = self.jsContext[@"showAlert"];
  //设置参数
  NSArray * argus = @[@"hahaha"];
  //进行调用
  JSValue *returnValue = [ocCallJS callWithArguments:argus];
  NSString *title = returnValue.toString;
}

方式3: 利用UIWebView的API stringByEvaluatingJavaScriptFromString

使用场景:js调用native,native处理后,将处理结果回传给js

- (void)addPayActionWithContext:(JSContext *)context
{
    //调用native支付
    context[@"payAction"] = ^() {
        NSArray *args = [JSContext currentArguments];
        
        if (args.count < 4) {
            return ;
        }
        
        NSString *orderNo = [args[0] toString];
        NSString *channel = [args[1] toString];
        long long amount = [[args[2] toNumber] longLongValue];
        NSString *subject = [args[3] toString];
        
        // 支付操作
        NSLog(@"orderNo:%@---channel:%@---amount:%lld---subject:%@",orderNo,channel,amount,subject);
        // 将支付结果回传给js
        [[JSContext currentContext][@"payResult"] callWithArguments:@[@"支付成功"]];
    };
}


注意点

避免循环引用,因为block 会持有外部变量,而JSContext也会强引用它所有的变量,因此在block中调用self时,要用__weak 转一下。

而且在block内部要使用外部的context 以及JSValue,都会导致循环引用。如果要使用context 可以使用[JSContext currentContext]

当然我们可以将JSContext 和JSValue当做block的参数传进去。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容

  • 前言 Web 页面中的 JS 与 iOS Native 如何交互是每个 iOS 猿必须掌握的技能。而说到 Nati...
    幽城88阅读 2,195评论 1 8
  • 随着H5技术的兴起,在iOS开发过程中,难免会遇到原生应用需要和H5页面交互的问题。其中会涉及方法调用及参数传值等...
    Chris_js阅读 3,060评论 1 8
  • 目录 《App与Js交互(一)iOS》 《App与Js交互(二)Android》 《App与Js交互(三)Andr...
    gwpp阅读 10,339评论 1 20
  • 一、简述 目前原生与JS交互的方式有以下几种 JavaScriptCore WKWebView 拦截URL Web...
    兔先森Amo阅读 5,206评论 0 4
  • 跟原生开发相比,H5的开发相对来一个成熟的框架和团队来讲在开发速度和开发效率上有着比原生很大的优势,至少不用等待审...
    卡哇伊小王子阅读 2,223评论 0 0