App Store iPad Pro 截图尺寸不符 —— 修复指南

App Store Connect 因 Invalid Screenshot Dimensions 拒掉 iPad Pro 截图。2026 年起必填的是 13 英寸 2064x2752 槽位。给出对照表、sips 修复命令与 FAQ。

你把一套精修过的截图上传到 App Store Connect,拖进 iPad 槽位,屏幕上立刻飘出红条:“Invalid Screenshot Dimensions. Please make sure the screenshots are 2064 x 2752, 2752 x 2064, 2048 x 2732, or 2732 x 2048 pixels.” 你从 Figma 的”iPad Pro”预设导出,看着像那么回事;改用 Xcode 模拟器截图还是被拒。

最快的修复(截至 2026 年 6 月): iPad 截图现在必填的是 13 英寸显示屏,精确 2064 x 2752(竖)或 2752 x 2064(横)。从 iPad Pro 13-inch (M4) 模拟器截图,用 sips -g pixelWidth -g pixelHeight shot.png 确认尺寸,再重新上传即可。旧的 2048 x 2732(12.9 英寸)现在是 legacy 尺寸 —— 仍被接受,但不再是必填槽位,而且两者相差 16 / 20 像素,不能互通。

iPad 是 App Store Connect 上拒得最多的截图尺寸类,因为苹果在 2024-2025 年间改了必填尺寸,“12.9 英寸”这个叫法横跨好几代硬件,设计工具自带的”iPad Pro”预设也常常不对,而 App Store Connect 对像素是零容差的强制校验。

2026 年有什么变化

