Goldie如何保证App Store素材100%一次过审：Apple截图尺寸与预览视频规则深度解析

Goldie如何保证App Store素材100%一次过审：Apple截图尺寸与预览视频规则深度解析

【免费下载链接】goldie✨ agentic app store previews and screenshots项目地址: https://gitcode.com/gh_mirrors/gol/goldie

提交 App Store 时，你是否因为“尺寸不对”或“视频太长”被审核反复打回？Goldie是一个开源的 App Store 素材生成工具，它能自动产出 6.9 英寸截图（1320×2868）与 App Store 预览视频（886×1920），并在导出前用 Apple 官方规则逐项自检，让素材一次过审。本文深度解析截图与预览视频两套硬性规则，以及 Goldie 如何把它们“写死”在流水线里。

App Store 素材审核打回：4 个最常见原因

🔍 绝大多数驳回都来自“手工导出 + 肉眼检查”：

这类错误靠人记规格表非常容易翻车。Goldie 的思路是：规则写进代码，而不是记在脑子里。

Apple 截图与预览视频规则速查表

Goldie 的规则集中在一个文件里：src/specs.ts，它对应 Apple 的 App Store Connect 截图规格与预览视频规格。核心数值如下：

还有一个容易踩坑的细节：Apple 建议预览视频采用10–12 Mbps 可变码率，Goldie 默认固定为 11 Mbps，既清晰又不会超标。


Goldie 会把模拟器实拍画面放进设备边框（bezel）再合成成 App Store 截图，项目 assets/ 目录内置了多套高分辨率设备边框，可直接用于合成。

Goldie 如何把规则硬编码进流水线

1️⃣ 规则集中化：一份规格表管全链路

所有尺寸、帧率、时长、码率都定义在 src/specs.ts。生成阶段和校验阶段读的是同一张表——未来规则更新，只需改这一个文件，不会“生成按新规、校验按旧规”。

2️⃣ 截图自动去透明通道

画布绘制天然输出 RGBA，而 App Store 会拒收带透明通道的截图。src/render.ts 在落盘时用 ffmpeg 强制转成 rgb24，从根上杜绝透明问题；只有用户显式配置透明背景（用于二次合成）才保留 alpha，且校验时会明确标注“不可直接上传”。

3️⃣ 预览视频时长越界直接拒绝渲染

合成预览视频时，src/render.ts 会先累加所有片段的实际时长，一旦超出 15–30 秒立即报错并给出调整建议，避免“渲染十分钟、上传时才差 2 秒”的尴尬。

另外，预览视频会按“纯屏幕录像”合成：不加边框、不加背景、不加字幕——这些正是 Apple 明确不允许出现在预览视频中的元素。即使没有音乐，也会自动补一条静音 AAC 音轨，因为 Apple 要求音轨必须存在。

4️⃣ goldie verify 六项自检清单

流水线最后一步是 verify 校验：用sips检查每张截图的像素宽高与是否有 alpha 通道，用ffprobe逐项检查视频：

每一项都打印ok或FAIL，任何一项不过，goldie all就不会让你“带着病”提交。

生成前的兜底自查：goldie doctor

在真正截图前，goldie doctor 会先对环境和素材做一次体检：xcrun、ffmpeg、argent 是否就绪、目标模拟器是否安装、App 是否为 Release 构建（Debug 构建会把开发警告横幅画进截图）、argent 视频水印是否已关闭（带水印的预览视频会被直接拒收）。每项检查失败时，还会打印一条可直接执行的修复命令。

三步走完一次过审的工作流

完整命令清单见 src/cli.ts，日常只需要三步：

npm i -g goldie # 安装 CLI goldie doctor # 环境自检 goldie all # 采集 → 合成 → 渲染预览视频 → 逐项自检

想换背景、字体、边框或排版节奏，用goldie studio打开浏览器设计页实时预览，保存的设计与 CLI 导出逐像素一致。配置项详解见 skills/goldie/references/config.md，如何编写 App 交互流程（flow）来产出每一帧截图和每个视频片段，见 skills/goldie/references/flows.md——里面给出了 3～4 个片段、每段 4～7 秒的“15–30 秒”节奏建议。

小结：一次过审的关键

• 规则数据化：尺寸与编码参数集中在 src/specs.ts，生成与校验共用一份真相
• 问题提前拦：透明通道自动剥离、视频时长越界即报错、环境先体检
• 导出全自检：verify逐项输出 ok/FAIL 报告，不看规格表也能放心提交

把查尺寸表的功夫省下来，让 Goldie 的规则引擎保证你的 App Store 截图与预览视频 100% 一次过审 🎉

【免费下载链接】goldie✨ agentic app store previews and screenshots项目地址: https://gitcode.com/gh_mirrors/gol/goldie