從 tap 到雙指 pinchBaguette 手勢(shì)注入與 Home 條系統(tǒng)手勢(shì)終極教程【免費(fèi)下載鏈接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm項(xiàng)目地址: https://gitcode.com/gh_mirrors/baguette/baguetteBaguette是 Apple 模擬器Xcode Simulator的無(wú)頭控制工具——3D 模型渲染、點(diǎn)擊、滑動(dòng)、多指手勢(shì)注入、60 fps 屏幕流與多設(shè)備農(nóng)場(chǎng)一個(gè) CLI 全包。本文將帶你從最簡(jiǎn)單的baguette tap一路玩到雙指pinch縮放再解鎖 Home 條上劃、應(yīng)用切換器、鎖屏與通知中心這組系統(tǒng)手勢(shì)全部命令可直接復(fù)制執(zhí)行。 快速上手找到模擬器并注入第一個(gè) tap在 macOS Xcode 26 環(huán)境下克隆并構(gòu)建git clone https://gitcode.com/gh_mirrors/baguette/baguette cd baguette swift build先確認(rèn)目標(biāo)模擬器正在運(yùn)行取出它的 UDIDbaguette list UDID$(baguette list --json | jq -r .running[0].udid)第一個(gè)手勢(shì)——在屏幕 (220, 480) 注入一次點(diǎn)擊baguette tap --udid $UDID --x 220 --y 480 --width 402 --height 874成功時(shí)返回一行 JSON 回執(zhí){ok:true,action:tap}參數(shù)怎么填--x / --y是設(shè)備點(diǎn)數(shù)坐標(biāo)左上角為原點(diǎn)--width / --height是整塊屏幕的點(diǎn)數(shù)尺寸如 iPhone 17 為 402×874不是坐標(biāo)。Baguette 用它把坐標(biāo)換算成屏幕內(nèi)比例——填錯(cuò)這兩項(xiàng)是雙指點(diǎn)擊只響了一次這類問(wèn)題的頭號(hào)原因。 單指手勢(shì)全家桶tap、double-tap、swipe命令作用典型參數(shù)tap單擊可加--edge標(biāo)記屏幕邊緣--duration 0.05按住時(shí)長(zhǎng)double-tap雙擊觸發(fā)TapGesture(count: 2)--interval 0.05兩擊間隔swipe單指從起點(diǎn)拖到終點(diǎn)--duration 0.25拖拽時(shí)長(zhǎng)雙擊是新手最容易踩坑的一步連續(xù)跑兩條baguette tap是點(diǎn)不出雙擊的——每條命令光進(jìn)程啟動(dòng)就要 150~300 ms早就超過(guò)了 iOS 雙擊識(shí)別器約 250 ms 的聚合窗口。必須用專門命令讓四個(gè) HID 事件在同一個(gè)進(jìn)程內(nèi)完成baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 # 自定義節(jié)奏兩擊間隔 0.08s、每次按住 0.05s baguette double-tap --udid $UDID --x 201 --y 437 --width 402 --height 874 \ --interval 0.08 --duration 0.05單指上劃滾動(dòng)列表baguette swipe --udid $UDID --start-x 220 --start-y 800 \ --end-x 220 --end-y 200 --width 402 --height 874?? 雙指 pinch兩指捏合縮放一次到位單指玩到頭了雙指手勢(shì)走的是另一條注入通道兩指同時(shí)下壓的兩條并行事件事件。pinch 捏合 / 放大參數(shù)給中心點(diǎn) 兩指的起始、結(jié)束間距結(jié)束間距小于起始就是捏合縮小反之是張開(kāi)放大baguette pinch --udid $UDID --cx 201 --cy 437 \ --start-spread 240 --end-spread 80 --width 402 --height 874pan 雙指平移兩指保持間距平行拖動(dòng)常用于地圖平移baguette pan --udid $UDID --x1 150 --y1 400 --x2 250 --y2 400 \ --dx 0 --dy -300 --width 402 --height 874?? 如果你自己在寫腳本直接發(fā) WebSocket 事件捏合務(wù)必用touch2-*雙指系列。單指touch1-*能正確路由但 iOS 的UIPinchGestureRecognizer只會(huì)把它當(dāng)成普通拖動(dòng)。 Home 條系統(tǒng)手勢(shì)一條 press 命令直達(dá)這是 Baguette 最有意思的部分Home 條上劃、應(yīng)用切換器、鎖屏下拉、通知中心統(tǒng)統(tǒng)一條命令觸發(fā)。它把整條軌跡速度、停頓、起點(diǎn)位置都替你擺好了baguette press --udid $UDID --button swipe-to-home按鈕注入的軌跡iOS 的反應(yīng)swipe-to-home底部快速上劃約 12 步 ×16 msHome——回主屏幕swipe-to-app-switcher底部緩慢上劃 30 步 中點(diǎn)停頓約 900 ms應(yīng)用切換器——多任務(wù)卡片pull-down-to-lock-screen從屏幕左上 1/4 處緩慢下拉鎖屏蓋住下壓pull-down-to-notification-center從屏幕右上 3/4 處緩慢下拉通知中心Baguette 本身不做客戶端手勢(shì)判別——iOS 只認(rèn)速度、停頓時(shí)長(zhǎng)和起始橫坐標(biāo)所以效果與 Xcode 自帶模擬器里的手感完全一致設(shè)計(jì)細(xì)節(jié)見(jiàn) docs/features/touches/design.md。? 瀏覽器畫布上真實(shí)地拖 Home 條baguette serve的頁(yè)面畫布支持實(shí)時(shí)系統(tǒng)手勢(shì)從屏幕底部 7%區(qū)域開(kāi)始拖動(dòng)事件自動(dòng)帶上edge: bottomiOS 會(huì)一邊跟手一邊顯示 Home / 應(yīng)用切換器實(shí)時(shí)預(yù)覽從頂部 7%區(qū)域拖動(dòng)則帶edge: top拉出鎖屏或通知中心——跟隨你的真實(shí)拖速松手時(shí)不做任何罐頭回放。?? 橫屏?xí)r的坑edge 要跟著方向走edge標(biāo)記的是物理邊而非視覺(jué)邊。設(shè)備旋轉(zhuǎn)后edge: bottom可能對(duì)應(yīng)的是視覺(jué)上的右側(cè)——此時(shí) Home 手勢(shì)不會(huì)觸發(fā)。頁(yè)面會(huì)幫你自動(dòng)換算CLI 腳本則按此映射修正屏幕方向視覺(jué)底部的物理邊portrait豎屏bottomlandscape-leftrightportrait-upside-downrightlandscape-righttop拿不準(zhǔn)就直接用swipe-to-home/swipe-to-app-switcher按鈕它們永遠(yuǎn)從設(shè)備的豎屏底部發(fā)起旋轉(zhuǎn)由 iOS 自己消化。 常見(jiàn)問(wèn)題速查Gotchas 清單雙指 pinch 沒(méi)反應(yīng)確認(rèn)走的是touch2-*/pinch命令單指事件會(huì)被當(dāng)成 pan。{ok:true}之后 App 沒(méi)反應(yīng)回執(zhí)只代表消息成功送達(dá)模擬器不代表 App 已處理——驗(yàn)證失敗先看屏幕再重試。--width/--height填的是屏幕尺寸填成坐標(biāo)是雙指點(diǎn)擊、捏合失效的常見(jiàn)原因。所有輸入事件的信封格式edge、touch1-*、touch2-*詳見(jiàn) docs/wire.md。 延伸閱讀完整命令參考docs/commands.md觸摸與系統(tǒng)手勢(shì)設(shè)計(jì)原理IOHIDEvent 數(shù)字筆配方docs/features/touches/硬件按鍵home / lock / action 等docs/features/buttons/README.md手勢(shì)命令源碼Sources/Baguette/App/Commands/GestureCommands.swift搞定手勢(shì)注入只是開(kāi)始——Baguette 還有 60 fps 視頻流、3D 模型渲染和多設(shè)備農(nóng)場(chǎng)等著你全部寫在 docs/ 里?！久赓M(fèi)下載鏈接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm項(xiàng)目地址: https://gitcode.com/gh_mirrors/baguette/baguette創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考