Hybrid App开发模式中, IOS/Android 和 JavaScript相互调用方式
IOS:Objective-C 和 JavaScript 的相互调用
iOS7以前,iOS SDK 并没有原生提供 js 调用 native 代码的 API。但是 UIWebView 的一个 delegate 方法使我们可以做到让 js 需要调用时,通知 native。在 native 执行完相应调用后,可以用stringByEvaluatingJavaScriptFromString 方法,将执行结果返回给 js。这样,就实现了 js 与 native 代码的相互调用。具体让 js 通知 native 的方法是让 js 发起一次特殊的网络请求。使用加载一个隐藏的 iframe 来实现的,通过将 iframe 的 src 指定为一个特殊的 URL,在Objective-C中通过UIWebView的webView:shouldStartLoadWithRequest:navigationType:方法拦截这个跳转,然后通过解析跳转的url获取js需要调用的方法名和参数。
Objective-C调用JavaScript
UIWebView有个方法是: - (NSString *)stringByEvaluatingJavaScriptFromString:(NSString *)script 可以
直接调用js。例如你想获取页面document的clientHeight属性,这样写: NSString *title = [webview stringByEvaluatingJavaScriptFromString:@"document.documentElement.clientHeight"]];
如果想调用页面的一个叫xxx的函数,则只需要 [webview stringByEvaluatingJavaScriptFromString:@"xxx()"]
这种调用有一个限制条件: JS代码占用的内存 < 10M。
Javascript调用Objective-C
iOS里面加载一个网页用的是UIWebView,页面加载是通过UIWebView的一个Delegate:UIWebViewDelegate来通知对应的webview的。而每次点击页面上的链接(或者是加载本页面的地址时) 都会在加载前调用UIWebViewDelegate的一个方法: - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
如果这个方法的返回值是YES的话就继续加载这个请求,如果是NO的话就不加载了。 Javascript调用Objective C代码的秘诀就在这里面。
第一步. 匹配url格式
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType: (UIWebViewNavigationType)navigationType { if (request.URL.absoluteString match urlSchemePattern) { [self executeSomeObjectiveCCode]; return NO; } else { return YES; } }
request.URL.absoluteString match urlSchemePattern
这句的意思是: 如果页面的url格式满足某种特定格式, 就不加载那个请求,而是执行Objective-C代码。
第2步 协商url格式以及参数传递方式
Javascript想要调用Objective-C代码时,Javascript代码就需要和Objective-C协商一个请求的协议,例如:凡是请求的url scheme 是"js-call://"
这样格式开头的就是Javascript需要调用Objective C的代码,再具体点,比如"js-call://user/get" 就是要调用Objective-C 代码中一个getUser的方法的。 如果Javascript需要传递参数给Objective-C, 最简单的方法是像http的query string一样传参数, 例如:"js-call://user/set?uid=1&name=jpx",然后在分析url的时候将query string提取出来传给Objective -C的方法即可。 代码如下:
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType { if ([request.URL.absoluteString hasPrefix:@"js-call://user/set"]) { NSDictionary *parameters = [self parseQueryString:request.URL.absoluetString]; [self executeSomeObjectiveCCodeWithParameters:parameters]; return NO; } else if ([request.URL.absoluteString hasPrefix:@"js-call://user/get"]) { NSDictionary *parameters = [self parseQueryString:request.URL.absoluetString]; [self executeSomeObjectiveCCodeWithParameters:parameters]; return NO; } return YES; }
如果Javascript需要调用好几个 Objective C的接口,那么在shouldStartLoadWithRequest的delegate方法里面就会有很多if ... else if分支代码, 此外,解析query string的那部分代码也是重复的,最好的办法是将这一切封装起来,可以定义一个JPXUIWebViewJSBridge方法。
self.bridge = [[JPXUIWebViewJSBridge alloc] initWithHandler:self];
self.bridge.routines = @[@[@"^js-call://user/set.*$", @"setUser"],
@[@"^js-call://user/get.*$", @"getUser"]
];
定义了这套规则之后,只需要比如说在ViewController里面实现一个叫setUser的方法即可: - (void)setUser:(NSDictionary *)parametersFromWeb
, 其中parametersFromWeb就是query string对应的字典!
然后在 - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
只需要这样写就可以了:
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType { NSError *error; BOOL canHandleRequest = [self.bridge canHandleRequest:request error:&error]; if (canHandleRequest) { [self.bridge handleRequest:request error:&error]; NSLog(@"error1:%@", [error localizedDescription]); return NO; } else { NSLog(@"error2:%@", [error localizedDescription]); } return YES; }
Javascript调用Objective C时,很多人第一反应就是在a标签里面的href写url调用,例如: <a href="js-call://user/set?uid=1&name=jpx" >测试</a>
, 但是这样的调用会如下的一些问题:
如果我们连续 2 个 js 调 native,连续 2 次改 <a href>
的话,在 native 的 delegate 方法中,只能截获后面那次请求,前一次请求由于很快被替换掉,所以被忽略掉了。还有这种改url的方式也不太安全。
而合理的做法应该是通过加载一个iframe:
function execute(url)
{
var iframe = document.createElement("IFRAME");
iframe.setAttribute("src", url);
document.documentElement.appendChild(iframe);
iframe.parentNode.removeChild(iframe);
iframe = null;
}
从iOS7开始,我们可以使用JavaScriptCore框架来让我们的Objective-C代码和JavaScript进行深度交互,简单的说我们可以在Objective-C代码中访问JavaScript中的变量或调用JavaScript的函数,也可以JavaScript中使用Objective-C的对象和方法
同步和异步
因为 iOS SDK 没有天生支持 js 和 native 相互调用,大家的技术方案都是自己实现的一套调用机制,所以这里面有同步异步的问题。细心的同学就能发现,js 调用 native 是通过插入一个 iframe,这个 iframe 插入完了就完了,执行的结果需要 native 另外用 stringByEvaluatingJavaScriptFromString 方法通知 js,所以这是一个异步的调用。
而 stringByEvaluatingJavaScriptFromString 方法本身会直接返回一个 NSString 类型的执行结果,所以这显然是一个同步调用。
所以 js call native 是异步,native call js 是同步。在处理一些逻辑的时候,不可避免需要考虑这个特点。
方法。
Android:Java 和 JavaScript 相互调用
在Android 4.2之前可以使用addJavascriptInterface
方式注入原生Java方法给JavaScript调用, 这种方案有一定的安全风险,在页面中执行一些不可信的Javascript代码即可能控制用户的手机,
因此在Android 4.2之后Android提供了@JavascriptInterface
对象注入的方式建立Javascript对象和android原生对象的绑定,提供给javascript调用的函数必须带有@JavascriptInterface
。本文以@JavascriptInterface为例,讲解一下Android:Java和JavaScript之间相互调用的方法。
第一步: 加载本地html文件
有的时候我们在使用webview开发的时候会使用本地的html文件,在这里为了方便我们把html文件都放在assets
文件夹中,使用本地加载的方式,不需要server支持。
先定义一个html文件:
<!DOCTYPE html>
<html>
<body>
<h1>this is html</h1>
</body>
</html>
使用file:///android_asset/index.html
加载到webview中:
private void initView() {
webView = (WebView) findViewById(R.id.webView);
webView.loadUrl("file:///android_asset/index.html");
}
Javascript调用Java方法
以Android的Toast的为例,从Javascript代码中调用系统的Toast。
我们定义一个AndroidToast的Java类,它有一个show的方法用来显示Toast:
public class AndroidToast {
@JavascriptInterface
public void show(String str) {
Toast.makeText(MainActivity.this, str, Toast.LENGTH_SHORT).show();
}
}
需要对WebView设置一些参数,开启JavaScipt,注册JavascriptInterface:
private void initView() {
webView = (WebView) findViewById(R.id.webView);
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
webSettings.setDefaultTextEncodingName("UTF-8");
webView.addJavascriptInterface(new AndroidToast(), "AndroidToast");
webView.loadUrl("file:///android_asset/index.html");
}
addJavascriptInterface
的作用是把AndroidToast类映射为Javascript中的AndroidToast对象。
在Javascript中调用Java代码:
function toastClick(){
window.AndroidToast.show('from js');
}
通过window的属性可以找到Java映射的对象AndroidToast,调用它的show方法。
注意这里传输的数据只能是基本数据类型和string,可以传输string意味着我们可以使用json
传输结构化数据。
Javascript调用有返回值Java函数
如果想从Javascript调的方法里面获取到返回值,只需要定义一个带返回值的@JavascriptInterface
方法:
public class AndroidMessage {
@JavascriptInterface
public String getMsg() {
return "form java";
}
}
添加Javascript的映射Webview:
webView.addJavascriptInterface(new AndroidMessage(), "AndroidMessage");
Javascript直接调用Java方法:
function showAlert(){
var str=window.AndroidMessage.getMsg();
console.log(str);
}
Java调用Javascript方法
Java在调用js的时候,使用的是WebView.loadUrl()
方法,可以直接在HTML页面里面执行JavaScript方法,首先定义一个Javascript方法给Java调用:
Java调用有参数无返回值的js函数
function callFromJava(str){
console.log(str);
}
Java端调用Javascript方法:
public void javaCallJS(){
webView.loadUrl("javascript:callFromJava('call from java')"); // 可以在loadUrl中直接给Javascript方法直接传值
}
调用js有参数有返回值的函数
Android在4.4之前并没有提供直接调用js函数并获取值的方法,所以在此之前,常用的思路是 java调用js方法,js方法执行完毕,再次调用java代码将值返回。
1.Java调用js代码
String call = "javascript:sumToJava(1,2)";
webView.loadUrl(call);
2.js函数处理,并将结果通过调用java方法返回
function sumToJava(number1, number2){ window.control.onSumResult(number1 + number2) }
3.Java在回调方法中获取js函数返回值
@JavascriptInterface public void onSumResult(int result) { Log.i(LOGTAG, "onSumResult result=" + result); }
Android 4.4处理
Android 4.4之后使用evaluateJavascript即可。这里展示一个简单的 具有返回值的js方法
function getGreetings() { return 1; }
java代码时用evaluateJavascript方法调用
private void testEvaluateJavascript(WebView webView) { webView.evaluateJavascript("getGreetings()", new ValueCallback<String>() { @Override public void onReceiveValue(String value) { Log.i(LOGTAG, "onReceiveValue value=" + value); }}); }
注意事项:
- 上面限定了结果返回结果为String,对于简单的类型会尝试转换成字符串返回,对于复杂的数据类型,建议以字符串形式的json返回。
- evaluateJavascript方法必须在UI线程(主线程)调用,因此onReceiveValue也执行在主线程。