1. Mac 准备工具

安装桌面版 Chrome。如果 Mac 已安装 Homebrew，在终端执行：

brew install --cask android-platform-tools

已有 adb 就跳过安装：

adb version

2. 手机开启 USB 调试

在安卓手机上：

  1. 进入「设置 → 关于手机」，连续点击「版本号」开启开发者选项。
  2. 在「开发者选项」中开启「USB 调试」。
  3. 用支持数据传输的 USB 线连接 Mac。
  4. 手机出现「允许 USB 调试」时，确认授权。

在 Mac 终端执行：

adb devices

正常结果类似：

List of devices attached
XXXXXXXX    device

如果显示 unauthorized，解锁手机并确认授权；如果没有设备，先检查数据线、USB 连接模式和手机调试设置。Mac 通常不需要另装安卓 USB 驱动。

3. Chrome 找到活动页

Mac Chrome 地址栏打开：

chrome://inspect/#devices

勾选 Discover USB devices，然后在手机上打开第三方 App，进入活动页面并保持前台。

如果列表出现类似：

WebView in com.xxx.xxx
    活动页面标题
    https://活动地址
    inspect

点击 inspect，即可在 Mac 上操作该手机页面的 Console、Network、Elements 和 JS 断点。

建议打开：

  • Console：Preserve log，保留跳转前日志。
  • Network：Preserve log，观察登录、跳转和接口请求。
  • 需要重新请求资源时：勾选 Disable cache，它通常只在 DevTools 打开期间生效。

4. 能看到手机，但看不到 App 活动页

先在手机 Chrome 打开任意网页，检查 Mac 是否能发现该 Chrome 页面。

结果 下一步
手机 Chrome 页面也看不到 继续检查 USB、授权和设备发现配置
手机 Chrome 页面可调试，App 活动页看不到 联系第三方确认 WebView 调试开关及使用的内核
App 活动页出现且可 inspect 直接开始调试

第三方如果使用标准 Android WebView，需要在宿主 App 中开启：

WebView.setWebContentsDebuggingEnabled(true);

这段配置属于安卓 App，活动 H5 无法自行开启。可以让对方提供开启该能力的测试包；如果对方无法提供，再考虑在 H5 测试环境接入 eruda/vConsole。

容易忽略的细节：DevTools 连接后，重新进入活动页才能完整记录首屏请求；清除 App 数据会影响登录态，排查时先用普通退出、重新进入页面。