H5移动端调试方案全解(iOS&Android&Chrome&vConsole)

前言

在移动端盛行的今天,大家在日常中经常会接触到H5的移动端网页,不仅仅是在浏览器中,在各种的APP中也有存在着许多的H5页面,所以我们作为前端开发者就会有在开发时候进行移动端调试、甚至是真机调试的需求,本文旨在一文带领大家了解iOS、Android等平台的调试以及模拟器和真机的调试方法。

谷歌浏览器手机模式调试

  • 优点:方便,常用
  • 确定:无法完全模拟真机,无法发现真机上的一些问题

调试方法

与我们正常的网页调试几乎一模一样,但是你需要打开调试窗口左上角的移动端模式,另外在页面的上方可以选择对应的机型,通过不同大小的机型来测试网页布局等是否合理。

另外在移动端的设计稿中长宽经常是375667也就是我们的iPhone6的大小,但是默认的机型选择中并没有这个机型,此时可以在编辑中添加,或者可以添加自定义机型。

IOS调试

iOS调试主要依靠Mac + Safari这对组合来实现

Safari开发权限开启

PC

PC浏览器:设置 ⇒ 高级 ⇒ 在菜单中显示"开发"菜单

iPhone

iPhone 设置:设置 -- Safari浏览器 -- 高级 -- 打开网页检查器

模拟器调试:Xcode中的Simulator

注意点:最新下载的Xcode默认ios版本为16.4,该版本有个bug会导致在App上的应用无法被调试(找不到调试页面),该bug最早可追溯在四月份在外网被提出,至今(2023.8.14)未被修复,最方便的解决方案是降低IOS版本(可使用15.0版)。

在Xcode中增加iOS版本后再Simulator选择版本打开。

在应用中打开对应的H5移动端页面,在Safari中的开发中选择模拟器的对应页面打开。

然后在Safari的开发中选择对应的页面

这个时候就和我们正常的浏览器调试一样了,开始愉快的调试吧!

真机调试

用数据线把手机和电脑连接,并且选择信任电脑,剩下的方式和在模拟器上没区别。

Android调试

大坑

首先我们知道需要事先安装SDK或者adb,但是我这次连接是无论是真机还是模拟器adb都会报

bash 复制代码
% adb shell
adb: no devices/emulators found

排查了很久很久,各种方式都试过了,一直都是找不到设备,最后怀疑是adb的问题,就打算重装了,在重装前了灵机一动,我杀服务重开一下试试呢?

bash 复制代码
% adb kill-server
% adb reconnect
* daemon not running; starting now at tcp:5037
* daemon started successfully
reconnecting emulator-5554 [offline]

皇天不负有心人啊!终于连上了!

原开启的服务为什么失效我们不得而知,以后遇到这种问题可以直接考虑重启。

模拟器调试

  1. 下载模拟器(MUMU For Android
  1. 安装Debug版本的应用(就是安装你在手机上的APP)

  2. 在应用中进入对应需要调试的页面

  3. 谷歌浏览器中输入

    arduino 复制代码
    chrome://inspect
  4. 在终端terminal中输入adb shell

    (事先需要安装adb可见链接

  1. 在浏览器页面中就可以见到被调试的页面了,点击inspect 后和在浏览器一样的调试方法
  1. 对了,如果这个时候的你还是发现不能用的话。那你就是被墙了,你需要一个🪜来帮助你自己(或者可以使用edge浏览器,在地址栏输入edge://inspect)。

真机调试

与模拟器调试基本相同但是有以下注意点

  1. 需要打开开发者模式

    设置 → 系统 → 版本号 → 点击版本号5-10次即可打开

  2. 打开开发者模式后进入开发者选项

    打开USB调试按钮

  3. 需要有一根可以数据连接数据线(有些数据线仅支持充电)

  4. 连接后会弹出授权,确定即可

vConsole调试

安装

bash 复制代码
npm install vconsole

使用

JavaScript 复制代码
// 全局使用
// main.js
import Vconsole from 'vconsole'
let vConsole = new Vconsole()

就可以看到我们的页面上出现了vConsole

大功告成!

符合工程化

调试工具我们肯定是希望他在PC端不出现,在生产环境不出现。所以我们可以根据对应的启动环境去做一些工作

javascript 复制代码
// 判断是否是pc设备
const isPc = () => {
    const userAgentInfo = navigator.userAgent;
    const Agents = ["Android", "iPhone",
        "SymbianOS", "Windows Phone",
        "iPad", "iPod"];
    let flag = true;
    for (let v = 0; v < Agents.length; v++) {
        if (userAgentInfo.indexOf(Agents[v]) > 0) {
            flag = false;
            break;
        }
    }
    return flag;
}
 
//如果不是生产环境并且不是pc设备那么就显示调试
if (process.env.NODE_ENV != "prod" && !isPc()) {
    console.log(process.env.NODE_ENV);
    const vConsole = new VConsole();
}

Chrome DevTools 调试工具基本原理

了解了一下这部分,发现内容很多很复杂,接下来有时间会单独出一篇文章来写这部分。。。。。。。

Flag

相关推荐
吴敬悦12 小时前
Claude Code 使用的命令行 UI 库: ink(使用 react 编写命令行界面)
前端·react.js
yinuo12 小时前
前端跨页面通讯终极指南⑦:ServiceWorker 用法全解析
前端
1024肥宅12 小时前
JavaScript 性能与优化:数据结构和算法
前端·数据结构·算法
有位神秘人12 小时前
Android中Compose系列之按钮Button
android
沐风。5612 小时前
TypeScript
前端·javascript·typescript
用户479492835691512 小时前
XSS、CSRF、CSP、HttpOnly 全扫盲:前端安全不只是后端的事
前端·后端·面试
O***p60412 小时前
当“前端虚拟化”成为可能:构建下一代 Web 应用的新范式
前端
孤酒独酌12 小时前
一次断网重连引发的「模块加载缓存」攻坚战
前端
AI科技摆渡12 小时前
GPT-5.2介绍+ 三步对接教程
android·java·gpt
jinzeming99912 小时前
Vue3 PDF 预览组件设计与实现分析
前端