Windows 怎么查看 iOS App 界面层级?3D 视图调试与实时修改
在浏览器里用 3D 分层视图查看真机上 App 的界面,看每个控件的属性和约束,直接修改并在手机上看到效果。
最后更新
在 Windows 查看 iOS App 的界面层级,运行 kxdevice web,在浏览器的「视图调试」里抓取真机上正在运行的 App:得到可以旋转的 3D 分层视图、控件树和每个控件的属性,还能直接改属性和约束,在手机上立刻看到效果。kxbuild 打的 Debug 包读取时不暂停,其他开发签名的 App 通过调试器读取。Linux、macOS 上用法相同。
怎么打开界面层级查看器?
1. 启动网页界面
手机连上电脑并已信任,步骤见设备准备。运行下面的命令,用浏览器打开 http://127.0.0.1:8780,在左侧选「视图调试」。
2. 抓取一个 App
在「要启动的应用」里选 App,点「启动并抓取」;App 已经在运行时,在「运行中的进程」里选它,点「抓取」。界面变化之后点「重新抓取」,选中的控件会保持选中。
> kxdevice web应用内读取和调试器两种抓取方式有什么区别?
抓取按钮旁边可以选抓取方式。默认的「自动」会先试应用内读取,App 不支持时改用调试器。
| 应用内读取 | 调试器 | |
|---|---|---|
| 适用的 App | kxbuild 打的 Debug 包,并且在手机前台 | 任何开发签名的 App |
| 抓取时 App 的状态 | 照常运行,约 1 秒完成 | 暂停,约 10 秒后继续运行 |
| App 正在被调试时 | 可以抓取(App 没有停在断点上时) | 不能,先结束调试 |
| 能修改什么 | 属性面板里所有标了可写的属性,以及约束 | alpha、hidden、frame、背景色 |
| 额外内容 | 无障碍元素、每个控件的可见比例 | 可以导出 .viewhierarchy 文档 |
3D 画布、控件树和属性面板怎么用?
| 位置 | 可以做什么 |
|---|---|
| 左侧控件树 | 按类名、地址或文字搜索;点一行选中控件。视图控制器的根视图后面带控制器的类名 |
| 中间画布 | 拖动旋转,滚轮缩放,点击选中控件。「3D / 2D」切换分层和平面,「间距」调层与层的距离,「层级」只看其中几层 |
| 画布上方的开关 | 「隐藏视图」显示 hidden 的视图,「线框」只画边框,「无障碍元素」把不是视图的无障碍元素画成橙色框 |
| 窗口选择 | App 有多个窗口时,可以只看一个,或选「全部窗口」叠在一起看 |
| 右侧属性面板 | 选中控件的位置、大小、可见比例、无障碍信息、单层图和含子视图的图,以及视图和图层的全部属性 |
怎么直接修改属性和约束?
应用内读取时,属性面板里可写的属性直接在行内修改:开关、数字、文字、颜色、枚举值、矩形都可以,改完手机上立刻生效,画布随后自动更新。「约束」一栏列出决定这个视图位置和大小的约束,可以改常量、优先级和是否启用;约束不足以确定布局时,这一栏会提示。
通过调试器抓取时,在「在设备上修改」里改 alpha、hidden、frame 或背景色,点「应用」。
这些修改只作用于正在运行的 App,重新启动就恢复。用它试出合适的数值,再写回代码或 storyboard。
怎么用命令行抓取界面层级?
kxdevice viewdebug capture -B com.example.myapp -o tree.json
kxdevice viewdebug capture --pid 1234
kxdevice viewdebug snapshot --pid 1234 --id 0x10320b9d0 -o view.png
kxdevice viewdebug set --pid 1234 --id 0x10320b9d0 --alpha 0.5 --bg 3366ff
kxdevice viewdebug set --pid 1234 --id 0x10320b9d0 --attr v.text='"Hello"'| 命令 | 作用 |
|---|---|
| viewdebug capture | 打印控件树;-B 指定 App(不在前台时会启动它),--pid 指定运行中的进程,-o 另存一份 JSON,--until <类名> 等某个类的视图出现后再抓 |
| viewdebug snapshot | 把一个视图存成 PNG,--layer-only 只要它自己那一层 |
| viewdebug set | 修改一个视图:--alpha、--hidden、--frame x,y,宽,高、--bg RRGGBB;Debug 包还可以用 --attr 名称=值 改任何可写属性,名称见网页属性面板或 capture 的输出 |
| viewdebug export | 导出 .viewhierarchy 文档 |
每条命令都可以加 --backend agent 或 --backend debugger 指定抓取方式,不加就是自动。
怎么导出 .viewhierarchy 文档?
网页里通过调试器抓取之后点「导出」,或者用命令行。导出的文档与 Xcode 兼容,可以在 Xcode 里打开;也可以在网页里点「导入」重新查看,不需要连着手机。
> kxdevice viewdebug export -B com.example.myapp -o MyApp.viewhierarchy怎么让 AI 代理读取界面层级?
把 kxdevice 添加为 MCP 服务器后,AI 代理用 view_hierarchy 工具读出控件树,包括文字、位置、无障碍信息和可见比例,用来核对改动后的界面。操作界面的工具见UI 自动化。
> claude mcp add kxdevice -- kxdevice mcp想看 AI 从一句话开始做出 App、在 iPhone 上自己测试、一路做到准备上架,见AI 全自动开发,有完整的演示视频。
抓取失败怎么处理?
| 现象 | 处理 |
|---|---|
| 提示 App 在后台、没有响应 | 把 App 切到手机前台再抓取 |
| 提示 App 正在被另一个调试器调试 | 结束那个调试会话;或者用 kxbuild 打的 Debug 包,它在调试中也能抓取 |
| 抓到的窗口是空的 | App 还没画出界面。在「等待类名」里填一个界面上一定会出现的视图类名,再点「启动并抓取」 |
| 提示开发者镜像没有挂载 | 网页的「维护」页里点「挂载」,或运行 kxdevice ddi auto-mount |
| 指定应用内读取时提示 App 没有应答 | App 要是 kxbuild 打的 Debug 包并且在前台。运行 kxbuild doctor 更新后重新构建、安装 |
看清界面之后要自动操作它,见UI 自动化;需要断点调试,见VS Code 真机调试 iOS App。