A powerful macOS tool and CLI to generate professional App Store preview images and videos with ease.
AppStorePreview 是一款专为开发者设计的 macOS 工具，旨在高效、自动化地生成符合 App Store 审核标准的预览图（Screenshots）和预览视频（Preview Videos）。通过集成设备外框（Bezel）、多语言翻译、动态背景渐变等功能，本项目能够显著降低上架多国语言应用时的视觉素材准备工作量。
- 🚀 命令行工具 (CLI)：内置
asp命令，支持完全脱离界面的自动化渲染流程，完美适配 CI/CD。 - 📱 自动化外框合成：内置 iPhone 14, 15 Pro Max, 16 Pro Max 以及 iPad Air 13" 等机型的官方渲染外框。
- 🌍 多语言批量生成：支持根据配置文件自动读取不同语言（中、英、日、韩、德、法、阿等）的文案并合成预览图。
- 🎨 动态背景与布局：支持自定义背景渐变色、十六进制颜色 (#RRGGBB)、多行文本自动缩放适配（Minimum Scale Factor）。
- 🎬 视频预览生成：支持将一系列静态图片或渲染帧合成为符合 App Store 规范的视频文件。
- 🤖 自动化脚本支持：提供 Python 辅助脚本，实现源文件自动命名及配置文件的快速生成。
AppStorePreview 内置了快捷的命令行工具 asp。由于 App 处于沙盒环境，您需要通过以下方式完成安装：
- 打开 AppStorePreview 应用并切换到 "CLI Settings" 标签页。
- 复制提供的安装命令（推荐使用方法 1，或在无权限时使用方法 2）。
- 在终端中粘贴并执行，即可全局使用
asp命令。
# 查看帮助
asp --help
# 生成单张预览图
asp --input screen.png --output result.png --text "New Feature\nCheck it out" --bezel 16pm --bg "#1A2B3C"- 准备素材：将原始截图放入
AppStorePreview/Source Images目录下，按语言建立子文件夹。 - 初始化配置：在根目录下运行
python3 rename_images.py自动生成配置文件。 - 生成预览图：运行 App，在 "Get Preview Images" 标签页点击 "Export Images"。
- 生成预览视频：在 "Get Preview Video" 标签页，选择渲染后的图片并点击 "Export Video"。
本项目支持通过 DMG 方式进行分发。如果您需要自行构建发布版本：
- 确保安装了
create-dmg：brew install create-dmg。 - 复制配置文件模板：
cp .env.sh.example .env.sh并填入您的 Apple 开发者凭据。 - 运行构建脚本：
bash create_dmg.sh。 - 脚本会自动进行编译、导出、打包，并可选支持 Apple 公证（Notarization）。
- SwiftUI: 现代化、响应式的 macOS 原生 UI。
- AppKit: 处理底层图像渲染与导出。
- ImageRenderer: 利用 Apple 最新的渲染 API 实现高质量导出。
- Python: 用于预处理资源的辅助脚本。
- AppStorePreview/: 主应用源代码。
- Bezels/: 设备外框图片资源。
- PreviewEngine.swift: 核心渲染引擎（GUI/CLI 共享）。
- CLIHandler.swift: 命令行逻辑处理。
- .build/: 本地构建产物及缓存。
- create_dmg.sh: DMG 打包与分发脚本。
- 确保导出的图片分辨率符合苹果官方要求（如 16pm 为 1320 x 2868 px）。
- 背景颜色和渐变可以在
Assets.xcassets中灵活配置，或直接在 CLI 中使用 Hex。
Created by PK