iOS与JS交互之UIWebView-JavaScriptCore框架

96
QiShare 22d8d123 271c 4d80 9c59 6990844a9e37
0.2 2018.08.30 20:14* 字数 812

级别:★★☆☆☆
标签:「iOS与JS交互」「UIWebView与JS交互」「JavaScriptCore」
作者: Xs·H
审校: QiShare团队

先解释下标题:“iOS与JS交互”。iOS指iOS原生代码(文章只有OC示例),JS指WEB前端(不单指JavaScript),交互指JS调用iOSiOS调用JS
作者将iOS与JS交互总结成了6种方式,并将逐一介绍。目录如下:


本文介绍如何使用JavaScriptCore框架在 UIWebView上实现iOSJS交互。
JavaScriptCoreAppleiOS7开放的框架。它为在UITableView上实现OCJS的交互提供了更为简单的方式。

一、JS调用iOS:
  • 实现逻辑:点击JS的登录按钮,JS将登录成功后的token数据传递给iOS,iOS将收到的数据展示出来。
  • 实现效果:


    JS调用iOS实现效果
  • JS代码:
//! 登录按钮
<button onclick = "login()" style = "font-size: 18px;">登录</button>
//! 登录
function login() {
  var token = "js_tokenString";
  loginSucceed(token);
}

//! 登录成功
function loginSucceed(token) {
  var action = "loginSucceed";
  jsToOc(action, token);
}

//! JS调用OC入口
function jsToOc(action, params) {
  var url = "jsToOc://" + action + "?" + params;
  loadURL(url);
}

//! 加载URL
function loadURL(url) {
  window.location.href = url;
}
  • iOS代码:
//! 导入JavaScriptCore框架头文件
#import <JavaScriptCore/JavaScriptCore.h>
#pragma mark - UIWebViewDelegate

//! UIWebView在每次加载请求完成后会调用此方法
- (void)webViewDidFinishLoad:(UIWebView *)webView {
    
    //! 获取JS代码的执行环境/上下文/作用域
    JSContext *context = [webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];

    //! 监听JS代码里面的jsToOc方法(执行效果上可以理解成重写了JS的jsToOc方法)
    context[@"jsToOc"] = ^(NSString *action, NSString *params) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [UIWebViewJavaScriptCoreController showAlertWithTitle:action message:params cancelHandler:nil];
        });
    };
}
  • 实现原理:
    1、JS与iOS约定好jsToOc方法,作为JS调用iOS的入口;
    2、iOS通过[webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"]获取JS代码的上下文JSContext;
    3、JS调用jsToOc方法,iOS使用Block形式监听(重写)此方法context[@"jsToOc"] = ^() {},收到JS的调用请求和参数;

PS:在使用Block形式监听(重写)JS的方法的时候,不要在Block中直接使用外部的JSValueJSContent,因为JSContext强引用BlockBlock强引用外部变量,JSValue又强引用JSContextJSValue需要JSContext来执行JS代码),会形成循环引用。因为JS没有弱引用的概念,所以__weak不会奏效,可以通过将JSValue作为Block内部参数和[JSContext currentContext]的方式分别解决两类循环引用的问题。


二、iOS调用JS:
  • 实现逻辑:点击iOS的登录按钮,iOS将登录成功后的token数据传递给JS,JS将收到的数据展示出来。

  • 实现效果:


    iOS调用JS实现效果
  • iOS代码:

//! 登录按钮
UIBarButtonItem *loginBtnItem = [[UIBarButtonItem alloc] initWithTitle:@"登录" style:UIBarButtonItemStylePlain target:self action:@selector(login:)];
self.navigationItem.rightBarButtonItems = @[loginBtnItem];
//! 登录方法
- (void)login:(id)sender {
    
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.5 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        JSContext *context = [self.webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
        //! JSContext -evaluateScript:方式调用JS方法
        [context evaluateScript:[NSString stringWithFormat:@"ocToJs('loginSucceed', 'oc_tokenString')"]];
        //! JSValue -callWithArguments:方式调用JS方法
        // [context[@"ocToJs"] callWithArguments:@[@"loginSucceed", @"oc_tokenString"]];
    });
}
  • JS代码:
//! iOS调用JS入口
function ocToJs(action, params) {
  document.getElementById("returnValue").innerHTML = action + '?' + params;
}
//! iOS调用JS数据显示框
<div id = "returnValue" style = "font-size: 18px; border: 1px dotted; height: 50px;"> </div>
  • 实现原理:
    1、iOS通过UIWebView的-valueForKeyPath:方法获取JSContext对象(保证在最新的JS环境中执行JS代码);
    2、iOS通过JSContext的-evaluateScript:方法执行一段JS代码ocToJs('loginSucceed', 'oc_tokenString')
    3、JS在ocToJs方法中将iOS传过来的数据显示在div元素中。

PS:除了使用JSContext的-evaluateScript:方法之外,还可以先通过[context[@"ocToJs"]获取到JS的ocToJs方法对应的JSValue,然后使用JSValue的-callWithArguments:方法调用JS的ocToJs方法。


续篇:iOS与JS交互之UIWebView-JSExport协议


关注我们的途径有:
QiShare(简书)
QiShare(掘金)
QiShare(知乎)
QiShare(GitHub)
QiShare(CocoaChina)
QiShare(StackOverflow)
QiShare(微信公众号)

推荐文章:
vue-cli 自动化测试 Nightwatch 详解
Vuex工作原理详解

iOS
Gupao