WebViewJavascriptBridge的使用和封装

iOS原生和UIWebView交互一般采用JavaScript来做,而目前第三方中框架比较好用,还是WebViewJavascriptBridge。这里基于WebViewJavascriptBridge(版本5.0.5)封装了些代码,作用是最后能实现Web传参到原生进行原生页面的跳转或者方法的直接调用以及原生传至给Web让Web根据得到的值进行业务或者界面的编写。

一.前期工作

1.1 下载库

你需要下载WebViewJavascriptBridge第三方库,点击这里进入,测试工程是使用pod下载,版本为5.0.5

1.2 界面搭建

用到的主要文件如下:


主要使用文件.png

入口使用原始的ViewController,让它带了NavigationController,中间按钮点击后会push出BridgeVc,BridgeVc带了一个UIWebview并加载网页WebTest.html,该网页利用了写好的JavaScript文件WebBridge.js来和原生界面进行交互。WebTest.html中有3个按钮,分别点击交互后对应push或者present出BViewController,BViewController带2个属性name和sex,BViewController界面出现后会打印这两个属性值,3种方式跳转后打印的属性值不同。

主页面.png

![Web.png](http://upload-images.jianshu.io/upload_images/1221039-62aee6dc707b9648.png?imageMogr2/auto-orient/strip%7CimageView2/2/
w/1240)

打印属性.png

二.代码

2.1 BridgeVc代码

该控制器主要负责显示加载UIWebview内容并且进行交互

//
//  BridgeVc.m
//  NewWebTest
//
//  Created by Jeffrey on 2017/5/14.
//  Copyright © 2017年 Jeffrey. All rights reserved.
//

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
#pragma ide diagnostic ignored "CannotResolve"

#import "BridgeVc.h"
#import "WebViewJavascriptBridge.h"

@interface BridgeVc ()
@property WebViewJavascriptBridge *bridge;
@property(nonatomic, strong) UIWebView *webView;

@end

@implementation BridgeVc

- (void)viewDidLoad {
    [super viewDidLoad];
    /**基础设置,并初始化bridge*/
    [self baseConfig];
    /**配置WebBridge*/
    [self bridgeConfig];
    /**加载本地网页*/
    [self loadExamplePage:self.webView];
    // Do any additional setup after loading the view.
}

/**常规设置,添加网页*/
- (void)baseConfig {
    self.webView = [[UIWebView alloc] initWithFrame:self.view.bounds];
    [self.view addSubview:self.webView];
}

/**配置WebBridge*/
- (void)bridgeConfig {
    /**初始化bridge*/
    self.bridge = [WebViewJavascriptBridge bridgeForWebView:(WVJB_WEBVIEW_TYPE *) self.webView];

    /***
     * 向Web发送数据data,并接收Web返回的数据responseData
     * data: 发送给Web的数据
     * responseData:Web接收到数据后执行了callHandler,带回来responseData数据
     */
    NSDictionary *customData = @{
            @"token": @"tokenValue",
            @"phoneType": @"iPhone7P"
    };
    [self.bridge callHandler:@"LocalToWeb" data:customData responseCallback:^(id responseData) {
        NSLog(@"发送给网页的内容为:%@,接收到网页的内容为:%@", customData, responseData);
    }];



    /***
     * 注册handler,接收Web发送的数据data并回传给Web本地的数据
     * data:Web发送过来的数据
     * responseCallback:是个block,可以带数据执行,例如responseCallback(dataForWeb),dataForWeb为id类型
     * 目测常规的数组字典字符串等都可以传,Web在接受数据后可以进行一些自定义操作
     * 目的:注册完这个方法后,可以实现:Web里调用js的pushViewControllerWithParameters方法后,原生界面根据方法内的具体参数进行界面跳转
     * 具体见WebTest.html文件
     * 另外,可以实现Web里调用js的performMethod方法后,直接调用本网页控制器内写好的方法,这里测试的为其继承类BaseViewController的
     * presentBWithName:sex:方法。
     */
    [self.bridge registerHandler:@"WebToLocal" handler:^(id data, WVJBResponseCallback responseCallback) {
        NSLog(@"网页传过来的数据是%@", data);
        NSArray *p = data[@"parameters"];
        NSString *methodName = data[@"methodName"];
        /**push控制器并带参数*/
        if ([methodName isEqualToString:@"push"]) {
            NSString *controllerName = data[@"controllerName"];
            NSDictionary *parameters = data[@"parameters"];
            Class controllerClass = NSClassFromString(controllerName);
            UIViewController *controller = (UIViewController *) [[controllerClass alloc] init];
            @try {
                /**Web里传过来的参数必须和要push出去的控制器属性一一对应,否则会抛出下面的异常*/
                [controller setValuesForKeysWithDictionary:parameters];
            }
            @catch (NSException *exception) {
                if ([exception.name isEqualToString:@"NSUnknownKeyException"]) {
                    /**属性没对应上,会抛出异常,并告知是哪个字段设置错误*/
                    NSLog(@"要push出的控制器没有该属性:%@,请在js上重新确认", exception.userInfo[@"NSUnknownUserInfoKey"]);
                    @throw exception;
                }
            }
            [self.navigationController pushViewController:controller animated:YES];
        } else {
            /**如果不是push方法,则执行常规的方法名带参数的方法*/
            [self performWithTarget:self MethodName:methodName withParameters:p];
        }
        /**回传内容*/
    }];
}

