跳到主要内容
本页目录

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 不支持时改用调试器。

应用内读取调试器
适用的 Appkxbuild 打的 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。

接下来