SuperAPI AI 工具集

swiftui-whats-new-27

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:说明 SDK 27(2027 年系统版本)中 SwiftUI 的新 API、行为变化、源码不兼容与弃用项,用于在编写或修改相关代码前查阅权威变更,并处理构建错误、弃用警告和已知 API 变化;也可用于回答「SDK 27 中 SwiftUI 有什么新东西」这类问题。资料强调不得臆造参考文件中未记录的 API 或参数,同名重载的闭包签名与行为可能不同,凭记忆选择会导致编译失败或运行行为错误。

主要能力与用法:使用任何新增或变更的 SDK 27 SwiftUI API 前,先阅读对应的 references/*.md。遇到使用 @State 的视图在 SDK 更新后出现编译错误时,必须先查阅 references/state-macro.md;常规做法(调整 init 赋值顺序)并不正确,会造成运行行为错误。

内容要点:reorderable.md 提供任意容器(List、堆栈、网格、自定义布局)的拖拽重排,通过 ForEach 的 .reorderable() 与 .reorderContainer(for:),涉及 ReorderDifference apply、分区与多集合、拖放集成及逐子项 dropDestination。async-image.md 说明 AsyncImage 默认采用标准 HTTP 缓存,新增 AsyncImage(request:) 与 asyncImageURLSession(_:)。toolbar.md 涉及受限空间下工具栏的可见性与溢出控制(visibilityPriority、ToolbarOverflowMenu、.topBarPinnedTrailing、toolbarMinimizeBehavior、contentMarginsRemoved、ToolbarPlacement.statusBar,以及 ForEach/EmptyView 支持)。item-binding.md 提供接收 item: Binding<T?> 的 confirmationDialog 与 alert 重载。swipe-actions.md 让滑动操作可用于任意可滚动容器。document-based-apps.md 介绍 ReadableDocument / WritableDocument 等新文档 API。content-builder.md 说明 @ContentBuilder 带来的源码不兼容。deprecations.md 列出 SDK 27.0 硬弃用 API(如 visionOS 的 statusBarHidden 无效果,应移除调用)。

限制:各 API 可用平台与最低版本不一(部分仅 iOS/macOS/watchOS/visionOS,tvOS 不可用),需查阅参考文件中的表格;软弃用 API 由 swiftui-specialist 技能覆盖。