/**执行单个方法*/
- (void)performWithTarget:(id)target MethodName:(NSString *)methodName withParameters:(NSArray *)parameters {
    SEL method = NSSelectorFromString(methodName);
    NSMethodSignature *methodSignature = [[target class] instanceMethodSignatureForSelector:method];
    if (!methodSignature) {
        NSLog(@"无此方法名");
        return;
    }

    NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:methodSignature];
    invocation.target = target;
    invocation.selector = method;
    if (parameters.count > methodSignature.numberOfArguments - 2) {
        NSLog(@"参数个数不匹配");
    } else {
        for (int i = 0; i < parameters.count; i++) {
            NSString *value = parameters[(NSUInteger) i];
            [invocation setArgument:&value atIndex:i + 2];
        }
        [invocation invoke];
    }
}

/**加载网页*/
- (void)loadExamplePage:(UIWebView *)webView {
    NSString *htmlPath = [[NSBundle mainBundle] pathForResource:@"WebTest" ofType:@"html"];
    NSString *appHtml = [NSString stringWithContentsOfFile:htmlPath encoding:NSUTF8StringEncoding error:nil];
    NSURL *baseURL = [NSURL fileURLWithPath:htmlPath];
    [webView loadHTMLString:appHtml baseURL:baseURL];
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

@end

#pragma clang diagnostic pop

原则上如果网页端写好,项目中只需要加入上面对应的bridgeConfig方法即可,会自动根据Web里的JavaScript来进行调整或者方法的执行。

2.2 JavaScript代码(WebBridge.js文件)

/**
 * Created by jeffrey on 2017/5/15.
 */

/**
 * 原始方法,两个注册都需要调用这个方法才能使用
 * @param callback
 * @returns {*}
 */
function setupWebViewJavascriptBridge(callback) {

    if (window.WebViewJavascriptBridge) {
        return callback(WebViewJavascriptBridge);
    } else {

    }
    if (window.WVJBCallbacks) {
        return window.WVJBCallbacks.push(callback);
    }
    window.WVJBCallbacks = [callback];
    var WVJBIframe = document.createElement('iframe');
    WVJBIframe.style.display = 'none';
    /**注意,git上原来的readme文档上下面的资源有问题,会导致交互不能正常记性,下面这个是正常的*/
    WVJBIframe.src = 'wvjbscheme://__BRIDGE_LOADED__';
    document.documentElement.appendChild(WVJBIframe);
    setTimeout(function () {
        document.documentElement.removeChild(WVJBIframe)
    }, 0)
}


/**
 * push方法,让原生界面进行push跳转
 * @param controllerName 原生界面控制器名称
 * @param parameters 原生界面控制器的各个属性值(有的界面需要传值跳转),为字典类型,且键值对必须和控制器内属性一一对应,否则原生会抛异常。
 */
function pushViewControllerWithParameters(controllerName, parameters) {
    setupWebViewJavascriptBridge(function (bridge) {
        /**这里接收原生控制器的数据*/
        bridge.registerHandler('JS Echo', function (data, responseCallback) {
            responseCallback(data)
        });
        let data = {'methodName': 'push', 'controllerName': controllerName, 'parameters': parameters};
        bridge.callHandler('WebToLocal', data, function responseCallback(responseData) {
            console.log("JS received response:", responseData);
            alert(responseData['good'])
        })
    })
}

/**
 * 执行原生网页所在控制器的方法
 * @param methodName 方法名
 * @param parameters 所带参数,为数组。参数将按照方法里的顺序赋值
 */
function performMethod(methodName,parameters) {
    setupWebViewJavascriptBridge(function (bridge) {
        let data = {'methodName': methodName, 'parameters': parameters};
        bridge.callHandler('WebToLocal', data, function responseCallback(responseData) {
            alert(responseData['good'])
        })
    })
}


/**
 * 注册接收原生数据
 * 原生界面直接传数据过来,接收后可以根据接收的数据写出项目中的网页需要的逻辑
 */
function registerHandlerLocalToWeb() {
    window.onload = function () {
        /**注册接收原生数据*/
        setupWebViewJavascriptBridge(function (bridge) {
            /**
             * data: 原生传过来的数据
             * responseCallback:传入数据执行后原生会接收到,数据为responseData
             */

            bridge.registerHandler('LocalToWeb', function (data, responseCallback) {
                /**下面后台在获取相关数据后可以对网页进行一些操作,并返回原生一些数据*/
                alert('token是' + data['token']);
                let responseData = {'key1': 'this is a test', 'key2': 'Web To Local'};
                responseCallback(responseData);
            });
        });
    };
}

2.3 网页内使用JavaScript文件(WebTest.html)
注意:如果自己重新写,记得把上面的JavaScript文件添加到Copy Bundle Resources,否则不会在html里生效。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>测试</title>
    <script src="WebBridge.js"></script>
    <script>
        /**注册接收原生发过来的数据*/
        registerHandlerLocalToWeb();
    </script>
</head>
<body>
<p>这是个测试</p>
<script>
    let parametersA = {'name': 'Jeff', 'sex': 'M'};
    let parametersB = {'name': 'Tom', 'sex': 'F'};
    let parametersC = ['Lucy','F'];
</script>
<button onclick="pushViewControllerWithParameters('BViewController', parametersA)">点我A</button>
<button onclick="pushViewControllerWithParameters('BViewController', parametersB)">点我B</button>
<button onclick="performMethod('presentBWithName:sex:', parametersC)">点我present</button>
</body>
</html>

这里可以看到,html中在点击事件中执行js的pushViewControllerWithParameters方法,并传入iOS原生控制器名称(类名称)和该控制器的各属性(按照字典形式传入),即会push出对应控制器,这里还可以在push完后给出回调让html使用具体的返回数据

点击执行的performMethod方法,需要传入原生控制器的方法名字和参数,例如上面的第三个按钮,点击后调用了BridgeVc的方法presentBWithName:sex:(父类方法也可以调用),传入参数parametersC为数组,为方法里的各个参数,顺序从左到右。

另外在<head>标签执行的js:registerHandlerLocalToWeb()为注册去收到原生页面的传至,具体传至后如何使用可以在方法内部定义或者另行根据项目封装。

三.总结

最后根据项目的需求,先在原生中集成交互的代码(bridgeConfig相关代码,可以单独摘出来作为工具类也行),然后把js文件适当修改,扔给后台,在需要用到的网页上直接调用对应的方法即可。也可以根据自己项目中的逻辑进行再修改来使用。****
本工程git地址:https://github.com/JeffreyWW/JFWebBridgeTest

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

推荐阅读更多精彩内容