跳到正文
文档目录

界面

iOS 模拟器

在检查器里运行 iOS 模拟器,用指针和键盘操作它,并让 Agent 用 termio sim 启动、点按和检查你的 App。

模拟器窗格在检查器里、会话旁边,实时显示一台 iOS 模拟器。你用指针和 Mac 键盘操作它。Agent 通过 termio sim 操作设备;当 Agent 操作的正是窗格显示的那台设备时,它的每一次点按你都看得见,也随时可以接手。

这个窗格需要搭载 Apple 芯片的 Mac 和 macOS 15 或更高版本。在其他 Mac 上,窗格菜单里没有它。它还需要下载了 iOS 运行时的 Xcode。缺了这些时,窗格会说明该怎么做:安装 Xcode、接受 Xcode 许可协议,或下载 iOS 平台。

打开窗格

在所选会话标题栏的窗格菜单里选择 iOS Simulator。窗格会打开你上次用的设备;如果它已经关机,就启动它。

左上角的设备菜单用来切换设备。已启动的设备排在前面,选择一台已关机的设备会启动它。同一个菜单里还有 新建模拟器、重新启动、关机、重命名…、抹掉所有内容和设置… 和 删除…。

自己使用

在屏幕上点按和拖移,就是触摸它。在 Mac 键盘上打字,就是在设备上打字。

标题栏放着指针够不到的控制:

  • 主屏幕 和 向右旋转。
  • 存储截屏到桌面 和 录制屏幕到桌面。
  • 选择元素:选中屏幕上的一个元素,看它的类型、标签和辅助功能特征。它打开的卡片可以拷贝这个元素,或用 添加到聊天 把它加进所选会话的提示里,让 Agent 去点按它。
  • 标注:用笔、矩形或箭头在截屏上画。
  • 更多(…):其他硬件按钮、缩放、浅色或深色外观、干净的状态栏、慢速动画、帧率、App 日志,以及屏幕键盘。在 Simulator.app 里有快捷键的项会标出它,屏幕获得焦点时就能用。

你截的屏会以卡片的形式留在屏幕下方。从卡片上你可以预览、标注、拷贝图像、用 添加到聊天 把它加进所选会话,或者移到废纸篓。

让 Agent 来操作

Agent 第一次请求一台设备时,Termio 会问你:允许 Agent 使用“iPhone 17”吗? 之后 Agent 就能控制这台模拟器,并截取它的整个屏幕,所以不要在上面登录真实账户。Termio 会记住你允许的每台设备。如果你不允许,Agent 的下一条命令会再问一次。

在 Termio 会话里运行的 Agent 用 termio sim 操作设备:

termio sim attach --device "iPhone 17"
xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 17' \
  -derivedDataPath build build
termio sim launch build/Build/Products/Debug-iphonesimulator/MyApp.app
termio sim inspect
termio sim tap --label "Continue"
termio sim text "hello@example.com" && termio sim key return
termio sim screenshot

attach 在这台设备上打开窗格,需要时启动它,设备一开始绘制就返回。在构建之前运行它,这样设备会在 Xcode 编译的同时启动。

不加 --device 时,命令使用下面第一台已启动的设备:

  1. 这个会话上次用的设备。
  2. 窗格显示的设备,除非另一个会话正在操作它。
  3. 没有被其他会话操作的设备。
  4. 任意一台设备。

没有设备启动时,用 attach --device 指定一台。

命令作用
list列出模拟器;* 标出窗格显示的那一台
attach、detach在一台设备上打开窗格,或关闭实时画面、让设备继续运行
launch安装构建好的 .app 并启动它,替换正在运行的那一份
open-url打开 URL 或深层链接
inspect打印最前面那个 App 的辅助功能树,坐标以设备点为单位
tap在以设备点为单位的 X Y 处点按,或点按标签包含 --label 的元素
swipe、touch-path、touch2-path用一根手指拖移、沿路径移动,或用两根手指捏合和旋转
text、key在获得焦点的输入框里打字,或按一个键或编辑命令
button、rotate、keyboard按硬件按钮、旋转设备,或显示或隐藏屏幕键盘
screenshot把屏幕存为 PNG 并打印它的路径
logs、crash-report打印 App 最近的日志,或总结它最近一次崩溃

点按一个还没定位的东西之前,先用 inspect 读屏幕;颜色、图片和布局用 screenshot 看。termio sim <command> --help 列出一条命令的选项。CLI 的其余部分见命令行工具。

文档