如果你上一次交截图是一年前,最容易被这点绊住:

  • iPad 必填槽位现在是 13 英寸(2064 x 2752,覆盖 iPad Pro(M5、M4)和 iPad Air(M4/M3/M2),取代了旧的 12.9 英寸槽。
  • 12.9 英寸(2048 x 2732 现在是 legacy 尺寸:针对第 2 代 iPad Pro 的 App 仍可用,但如果你只提供 13 英寸,苹果会自动给更小的设备下采样。大多数情况下你已经完全不需要 12.9 英寸了。
  • 11 英寸如果你什么都不传,苹果会用缩放后的 13 英寸截图。基本上不需要单独上传 11 英寸。

所以 2026 年最省事且正确的做法是:只交一套 2064 x 2752/2752 x 2064,剩下交给苹果缩放。 下面各节覆盖文件依然出错的各种情形。

常见原因

按频次排序。

1. 把 legacy 的 12.9 英寸尺寸(2048 x 2732)传到了 13 英寸槽

这现在是头号原因。你的截图是 2048 x 2732(2025 年之前所有教程用的尺寸),但当前必填槽位要的是 2064 x 2752。两者宽差 16 像素、高差 20 像素。

如何识别sips 显示 2048 x 2732,但槽位标签是”iPad 13-inch Display”(或在 App Store Connect 里映射到 13 英寸要求的”iPad Pro (3rd generation) 12.9-inch Display”)。

2. Figma 用了”iPad Pro”预设却没看实际像素

Figma、Sketch、Adobe XD 的”iPad Pro”预设默认是点尺寸(比如 1024 x 1366 ),不是像素。按 1x 导出就是半分辨率;按 2x 导出 1024 点的 frame 出来是 2048 x 2732,那是 legacy 尺寸,不是必填的 2064 x 2752

如何识别:图像信息显示 1024 x 13662048 x 2732,或任何宽度不是 2064 的尺寸。

3. fastlane / deliver 版本过旧,把合法尺寸也拒了

如果你用 fastlane deliver / upload_to_app_store 上传,旧版本拿着过时的设备表校验,会把正确文件以 Invalid screen size (Actual size is 2064x2752...) 拒掉,哪怕 App Store Connect 自己是接受的。fastlane 内置的设备表往往比苹果晚一两个版本更新,过时的副本可能误拒 2064 x 2752

如何识别:网页端接受文件,但 CI / fastlane 在同一张图上失败。修复:bundle update fastlane(或 gem update fastlane)升到最新版再重跑。

4. 截图里意外带了状态栏或设备外壳

模拟器的截图工具有时会捕捉到模拟器自身的外壳(圆角、底部 home 提示条)。App Store Connect 会拒掉带设备框的截图。

如何识别:截图边缘能看到圆角或一圈黑色 bezel。

5. 裁剪之后比例错了

你截了整屏然后裁掉状态栏,剩下的是类似 2064 x 2700 —— 不属于任何要求的尺寸,App Store Connect 拒。

如何识别:像素接近但不对(比如 2064 x 2700 而不是 2064 x 2752)。

6. JPEG/EXIF 来回转换后差一个像素

某些处理流水线会重新编码,OS 报告的尺寸略有出入(比如 2065 x 2753)。App Store Connect 的解析器是零容差。

如何识别sips -g pixelWidth -g pixelHeight screenshot.jpg 显示差 1 或差几个像素。

7. 带 alpha 通道或非 RGB 色彩 profile

App Store Connect 要求拍平的 RGB 图,且不带 alpha 通道。带透明度的 PNG、或者标记为 Display P3 的图,即使 sips 报的像素是对的,也可能以通用尺寸/格式错误被拒。

如何识别sips 显示尺寸正确,但上传仍失败。重新导出成平的 sRGB PNG(去掉 alpha)即可解决。

开始之前

  • 先打开苹果的权威清单:App Store Connect Help → Screenshot specifications。每次有新 iPad 硬件发布苹果都会更新。
  • 看清 App Store Connect 拒的是哪个槽位;槽位标签直接告诉你用哪一行尺寸。
  • 想清楚你到底要不要 13 英寸以外的东西。多数情况下不需要。

需要收集的信息

  • 被拒文件的精确像素:sips -g pixelWidth -g pixelHeight myshot.png
  • 方向(竖/横)—— App Store Connect 是分开校验的。
  • 来源:模拟器截图、Figma 导出、营销渲染等。
  • App Store Connect 中目标槽位的具体名字(例如”iPad 13-inch Display”)。
  • 色彩 profile、格式,以及是否带 alpha:sips -g all myshot.png | grep -E "format|profile|space|hasAlpha"
  • 如果走 CI 上传:你的 fastlane 版本(fastlane --version)。

修复步骤

步骤 1:确定槽位对应的目标尺寸

iPad 截图参考表(截至 2026 年 6 月,依据苹果规格页):

设备类别竖屏横屏状态
13 英寸(iPad Pro M5/M4、iPad Air M4/M3/M2)2064 x 27522752 x 2064必填
12.9 英寸(iPad Pro 第 2 代)2048 x 27322732 x 2048legacy,可选
11 英寸(iPad Pro M5/M4)1488 x 22662266 x 1488可选(自动缩放)
11 英寸(iPad Pro 第 4-1 代)1668 x 24202420 x 1668可选(自动缩放)

把槽位标签对到表中某一行,再按那一行的精确像素导出。对绝大多数人来说,就是第一行。

步骤 2:从对的模拟器出图

打开 Xcode → Window → Devices and Simulators → Simulators → +(Create New Simulator)→ 选 iPad Pro 13-inch (M4) 对应当前必填槽位。跑 App、导航到目标页面,然后在模拟器菜单栏:

Device → Trigger Screenshot

模拟器把 PNG 存到桌面,尺寸正好满足要求(无设备外壳、无 alpha)。验证:

sips -g pixelWidth -g pixelHeight ~/Desktop/Simulator\ Screenshot\ *.png

竖屏你要看到 pixelWidth: 2064pixelHeight: 2752

步骤 3:Figma / 设计工具导出时显式设帧像素

Figma 里建一个按像素的 frame,按 1x 导出:

Frame size: 2064 x 2752 px (not points)
Export at: 1x PNG

常见误区:frame 设成 1024 x 1366 点然后 2x 导出。那出来是 2048 x 2732,是 legacy 的 12.9 英寸尺寸,不是必填的 2064 x 2752。没有哪个基于点的 frame 能干净缩到 2064 x 2752,所以直接把像素尺寸写死。

步骤 4:用 sips 剥设备外壳 / 修差几个像素的图

截图里有状态栏残留、圆角,或差几个像素时,裁到精确尺寸。sips --cropToHeightWidth 参数顺序是先高后宽:

sips --cropToHeightWidth 2752 2064 input.png --out output.png

需要精确指定裁剪 offset(左上角为原点):

sips --cropOffset 0 0 --cropToHeightWidth 2752 2064 input.png --out output.png

验证结果:

sips -g pixelWidth -g pixelHeight output.png
# pixelWidth: 2064
# pixelHeight: 2752

裁剪(而不是缩放)能保持 UI 像素精确。如果源图本来就是另一种比例,应回模拟器重新截,而不是拉伸。

步骤 5:拍平到 sRGB 并去掉 alpha 通道

App Store Connect 要的是拍平的 RGB、无透明度。用 sips 转换:

sips --setProperty format png --setProperty profile sRGB \
  input.png --out output.png

要同时拍掉 alpha 通道(最常见的”静默被拒”原因),用 ImageMagick:

magick input.png -background white -alpha remove -alpha off \
  -colorspace sRGB -depth 8 output.png

确认 alpha 已去掉:

sips -g hasAlpha output.png
# hasAlpha: no

步骤 6:重新上传,留意槽位特定的校验提示

App Store Connect → 你的 App → 发布(Distribution)→ 对应 locale → iPad 截图 → 把修好的文件拖进对应槽位。这个拖拽区在客户端就校验尺寸;接受并且出现新缩略图就是对的。如果还拒,红条会告诉你期望尺寸 —— 拿到 sips 里再算一遍重新导出。

如果走 CI 上传,先跑 fastlane --version,升到最新版,让本地校验器与苹果当前的表一致。

步骤 7:把导出流水线脚本化

一段小 shell 脚本能省下后面十次手工。这段把图归一化到当前必填尺寸并逐个验证:

#!/bin/bash
# export-screenshots.sh — 把 iPad 截图归一化到 2026 必填尺寸
TARGET_W=2064
TARGET_H=2752
mkdir -p export
for src in raw/*.png; do
  out="export/$(basename "$src")"
  # 裁到精确尺寸(假设源图 >= 目标);要缩放就改用 --resampleHeightWidth
  sips --cropToHeightWidth "$TARGET_H" "$TARGET_W" \
       --setProperty format png --setProperty profile sRGB \
       "$src" --out "$out" >/dev/null
  echo "$out -> $(sips -g pixelWidth -g pixelHeight "$out" | tail -2 | tr '\n' ' ')"
done

每次截图完跑一遍,输出就是 App Store Connect 直接可用。

如何确认已修好

  • sips -g pixelWidth -g pixelHeight 对每个上传文件都报 2064 x 2752(或 2752 x 2064)。
  • sips -g hasAlphahasAlpha: no
  • App Store Connect 接受文件,不再有红条尺寸警告,槽位里出现新缩略图。
  • 如果用 fastlane,fastlane deliver 跑完不报 Invalid screen size
  • 预览上架页(上架后 App Store Connect 的”在 App Store 上查看”,或页面内预览);截图清晰显示,没有黑边。

长期预防

  • Xcode 模拟器截图当作 source of truth —— 尺寸保证正确,也不带外壳。
  • 把当前苹果的尺寸表硬编码进导出脚本;每次苹果发新硬件更新一次。
  • 永远别信设计工具的”iPad Pro”预设 —— 始终按精确像素建 frame 并按 1x 导出。
  • 把原始截图留在版本管理里,未来苹果增删设备类别时方便重新裁。
  • 每个版本的截图按 <version>-<locale>-<device-class>/ 命名存放,方便审计。
  • WWDC 苹果一发布新 iPad 硬件,预计几个月内必填槽位就会变 —— 在下次提交前更新流水线(以及你的 fastlane 版本)。相关 metadata 问题参考App Store 截图 metadata 问题

常见坑

  • 以为旧的 2048 x 2732 还是必填尺寸 —— 2026 年起必填槽位是 2064 x 2752
  • 1920 x 2560(或任何”差不多”的尺寸)并指望它给警告 —— App Store Connect 是直接拒。
  • fastlane 过旧,把网页端乐意接受的文件拒掉;升到最新版。
  • PNG 里留着 alpha 通道 —— 拍平它。
  • 让设计工具按 1.5x2.5x 缩放导出;只有”按 1x 导出精确尺寸的 frame”才能产生准确像素。
  • 修完之后传错文件 —— App Store Connect 有缓存,要确认新缩略图真的显示出来了。

FAQ

Q:2026 年 iPad 到底需要什么尺寸?

2064 x 2752(竖)或 2752 x 2064(横)—— 也就是 13 英寸显示屏槽位。交这一套,苹果会自动给 12.9 英寸和 11 英寸下采样。只有当你专门针对第 2 代 12.9 英寸 iPad Pro 准备了不同素材时,才需要 legacy 的 2048 x 2732

Q:网页端接受我的截图,但 fastlane 以 “Invalid screen size” 拒,为什么?

你的 fastlane 版本落后于当前 iPad 表 —— 内置设备列表仍会拒掉 2064 x 2752。跑 bundle update fastlane(或 gem update fastlane)升到最新版再重跑 deliver

Q:我的 App 只支持竖屏,需要交横屏截图吗?

不需要。只交你支持的方向。竖屏 App 交横屏截图,审核时可能因不一致被标记。

Q:能用营销渲染图代替真实截图吗?

可以加营销文案叠加,但不允许加设备外框,且底层 UI 必须真实 —— 审核员会与 App 实际行为对照。展示 App 没有的功能的风格化渲染,会招来 Guideline 2.3 / 4.3 拒信。

Q:App Store Connect 支持 WebP 或 HEIC 吗?

不支持 —— 只支持 PNG 和 JPEG,RGB,无 alpha 通道,每个设备类型 1 到 10 张。照片重的截图传 JPEG,UI 重的传 PNG。

Q:苹果为什么要精确像素,而不是把一切都下采样?

苹果确实会从 13 英寸母版下采样,但源图必须像素精确,缩放后才能在 Retina 屏上保持清晰。源图哪怕差一个像素、或是从更小截图放大来的,在设备上看着都发糊。

相关阅读

标签: #排查 #App Store #截图 #ipad-pro #Metadata