iOS WebKit Debug Proxy 技术文档

iOS WebKit Debug Proxy 技术文档

ios-webkit-debug-proxy A DevTools proxy (Chrome Remote Debugging Protocol) for iOS devices (Safari Remote Web Inspector). 项目地址: https://gitcode.com/gh_mirrors/io/ios-webkit-debug-proxy

iOS WebKit Debug Proxy（简称 iwdp）是一个强大的工具，它通过WebSocket连接代理了来自usbmuxd守护进程的请求，使开发者能够对实际和模拟的iOS设备上的MobileSafari和UIWebViews发送命令。此文档旨在指导您安装、配置并有效利用该工具进行远程调试。

安装指南

MacOS

对于MacOS用户，推荐使用Homebrew来简化安装过程：

brew install ios-webkit-debug-proxy

Windows

Windows用户可以通过Scoop包管理器来安装：

1. 首先添加extras存储库：

   scoop bucket add extras
   

2. 然后安装ios-webkit-debug-proxy：

   scoop install ios-webkit-debug-proxy
   

注意，还需确保安装最新版本的iTunes。

Linux

在Linux上，您需要手动处理依赖项：

1. 使用apt安装基础依赖：

   sudo apt-get install autoconf automake libusb-dev libusb-1.0-0-dev libplist-dev libtool libssl-dev
   

2. 下载并编译更现代版本的特定依赖项。
3. 接着克隆并构建ios-webkit-debug-proxy：

   git clone https://github.com/google/ios-webkit-debug-proxy.git
   cd ios-webkit-debug-proxy
   ./autogen.sh
   make
   sudo make install
   

使用说明

启动iOS模拟器或设备

确保iOS模拟器（如果使用）在启动代理前运行，并且设置好设备的Web Inspector权限。

开启Web Inspector

• 进入iOS设备的设置 > Safari > 高级 > Web Inspector并开启。

启动代理

基本启动命令为：

ios_webkit_debug_proxy

您可以加上参数以获得更多信息或指定前端界面，如：

• 增加--debug选项来获取详细日志。
• 使用--frontend指定前端URL。
• 查看所有可用选项可通过--help。

与DevTools集成

• Chrome DevTools: 注意版本兼容性差异，较新的Chrome可能不完全兼容Safari的Inspector协议。
• Safari Web Inspector: 可通过第三方工具桥接，比如从Webkit源码提取的Safari Web Inspector。
• Firefox DevTools: 利用Valence扩展实现跨浏览器调试。

API使用文档

iOS WebKit Debug Proxy提供了JSON格式的API接口供客户端程序使用：

• 访问http://localhost:9221/json可获取所有连接的设备列表。
• http://localhost:9222/json展示特定端口（如9222）绑定设备的标签页信息。
• 而Websocket地址，如ws://localhost:9222/devtools/page/1可用于直接调试标签页。

配置和高级使用

• 自定义前端界面(-f选项)，例如使用本地的Chromium DevTools页面。
• 设定设备到端口的映射(-c)，允许精确控制每个设备使用的调试端口范围。

遇到问题？

• 详细的故障排除步骤涵盖了常见错误，如库依赖未找到、iOS版本兼容性问题等，确保检查设备的信任设置，以及更新到软件的最新版本。

---

本文档提供了一个全面的概览，引导您完成iOS WebKit Debug Proxy的安装、配置和使用流程。运用这些知识，开发者可以有效地在多种平台上对iOS设备上的Web内容进行远程调试。

ios-webkit-debug-proxy A DevTools proxy (Chrome Remote Debugging Protocol) for iOS devices (Safari Remote Web Inspector). 项目地址: https://gitcode.com/gh_mirrors/io/ios-webkit-debug-proxy