Baguette 键盘、剪贴板与状态栏：文本输入、Unicode粘贴与状态栏覆写完全指南

Baguette 键盘、剪贴板与状态栏文本输入、Unicode粘贴与状态栏覆写完全指南【免费下载链接】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 iOS 模拟器的无头Headless控制工具让你不打开 Xcode 或 Simulator.app就能对模拟器进行键盘输入、任意 Unicode 文本粘贴和状态栏覆写。本教程带你快速掌握baguette key、baguette type、baguette paste与baguette status-bar四组核心命令轻松完成自动化填表、Emoji 输入与 App Store 级演示截图。一、为什么需要这三件套在自动化 iOS 应用时你通常会遇到三个高频场景场景痛点Baguette 的解法填写表单需要逐键模拟key按单键、type整串打字输入 Emoji / 中文 / 法语重音按键模拟只支持 US-ASCIIpaste走剪贴板任意 Unicode 原样落地拍演示截图电量、信号、时间太真实status-bar override一键定格 9:41 满电满格三者共享同一个前提目标设备必须已启动baguette boot --udid UDID。完整命令参数见官方文档 commands.md。二、键盘输入教程baguette key 与 type 一键打字按单个键baguette keybaguette key --udid UDID --code Enter baguette key --udid UDID --code KeyA --modifiers shift,command支持的按键覆盖KeyA–KeyZ、Digit0–Digit9、数字键盘、Enter/Escape/Backspace/Tab/Space、方向键和 US 布局标点修饰键支持shift、control、option、command四种组合。键码采用 W3CKeyboardEvent.code命名浏览器与 CLI 共用同一套编码无需转换。整串打字baguette typebaguette type --udid UDID --text Hello, world!type会把字符串逐字符拆解为按键 修饰键序列例如A→KeyA shift!→Digit1 shift后依次下发。键盘输入的三条边界不支持 IME 输入法拼音、日韩候选词无法走这条路径不支持 Emoji 与重音字符é/中/ 会被明确拒绝避免字符串中途静默丢字——这类内容请改用下一节的pasteF 键与 Page Up/Down 不转发它们会留给宿主机浏览器处理。底层实现按键通过 HID 页面 7 的 usage 码注入模拟器修饰键会被按下→按键→松开成对包裹详见设计文档 docs/features/keyboard/design.md领域模型在 Key.swift 与 Keyboard.swift。三、剪贴板与 Unicode 粘贴突破纯 ASCII 限制baguette type受 US 键盘布局限制而paste走的是模拟器的剪贴板pasteboard因此Emoji、重音符号、中日韩文字都能完整落地baguette paste --udid UDID --text héllo # 先写剪贴板再自动按 CmdV baguette paste --udid UDID --text x --no-press # 只写剪贴板不按快捷键为什么不能直接把 CmdV 当普通按键转发因为那样 iOS 只会粘贴它自己的空剪贴板。paste在服务器端闭环先把文本写入模拟器剪贴板成功后再下发 CmdV两步有序执行写入失败绝不会误触发按键。剪贴板双向同步baguette clipboardbaguette clipboard get --udid UDID # 读取模拟器剪贴板文本类似 pbpaste baguette clipboard copy --udid UDID # 模拟器 → 宿主机 Mac支持图片 baguette clipboard sync --udid UDID # 宿主机 Mac → 模拟器图片全保真copy是纯搬运按下 CmdC 让当前输入框复制选区稳定约 200 ms 后把剪贴板同步到宿主机 Mac。两个值得注意的细节复制依赖视图响应 CmdC不可编辑视图按 CmdC 无效此时只会搬运剪贴板已有内容浏览器端的 CmdC 落在运行 baguette 的那台 Mac 上局域网远程浏览时不会落到你自己的电脑剪贴板。实现位于 Paste.swift、Copy.swift 与 Pasteboard.swift完整行为与踩坑说明见 docs/features/paste/README.md。四、状态栏覆写9:41 完美演示状态一键搞定拍演示图 / App Store 截图时真实的电量、信号、时间会抢戏。status-bar命令把 Xcode 模拟器菜单里的 Status Bar 功能搬到了 CLI、HTTP 接口和浏览器面板# 经典演示状态9:41、满格信号、满电 baguette status-bar override --udid UDID \ --time 9:41 --operator-name Baguette \ --data-network 5g --cellular-bars 4 --wifi-bars 3 \ --battery-state charged --battery-level 100 baguette status-bar clear --udid UDID # 清除覆写恢复实时值可覆写的字段包括时间、运营商名称、数据网络类型Wi-Fi / 4g / 5g、Wi-Fi 与蜂窝模式及信号格数、电池状态与电量百分比。覆写行为的实用规则只发改过的字段HTTP POST 单字段如{wifiBars:1}只更新对应指示器其余保持原值越界值自动夹紧Wi-Fi 格数收到 0–3、蜂窝 0–4、电量 0–100不会让命令报错枚举值写错会大声失败返回 400 而不是静默丢弃覆写随设备保留跨 App 启动仍然生效但模拟器重启或抹除后会清除CLI 无法读回当前覆写需要用 HTTPGET /simulators/UDID/status-bar查询。浏览器里更省事打开聚焦模式页面点工具栏的信号格按钮即可实时调整改动 250 ms 防抖后逐字段下发结果直接体现在 60 fps 直播流里。源码在 Sources/Baguette/Domain/StatusBar设计说明见 docs/features/status-bar/design.md。五、浏览器端serve 页面的键盘与粘贴体验运行baguette serve后Web UI 位于http://127.0.0.1:8421/simulators点击设备屏幕获得焦点即可直接用宿主机键盘操作 iOS焦点门控屏幕聚焦时受支持的按键全部转发给 iOS浏览器快捷键如 CmdR被接管焦点移开后浏览器恢复正常粘贴组合键特殊处理CmdV / CtrlV 交给浏览器触发原生 paste 事件剪贴板文本再走paste通道进模拟器因此局域网普通 http 下也无需权限弹窗复制同理CmdC 由服务端在模拟器侧按下结果直接同步到宿主机 Mac 剪贴板。六、常见问题速查 问题原因与对策type输入中文报解析错误属预期行为US 布局只支持 ASCII改用paste需要输入 Emojibaguette paste --text 走剪贴板无损传递粘贴没反应确认设备已 boot写入剪贴板失败时不会按下 CmdV状态栏覆写不生效检查枚举拼写clear后确认已恢复实时值想读回状态栏覆写用 HTTP GET 接口CLI 不提供读取相关资料功能文档键盘 · 粘贴与剪贴板 · 状态栏全量命令参考docs/commands.md硬件按键Home / 音量 / Action 键docs/features/buttons/README.md领域源码Sources/Baguette/Domain/Input · Sources/Baguette/Domain/Pasteboard【免费下载链接】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），仅供参考