Need
Liquid Glass UI API
Default options
SwiftUI ，搭配 glassEffect、GlassEffectContainer 和玻璃效果按钮样式
Why it's needed
这些是该技能应优先采用的原生 API，以便 Codex 移除自定义模糊层，而不是重新构建材质系统。
Codex use case
采用 Liquid Glass
使用 Codex，利用 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。
Difficulty 高级
Time horizon 1 小时
使用 Codex 和 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，以原生 Liquid Glass 替换自定义模糊或材质层叠，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
最适合
- 需要切实可行的 iOS 26 Liquid Glass 迁移方案（而非含糊的重新设计简报）的现有 SwiftUI 应用
- 希望 Codex 审查自定义卡片、工作表、标签栏、工具栏和操作按钮，再分块实施迁移的团队
- 仍需支持较早 iOS 版本，并需要通过 `#available(iOS 26, *)` 提供回退方案，而不是进行不可逆视觉重写的应用
Contents
采用 Liquid Glass
使用 Codex，利用 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。
使用 Codex 和 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，以原生 Liquid Glass 替换自定义模糊或材质层叠，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
高级
1 小时
使用 Codex 和 Build iOS Apps 插件审查现有 iPhone 和 iPad UI，以原生 Liquid Glass 替换自定义模糊或材质层叠，并通过 iOS 26 可用性检查和模拟器驱动的验证确保迁移安全。
高级
1 小时
最适合
- 需要切实可行的 iOS 26 Liquid Glass 迁移方案（而非含糊的重新设计简报）的现有 SwiftUI 应用
- 希望 Codex 审查自定义卡片、工作表、标签栏、工具栏和操作按钮，再分块实施迁移的团队
- 仍需支持较早 iOS 版本，并需要通过 `#available(iOS 26, *)` 提供回退方案，而不是进行不可逆视觉重写的应用
技能与插件
- 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模拟器调试技能，对 iOS 屏幕进行现代化改造，采用原生玻璃效果，并在 iOS 26 模拟器上验证结果。
| Skill | Why use it |
|---|---|
| Build iOS Apps | 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模拟器调试技能，对 iOS 屏幕进行现代化改造，采用原生玻璃效果，并在 iOS 26 模拟器上验证结果。 |
入门提示
使用 Build iOS Apps 插件及其 SwiftUI Liquid Glass 技能，将此应用中的一个高频流程迁移到 Liquid Glass。
限制：
- 将此次任务作为一次 iOS 26 + Xcode 26 迁移来处理，但要通过 `#available(iOS 26, *)` 为较早的部署目标保留非玻璃效果回退方案。
- 先审查此流程。指出哪些自定义背景、模糊层叠、标签块、按钮、工作表和工具栏应改用原生 Liquid Glass 效果，并指出哪些界面区域应保持普通内容样式。
- 优先使用系统控件以及 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)` 等原生 API，而不是自定义模糊效果。只有在真正的形变过渡能改善流程时，才将 `glassEffectID` 与 `@Namespace` 配合使用。
- 在布局和视觉修饰符之后应用 `glassEffect`，保持形状一致，并且只对真正响应触控的控件使用 `.interactive()`。
- 使用 XcodeBuildMCP 在 iOS 26 模拟器上构建并运行，截取迁移后流程的屏幕截图，并明确说明所用的构建方案、模拟器和检查项。
交付内容：
- 此流程的简明迁移方案
- 已实现的 Liquid Glass 迁移部分
- 面向 iOS 26 之前版本设备的回退行为
- 所采用的模拟器验证步骤和屏幕截图
使用 Build iOS Apps 插件及其 SwiftUI Liquid Glass 技能，将此应用中的一个高频流程迁移到 Liquid Glass。
限制：
- 将此次任务作为一次 iOS 26 + Xcode 26 迁移来处理，但要通过 `#available(iOS 26, *)` 为较早的部署目标保留非玻璃效果回退方案。
- 先审查此流程。指出哪些自定义背景、模糊层叠、标签块、按钮、工作表和工具栏应改用原生 Liquid Glass 效果，并指出哪些界面区域应保持普通内容样式。
- 优先使用系统控件以及 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)` 等原生 API，而不是自定义模糊效果。只有在真正的形变过渡能改善流程时，才将 `glassEffectID` 与 `@Namespace` 配合使用。
- 在布局和视觉修饰符之后应用 `glassEffect`，保持形状一致，并且只对真正响应触控的控件使用 `.interactive()`。
- 使用 XcodeBuildMCP 在 iOS 26 模拟器上构建并运行，截取迁移后流程的屏幕截图，并明确说明所用的构建方案、模拟器和检查项。
交付内容：
- 此流程的简明迁移方案
- 已实现的 Liquid Glass 迁移部分
- 面向 iOS 26 之前版本设备的回退行为
- 所采用的模拟器验证步骤和屏幕截图
从 iOS 26 基线开始
首先，将 Liquid Glass 视为一项 iOS 26 和 Xcode 26 迁移项目。使用 iOS 26 SDK 重新构建应用，查看标准 SwiftUI 控件能自动呈现哪些效果，然后再让 Codex 重新设计那些看起来仍然过于扁平、厚重或与系统界面元素脱节的自定义部分。
如果应用仍支持较早的 iOS 版本，请从一开始就明确这项约束。 Build iOS Apps 插件 中的 SwiftUI Liquid Glass 技能应使用 #available(iOS 26, *) 为新的 Liquid Glass 专用 API 添加可用性判断，同时保留一条在较旧设备上仍具备良好可读性的回退路径。
善用 iOS 插件
如果您希望 Codex 将 SwiftUI UI 变更与基于模拟器的验证结合起来，请使用 Build iOS Apps 插件。对于 Liquid Glass 迁移，有效的做法是让 Codex 审查一个流程、迁移少量界面区域、在 iOS 26 模拟器上启动迁移后的应用并截取屏幕截图，之后再扩大范围。
该插件内置 SwiftUI Liquid Glass 技能，其中有一组简单的默认原则值得写入您的提示：
- 相比自定义模糊视图，应优先采用原生的
glassEffect、GlassEffectContainer、玻璃效果按钮样式和glassEffectID过渡。 - 请在布局和视觉修饰符之后应用
.glassEffect(...)，这样材质就会包裹您实际想要的最终形状。 - 当多个界面区域同时出现时，请将相关玻璃元素包裹在
GlassEffectContainer中。 - 仅在真正响应触控的按钮、标签块和控件上使用
.interactive()。 - 在整个功能中保持边角形状、着色和间距一致，不要混用仅针对个别位置的玻璃效果样式。
- 为 iOS 26 之前的部署目标保留非玻璃效果回退方案。
如需进一步了解如何安装插件和技能，请参阅我们的 插件 和 技能 文档。
观看 WWDC 讲座
在让 Codex 重构实际的生产流程之前，以下 WWDC25 讲座是一组很好的参考资料：
先让 Codex 制定迁移方案，再完成一小部分迁移
当 Codex 将“玻璃效果应出现在哪里？”与“现在就编写所有代码”分开处理时，Liquid Glass 迁移会更顺利。先让 Codex 快速审查，再让智能体实现一个可独立完成的迁移部分，并通过模拟器进行验证。
实用技巧
不要处处使用玻璃效果
Liquid Glass 应在内容上方形成清晰的控件层，而不是把每张卡片都变成发光面板。让 Codex 移除与系统材质冲突的装饰性背景，在最需要保证可读性的区域保留普通内容样式，并仅将着色用于语义强调或主要操作。
从一个高频流程开始
标签页根视图、详情屏幕、工作表、搜索界面或新手引导流程，通常比一次性迁移整个应用更适合作为首个迁移目标。这样既更易于审查，也能明确哪些 Liquid Glass 设计决策应转化为可复用的组件模式。
有针对性地审查回退行为
如果您的部署目标低于 iOS 26，请让 Codex 同时展示回退实现和 Liquid Glass 版本。此审查步骤可发现意外引入的 API 可用性回归，并避免发布只能在最新模拟器上运行的迁移版本。
Tech stack
Need
Default options
Why it's needed
Need
平台基线
Default options
iOS 26 和 Xcode 26
Why it's needed
Liquid Glass 随 iOS 26 SDK 一同推出。Codex 应使用 Xcode 26 编译，并为支持较早的 OS 版本显式添加回退方案。
Need
模拟器验证
Default options
Why it's needed
视觉迁移期间，构建、启动、截取屏幕截图和检查日志都很重要，尤其是在审查多种状态和设备尺寸时。
| Need | Default options | Why it's needed |
|---|---|---|
| Liquid Glass UI API | SwiftUI ，搭配 glassEffect 、 GlassEffectContainer 和玻璃效果按钮样式 | 这些是该技能应优先采用的原生 API，以便 Codex 移除自定义模糊层，而不是重新构建材质系统。 |
| 平台基线 | iOS 26 和 Xcode 26 | Liquid Glass 随 iOS 26 SDK 一同推出。Codex 应使用 Xcode 26 编译，并为支持较早的 OS 版本显式添加回退方案。 |
| 模拟器验证 | XcodeBuildMCP | 视觉迁移期间，构建、启动、截取屏幕截图和检查日志都很重要，尤其是在审查多种状态和设备尺寸时。 |
