SuperAPI AI 工具集

swift-ios-migration

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:面向已有 Swift/iOS 代码的版本升级与迁移,覆盖并发模型的破坏性变更适配和 iPadOS 26 窗口系统迁移。

主要能力:技能目录包含 SKILL.md 与 references/ 下的四份参考文档:ios17-observable.md 提供 ObservableObject 到 @Observable 的迁移模式、@Bindable 替代 @Published/@Binding、@Environment 变更、按属性粒度监听的性能提升及兼容性注意点;swift6-concurrency.md 覆盖 @MainActor 应用于 ViewModel、Sendable 数据模型设计、Strict Concurrency Checking 清单及常见警告(如 Non-sendable type captured、Actor-isolated property cannot be mutated)的解决;swift62-changes.md 涉及 Approachable Concurrency、默认 Actor 隔离为 MainActor、@concurrent 显式后台执行以及 Xcode 26 相关变化;ipados26-windowing.md 涉及移除 UIRequiresFullScreen、UIWindowScene.Geometry 与 effectiveGeometry、UISceneSizeRestrictions、方向锁定、菜单栏与多窗口支持、Trait Collection 适配。

使用方式:按迁移目标查阅对应参考文档。iOS 17 迁移时先在新代码使用 @Observable,再从小型 ViewModel 逐步迁移;Swift 6 迁移时启用严格并发检查、为 ViewModel 添加 @MainActor、使数据模型符合 Sendable 并逐个消除警告;Swift 6.2 迁移时启用 Approachable Concurrency、将默认 Actor 隔离设为 MainActor,并在需要处添加 @concurrent;iPadOS 26 适配时从 Info.plist 移除 UIRequiresFullScreen、用 Auto Layout 实现尺寸自适应并设置最小尺寸。资料给出各迁移方向的推荐优先级顺序,建议从新代码和小型模块入手,大型 ViewModel 谨慎处理。

适用场景:Swift/iOS 项目升级到对应系统与语言版本时的迁移改造及警告清理。

限制:资料未提供安装命令、价格或授权信息,也未说明具体支持的平台与维护状态;各参考文档的完整技术细节未在给出的资料中展开。