2016移动前端调试漫游

如今在移动平台上,web/hybrid app 不断向 native app 发起挑战。

背景

出于解放生产力和降低成本的考量,越来越多的团队开始尝试以 web 技术来开发应用。

在各移动平台上,native app 开发都得到了官方的最大支持,工具链非常成熟。尽管如此,native app 开发者往往都不喜欢真机调试,因为它非常费时。在 webapp 开发这边,情况更加糟糕。不仅费时,由于 webapp 往往要覆盖多个平台,需要在多种设备上进行调试,这还让调试工作变得非常地琐碎,难以形成通用的方案。

前端开发者在 PC 平台上如鱼得水,然而切换到移动平台,则受到掣肘。本文尝试总结一些简单有效的调试方案,以满足不同场景下调试的需求。

缩小调试范围

笔者认为移动设备上调试的需求主要来自于两点,一是 webapp 使用了(或需要适配)移动平台上独有的特性,例如触摸事件、虚拟键盘遮盖、移动平台独有的 BOM API 等,二是 webapp 出现 PC 浏览器上不可复现的错误。对于前者,我们似乎是只能迎难而上,但对于后者,则可以尽量避免。

出现在 PC 上不可复现的错误的主要原因是浏览器的兼容性问题,其中渲染的问题更加突出。得益于 JavaScript 的语言特性和 ES5 广泛实现,借助 babel 等工具,我们可以将由 ES6 ES7 语法编写的代码编译为 ES5 的,从而避免 JavaScript 上的兼容性问题。

(ES5 support table (来自于 caniuse))


不过 CSS 很难甚至是不能被通过打补丁(polyfill)和编译的方式来达到完美的兼容性。开发者要对各目标平台的 CSS 支持度充分了解,从中选取广泛支持的特性来进行开发。好在 WebKit 以及衍生品已占据了移动浏览器渲染引擎(WebKit 包括用于布局渲染的 WebCore 和执行 JavaScript 的 JavaScriptCore 两个引擎,本文只取其渲染引擎的含义)的主要份额,使 CSS 特性确定的工作减轻不少。

主要的移动平台

不可否认,现如今 iOS 和 Android 系统统治了智能手机和平板电脑设备,本文所介绍的调试方法也仅针对于这两个系统。iOS 上,浏览器核心随系统一直平滑稳定地升级,iOS 6 以后支持使用 Mac Safari 来进行调试。Android 从 4.4 开始,其 WebView 基于 Chromium 开发,这不仅带来了 v8 JavaScript 引擎,还带来了可用桌面 Chrome 来调试的能力。

除此之外,微信的巨大成功,也让针对于微信的 webapp 开发备受重视。在 iOS 上,微信浏览器与 Safari 表现一致。在 Android 上,它采用的是腾讯浏览服务(TBS),并非系统提供的 WebView 组件。TBS 的初衷也许是解决在官方版本和衍生版本众多的 Android 系统上,WebView 表现一致性的问题。由于不随 Android 系统一起升级,在很长一段时间里,TBS 的 Webkit 版本都落后于系统的 WebView,导致微信常被调侃为“移动端的IE 6”。好在今年 3 月基于 Blink 打造的 TBS 2.0 终于发布,使其支持更新的 CSS 特性。

