SuperAPI AI 工具集

stratos-swiftui

通用与其它

查看项目

更新于 10-16 08:04

技能介绍

用途:该技能用于设计和审查可复用的 SwiftUI 组件,让组件在调用处读起来自然、符合 Apple 原生习惯。适用于自定义视图、按钮、卡片、徽章,以及 ViewModifier 扩展、*Style 与 *StyleConfiguration 协议、通过 EnvironmentValues(@Entry)传播主题或组件设置等场景。

主要能力:以“调用点优先”为原则,先展示期望的调用方式,再实现视图、修饰符与样式协议;采用分层模型(对流层、平流层、中间层、热层),从零配置初始化器逐步提升到语义修饰符、环境主题与自定义 Style 协议;支持容器视图、@Observable 模型配 @Bindable、语义化修饰符链、@Entry 环境值、自定义 Style 协议等模式。

使用方式:构建组件时先写第 1、2、4 层的调用片段,再实现;从 @ViewBuilder 初始化器和 LocalizedStringKey 便捷重载开始,添加语义修饰符,用 @Entry 传播主题,仅在调用方需要替换内部视图层级时才引入自定义 Style。审查组件时检查样式参数是否污染主初始化器、@Observable 视图模型是否标注 @MainActor、是否使用已软弃用的 API 以及图标按钮是否具备无障碍标签。

适用场景:需要可复用、可组合、调用体验良好的 SwiftUI 组件库或应用内组件设计时。

限制:部分能力有系统版本要求,如 @Animatable 需 iOS 26+/macOS 26+,@Entry 需 iOS 18+/macOS 15+;SDK 27 起 @State 改为宏、多个构建器属性统一为 @ContentBuilder,升级后遇到相关错误不应重排初始化赋值。该资料未提供安装命令、价格或平台信息。