SuperAPI AI 工具集

preview-data-generator

编程与开发

查看项目

更新于 10-16 09:52

技能介绍

用途:为 SwiftUI 视图准备 Xcode 画布所需的示例数据和预览变体,属于设计阶段的配套技能,与负责测试 fixture 的 testing/test-data-factory 区分。

主要能力:为每个模型生成 Model.preview 命名空间,包含真实实例和易暴露布局问题的边界数据(空、单条、超长列表、超长或溢出字符串、缺失图片、错误与加载状态);生成 #Preview 矩阵,覆盖数据状态、浅色/深色、动态字体、语言/RTL 和设备尺寸;对 SwiftData 视图生成内存种子容器;在 Xcode 16/iOS 18 上可用 PreviewModifier 缓存预览数据,用 @Previewable 保存状态。已有 Model.fixture() 时复用,不重复造数据。

使用方式:在生成前检测部署目标、目标视图及其模型、已有 fixture、是否使用 @Model、视图形态与平台,从而选择 #Preview、PreviewModifier 或 PreviewProvider。示例数据放入 Article+Preview.swift 等文件,预览块可附加到视图文件或单独的 +Previews 文件;仅预览代码用 #if DEBUG 包裹。生成后应说明创建的文件、集成步骤、所用 API 与测试方式。

适用场景:需要为预览准备 mock 数据、希望预览空/加载/错误/加载完成状态、做原型并需要深色/大字/RTL/设备变体、或需要 SwiftData 内存容器时。仅需单元测试 fixture 应使用 testing/test-data-factory;截图回归用 testing/snapshot-test-setup,可复用同一套数据与变体矩阵;无数据的简单视图用 Xcode 自动生成的 #Preview 即可;仅需本地化预览辅助可复用 generators/localization-setup。

限制:需自行判断并询问无法推断的信息(如需要哪些状态);具体命令、安装方式与价格等资料未提供;输出规模应随请求缩放,不应为简单标签生成大量预览。