需求
Liquid Glass 界面 API
默认选项
SwiftUI 提供的 glassEffect、GlassEffectContainer 和玻璃按钮样式
为什么需要
该技能应优先使用这些原生 API,这样 Codex 就能移除自定义模糊层,无需重新实现材质系统。
.md 即可查看该页面的 Markdown 版本。
Codex 使用场景
使用 Codex,通过 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。
使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。
使用 Codex,通过 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。
使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。
使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。
| 技能 | 使用理由 |
|---|---|
| Build iOS Apps | 使用 SwiftUI Liquid Glass、SwiftUI 界面模式和模拟器调试技能,更新现有 iOS 界面,采用原生玻璃效果,并在 iOS 26 模拟器上验证结果。 |
采用 Liquid Glass 时,先从迁移到 iOS 26 和 Xcode 26 入手。使用 iOS 26 SDK 重新构建应用,看看标准 SwiftUI 控件自动获得了哪些新效果。然后再请 Codex 重新设计那些仍然显得过于扁平、厚重,或与系统界面风格不协调的自定义部分。
如果应用仍需支持较早的 iOS 版本,请一开始就明确这一要求。Build iOS Apps 插件中的 SwiftUI Liquid Glass 技能应使用 #available(iOS 26, *) 检查系统版本,仅在 iOS 26 及更高版本上调用玻璃效果专用的新 API,同时保留在旧设备上也能清晰呈现内容的回退方案。
如果您希望 Codex 修改 SwiftUI 界面并在模拟器中验证效果,可以使用 Build iOS Apps 插件。迁移到 Liquid Glass 时,可以先请 Codex 检查一个使用流程,迁移其中少量界面元素,然后在 iOS 26 模拟器中启动应用并截图,再扩大迁移范围。
该插件包含 SwiftUI Liquid Glass 技能。您可以把这项技能默认遵循的几条原则写入提示词:
glassEffect、GlassEffectContainer、玻璃按钮样式和 glassEffectID 转场效果,尽量避免自定义模糊视图。.glassEffect(...),让玻璃材质贴合您想要的最终形状。GlassEffectContainer 中。.interactive()。在请 Codex 重构生产应用中的实际流程之前,可以先参考以下 WWDC25 讲座:
迁移到 Liquid Glass 时,先让 Codex 回答“哪些地方应该使用玻璃效果?”这个问题。比起一开始就要求“现在写出全部代码”,这样更容易推进迁移。先请智能体快速检查现有界面,再让它完成一项可以独立实施的改动,并在模拟器中验证效果。
Liquid Glass 应让内容上方的控件层清晰可辨。给每张卡片都加上玻璃效果,会让它们看起来像一块块发光的面板。请 Codex 移除与系统材质不协调的装饰性背景,在可读性最重要的地方保持内容呈现简洁,仅在需要通过颜色强调特定含义或突出主要操作时着色。
首次迁移时,可以选择一个标签页的根视图、一个详情页、一个模态弹出页、一个搜索界面或一段新用户引导流程。这样通常比一次改动整个应用更合适,也更容易审查改动,判断哪些 Liquid Glass 设计适合提炼为可复用的组件模式。
如果您的最低部署版本低于 iOS 26,请 Codex 并排展示回退实现和 Liquid Glass 版本。这样可以在审查时发现因误用旧系统不支持的 API 而引入的兼容性问题,避免发布只能在最新版模拟器上运行的迁移版本。
需求
默认选项
为什么需要
需求
Liquid Glass 界面 API
默认选项
SwiftUI 提供的 glassEffect、GlassEffectContainer 和玻璃按钮样式
为什么需要
该技能应优先使用这些原生 API,这样 Codex 就能移除自定义模糊层,无需重新实现材质系统。
需求
平台基准版本
默认选项
iOS 26 和 Xcode 26
为什么需要
iOS 26 SDK 引入了 Liquid Glass。Codex 应使用 Xcode 26 编译应用,并为较早的系统版本显式添加回退逻辑。
需求
模拟器验证
默认选项
为什么需要
迁移界面时,构建并启动应用、截图和检查日志都是重要步骤,尤其是在核对不同界面状态和设备尺寸下的显示效果时。
| 需求 | 默认选项 | 为什么需要 |
|---|---|---|
| Liquid Glass 界面 API | SwiftUI 提供的 glassEffect 、 GlassEffectContainer 和玻璃按钮样式 | 该技能应优先使用这些原生 API,这样 Codex 就能移除自定义模糊层,无需重新实现材质系统。 |
| 平台基准版本 | iOS 26 和 Xcode 26 | iOS 26 SDK 引入了 Liquid Glass。Codex 应使用 Xcode 26 编译应用,并为较早的系统版本显式添加回退逻辑。 |
| 模拟器验证 | XcodeBuildMCP | 迁移界面时,构建并启动应用、截图和检查日志都是重要步骤,尤其是在核对不同界面状态和设备尺寸下的显示效果时。 |