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 个最常见原因 绝大多数驳回都来自“手工导出 肉眼检查”驳回原因Apple 的硬性要求截图尺寸不对必须是目标设备的精确像素6.9 英寸为 1320×2868PNG 带透明通道截图不能含 alpha 通道必须是不透明像素预览视频时长越界必须落在 1530 秒区间内视频编码不规范H.264、30fps、必须有 AAC 音轨、单文件 ≤500MB这类错误靠人记规格表非常容易翻车。Goldie 的思路是规则写进代码而不是记在脑子里。Apple 截图与预览视频规则速查表Goldie 的规则集中在一个文件里src/specs.ts它对应 Apple 的 App Store Connect 截图规格与预览视频规格。核心数值如下素材Apple 要求尺寸其他硬性规则6.9 英寸截图1320×2868 PNG不允许透明通道按 rgb24 导出6.9 英寸预览视频886×1920H.264、30fps、15–30 秒、≤500MB、必须带 48kHz/256kbps AAC 音轨还有一个容易踩坑的细节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逐项检查视频检查项判定标准size886×1920codech264fps≤30duration15–30 秒audioAAC 48kHzfilesize≤500MB每一项都打印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——里面给出了 34 个片段、每段 47 秒的“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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考