wuchangming/remote_inspect_web_on_real_device

各种真机远程调试方法汇总——“真机远程调试”（remote inspect web on real device），是指用桌面电脑（PC或MAC）远程连接上移动设备，通过类似Chrome浏览器开发人员工具的界面，来调试移动设备上运行的网页

各种 真机远程调试 方法 汇总

“真机远程调试”（remote inspect web on real device），是指用桌面电脑（PC或MAC）远程连接上移动设备，通过类似Chrome浏览器开发人员工具的界面，来调试移动设备上运行的网页

当前：Oct 27,2014

“真机远程调试”的方法总是在发展，日新月异，有必要在每次更新本文档时标注当前时间及当前相关软件版本

• 当前最新 桌面版Chrome 版本：MAC：38.0.2125.104，PC：未知
• 当前最新 Android上的Chrome 版本：38.0.2125.102
• 当前最新 Android上的UC开发人员版 版本：9.8.9.457
• 当前最新 iOS：8.1

总览表格

方法	关键点	实现难度（综合考虑搭环境、软件、硬件成本，分数 小 为佳）	调试效果（综合考虑仿真效果、能调试的项等，分数 大 为佳）	可用的桌面设备	可用的移动设备及可调试的浏览器	简要步骤
Chorme模拟器	非真机，只是模拟	0	2（新版本加入了模拟网络链接的功能，故上调评分）	PC、MAC	无	GO
weinre	安装较为繁琐	3	2	PC、MAC	全部	GO
spy-debugger (简化weinre配置，支持https)	需要桌面设备和移动设备同一网段	1	2	PC、MAC	全部	GO
调试Android上的Chrome	需要翻墙	2	4	PC、MAC	Android上的Chrome	GO
调试Android APP里的webview	需要翻墙	3	4	PC、MAC	Android APP里的webview	GO
调试Android上的x5内核（微信等）	安装较为繁琐	3	5	PC、MAC	Android上的应用了x5内核的app，如微信、手Q、QQ浏览器等	GO
调试Android上的UC	需要桌面设备和移动设备同一网段	1	3	PC、MAC	Android上的UC	GO
调试iOS上的Safari	需要MAC（甚至可以无需iOS设备）	2	4	MAC	iOS上的Safari	GO

简要步骤

Chorme模拟器

1. 在PC或MAC上打开Chrome浏览器，打开想要调试的页面，然后打开开发人员工具
2. 点击开发人员工具顶栏上的手机图标，即可开始调试（ 示意图 ），一般来说需要重新刷新页面
3. 在页面顶部可以看到设备选择下拉菜单 Device 和 模拟网络环境的下拉菜单 Network ，及左侧的清除选择按钮和打开关闭 media queries 的按钮（ 示意图 ）
4. 打开设置左边的那个类似 >三 的图标，切换到 Emulation 标签，可以更细粒度地调整，来定制化你的模拟（ 示意图 ）

weinre

过程稍微繁琐，但是这个方案能调试几乎所有平台的所有浏览器，只要能运行js的就行

1. 安装nodejs
2. 安装weinre到global，即在命令行中运行 npm -g install weinre （MAC可能需要在前面加上 sudo ）
3. 获取本机IP地址（PC：开始→运行→cmd，输入 ipconfig ，查看“IPv4地址”字段； MAC：在网络偏好设置内），假设获取到的IP地址为 4.4.4.4
4. 在命令行运行weinre： weinre --boundHost 4.4.4.4 ，其中IP地址为上一步所获取的地址，如果弹出防火墙，请允许访问（ 示意图 ）
5. 在PC或MAC上用浏览器打开 http://4.4.4.4:8080/client/#anonymous ，其中IP地址为第三步所获取的地址（ 示意图 ）
6. 将移动设备连接到与PC或MAC同一局域网，打开移动设备上的需要调试的浏览器，然后随便打开一个网页。将它保存为书签
7. 修改上述书签，将地址改成：

