如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

采用 Liquid Glass

使用 Codex,通过 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。

难度 Advanced
时间跨度 1h

使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。

最适合

  • 需要迁移到 iOS 26 Liquid Glass 的现有 SwiftUI 应用,希望获得有具体实施步骤的迁移计划,而非笼统的改版说明
  • 希望 Codex 先检查自定义卡片、弹出面板、标签栏、工具栏和操作按钮,再分批迁移这些组件的团队
  • 仍需支持旧版 iOS 的应用,更新界面时需使用 `#available(iOS 26, *)` 为旧版系统保留回退方案

目录

    ← 所有使用场景

    采用 Liquid Glass

    使用 Codex,通过 iOS 26 API 和 Xcode 26 将现有 SwiftUI 应用迁移到 Liquid Glass。

    使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。

    Advanced
    1h

    使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS 26 API 可用性检查和模拟器验证,降低迁移风险。

    Advanced
    1h

    最适合

    • 需要迁移到 iOS 26 Liquid Glass 的现有 SwiftUI 应用,希望获得有具体实施步骤的迁移计划,而非笼统的改版说明
    • 希望 Codex 先检查自定义卡片、弹出面板、标签栏、工具栏和操作按钮,再分批迁移这些组件的团队
    • 仍需支持旧版 iOS 的应用,更新界面时需使用 `#available(iOS 26, *)` 为旧版系统保留回退方案

    技能与插件

    • 使用 SwiftUI Liquid Glass、SwiftUI 界面模式和模拟器调试技能,更新现有 iOS 界面,采用原生玻璃效果,并在 iOS 26 模拟器上验证结果。
    技能 使用理由
    Build iOS Apps 使用 SwiftUI Liquid Glass、SwiftUI 界面模式和模拟器调试技能,更新现有 iOS 界面,采用原生玻璃效果,并在 iOS 26 模拟器上验证结果。

    起始提示词

    使用 Build iOS Apps 插件及其 SwiftUI Liquid Glass 技能,将此应用中一个使用频率较高的用户流程迁移到 Liquid Glass。 要求: - 使用 iOS 26 和 Xcode 26 实施迁移,同时通过 `#available(iOS 26, *)` 为较早的部署目标保留不使用玻璃效果的回退方案。 - 先检查整个流程。列出应改用原生 Liquid Glass 的自定义背景、叠加的模糊层、标签控件、按钮、弹出面板和工具栏,并指出哪些区域应保留普通内容样式。 - 优先使用系统控件和原生 API,如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`,减少使用自定义模糊效果。只有当元素之间的形变过渡确实能改善这一流程的使用体验时,才将 `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 的自定义背景、叠加的模糊层、标签控件、按钮、弹出面板和工具栏,并指出哪些区域应保留普通内容样式。 - 优先使用系统控件和原生 API,如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`,减少使用自定义模糊效果。只有当元素之间的形变过渡确实能改善这一流程的使用体验时,才将 `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, *) 检查系统版本,仅在 iOS 26 及更高版本上调用玻璃效果专用的新 API,同时保留在旧设备上也能清晰呈现内容的回退方案。

    使用 iOS 插件

    如果您希望 Codex 修改 SwiftUI 界面并在模拟器中验证效果,可以使用 Build iOS Apps 插件。迁移到 Liquid Glass 时,可以先请 Codex 检查一个使用流程,迁移其中少量界面元素,然后在 iOS 26 模拟器中启动应用并截图,再扩大迁移范围。

    该插件包含 SwiftUI Liquid Glass 技能。您可以把这项技能默认遵循的几条原则写入提示词:

    • 优先使用原生 glassEffect、GlassEffectContainer、玻璃按钮样式和 glassEffectID 转场效果,尽量避免自定义模糊视图。
    • 在布局和外观修饰符之后应用 .glassEffect(...),让玻璃材质贴合您想要的最终形状。
    • 当多个玻璃界面元素同时出现时,将相关元素放入同一个 GlassEffectContainer 中。
    • 仅对确实会响应触摸的按钮、标签按钮和其他控件使用 .interactive()。
    • 在整个功能中统一边角形状、着色和间距,避免为各个元素单独设计互不协调的玻璃效果。
    • 如果部署目标早于 iOS 26,请保留不使用玻璃效果的回退方案。

    有关如何安装插件和技能,请参阅插件和技能文档。

    观看 WWDC 讲座

    在请 Codex 重构生产应用中的实际流程之前,可以先参考以下 WWDC25 讲座:

    先请 Codex 制订迁移计划,再实现其中一部分

    迁移到 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 编译应用,并为较早的系统版本显式添加回退逻辑。

    需求

    模拟器验证

    默认选项

    XcodeBuildMCP

    为什么需要

    迁移界面时,构建并启动应用、截图和检查日志都是重要步骤,尤其是在核对不同界面状态和设备尺寸下的显示效果时。

    需求 默认选项 为什么需要
    Liquid Glass 界面 API SwiftUI 提供的 glassEffect 、 GlassEffectContainer 和玻璃按钮样式 该技能应优先使用这些原生 API,这样 Codex 就能移除自定义模糊层,无需重新实现材质系统。
    平台基准版本 iOS 26 和 Xcode 26 iOS 26 SDK 引入了 Liquid Glass。Codex 应使用 Xcode 26 编译应用,并为较早的系统版本显式添加回退逻辑。
    模拟器验证 XcodeBuildMCP 迁移界面时,构建并启动应用、截图和检查日志都是重要步骤,尤其是在核对不同界面状态和设备尺寸下的显示效果时。

    相关使用场景