核心是 JSBridge,它提供了一条双向通信的"桥梁"。主流方式有以下几种:
H5 调用原生
-
注入全局对象(主流) :原生端向 WebView 注入一个 JS 对象(如
nativeBridge),H5 直接调用其方法(如nativeBridge.scanQRCode())并传入回调,原生执行完毕后通过回调将结果返回给 H5。 -
URL Scheme 拦截(较老) :H5 发起一个特殊格式的请求(如
myapp://action?param=xxx),原生端拦截该请求并解析执行。这种方式获取返回值相对麻烦,灵活性不如注入对象。 -
鸿蒙 ArkWeb :推荐使用
javaScriptProxy将原生对象暴露给 H5,适合 H5 主动调原生能力的场景。
原生调用 H5
-
执行 JS 代码 :原生端直接调用 WebView 的
evaluateJavaScript(或类似方法),执行 H5 页面中已定义的全局函数,从而将数据传递给 H5 或触发其更新。鸿蒙 ArkWeb 对应使用runJavaScript()。 -
消息端口(复杂双向通信) :对于需要持续、双向传递消息的复杂场景,可使用
WebMessagePort等机制建立专门的消息通道。
H5 内容部署与更新
为了提升加载速度并支持动态更新,通常采用 H5 离线包方案。
部署方式
H5 的静态资源(HTML、JS、CSS、图片)被打包成一个压缩包(如 .amr 或 .zip)。可以预置在 App 安装包内,让用户首次打开就能快速加载;也可以放在服务端,由 App 在运行时下载。
更新机制
-
版本检查:App 启动或打开 H5 时,向服务端请求离线包的最新版本信息。
-
按需下载:若服务端版本更新,客户端在后台(可配置仅 Wi-Fi 或任意网络)下载新包。
-
本地替换:下载完成后解压,替换旧版本资源。下次打开 H5 时,WebView 会优先加载本地的新资源,实现"无需发版即更新"。
-
Fallback 兜底:如果离线包尚未下载完成,WebView 会拦截请求并转向线上的 CDN 地址,确保页面正常显示。
数据存储
数据存储位置取决于数据的用途和生命周期,主要分为 H5 侧和原生侧。
H5 侧存储(在 WebView 内)
-
localStorage:用于存储少量键值对数据,除非被主动清除,否则会一直保留。注意它是同步 API,大量使用可能影响性能。 -
IndexedDB:适合存储大量结构化数据或文件。它是异步 API,不会阻塞主线程,是 H5 端存储较多数据的推荐选择。 -
sessionStorage:生命周期仅限于当前会话,关闭页面或浏览器后即被清除。
原生侧存储
-
Native 数据库/文件:登录态(Token)、用户偏好设置等核心数据,通常由原生端存储在本地数据库(如 SQLite、CoreData)或文件中。H5 通过 JSBridge 向原生请求这些数据,而非自己直接管理。
-
共享存储:部分框架支持原生与 H5 之间的数据互通,例如通过桥接 API 传递登录态或上下文信息,避免两边各自维护一套用户体系。
H5 与原生交互是否需要网络
交互本身不需要网络。 JSBridge 的通信发生在设备内部的 WebView 和原生代码之间,是一条本地通道。
但 H5 内容本身可能依赖网络:
-
首次加载或未使用离线包:如果 H5 页面是线上 URL,打开时需要网络从服务器拉取资源。
-
业务数据请求:H5 页面内的 API 请求(获取列表、提交表单)需要网络。
-
离线包更新:下载新版本离线包需要网络。
使用离线包方案后,H5 的静态资源 加载可以完全脱离网络,但页面内的动态数据交互依然需要网络支持。
H5 自选内容的部署、下载和调用,通常通过 H5 离线包机制来实现。下面以业界常见的 mPaaS 离线包方案为例,说明整个流程。
如何部署:打包与发布
H5 内容的部署发生在客户端之外,核心是把前端资源打包并发布到管理后台。
首先,前端工程(HTML、JS、CSS、图片等)会被构建并打包成一个 ZIP 压缩包。然后,在离线包管理控制台(如 mPaaS 控制台)创建离线包,上传这个 ZIP 包,并配置好版本号、主入口 URL、生效的客户端版本范围等关键信息。发布后,这个离线包就具备了被客户端发现和下载的前提。
如何下载到客户端:预置与动态更新
客户端获取离线包有两条路径:预置 和动态下载。
预置(随 App 安装包分发)
对于首页、登录页等需要快速加载的核心 H5 页面,可以把离线包文件(通常是 .amr 格式)和配置文件(h5_json.json)提前放入 App 工程的 assets 目录(Android)或 Bundle 中(iOS)。App 启动时,调用 SDK 接口(如 MPNebula.loadOfflineNebula)完成安装。这样用户首次打开 App 时,即使没有网络,也能直接加载本地资源。
动态下载(从服务端获取)
对于非核心或需要频繁更新的 H5 页面,客户端会在运行时向服务端请求离线包信息。SDK 提供下载接口(如 downloadApp),客户端可以在合适的时机(如 Wi-Fi 环境或 App 启动后)在后台下载新的离线包。为了节省流量,更新时还可以采用差分更新:服务端只下发新旧版本的差异部分(差分包),客户端本地将旧包与差分包合并,生成新版本,无需下载完整包。
客户端如何调用:加载与打开
客户端加载 H5 内容时,并不是直接打开一个在线 URL,而是通过容器 SDK 指定 App ID 来打开本地的离线包。
以 Android 为例,在需要打开页面的地方,调用类似 MPNebula.startApp("80000000") 的代码,传入离线包的 App ID 即可。SDK 内部会检查本地是否存在对应版本的离线包:如果存在,就直接加载本地资源;如果不存在(或版本过旧),则通常会回退到使用线上 URL(fallback URL)来保证页面能打开。
整个过程对 H5 开发者是透明的,前端代码无需感知自己是被预置加载还是动态下载加载的。
技术领域:
-
Hybrid 开发:专门负责各 App(主要是炒股软件)的 Hybrid 前端开发。
-
Web 技术:使用原生 JS、jQuery、Vue、React 等,实现一套代码多端运行(H5 移动网页)。
-
工程化与桌面端:涉及 Nginx、Docker、Shell,以及 Electron(用于桌面版视频软件或 IDE 工具)
H5 与 H5 之间的交互,在移动端原生 App 的 WebView 环境里,情况会比纯浏览器复杂一些。核心要看这两个 H5 页面处于什么关系:是同一个 WebView 内的父子窗口(iframe) 、不同 WebView(多窗口) ,还是跨域(不同域名)。
结合你之前关注的移动端混合开发场景,主流方案有以下几种:
场景一:两个 H5 在同一个 WebView 内(iframe 父子关系)
如果 H5 页面是通过 <iframe> 嵌套在另一个 H5 里,最标准且安全的方案是 window.postMessage。
这是 HTML5 提供的跨源通信 API,允许不同源的窗口之间安全地传递数据。父页面获取到 iframe 的 contentWindow 引用后,调用 postMessage 发送消息,子页面通过监听 message 事件接收并处理。使用时务必在 targetOrigin 参数里指定确切的源,而不是 *,以防止数据泄露给恶意站点。
场景二:两个 H5 在不同 WebView 里(App 多窗口共存)
在移动端 App 里,有时会用两个独立的 WebView 分别加载两个 H5 页面(比如 A 页面选地址,B 页面展示)。它们彼此独立,无法直接访问对方的 JS 上下文,通常需要借助原生或共享存储作为"中转站"。
方案 A:基于 localStorage 共享(需同源或借助 SDK)
如果两个 WebView 加载的 H5 同源 (协议、域名、端口一致),它们共享同一份 localStorage。一个页面写入数据,另一个页面通过监听 storage 事件就能收到通知。
对于跨域 的多 WebView,有专门的通信 SDK(如 nw-mwa)利用了多 WebView 之间 localStorage 实时共享的机制,配合 storage 的 onchange 事件来封装跨 WebView 的通信能力,让 A 页面能感知 B 页面的操作。
方案 B:原生 JSBridge 中转(跨域场景的兜底)
如果两个 H5 域名不同,且没有使用上述 SDK,最可靠的方式是走原生。一个 H5 通过 JSBridge 把消息发给原生,原生再通过 JSBridge 把消息注入给另一个 H5。有专利方案描述了这种路径:第一 H5 → JSBridge → 第一原生页面 → 消息管理中心 → 第二原生页面 → JSBridge → 第二 H5,专门用于解决跨域 H5 页面间的通信。
场景三:同源页面的现代方案
如果两个 H5 页面同源(无论是否在同一 WebView),且浏览器版本较新,可以使用 BroadcastChannel API 。它就像给同源页面开了一个广播频道,一个页面发送消息,所有监听该频道的同源页面都能收到,无需依赖 localStorage 的存储写入操作。它不支持 IE,但兼容所有现代移动端浏览器。
选型建议
-
同 WebView 内嵌 iframe :首选
postMessage,标准且安全。 -
多 WebView 且同源 :
localStorage+storage事件最简单。 -
多 WebView 且跨域:优先看 App 是否提供了 JSBridge 或现成的多 WebView 通信 SDK;如果没有,走原生 JSBridge 中转最稳妥。
App 内两个独立的 WebView 窗口,它们的 JavaScript 运行环境是完全隔离的,无法像 iframe 那样直接互相访问。要实现交互,核心思路是找一个双方都能访问的"中间人"来转发消息。
具体方案取决于你的 App 是 Android 还是 iOS,以及两个 H5 页面是否同源。
如果两个 H5 同源(域名、端口一致)
这是最省事的场景,可以利用 WebView 之间共享的存储机制。
方案:localStorage + storage 事件
同源的两个 WebView 会共享同一份 localStorage。你可以在一个页面写入数据,另一个页面监听 storage 事件来感知变化。不过,原生 WebView 对 storage 事件的实时触发支持并不完美,有时需要页面重新获得焦点或刷新才能感知。
更稳妥的封装:使用 nw-mwa 这类 SDK
有专门解决多 WebView 通信的 SDK(如 nw-mwa),它的原理正是利用多 WebView 间 localStorage 实时共享,并借助 storage 的 onchange 事件来封装成事件监听/触发模式,让 A 页面能方便地通知 B 页面。用法类似:
javascript
// WebView B(发送消息)
import { triggerMwaEvent } from 'nw-mwa'
triggerMwaEvent('addressSelect', { address: '北京市海淀区...' })
// WebView A(监听消息)
import { addMwaListener } from 'nw-mwa'
const listener = addMwaListener('addressSelect', (data) => {
console.log('收到地址:', data.data.address)
})
// 记得在页面销毁时 listener.remove()
如果两个 H5 跨域,或不想依赖存储机制
最通用、最可靠的方式是通过原生 App 做中转。无论 Android 还是 iOS,两个 WebView 的 JS 环境都是隔离的,但它们都能和原生代码通信。
流程如下:
-
WebView A 通过 JSBridge 调用原生方法,把消息发给原生。
-
原生端(Android/iOS)收到消息后,找到 WebView B 的引用。
-
原生端 调用 WebView B 的
evaluateJavascript(Android)或evaluateJavaScript(iOS),执行一个约定好的 JS 回调函数,把数据注入进去。
在 iOS 上,即使多个 WKWebView 共享了 WKProcessPool 或 WKWebsiteDataStore(能共享 Cookie 等),它们的 JS 上下文依然是独立的,所以原生中转是标准做法。
选型建议
-
优先看是否同源 :同源且能接受轻微延迟,用
localStorage+storage事件(或nw-mwa封装)最轻量。 -
跨域或要求稳定可靠:走原生 JSBridge 中转。虽然需要写一点原生代码,但这是最可控、兼容性最好的方案,不依赖 WebView 内核的具体实现细节。
App 内两个独立 WebView 的通信,本质是一个进程内的消息路由问题 。两个 WebView 的 JS 上下文完全隔离,不能直接互访。我的方案是:不依赖 H5 同源假设,用原生层做确定性路由,H5 侧只暴露极简的收发接口。
架构设计:原生消息总线
整体分三层:H5 发送方 → 原生 MessageHub → H5 接收方。
H5 发送方 通过 JSBridge 调用原生方法 postToWebView(targetId, eventName, payload)。
原生 MessageHub 维护一个 Map<String, WebView> 注册表,收到消息后根据 targetId 找到目标 WebView,调用 evaluateJavascript 执行目标页面预注册的回调。
H5 接收方在页面初始化时向原生注册自己的 ID 和事件监听函数。
这样做的原因是:两个 WebView 的 JS 运行时天然隔离,iOS 的 WKProcessPool 只共享 Cookie 和进程资源,不共享 JS 上下文;Android 同样如此。原生层是唯一可靠的汇聚点。
关键实现:Android 端
用 addWebMessageListener 替代老旧的 @JavascriptInterface,因为它自带 sourceOrigin 校验,能防止未授权页面调用桥接方法。
Kotlin
// 初始化两个 WebView 时注册监听
fun setupBridge(webView: WebView, pageId: String) {
WebViewCompat.addWebMessageListener(
webView, "nativeBridge",
setOf("https://your-h5-domain.com")
) { _, message, sourceOrigin, _, replyProxy ->
// message.data 是 JSON 字符串
val json = JSONObject(message.data)
when (json.getString("action")) {
"register" -> registry[pageId] = webView
"send" -> {
val target = json.getString("target")
val event = json.getString("event")
val payload = json.getJSONObject("payload")
registry[target]?.let { targetWebView ->
targetWebView.post {
targetWebView.evaluateJavascript(
"window.__onNativeMessage('$event', ${payload})", null
)
}
}
}
}
}
}
注意 replyProxy 可以保留,用于后续主动向该页面推送消息,但当前场景用 evaluateJavascript 更直接。
关键实现:iOS 端
用 WKScriptMessageHandler 接收 H5 消息,用 evaluateJavaScript 向目标 WebView 注入。
Swift
// 注册消息处理器
config.userContentController.add(self, name: "nativeBridge")
func userContentController(_ controller: WKUserContentController,
didReceive message: WKScriptMessage) {
guard let body = message.body as? [String: Any],
let action = body["action"] as? String else { return }
if action == "send",
let target = body["target"] as? String,
let event = body["event"] as? String,
let payload = body["payload"] {
let js = "window.__onNativeMessage('\(event)', \(jsonStringify(payload)))"
registry[target]?.evaluateJavaScript(js, completionHandler: nil)
}
}
WKWebView 的 JS 上下文隔离是系统设计行为,没有绕过的方法,原生中转是标准解法。
H5 侧:极简收发协议
两个页面共用同一份桥接 JS,保持接口一致。
javascript
// bridge.js ------ 两个 H5 页面引入同一份
const NativeBridge = {
pageId: null,
// 页面初始化时调用
init(pageId) {
this.pageId = pageId
window.__onNativeMessage = (event, payload) => {
// 分发到页面自己注册的处理器
const handler = this._handlers[event]
if (handler) handler(payload)
}
// 通知原生注册
window.nativeBridge?.postMessage(JSON.stringify({
action: 'register',
pageId: pageId
}))
},
_handlers: {},
on(event, handler) {
this._handlers[event] = handler
},
send(targetPageId, event, payload) {
window.nativeBridge?.postMessage(JSON.stringify({
action: 'send',
target: targetPageId,
event: event,
payload: payload
}))
}
}
发送方页面:
javascript
NativeBridge.init('pageA')
NativeBridge.send('pageB', 'addressSelected', { address: '北京市海淀区...' })
接收方页面:
javascript
NativeBridge.init('pageB')
NativeBridge.on('addressSelected', (data) => {
console.log('收到地址:', data.address)
// 执行业务逻辑
})
数据一致性保障
作为数据技术人员,必须处理两个边界情况:
消息丢失 :如果目标 WebView 尚未注册或已被销毁,原生层直接丢弃消息并记录日志。H5 侧不保证送达,业务层如果需要确认,在 payload 里自带 messageId,接收方回执。
消息顺序 :evaluateJavascript 在 WebView 的主线程队列中按调用顺序执行,天然保序。但两个 WebView 各自有独立的消息循环,跨页面无法保证全局顺序。如果业务对顺序敏感,需要在 payload 中携带递增序号,接收方做重排或丢弃。
与纯 H5 方案的取舍
如果两个页面同源 ,localStorage + storage 事件更轻量,但 WebView 对 storage 事件的实时触发支持不稳定。nw-mwa 这类 SDK 封装了轮询机制来弥补,但引入了额外依赖。
我的选择是直接走原生。理由:不依赖同源假设,不引入第三方 SDK,行为在两个平台上一致,调试时链路清晰(H5 → 原生日志 → H5)。代价是需要写两端原生代码,但代码量很小,一次性投入换长期确定性。
下面是可落地的全套代码,按 Android 原生 → iOS 原生 → H5 共用桥接层 三层给出。核心设计是:原生层维护一个 pageId → WebView 的注册表,H5 通过 postMessage 发送消息,原生路由到目标 WebView 并调用其 evaluateJavascript/evaluateJavaScript 执行目标页面预注册的回调。
一、Android 端(Kotlin)
1. 消息总线与注册表
Kotlin
// MessageHub.kt
object MessageHub {
private val registry = mutableMapOf<String, WebView>()
private val lock = Any()
fun register(pageId: String, webView: WebView) {
synchronized(lock) { registry[pageId] = webView }
}
fun unregister(pageId: String) {
synchronized(lock) { registry.remove(pageId) }
}
fun send(targetId: String, event: String, payloadJson: String): Boolean {
val target = synchronized(lock) { registry[targetId] } ?: return false
// payloadJson 已是合法 JSON 字符串,直接内联
val js = "window.__onNativeMessage('$event', $payloadJson)"
target.post {
target.evaluateJavascript(js, null)
}
return true
}
}
2. WebView 初始化与桥接
Kotlin
// WebViewBridge.kt
import android.webkit.WebView
import androidx.webkit.WebViewCompat
import androidx.webkit.WebViewFeature
import org.json.JSONObject
fun setupBridge(webView: WebView, pageId: String) {
webView.settings.javaScriptEnabled = true
if (!WebViewFeature.isFeatureSupported(WebViewFeature.WEB_MESSAGE_LISTENER)) {
// 低版本兜底:使用 @JavascriptInterface(注意安全校验)
return
}
WebViewCompat.addWebMessageListener(
webView,
"nativeBridge",
setOf("https://your-h5-domain.com") // 生产环境务必限定来源
) { _, message, _ /* sourceOrigin */, _ ->
val raw = message.data ?: return@addWebMessageListener
val json = try { JSONObject(raw) } catch (e: Exception) { return@addWebMessageListener }
when (json.optString("action")) {
"register" -> {
val pid = json.optString("pageId")
if (pid.isNotBlank()) MessageHub.register(pid, webView)
}
"send" -> {
val target = json.optString("target")
val event = json.optString("event")
val payload = json.optJSONObject("payload")?.toString() ?: "null"
MessageHub.send(target, event, payload)
}
}
}
}
3. 在 Activity/Fragment 中挂载与销毁
Kotlin
// 两个 WebView 分别初始化
class PageAActivity : AppCompatActivity() {
private lateinit var webView: WebView
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
webView = WebView(this)
setContentView(webView)
setupBridge(webView, "pageA")
webView.loadUrl("https://your-h5-domain.com/pageA.html")
}
override fun onDestroy() {
MessageHub.unregister("pageA")
webView.destroy()
super.onDestroy()
}
}
PageBActivity 同理,pageId = "pageB"。
二、iOS 端(Swift)
1. 消息总线与注册表
Swift
// MessageHub.swift
import WebKit
final class MessageHub: NSObject {
static let shared = MessageHub()
private var registry: [String: WKWebView] = [:]
private let lock = NSLock()
func register(_ pageId: String, webView: WKWebView) {
lock.lock(); defer { lock.unlock() }
registry[pageId] = webView
}
func unregister(_ pageId: String) {
lock.lock(); defer { lock.unlock() }
registry.removeValue(forKey: pageId)
}
func send(targetId: String, event: String, payload: Any) -> Bool {
lock.lock()
let target = registry[targetId]
lock.unlock()
guard let target else { return false }
guard let payloadData = try? JSONSerialization.data(withJSONObject: payload),
let payloadStr = String(data: payloadData, encoding: .utf8) else { return false }
let js = "window.__onNativeMessage('\(event)', \(payloadStr))"
DispatchQueue.main.async {
target.evaluateJavaScript(js, completionHandler: nil)
}
return true
}
}
extension MessageHub: WKScriptMessageHandler {
func userContentController(_ controller: WKUserContentController,
didReceive message: WKScriptMessage) {
guard let body = message.body as? [String: Any],
let action = body["action"] as? String else { return }
switch action {
case "register":
if let pid = body["pageId"] as? String,
let webView = message.webView {
register(pid, webView: webView)
}
case "send":
guard let target = body["target"] as? String,
let event = body["event"] as? String,
let payload = body["payload"] else { return }
_ = send(targetId: target, event: event, payload: payload)
default:
break
}
}
}
2. WebView 初始化
Swift
// WebViewFactory.swift
import WebKit
func makeWebView(pageId: String, url: URL) -> WKWebView {
let config = WKWebViewConfiguration()
config.userContentController.add(MessageHub.shared, name: "nativeBridge")
let webView = WKWebView(frame: .zero, configuration: config)
webView.load(URLRequest(url: url))
// pageId 由 H5 自行 register,原生不强制写入
return webView
}
3. 销毁时注销
Swift
deinit {
webView.configuration.userContentController
.removeScriptMessageHandler(forName: "nativeBridge")
MessageHub.shared.unregister("pageA")
}
三、H5 共用桥接层(bridge.js)
两个 H5 页面引入同一份文件,接口一致。
javascript
// bridge.js
(function (global) {
'use strict';
const handlers = {};
function postToNative(payload) {
if (global.nativeBridge && typeof global.nativeBridge.postMessage === 'function') {
global.nativeBridge.postMessage(JSON.stringify(payload));
} else if (global.webkit?.messageHandlers?.nativeBridge) {
global.webkit.messageHandlers.nativeBridge.postMessage(payload);
} else {
console.warn('[Bridge] nativeBridge not available');
}
}
const NativeBridge = {
pageId: null,
init(pageId) {
this.pageId = pageId;
// 原生回注消息时调用的全局入口
global.__onNativeMessage = (event, payload) => {
const list = handlers[event];
if (!list) return;
list.forEach(fn => {
try { fn(payload); } catch (e) { console.error('[Bridge] handler error', e); }
});
};
postToNative({ action: 'register', pageId });
},
on(event, handler) {
(handlers[event] || (handlers[event] = [])).push(handler);
},
off(event, handler) {
const list = handlers[event];
if (!list) return;
handlers[event] = list.filter(fn => fn !== handler);
},
send(targetPageId, event, payload) {
postToNative({ action: 'send', target: targetPageId, event, payload });
}
};
global.NativeBridge = NativeBridge;
})(window);
页面 A 使用示例
html
<!-- pageA.html -->
<script src="./bridge.js"></script>
<script>
NativeBridge.init('pageA');
function onSelectAddress(addr) {
NativeBridge.send('pageB', 'addressSelected', { address: addr, ts: Date.now() });
}
</script>
页面 B 使用示例
html
<!-- pageB.html -->
<script src="./bridge.js"></script>
<script>
NativeBridge.init('pageB');
NativeBridge.on('addressSelected', (data) => {
console.log('收到地址:', data.address);
document.getElementById('addr').textContent = data.address;
});
</script>
四、关键边界处理(必读)
-
目标未注册 :
MessageHub.send返回false,原生侧可打日志。H5 侧不保证送达,业务层若需确认,在payload里带messageId,接收方通过send回执。 -
来源校验 :Android 的
addWebMessageListener第三个参数必须限定为你的 H5 域名;iOS 端可在didReceive里校验message.frameInfo.securityOrigin。 -
JS 注入安全 :
event名只允许[a-zA-Z0-9_],payloadJson必须由JSONObject/JSONSerialization序列化产生,禁止字符串拼接用户输入,避免 XSS 注入到evaluateJavascript。 -
销毁顺序 :Activity/Fragment 销毁时先
unregister再destroy,避免消息路由到已销毁的 WebView。 -
低版本 Android 兜底 :
WebViewFeature.WEB_MESSAGE_LISTENER不支持时,退回addJavascriptInterface,但必须在@JavascriptInterface方法里校验sourceOrigin,否则有安全风险。 -
消息顺序 :单个 WebView 内
evaluateJavascript保序;跨 WebView 不保证全局顺序。对顺序敏感的业务在payload里带递增seq,接收端排序。
这套代码在 Android 和 iOS 两端行为一致,H5 侧只有一份 bridge.js,原生侧各自约 80 行。后续若需要消息持久化或离线补发,只需在 MessageHub 的 send 失败分支接入本地队列即可,H5 接口无需改动。