javascript:(function(e){e.setAttribute("src","http://4.4.4.4:8080/
target/target-script-min.js#anonymous");document.getElementsByTagName("body")[
0].appendChild(e);})(document.createElement("script"));void(0);

，其中IP地址为第三步所获取的地址（复制后请去掉代码中的换行，使之成为一行）
8. 在移动设备浏览器上打开想要调试的页面，然后点击上一步保存的书签，即可在PC或MAC上的页面中的target中找到对应页面，点击可以开始调试（ 示意图 ）（ 示意图 ）

更多：

1. 可以考虑在某个机器上搭建一个统一的weinre服务器，供团队成员共用，此方案我尚未尝试
2. 在上述第7步开始，可以不采用书签的形式，而是考虑在代码中引入它提供的调试js文件，如 <script src="http://4.4.4.4:8080/target/target-script-min.js#anonymous"></script> （这种情况适用于不能使用书签的场景，如app内的webview、微信中等，但是上线之前要记得移除这个js的引用）

其他参考链接

• http://people.apache.org/~pmuellr/weinre-docs/latest/Installing.html

spy-debugger(集成weinre)

内部集成了weinre，简化了weinre繁琐的配置过程。通过代理的方式拦截所有html自动注入weinre所需的js代码。

1. 安装
Windows: npm install spy-debugger -g
Mac: sudo npm install spy-debugger -g

2. 手机和PC保持在同一网络下（比如同时连到一个Wi-Fi下）

3. 命令行输入spy-debugger，按命令行提示用浏览器打开相应地址。

4. 设置手机的HTTP代理，代理IP地址设置为PC的IP地址，端口为spy-debugger的启动端口。

5. 用手机浏览器访问你要调试的页面即可。

其他参考链接

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

调试Android上的Chrome

1. 在Android设备上安装Chrome浏览器（版本>=32，https://play.google.com/store/apps/details?id=com.android.chrome&hl=en ）（只有安卓4.0以上才有Chrome）
2. 开启当前Android设备的USB调试
3. 在PC或MAC上安装chrome浏览器（版本>=32）和对应的Android设备驱动（如果找不到，可以在这个 列表 内尝试）
4. 用USB线连接Android设备，在PC或MAC上的chrome地址栏输入 chrome://inspect 然后回车，或通过菜单图标→工具→检查设备，进入调试界面
5. 勾选界面中的 Discover USB devices ，直到搜索到你的Android设备（ 示意图 ）
6. 在移动设备上弹出的是否允许远程调试上，选择“允许”
7. 在下面的页面列表（将展示已在Android上的chrome中打开的页面），点击对应的 inspect 开始调试
8. 此时将在桌面版Chrome上弹出一个新的标签页，即为调试界面；如果很久都没用响应，请翻墙后再试（ 示意图 ）（ 一个免费的梯子服务 ）（ 免费10天稳定梯子服务 ）

其他参考链接

• https://developer.chrome.com/devtools/docs/remote-debugging

调试Android APP里的webview

1. 通过修改代码，在APP内设置允许远程调试（需安卓版本为4.4及以上）： 方法 ，然后安装APP
2. 开启当前Android设备的USB调试
3. 在PC或MAC上安装chrome浏览器（版本>=32）和对应的Android设备驱动（如果找不到，可以在这个 列表 内尝试）
4. 用USB线连接Android设备，在PC或MAC上的chrome地址栏输入 chrome://inspect 然后回车，或通过菜单图标→工具→检查设备，进入调试界面
5. 勾选界面中的 Discover USB devices ，直到搜索到你的Android设备（ 示意图 ）
6. 在移动设备上弹出的是否允许远程调试上，选择“允许”
7. 在下面的页面列表（将展示已在Android上的chrome中打开的页面），点击对应的 inspect 开始调试
8. 此时将在桌面版Chrome上弹出一个新的标签页，即为调试界面；如果很久都没用响应，请翻墙后再试（ 示意图 ）（ 一个免费的翻墙服务 ）

