首页 > 代码库 > 手机调试

手机调试

2024-09-01 07:05:03   218人阅读

“真机远程调试”（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模拟器非真机，只是模拟02（新版本加入了模拟网络链接的功能，故上调评分）PC、MAC无GO
weinre安装较为繁琐32PC、MAC全部GO
调试Android上的Chrome需要FQ24PC、MACAndroid上的ChromeGO
调试Android APP里的webview需要FQ34PC、MACAndroid APP里的webviewGO
调试Android上的x5内核（微信等）安装较为繁琐35PC、MACAndroid上的应用了x5内核的app，如微信、手Q、QQ浏览器等GO
调试Android上的UC需要桌面设备和移动设备同一网段13PC、MACAndroid上的UCGO
调试iOS上的Safari需要MAC（甚至可以无需iOS设备）24MACiOS上的SafariGO

简要步骤

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

调试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上弹出一个新的标签页，即为调试界面；如果很久都没用响应，请FQ后再试（ 示意图 ）（ 一个免费的梯子服务 ）（ 免费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上弹出一个新的标签页，即为调试界面；如果很久都没用响应，请FQ后再试（ 示意图 ）（ 一个免费的FQ服务 ）

其他参考链接

  • 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-toolsexport 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调试。 （ 示意图 ）

手机调试


联系
我们