iOS营销截图

📌 Skill 基础信息

Skill 名称: ios-marketing-capture

简称: iOS 营销截图自动化工具

来源: 社区第三方（ParthJadhav）

运行宿主: Claude-Code CLI

核心定位: 为 SwiftUI iOS 应用提供跨多语言、多设备的自动化营销截图捕获解决方案，适用于应用商店素材制作和本地化测试场景。

🧩 内部核心组成

核心能力模块

• 全屏截图系统: 基于应用内捕获模式，非 XCUITest 方案
• 元素独立渲染: 支持卡片、小组件、图表等组件的透明背景渲染
• 本地化支持: 多语言环境自动切换和截图
• 状态预置机制: DEBUG-only 的状态注入系统
• 协调器架构: 基于步骤的自动化执行流程

目录结构

<AppName>/Debug/MarketingCapture.swift     # 核心捕获系统
<AppName>/Debug/DemoDataSeeder.swift       # 演示数据播种器
scripts/capture-marketing.sh               # 自动化执行脚本
templates/                                 # 参考模板文件

核心命令/工具

组件类型	功能简述
MarketingCaptureCoordinator	步骤式执行协调器，管理截图流程
CaptureStep 结构体	定义单个截图步骤的导航、等待和清理逻辑
MarketingElementHarness	独立元素渲染处理器
capture-marketing.sh	构建安装和本地化循环脚本

🛠 安装与启用方式

安装命令:

skills install --user ParthJadhav/ios-marketing-capture

前置依赖:

• Xcode 开发环境
• SwiftUI iOS 项目
• 可用的 iOS 模拟器
• DEBUG 编译配置

关键步骤:

1. 将 MarketingCapture.swift 添加到主应用目标的 Debug 目录
2. 在根视图中添加 DEBUG 钩子用于数据播种和协调器执行
3. 配置需要预置状态的视图
4. 放置 capture-marketing.sh 脚本文件
5. 在 .gitignore 中添加 marketing/ 输出目录

📋 标准工作流

1. 需求收集阶段: 依次确认截图屏幕、独立元素、支持语言、设备类型、外观模式和演示数据状态
2. 代码库探索: 分析项目导航模式、深层链接路由、数据播种机制和小组件架构
3. 方案设计确认: 向用户展示完整的捕获计划并获得明确批准
4. 实现阶段: 基于模板创建 MarketingCapture 系统，配置步骤序列和状态预置
5. 验证执行:

- 构建应用并安装到模拟器

- 按语言循环启动应用并执行捕获步骤

- 视觉验证输出 PNG 文件

- 迭代修复问题并重新运行

⚠️ 关键限制、缺陷、注意事项

平台限制:

• 仅支持 iOS SwiftUI 应用
• 需要 DEBUG 编译配置
• 依赖模拟器环境，不支持真机直接捕获

Token 消耗: 中等，需要分析项目结构和编写适配代码

适用项目类型:

• SwiftUI 架构的 iOS 应用
• 需要多语言营销素材的项目
• 有明确导航结构的应用

不适用场景:

• UIKit 或混合架构应用
• 无明确导航状态的复杂应用
• 需要真机截图的场景

已知坑点:

• Live Activities / ActivityKit 支持有限
• SwiftData + CloudKit 同步可能存在问题
• 导航状态清理需要特别注意顺序

生产环境适用性: 仅适用于开发测试环境，不适合生产环境部署

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景:

• SwiftUI iOS 应用的营销素材制作
• 多语言应用商店截图自动化
• 需要高质量组件独立渲染的项目
• 替代 Fastlane snapshot 的轻量级方案

❌ 不适合场景:

• UIKit 或 Objective-C 项目
• 需要真机截图的生产环境
• 无明确导航状态的复杂应用
• 需要深度 UI 测试验证的场景

skills install --user ParthJadhav/ios-marketing-capture