运营等不及发版

活动页一周换三次皮肤,原生发版根本追不上,于是 H5 嵌进来。嵌进去的那一刻只是开始:H5 要拿登录态、要调分享、要跳原生页面,原生要管缓存、管安全、管加载体验。这篇把 Web 组件的桥接和治理讲清楚,都是实际项目里被问过很多遍的东西。

▲ 示意图 · Web组件桥接治理

加载与基本配置

import { webview } from '@kit.ArkWeb';

@Entry
@Component
struct H5Page {
  controller: webview.WebviewController = new webview.WebviewController();

  build() {
    Web({ src: 'https://m.demo.com/activity', controller: this.controller })
      .javaScriptAccess(true)   // H5 要跑脚本
      .domStorageAccess(true)   // H5 要用 localStorage
      .onControllerAttached(() => {
        // 控制器就绪,桥在这里注册
      })
  }
}

onControllerAttached 是注册桥的正确时机,它在页面开始加载之前触发,注册早于 H5 任何脚本的执行。常见错误是把注册放在页面加载完成的回调里,H5 早就在调 window.nativeBridge 了,拿到的是 undefined,运营同学报"分享按钮没反应",最后查出来是注册晚了一步。

JS 与原生的双向桥

.onControllerAttached(() => {
  this.controller.registerJavaScriptProxy(
    this.bridge,            // 原生对象
    'nativeBridge',         // H5 侧调用的全局名
    ['getToken', 'share', 'openPage'] // 暴露的方法白名单
  );
  this.controller.refresh(); // 注册后要刷新一次才生效
})

注册之后,H5 里就能直接调 window.nativeBridge.getToken()。注意注册完成必须 refresh() 一次才生效,这是文档里写了但特别容易漏的一步,漏了就是 H5 反馈"接口不存在"。原生调 H5 用 runJavaScript,比如活动页刷新后通知 H5 更新状态。

this.controller.runJavaScript('window.onNativeEvent("themeChanged")');

桥接设计上有一条纪律:暴露的方法越少越好,每个方法都要在原生侧做参数校验。桥是 H5 与原生之间唯一的门,门开得越大,风险面越大。另一个隐藏要求是来源校验,桥对象是全局注入的,任何页面加载进来都能调,所以桥的方法内部要校验当前 URL 是否在白名单内,防止被恶意地址利用。

缓存与登录态的清理

H5 的缓存和 Cookie 是独立于应用账号体系的一套东西,退出登录时如果不清,下一个用户进来可能看到上一个用户的页面状态。

// 退出登录时清 H5 缓存与存储
this.controller.clearCache(true);      // 连磁盘缓存一起清
webview.WebCookieManager.configCookie(url, '');

登录态的传递建议不走 Cookie,而是通过桥把短期有效的凭据递给 H5,由 H5 存在自己的内存或 storage 里,应用退出时原生侧主动通知 H5 丢弃。直接把长效 token 塞进 Cookie,等于把家钥匙复制了一份放在户外。

什么时候用 H5,什么时候用原生

团队里长期争论的问题,我的判断标准就两条。内容变更频率高、强运营、不涉及核心交易链路的,用 H5,换皮肤不用发版;高频、对流畅度和交互体验敏感、在核心转化路径上的,用原生。中间地带按团队维护能力定,H5 和原生两头都要有人会改,人手不够时宁可通过原生多端配置来解决运营诉求。别被"H5 一次开发到处跑"诱惑着把核心链路也搬进去,加载白屏和交互割裂的账,最后都是转化率来还。

写在最后

收拢一下:桥在 onControllerAttached 注册、注册后必须刷新、方法白名单加来源校验;退出登录清缓存清凭据;H5 与原生的边界按变更频率和体验敏感度划。那次活动页嵌完之后,运营换皮肤的速度从两天变成两小时,但我们也守住了两条底线——核心下单链路没碰 H5,桥上暴露的方法一只手数得过来。混合开发是效率工具,边界守得住它才提效。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