其他参考链接

• https://developers.google.com/chrome-developer-tools/docs/remote-debugging

调试Android上的x5内核

过程略繁琐，但是这个方案应该是目前调试webview最强大的工具，支持断点调试、控制台打印等。以下步骤以微信6.1举例：

前期准备

• 下载 TbsSuiteNew.apk 安装到手机
• 打开微信，进入任意聊天界面，输入框内输入//deletetbs，点发送
• 打开TbsSuiteNew，安装本地tbs内核（ 示意图 ）

应用包名 微信：com.tencent.mm，qq：com.tencent.mobileqq，qq空间：com.qzone
我们选择微信即可

• 启动应用，用微信访问一个页面，停留1分钟左右，目的是让微信来静默安装刚导入进去的tbs_xxxx_inspector.apk包（ 示意图 ）
• 一分钟过后打开TbsSuiteNew 检查是否安装成功。（ 示意图 ）

这里还需要在检查下 打开微信 随便进入一个 webview页面 然后长按页面文字是否有水滴 ，若有则成功

ADB安装

• 官网下载 android-sdk ，执行tools文件夹下面的android，然后选择android sdk platform tools 安装（ 示意图 ）
• 配置android环境变量 vim ~/.bash_profile

export ANDROID_TOOLS=/Users/sherlock/dev/android-sdk-macosx/platform-tools
export PATH=$PATH:$ANDROID_TOOLS

• 输入source .bash_profile，执行下环境变量；接着在终端输入adb，看是否已经配置ok；
• usb连接手机，启动调试模式。终端输入adb devices，就能看到已经连接的设备。

有时 adb devices不能显示连接设备，需要拔掉数据线，多插几次，并且退出终端，然后重新打开，重启adb。

python启动调试服务

• 下载 调试包 ，解压，找到其中的inspector_client20150401 解压，然后进入
• 执行以下python命令， python ./inspector.py —abd 你自己的adb路径

python ./inspector.py --adb /Users/sherlock/dev/android-sdk-macosx/platform-tools/adb

• 启动成功，PC打开chrome浏览器，访问 http://localhost:9222/ ；手机打开微信任意webview，就能在chrome看到这个页面的选项卡，点进去就是熟悉的调试界面，请自由的使用～（ 示意图 ）

其他参考链接

• http://www.jianshu.com/p/ccf124f1f74b

调试Android上的UC

1. 在Android设备上安装UC浏览器开发版，http://www.uc.cn/business/developer/ ，点击第一行右侧的“安装包下载”（ 示意图 ）
2. 获取Android设备的IP，一般在WLAN设置内，假设为 4.4.4.4
3. 用和手机处于同一网段的PC或MAC访问步骤2获得的IP后加上 :9998 ，如例子中即为 4.4.4.4:9998
4. 在Android设备上弹出的是否允许远程调试上，选择“允许”（ 示意图 ），即可开始调试（ 示意图 ）

其他参考链接

• http://www.uc.cn/business/download/developer.pdf

调试iOS上的Safari

1. 在iOS设备上打开允许调试：设置→Safari→高级→打开”web检查器“
2. 在MAC上打开Safari的开发菜单：顶部菜单栏“Safari”→偏好设置→高级→打开”在菜单栏中显示“开发”菜单
3. 在iOS设备上的Safari浏览器中打开要调试的页面，然后切换到MAC的Safari，在顶部菜单栏选择“开发”→找到你的iOS设备名称→右边二级菜单选择需要调试的对应标签页，即可开始远程调试（ 示意图 ）
4. 如果没有iOS设备，也可以在Xcode中模拟一台，点击顶部“Xcode”→“Open Developer Tool”→“iOS Simulator”即可打开一个iOS设备的模拟器，并且模拟器里面Safari打开的页面，也是能通过上个步骤中MAC上的Safari调试。 （ 示意图 ）