Weinre --WebApp 调试工具

2015-06-18 浩阳 更多博文 » 博客 » GitHub »

Weinre WebApp 调试工具 JavaScript HTML

原文链接 https://gaohaoyang.github.io/2015/06/18/weinre/
注:以下为加速网络访问所做的原文缓存,经过重新格式化,可能存在格式方面的问题,或偶有遗漏信息,请以原文为准。


  • content {:toc}

什么是 weinre?

weinre官网 上有两句有意思的介绍:

weinre is WEb INspector REmote. Pronounced like the word "winery". Or maybe like the word "weiner". Who knows, really.

weinre is a debugger for web pages, like FireBug (for FireFox) and Web Inspector (for WebKit-based browsers), except it's designed to work remotely, and in particular, to allow you debug web pages on a mobile device such as a phone.

上面说 weinre 是一个远程 web 调试器。说到了它的发音,还挺幽默,哈哈。

远程 web 调试器。先说调试器,就像火狐中的 FireBug,Chrome 中的调试器一样。就是在浏览器中按下 F12 出现的那个工具。但是在手机上,你没办法按 F12,而这个 weinre 就是在手机上的 F12,与传统的不同的是,它是在手机上浏览你的 web 页面,在 PC 上查看调试工具,非常方便,这就是所谓的远程。


为什么用 weinre?

现代浏览器中调试工具都非常强大了,可以直接模拟手机设备,为什么还要用 weinre 这么麻烦的东西呢?

我觉得 PC 端的浏览器虽说可以模拟,但模拟毕竟还是模拟,还只是鼠标长按滑来滑去。在开发过程中,使用手机或平板直接来感受是多么的酷,指尖在移动设备的屏幕上摩擦摩擦!给人的直观感受绝对秒杀浏览器的模拟。


原理

使用一种工具之前,了解它的原理和结构是很有帮助的。weinre 作为一种远程调试工具,在结构上分为三层:

  • 目标页面(target):被调试的页面,页面已嵌入 weinre 的远程 js,下文会介绍;
  • Debug客户端(client):本地的 Web Inspector 调试客户端;
  • Debug服务端(agent):一个 HTTP Server,为目标页面与 Debug 客户端建立通信。

三层结构如下图所示:

http-flow

weinre 的 debug 客户端是基于 Web Inspector 开发,而 Web Inspector 只与以 WebKit 为核心的浏览器兼容,所以 Weinre 的客户端只能用 Chrome 或者 Safari 打开。

官网上也有相应的平台支持说明:

  • Platforms supported - debug server 服务端

    任何支持 node.js 的平台。

  • Platforms supported - debug client 客户端(跑 debugger 界面的浏览器)

    • Google Chrome
    • Apple Safari
    • Other recent-ish WebKit-based browsers 其他基于 webkit 内核的现代浏览器
  • Platforms supported - debug target 目标页面(在移动设备中调试运行的目标页面)

    • Android Browser application
    • iOS Mobile Safari application
    • PhoneGap/Cordova
    • other

安装

  1. weinre 是 nodeJS 的一个应用,首先要 安装 nodeJS 运行环境
  2. 使用 npm 命令,安装 weinre

    npm -g install weinre
    

    安装成功后会有类似的信息:

    C:\Users\haoyang\AppData\Roaming\npm\weinre -> C:\Users\haoyang\AppData\Roaming\npm\node_modules\weinre\weinre
    weinre@2.0.0-pre-I0Z7U9OV C:\Users\haoyang\AppData\Roaming\npm\node_modules\weinre
    ├── underscore@1.7.0
    ├── nopt@3.0.2 (abbrev@1.0.7)
    └── express@2.5.11 (mime@1.2.4, qs@0.4.2, mkdirp@0.3.0, connect@1.9.2)
    

使用

  1. 启动服务

    weinre --boundHost -all- --httpPort 8081
    
* --boundHost [hostname \| ip address \| -all-]

    The ip address to bind the server to.

* --httpPort [portNumber]

    The port to run the HTTP server on.

更多配置项参考 [官网的说明](http://people.apache.org/~pmuellr/weinre/docs/latest/Running.html)。
  1. 启动成功后看到如下界面:

    weinre

  2. 给目标页面添加一行脚本

    可以看到 2.中的 Target Script 说要添加一行脚本到要调试的 web 页面中。

    Target Script

    You can use this script to inject the weinre target code into your web page.

    http://localhost:8081/target/target-script-min.js#anonymous

    Example:

    <script src="http://localhost:8081/target/target-script-min.js#anonymous"></script>
    

    这里要说明一下,要把上面的 localhost 换为本机的 ip 地址。

    我们可以在命令行中 使用 ipconfig 得到 ip 地址,如下(当然你的可能和我的不一样):

    IPv4 地址 . . . . . . . . . . . . : 192.168.1.107
    

    即插入如下代码:

    <script src="http://192.168.1.107:8081/target/target-script-min.js#anonymous"></script>
    
  3. 进入调试页面

    PC 端访问这个地址:

    debug client user interface: http://localhost:8081/client/#anonymous

    此时 target 为 none,如下图:

    target-none

    现在我们要用手机访问同一个局域网下的这个目标页面。我们可以把要调试的页面放到这个路径下:

    C:\Users\haoyang\AppData\Roaming\npm\node_modules\weinre\web
    

    通过 http://192.168.1.107:8081/FILE_NAME 在手机上访问,就可以看到了。当然前提是同一个局域网。

    但是这样可能不太灵活,每次都要把目标页面放到指定的目录下。所以我们可以另外开一个服务器。

    我使用了基于 node.js 的 http-server 工具。将要调试的页面发布。这样我就能通过 ip 地址加端口号在手机上访问到了。

    我在手机上访问 http://192.168.1.107:8080 打开要调试的页面,此时 debug client user interface 中自动检测到 target。就可以进行调试了!

    如下图:

    target

    phone


参考