从 tap 到双指 pinchBaguette 手势注入与 Home 条系统手势终极教程【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguetteBaguette是 Apple 模拟器Xcode Simulator的无头控制工具——3D 模型渲染、点击、滑动、多指手势注入、60 fps 屏幕流与多设备农场一个 CLI 全包。本文将带你从最简单的baguette tap一路玩到双指pinch缩放再解锁 Home 条上划、应用切换器、锁屏与通知中心这组系统手势全部命令可直接复制执行。 快速上手找到模拟器并注入第一个 tap在 macOS Xcode 26 环境下克隆并构建git clone https://gitcode.com/gh_mirrors/baguette/baguette cd baguette swift build先确认目标模拟器正在运行取出它的 UDIDbaguette list UDID$(baguette list --json | jq -r .running[0].udid)第一个手势——在屏幕 (220, 480) 注入一次点击baguette tap --udid $UDID --x 220 --y 480 --width 402 --height 874成功时返回一行 JSON 回执{ok:true,action:tap}参数怎么填--x / --y是设备点数坐标左上角为原点--width / --height是整块屏幕的点数尺寸如 iPhone 17 为 402×874不是坐标。Baguette 用它把坐标换算成屏幕内比例——填错这两项是双指点击只响了一次这类问题的头号原因。 单指手势全家桶tap、double-tap、swipe命令作用典型参数tap单击可加--edge标记屏幕边缘--duration 0.05按住时长double-tap双击触发TapGesture(count: 2)--interval 0.05两击间隔swipe单指从起点拖到终点--duration 0.25拖拽时长双击是新手最容易踩坑的一步连续跑两条baguette tap是点不出双击的——每条命令光进程启动就要 150~300 ms早就超过了 iOS 双击识别器约 250 ms 的聚合窗口。必须用专门命令让四个 HID 事件在同一个进程内完成baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 # 自定义节奏两击间隔 0.08s、每次按住 0.05s baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 \ --interval 0.08 --duration 0.05单指上划滚动列表baguette swipe --udid $UDID --start-x 220 --start-y 800 \ --end-x 220 --end-y 200 --width 402 --height 874✌️ 双指 pinch两指捏合缩放一次到位单指玩到头了双指手势走的是另一条注入通道两指同时下压的两条并行事件事件。pinch 捏合 / 放大参数给中心点 两指的起始、结束间距结束间距小于起始就是捏合缩小反之是张开放大baguette pinch --udid $UDID --cx 201 --cy 437 \ --start-spread 240 --end-spread 80 --width 402 --height 874pan 双指平移两指保持间距平行拖动常用于地图平移baguette pan --udid $UDID --x1 150 --y1 400 --x2 250 --y2 400 \ --dx 0 --dy -300 --width 402 --height 874⚠️ 如果你自己在写脚本直接发 WebSocket 事件捏合务必用touch2-*双指系列。单指touch1-*能正确路由但 iOS 的UIPinchGestureRecognizer只会把它当成普通拖动。 Home 条系统手势一条 press 命令直达这是 Baguette 最有意思的部分Home 条上划、应用切换器、锁屏下拉、通知中心统统一条命令触发。它把整条轨迹速度、停顿、起点位置都替你摆好了baguette press --udid $UDID --button swipe-to-home按钮注入的轨迹iOS 的反应swipe-to-home底部快速上划约 12 步 ×16 msHome——回主屏幕swipe-to-app-switcher底部缓慢上划 30 步 中点停顿约 900 ms应用切换器——多任务卡片pull-down-to-lock-screen从屏幕左上 1/4 处缓慢下拉锁屏盖住下压pull-down-to-notification-center从屏幕右上 3/4 处缓慢下拉通知中心Baguette 本身不做客户端手势判别——iOS 只认速度、停顿时长和起始横坐标所以效果与 Xcode 自带模拟器里的手感完全一致设计细节见 docs/features/touches/design.md。️ 浏览器画布上真实地拖 Home 条baguette serve的页面画布支持实时系统手势从屏幕底部 7%区域开始拖动事件自动带上edge: bottomiOS 会一边跟手一边显示 Home / 应用切换器实时预览从顶部 7%区域拖动则带edge: top拉出锁屏或通知中心——跟随你的真实拖速松手时不做任何罐头回放。⚠️ 横屏时的坑edge 要跟着方向走edge标记的是物理边而非视觉边。设备旋转后edge: bottom可能对应的是视觉上的右侧——此时 Home 手势不会触发。页面会帮你自动换算CLI 脚本则按此映射修正屏幕方向视觉底部的物理边portrait竖屏bottomlandscape-leftrightportrait-upside-downrightlandscape-righttop拿不准就直接用swipe-to-home/swipe-to-app-switcher按钮它们永远从设备的竖屏底部发起旋转由 iOS 自己消化。 常见问题速查Gotchas 清单双指 pinch 没反应确认走的是touch2-*/pinch命令单指事件会被当成 pan。{ok:true}之后 App 没反应回执只代表消息成功送达模拟器不代表 App 已处理——验证失败先看屏幕再重试。--width/--height填的是屏幕尺寸填成坐标是双指点击、捏合失效的常见原因。所有输入事件的信封格式edge、touch1-*、touch2-*详见 docs/wire.md。 延伸阅读完整命令参考docs/commands.md触摸与系统手势设计原理IOHIDEvent 数字笔配方docs/features/touches/硬件按键home / lock / action 等docs/features/buttons/README.md手势命令源码Sources/Baguette/App/Commands/GestureCommands.swift搞定手势注入只是开始——Baguette 还有 60 fps 视频流、3D 模型渲染和多设备农场等着你全部写在 docs/ 里。【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguette创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从 tap 到双指 pinch：Baguette 手势注入与 Home 条系统手势终极教程
从 tap 到双指 pinchBaguette 手势注入与 Home 条系统手势终极教程【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguetteBaguette是 Apple 模拟器Xcode Simulator的无头控制工具——3D 模型渲染、点击、滑动、多指手势注入、60 fps 屏幕流与多设备农场一个 CLI 全包。本文将带你从最简单的baguette tap一路玩到双指pinch缩放再解锁 Home 条上划、应用切换器、锁屏与通知中心这组系统手势全部命令可直接复制执行。 快速上手找到模拟器并注入第一个 tap在 macOS Xcode 26 环境下克隆并构建git clone https://gitcode.com/gh_mirrors/baguette/baguette cd baguette swift build先确认目标模拟器正在运行取出它的 UDIDbaguette list UDID$(baguette list --json | jq -r .running[0].udid)第一个手势——在屏幕 (220, 480) 注入一次点击baguette tap --udid $UDID --x 220 --y 480 --width 402 --height 874成功时返回一行 JSON 回执{ok:true,action:tap}参数怎么填--x / --y是设备点数坐标左上角为原点--width / --height是整块屏幕的点数尺寸如 iPhone 17 为 402×874不是坐标。Baguette 用它把坐标换算成屏幕内比例——填错这两项是双指点击只响了一次这类问题的头号原因。 单指手势全家桶tap、double-tap、swipe命令作用典型参数tap单击可加--edge标记屏幕边缘--duration 0.05按住时长double-tap双击触发TapGesture(count: 2)--interval 0.05两击间隔swipe单指从起点拖到终点--duration 0.25拖拽时长双击是新手最容易踩坑的一步连续跑两条baguette tap是点不出双击的——每条命令光进程启动就要 150~300 ms早就超过了 iOS 双击识别器约 250 ms 的聚合窗口。必须用专门命令让四个 HID 事件在同一个进程内完成baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 # 自定义节奏两击间隔 0.08s、每次按住 0.05s baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 \ --interval 0.08 --duration 0.05单指上划滚动列表baguette swipe --udid $UDID --start-x 220 --start-y 800 \ --end-x 220 --end-y 200 --width 402 --height 874✌️ 双指 pinch两指捏合缩放一次到位单指玩到头了双指手势走的是另一条注入通道两指同时下压的两条并行事件事件。pinch 捏合 / 放大参数给中心点 两指的起始、结束间距结束间距小于起始就是捏合缩小反之是张开放大baguette pinch --udid $UDID --cx 201 --cy 437 \ --start-spread 240 --end-spread 80 --width 402 --height 874pan 双指平移两指保持间距平行拖动常用于地图平移baguette pan --udid $UDID --x1 150 --y1 400 --x2 250 --y2 400 \ --dx 0 --dy -300 --width 402 --height 874⚠️ 如果你自己在写脚本直接发 WebSocket 事件捏合务必用touch2-*双指系列。单指touch1-*能正确路由但 iOS 的UIPinchGestureRecognizer只会把它当成普通拖动。 Home 条系统手势一条 press 命令直达这是 Baguette 最有意思的部分Home 条上划、应用切换器、锁屏下拉、通知中心统统一条命令触发。它把整条轨迹速度、停顿、起点位置都替你摆好了baguette press --udid $UDID --button swipe-to-home按钮注入的轨迹iOS 的反应swipe-to-home底部快速上划约 12 步 ×16 msHome——回主屏幕swipe-to-app-switcher底部缓慢上划 30 步 中点停顿约 900 ms应用切换器——多任务卡片pull-down-to-lock-screen从屏幕左上 1/4 处缓慢下拉锁屏盖住下压pull-down-to-notification-center从屏幕右上 3/4 处缓慢下拉通知中心Baguette 本身不做客户端手势判别——iOS 只认速度、停顿时长和起始横坐标所以效果与 Xcode 自带模拟器里的手感完全一致设计细节见 docs/features/touches/design.md。️ 浏览器画布上真实地拖 Home 条baguette serve的页面画布支持实时系统手势从屏幕底部 7%区域开始拖动事件自动带上edge: bottomiOS 会一边跟手一边显示 Home / 应用切换器实时预览从顶部 7%区域拖动则带edge: top拉出锁屏或通知中心——跟随你的真实拖速松手时不做任何罐头回放。⚠️ 横屏时的坑edge 要跟着方向走edge标记的是物理边而非视觉边。设备旋转后edge: bottom可能对应的是视觉上的右侧——此时 Home 手势不会触发。页面会帮你自动换算CLI 脚本则按此映射修正屏幕方向视觉底部的物理边portrait竖屏bottomlandscape-leftrightportrait-upside-downrightlandscape-righttop拿不准就直接用swipe-to-home/swipe-to-app-switcher按钮它们永远从设备的竖屏底部发起旋转由 iOS 自己消化。 常见问题速查Gotchas 清单双指 pinch 没反应确认走的是touch2-*/pinch命令单指事件会被当成 pan。{ok:true}之后 App 没反应回执只代表消息成功送达模拟器不代表 App 已处理——验证失败先看屏幕再重试。--width/--height填的是屏幕尺寸填成坐标是双指点击、捏合失效的常见原因。所有输入事件的信封格式edge、touch1-*、touch2-*详见 docs/wire.md。 延伸阅读完整命令参考docs/commands.md触摸与系统手势设计原理IOHIDEvent 数字笔配方docs/features/touches/硬件按键home / lock / action 等docs/features/buttons/README.md手势命令源码Sources/Baguette/App/Commands/GestureCommands.swift搞定手势注入只是开始——Baguette 还有 60 fps 视频流、3D 模型渲染和多设备农场等着你全部写在 docs/ 里。【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguette创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考