阳孙应用工作室
返回博客列表
2026-11-176 分钟技术

iPhone Duo 内屏截图怎么做?simctl --display 3 与折叠姿态脚本化

给 iPhone Duo 模拟器截内屏图,很多人第一步就卡住:xcrun simctl io booted screenshot out.png 直接报 Invalid argument。原因很简单——Duo 有两块屏,simctl 不知道你要哪块。

正确命令:--display 3

xcrun simctl io booted screenshot --display 1 cover.png   # 外屏 1398×2034
xcrun simctl io booted screenshot --display 3 inner.png   # 内屏 2853×2007(横持)

内屏横持是 951×669pt @3x = 2853×2007px,这正是 App Store Connect 的 APP_IPHONE_DUO 槽位要求的尺寸。

为什么截出来是全黑?

因为设备还合着。合盖时内屏关闭,UI 在外屏。先展开再截,而且展开后显示切换有 1–2.5 秒延迟:

brew install artemnovichkov/tap/hinge   # 免费 MIT,无需 Mac App Store、无需 sudo
hinge open
sleep 2.5
xcrun simctl io booted screenshot --display 3 inner.png

simctl 和 devicectl 都没有折叠命令,Device Hub 只有隐藏滑杆(按住 Option)。hinge 用 CoreMotion 回读角度,折不动会报错而不是假成功。

横屏出不来?两个坑

  1. 启动时序:在已展开的 Duo 上直接 launch,app 可能留在竖屏。可靠顺序是「合盖 → launch → 展开」。
  2. 方向掩码:portrait-only 的 app 在内屏不会自动横屏(实测如此)。要给 iPhone 加 LandscapeLeft/Right,再按 horizontalSizeClass 在 delegate 里返回掩码。

布局上还要注意:内屏顶部 safe area 约 84pt,右侧有约 81pt 系统保留带,写死的顶部 inset 会把内容压到状态栏下。

工具怎么选

一次性截图,hinge + simctl 就够。要按语种×分区批量出 ASC 资产、或让 Claude Code/Cursor 通过 MCP 直接驱动 Duo,可以看看 duokit:免费 CLI + lint,Pro 买断 $19 出完整矩阵。

duokit

#iPhone Duo#simctl#Xcode#hinge#duokit#截图#折叠屏