ArkWeb 手记 04|DevTools 调试与缓存清理

前面 01 搞定页面生命周期、02 实现双向 JS 通信、03 解决 rawfile 本地资源 404。

写到这里,你一定会遇到两个很折磨人的问题:H5 里 JS 报错看不到详情,修改了 H5 页面重新跑模拟器,页面还是旧版本,怎么刷新都不变。

我最开始调试 ArkWeb 的时候,修改完 H5 的 JS,模拟器点刷新完全没反应,以为是代码没保存,反复改了半小时,最后才发现是 ArkWeb 缓存。同时没有 DevTools,H5 里面 js 报错只能靠打印日志猜问题,效率极低。

核心误区:ArkWeb 自带独立缓存机制,和浏览器缓存逻辑不一样;而且调试开关需要手动开启,默认是关闭状态。

核心概念一句话讲清

webDebuggingAccess = true 开启 ArkWeb 调试能力,我们可以用 Chrome DevTools 连接模拟器里的 H5 页面,查看 DOM、Console 日志、网络请求;

ArkWeb 的缓存分为内存缓存 + 磁盘缓存,单纯页面刷新清不掉磁盘缓存,开发阶段需要主动调用接口清理。

前置条件:HarmonyOS7,DevEco Studio,沿用 03 的工程。

第一步:开启 ArkWeb 调试开关

复制代码
import { ArkWeb, ArkWebController } from '@kit.ArkWeb';

@Entry
@Component
struct WebDebugDemo {
  controller: ArkWebController = new ArkWebController();

  aboutToAppear() {
    // 开启网页调试,仅开发环境!上线务必注释/删掉
    this.controller.webDebuggingAccess = true;
    this.controller.javascriptEnabled = true;
  }

  build() {
    Column() {
      // 原生按钮:一键清除缓存
      Button("清空ArkWeb缓存")
        .margin(10)
        .onClick(async ()=>{
          // 清除磁盘缓存,不清除cookie
          await this.controller.clearCache(false);
        })
      ArkWeb({
        src: $rawfile("index.html"),
        controller: this.controller
      })
      .width('100%')
      .layoutWeight(1)
    }
  }
}

关键语句拆解:

  1. webDebuggingAccess = true:开启调试。生产包一定要关闭,有安全风险。
  2. clearCache(false):参数 false = 只清缓存,保留 Cookie;传 true 会同时清空 Cookie 和缓存。
  3. 清除缓存是异步方法,必须加await。

第二步:电脑 Chrome 连接模拟器 DevTools

  1. 模拟器正常运行项目,ArkWeb 页面加载完成
  2. 打开电脑 Chrome 浏览器,地址栏输入 chrome://inspect
  3. 在页面列表找到对应 ArkWeb 实例,点击 inspect,调出调试面板
  4. 面板可以看 Elements、Console、Network,和普通网页调试操作几乎一样

注意:只能用 PC 端 Chrome,Edge 也可以,别的浏览器不支持这个调试协议。

第三步:开发常用缓存处理方案

方案 1:点击原生按钮手动清缓存(上面代码)

适合边写 H5 边调试,改完代码,点按钮清缓存,刷新页面。

方案 2:每次打开页面自动清除缓存(开发用)

复制代码
aboutToAppear() {
  this.controller.webDebuggingAccess = true;
  this.controller.javascriptEnabled = true;
  // 页面打开自动清空缓存
  this.controller.clearCache(false);
}

缺点:每次进入页面都会重新拉取资源,页面加载变慢,上线绝对不要这么写。

方案 3:rawfile 本地资源的特殊缓存坑

rawfile 打包进 hap 包,单纯清 ArkWeb 缓存有时候依旧加载旧文件。

✅解决办法:修改 html/js/css 之后,重新 Build 项目,不是只点模拟器刷新。

高频踩坑清单(重点)

  1. ❌ 打开 chrome://inspect 找不到设备页面
    ✅ 检查:模拟器正常在线;代码开启 webDebuggingAccess;重新编译运行工程;重启 DevEco 模拟器。
  2. ❌ DevTools 控制台中文日志乱码
    ✅ 不用额外配置,HarmonyOS7 新版模拟器基本修复;实在乱码就把日志改成英文打印。
  3. ❌ clearCache 调用后缓存依旧存在
    ✅ clearCache 是异步,忘记加 await;rawfile 资源修改必须重新 build,光清 ArkWeb 缓存没用。
  4. ❌ 上线版本保留 webDebuggingAccess=true
    ✅ 上线打包前注释,这个接口会允许外部调试页面,存在安全隐患。

小扩展:禁用缓存(远程 H5 页面场景)

如果加载的是线上 https 远程页面,可以在加载前设置缓存模式

复制代码
// 开发环境:每次都从网络拉取,不读取缓存
this.controller.cacheMode = WebCacheMode.NO_CACHE;

WebCacheMode 一共 4 种:NO_CACHE / NORMAL / ONLY_CACHE / DEFAULT,开发和生产按需切换。

相关推荐
KevinChaos11 小时前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
小巫编程室11 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
深入云栈12 小时前
Netty 4.2.x 源码深度解析 (二十四):池化内存分配 —— PoolArena、PoolChunk 与 PoolSubpage
java·后端·架构
惜.己13 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化
Vex2une13 小时前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程
杨凯凡13 小时前
Spring Framework 7 原生重试与并发限制实战:@Retryable、@ConcurrencyLimit 能替代 Resilience4j 吗?
数据库·spring·sqlserver
文丑颜不良啊15 小时前
LeetCode3281~3300题目解析
java·leetcode
txxzjmzlh15 小时前
Redis 介绍及简单使用
数据库·redis·缓存
nice_lcj52015 小时前
【从零理解计算机网络 · 02】分层模型:别背 OSI 七层,看数据怎么被“打包“和“拆包“
java·后端·tcp/ip·计算机网络·面试·osi·分层模型
SimonKing16 小时前
给Deepseek Harness装上插件市场,从此插件无忧
java·后端·程序员