需求
向系统开放操作
默认选项
为什么需要
App Intents 定义了应用向系统提供操作的接口,让应用中的操作可以出现在快捷指令、Siri、聚焦搜索、小组件、控件以及面向助手的新系统功能中。
.md 即可查看该页面的 Markdown 版本。
Codex 使用场景
使用 Codex,让快捷指令、Siri、聚焦搜索以及由助手驱动的新系统功能都能调用应用中的操作、访问其中的内容。
使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。
使用 Codex,让快捷指令、Siri、聚焦搜索以及由助手驱动的新系统功能都能调用应用中的操作、访问其中的内容。
使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。
使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。
| 技能 | 使用理由 |
|---|---|
| Build iOS Apps | 使用 iOS 构建技能和 SwiftUI 技能添加 App Intents、应用实体和 App Shortcuts,然后验证应用是否仍能正常构建,以及通过意图进入应用时能否到达正确的位置。 |
App Intents 为 iOS 应用提供了一种直接的方式,让用户在应用界面之外也能使用它的功能。用户无需事事都先启动应用,再点按界面找到所需功能。您可以让 Codex 将合适的操作和对象开放给快捷指令、Siri、聚焦、小组件、控制项,以及由助手驱动的新一代系统功能。
这样既方便用户发现应用功能、实现自动化,也能为助手在未来承担更多操作做好准备。如果您的应用已经能让用户撰写内容、打开项目、筛选结果、跳转到目标位置或生成摘要,App Intents 就能让系统以结构化的方式请求应用执行这些操作。
首次接入 App Intents 时,通常无需把整个应用照搬一遍。请让 Codex 找出:
Apple 的 App Intents 指南给出了设计思路:先定义操作,再确定需要向系统提供哪些实体信息,最后让用户能在不同的系统功能中发现并复用这些操作。可重点参考让操作和内容易于发现并可在多处使用、创建您的第一个应用意图,以及演示如何集成系统功能的示例采用 App Intents 支持系统功能。
App Intents 的用途远不止“添加一条快捷指令”。设计好应用开放的操作和实体,用户就能从多个入口使用应用功能:
应用采用以下结构时,接入 App Intents 通常效果最好:
AppShortcutsProvider 条目AppEntity 类型,例如账号、列表和时间线筛选条件对于大多数应用,我会请 Codex 采用这种模式:先向系统开放少量操作,只提供必要的实体信息,并明确运行时的交接方式,以便意图需要主界面时将控制权交还给应用。
编写提示词时,最好先向 Codex 说明应用的核心对象和用户最重要的操作,再请它选出第一版 App Intents 需要开放的操作和实体。范围应尽可能小,同时又能满足实际需求,避免一开始就开放所有功能。
适合作为首批意图的操作通常包括撰写、打开、查找、筛选、启动、继续或检查。如果用户必须先在应用内完成一连串设置,某项操作才有用,那么它可能不适合纳入首批 App Intents。
系统通常无需了解应用完整的持久化模型。请让 Codex 仅向系统提供必要的应用实体信息,同时确保 Siri、快捷指令和聚焦有足够的上下文来正确路由和展示操作。
即使首个版本中用户能看到的改进仅限于快捷指令或 Siri,应用也已经能用结构化的操作和实体来描述自身功能。相比只能通过点按操作和视图层级来体现功能的应用,您的应用将更容易接入未来的系统入口和由 AI 驱动的入口。
需求
默认选项
为什么需要
需求
向系统开放操作
默认选项
为什么需要
App Intents 定义了应用向系统提供操作的接口,让应用中的操作可以出现在快捷指令、Siri、聚焦搜索、小组件、控件以及面向助手的新系统功能中。
需求
向系统提供应用数据
默认选项
AppEntity、EntityQuery 和实体的显示形式
为什么需要
通过精简且设计合理的实体层,系统就能理解应用中的对象,无需公开整个模型层。
需求
让用户发现操作
默认选项
使用 AppShortcutsProvider,并提供清晰的调用短语、标题和图标
为什么需要
有了 App Shortcuts,用户可以更轻松地找到并运行首批开放的操作,无需从头创建快捷指令。
需求
构建与验证
默认选项
使用 xcodebuild 构建应用,在模拟器中检查,并重点验证运行时的跳转行为
为什么需要
编译意图的构建目标只是第一步。更难的是验证系统调用意图时,应用能否按预期打开或跳转到正确的位置。
| 需求 | 默认选项 | 为什么需要 |
|---|---|---|
| 向系统开放操作 | App Intents | App Intents 定义了应用向系统提供操作的接口,让应用中的操作可以出现在快捷指令、Siri、聚焦搜索、小组件、控件以及面向助手的新系统功能中。 |
| 向系统提供应用数据 | AppEntity 、 EntityQuery 和实体的显示形式 | 通过精简且设计合理的实体层,系统就能理解应用中的对象,无需公开整个模型层。 |
| 让用户发现操作 | 使用 AppShortcutsProvider ,并提供清晰的调用短语、标题和图标 | 有了 App Shortcuts,用户可以更轻松地找到并运行首批开放的操作,无需从头创建快捷指令。 |
| 构建与验证 | 使用 xcodebuild 构建应用,在模拟器中检查,并重点验证运行时的跳转行为 | 编译意图的构建目标只是第一步。更难的是验证系统调用意图时,应用能否按预期打开或跳转到正确的位置。 |
使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS...
让 Codex 找到合适的 Xcode 方案和模拟器,启动应用并检查 UI 层级结构。Codex 可以模拟轻点、输入和轻扫操作,截屏并收集日志,必要时还可以附加 LLDB...
使用 Codex 搭建 iOS SwiftUI 项目骨架,优先在 CLI 中用 `xcodebuild` 或 Tuist 构建和迭代。任务变复杂时,可以接入...