(渲染引擎和一些 CSS 特性的支持情况(iOS8 搭载 Webkit2 出自 http://asciiwwdc.com/2014/sessions/206))


调试工具

本文仅介绍可以免费下载和使用的工具。

(调试工具总览)


1、weinre 与 jsconsole

weinre (WEb INspector REmote) 与 jsconsole 是原理上相似的工具。weinre 复用了 WebKit 的 Web Inspector 的界面代码,有 Safari 和 Chrome 调试器经验的开发者会对此非常熟悉。jsconsole 是一个 JavaScript 的 web 控制台,它能接管控制台的日志输出,也能响应调试服务器发出的求值命令(通过 Server-Send Event 发出),将日志和求值结果通过 xhr 发送到服务器。jsconsole 功能虽然更少,但官方提供了一个开箱即用的线上应用,http://jsconsole.com/,无需安装任何软件即可开始调试。两者的调试功能都是由 JavaScript 编写,都必须把调试服务脚本插入目标页面,使其难以用于线上产品的调试。并且由于运行在浏览器沙盒中,其提供调试能力受到了较大的限制,例如无法查看 httponly 属性的 cookie,和非 xhr 的请求。

2、微信 Web 调试工具与 spy-debugger

这两者也是类似的工具,都是基于 weinre 开发的。设备连接调试工具提供的代理后访问目标网页,weinre 的调试脚本会被自动注入到 HTML 页面,从而免除了手动注入的麻烦。相比于 weinre 仅能查看 HTTP xhr 请求,利用代理,微信 Web 调试工具提供了查看所有 HTTP 请求的能力。不过由于没有实现 HTTPS 中间人,无法查看 HTTPS 请求。 spy-debugger 在这些功能之上提供了查看 HTTPS 请求的功能。值得一提的是,微信 Web 调试工具额外提供了调试微信 JSSDK 的能力,不过调试对象并不是真机,需是其提供的浏览器窗口。

3、Safari 与 Chrome

使用 PC 浏览器来调试对应的移动浏览器,你将拥有最佳的调试体验。WebKit 家族的 PC 浏览器都有非常强大的调试工具,其调试移动设备的体验几乎与调试桌面网页无异。Opera 自从将渲染核心从 Presto 切换到 Blink 之后,自家用于调试 Opera Mobile 的 Dragonfly 也被移除了,可见 Opera 对 Webkit 调试工具也是满意的(汗)。

Mac Safari 调试 iOS Safari 和 UIWebView 只需经过简单的设置。首先在 iOS 设备上启用 Safari 的 Web 检查器功能(设置>Safari>高级>Web 检查器),再通过 USB 线缆连接到 Mac,然后就能在 Mac Safari 的“开发”菜单中选中该设备来进行调试。如果没有找到“开发”菜单,则需要在 Safari 偏好设置中启用调试功能。调试 UIWebView 的步骤是一样的,但是要求 app 在该 Mac 设备上能被调试,也就是说第三方开发者是不能直接调试微信的 UIWebView 的。

(Mac Safari 调试 iOS Safari)

Chrome 调试 Chrome for Android 和基于 Chromium 的 WebView 的详情可以在https://developers.google.com/web/tools/chrome-devtools/debug/remote-debugging/remote-debugging找到。值得一提的是,Chrome 调试支持 Screencast 功能,能够将移动设备上的 Web 视图投射到 Chrome 调试工具中,不过这回降低 webapp 的性能表现。

(Chrome 调试 Chrome for Android)

使用 Chrome 来调试 iOS 设备也是可行的。利用 google 开发的 ios-webkit-debug-proxy,把 Safari 的远程调试协议代理到 Chrome DevTools 上,可以由 DevTools 接管几乎所有的调试功能。

(Chrome 调试 iOS Safari)


Webkit 远程调试协议

Webkit

Safari 和 Chrome 在移动平台上强大的调试能力源自 Webkit 的远程调试协议(remote debugging protocol)。Webkit 的远程调试协议是 Webkit 在 2012 年引入的,目前所有 Webkit 内核的浏览器都支持这一特性。DevTools 通过远程调试协议与目标页面相连,可以获取到 Webkit 内核提供的调试信息,这些信息远比 weinre 等在浏览器沙盒中获取的要准确和丰富。Webkit 远程调试协议与 Chrome DevTools 都是开放的,这让 ios-webkit-debug-proxy, React DevTools 和 vue-devtools 等强大且富有想象力的调试工具能成为现实。得益于协议的开放性,其他厂商也对 Webkit 调试表现出积极的兴趣。Firefox 宣布了用于调试 Webkit 内核浏览器的 Valence,不过目前仍处于技术预览版。

Fiddler

Fiddler 是可以运行在 Mac,Linux 和 Windows 上的一个用于 web 调试的代理软件。可以用来查看 HTTP API 访问,AMD 脚本加载,缓存命中等。Fiddler 有丰富的调试功能,其中支持 HTTPS 捕获和篡改请求响应对移动端调试十分有用。

使用 HTTPS 捕获功能需要在移动设备上安装 Fiddler 提供的证书,各移动平台的设置方法可在http://docs.telerik.com/fiddler/configure-fiddler/tasks/configurefiddler找到。有时我们需要替换线上产品的某个 js 文件来定位问题,或者伪造 session 来模拟使用场景,Fiddler 的篡改功能就能派上用场,具体的使用细节可以在http://docs.telerik.com/fiddler/KnowledgeBase/FiddlerScript/ModifyRequestOrResponse找到。

结论

调试运行 iOS >= 6 和 Android >= 4.4 的设备,优先采用 Safari 或 Chrome 进行调试。其余情况,可采用 weinre 及其衍生工具和 jsconsole。Fiddler 可作为这些方案的有效补充。

参考资料:

http://javascript.ruanyifeng.com/bom/mobile.html

https://developer.chrome.com/multidevice/webview/overview

http://bbs.mb.qq.com/thread-1128359-1-1.html

https://github.com/wuchangming/spy-debugger

https://github.com/google/ios-webkit-debug-proxy

http://people.apache.org/~pmuellr/weinre/docs/latest/Home.html

https://developers.google.com/web/tools/chrome-devtools/debug/remote-debugging/remote-debugging

http://docs.telerik.com/fiddler/configure-fiddler/tasks/configurefiddler

http://docs.telerik.com/fiddler/KnowledgeBase/FiddlerScript/ModifyRequestOrResponse

http://taobaofed.org/blog/2015/11/20/webkit-remote-debug-test/

https://trac.webkit.org/wiki/WebInspector

https://facebook.github.io/react/blog/2014/01/02/react-chrome-developer-tools.html

https://github.com/vuejs/vue-devtools

https://developer.mozilla.org/en-US/docs/Tools/Valence

http://moduscreate.com/enable-remote-web-inspector-in-ios-6/

本文作者:陈倬(点融黑帮),目前就职于点融网成都前端团队,主要负责内部 webapp 的开发,喜欢 Vue.js 。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,290评论 4 363
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,399评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,021评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,034评论 0 207
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,412评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,651评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,902评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,605评论 0 199
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,339评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,586评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,076评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,400评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,060评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,083评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,851评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,685评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,595评论 2 270

推荐阅读更多精彩内容

  • 大部分的后端会很很鄙视前端。我也不知道为什么,可能大部分人都会觉得脚本语言根本不算语言。 大多人 会叫我们切图仔,...
    小黑的眼阅读 3,253评论 0 15
  • 大家好,我叫马骏茹,今天我来给大家演讲的题目是我的妹妹。我有一个妹妹,她长着水灵灵的大眼睛尖锐的耳朵和灵敏的鼻子,...
    马骏茹阅读 218评论 0 0
  • 1. File -> Build Settings... 2. 添加场景以及选择平台 3. 点击Player Se...
    星空梦想阅读 1,253评论 1 1
  • 童话的结尾从来都是“王子和公主从此幸福地生活在了一起”。作者不会再写多余的笔墨,听故事的人也不会主动去想王子和公主...
    筑梦小兵阅读 1,957评论 4 6
  • 在翔云小区,韩姨是一个知名人物。今年七十二岁的她,被大家称作“老改队长”。因为整个小区的人,几乎都找她改过衣服。 ...
    命自我立阅读 651评论 12 16