客户端相关知识学习(二)之h5与原生app交互的原理

时间:2022-05-30 20:23:13

前言

现在移动端 web 应用,很多时候都需要与原生 app 进行交互、沟通(运行在 webview中),比如微信的 jssdk,通过 window.wx 对象调用一些原生 app 的功能。所以,这次就来捋一捋 h5 与原生 app 交互的原理。

h5 与原生 app 的交互,本质上说,就是两种调用:

app 调用 h5 的代码

h5 调用 app 的代码

app 调用 h5 的代码

因为 app 是宿主,可以直接访问 h5,所以这种调用比较简单,就是在 h5 中曝露一些全局对象(包括方法),然后在原生 app 中调用这些对象。

客户端相关知识学习(二)之h5与原生app交互的原理

Javascript:

window.sdk = {

double = value => value * 2,

triple = value => value * 3,

};

android:

webview.evaluateJavascript('window.sdk.double(10)', new ValueCallback<String>() {

@Override

public void onReceiveValue(String s) {

// 20

}

});

ios:

NSString *func = @"window.sdk.double(10)";

NSString *str = [webview stringByEvaluatingJavaScriptFromString:func]; // 20

h5 调用 app 的代码

因为 h5 不能直接访问宿主 app,所以这种调用就相对复杂一点。

这种调用常用有两种方式:

方法一:由 app 向 h5 注入一个全局 js 对象,然后在 h5 直接访问这个对象(addScriptMessageHandler)

这种方式沟通机制简单,比较好理解,并且对于 h5 来说,没有新的东西,所以是比较推荐的一种方式。但这种方式可能存在安全隐患,详细查看 你不知道的 Android WebView 使用漏洞。 客户端相关知识学习(二)之h5与原生app交互的原理

android:

webview.addJavascriptInterface(new Object() {

@JavascriptInterface

public int double(value) {

return value * 2;

}

@JavascriptInterface

public int triple(value) {

return value * 3;

}

}, "appSdk");

iOS:

@interface AppSdk : NSObject

{}

- (int) double:(int)value;

- (int) triple:(int)value;

@end

@implementation AppSdk

- (int) double:(int)value {

return value * 2;

}

- (int) triple:(int)value {

return value * 3;

}

@end

JSContext *context=[webview valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];

AppSdk *appSdk = [AppSdk new];

context[@"appSdk"] = appSdk;

javascript:

window.appSdk.double(10); // 20

方法二:由 h5 发起一个自定义协议请求,app 拦截这个请求后,再由 app 调用 h5 中的回调函数

这种方式要稍复杂一点,因为需要自定义协议,这对很多前端开发者来说是比较新的东西。所以一般不推荐这种方式,可以作为第一种方式的补充。

大致需要以下几个步骤:

  • 由 app 自定义协议,比如 sdk://action?params

  • 在 h5 定义好回调函数,比如 window.bridge={getDouble:value=>{},getTriple:value=>{}}

  • 由 h5 发起一个自定义协议请求,比如 location.href='sdk://double?value=10'

  • app 拦截这个请求后,进行相应的操作,获取返回值

  • 由 app 调用 h5 中的回调函数,比如 window.bridge.getDouble(20);

客户端相关知识学习(二)之h5与原生app交互的原理

javascript:

window.bridge = {

getDouble: value => {

// 20

},

getTriple: value => {

// more

}

};

location.href = 'sdk://double?value=10';

android:

webview.setWebViewClient(new WebViewClient() {

@Override

public boolean shouldOverrideUrlLoading(WebView view, String url) {

// 判断如果 url 是 sdk:// 打头的就拦截掉

// 然后从 url sdk://action?params 中取出 action 与params

Uri uri = Uri.parse(url);

if ( uri.getScheme().equals("sdk")) {

// 比如 action = double, params = value=10

webview.evaluateJavascript('window.bridge.getDouble(20)');

return true;

}

return super.shouldOverrideUrlLoading(view, url);

}

});

ios:

- (BOOL)webview:(UIWebView *)webview shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {

// 判断如果 url 是 sdk:// 打头的就拦截掉

// 然后从 url sdk://action?params 中取出 action 与params

NSString *urlStr = request.URL.absoluteString;

if ([urlStr hasPrefix:@"sdk://"]) {

// 比如 action = double, params = value=10

NSString *func = @"window.bridge.getDouble(20)";

[webview stringByEvaluatingJavaScriptFromString:func];

return NO;

}

return YES;

}

参考:

h5 与原生 app 交互的原理