手机App终将消失,聊一聊苹果的App Intents和谷歌的AppFunctions(一)

AppIntent / AppEntity        ↓系统生成元数据        ↓Siri / Spotlight / Shortcuts / Widget        ↓perform()

Apple 官方把 App Intents 定义为一个用于“让 App 的内容和操作在 App 外部可用”的框架。”

1. App Intent：描述一个可执行动作

例如：

• 开始一次健身训练

• 播放一首歌

• 创建一条笔记

• 发送一条消息

• 打开某个页面

• 将商品加入购物车

一个 App Intent 通常需要：

• 一个本地化标题和描述

• 必要的参数

• 一个 perform() 方法

• 成功或失败的返回结果

import AppIntentsstructCreateNoteIntent: AppIntent {    static var title: LocalizedStringResource = "Create Note"    @Parameter(title: "Content")    var content: String    func perform() async throws -> some IntentResult {        // 调用应用自己的业务逻辑        try await NoteStore.create(content: content)        return .result()    }}

这里的 AppIntent 并不是单纯的 UI 快捷方式，而是 App 对外暴露的一个“结构化动作”。

1. App Entity：描述 App 中的数据

如果动作需要操作某个具体对象，就需要使用 AppEntity。

例如：

• 一首歌

• 一张照片

• 一条笔记

• 一个日历事件

• 一个旅行目的地

AppEntity 通常需要：

• 唯一标识符

• 可展示的标题和描述

• 查询对象，用于根据名称或 ID 找到实体

• 关键属性

例如用户说：“播放专辑《Kind of Blue》”

Siri 需要先通过 AppEntity 和查询逻辑找到对应专辑，再把它传给 App Intent。

1. App Enum：描述有限选项

AppEnum 用于定义有限的枚举选项，例如：

• 任务优先级：高、中、低

• 邮件状态：已读、未读

• 播放模式：单曲、列表、随机

• 商品尺码：S、M、L

它的重点是告诉系统每个选项应该如何展示和解析。

1. 可以接入哪些系统能力？

根据 Apple 官方文档，App Intents 可以用于：

• Siri

• Apple Intelligence

• Spotlight

• Shortcuts

• Widget、Controls、Live Activities

• Action Button

• Focus 模式

• Visual Intelligence

• 后台 App Intent Extension

其中：

• App Intent 是基础动作；

• App Entity 是基础数据；

• App Shortcut 是为用户提供更直接、更易发现的 Siri 或快捷指令入口；

• Donation 可以把用户过去执行过的动作和使用过的实体反馈给系统，用于后续推荐。

1. 前台和后台执行

Apple 官方还区分了：

• 必须打开 App 执行的 Intent；

• 可以在后台执行的 Intent；

• 需要通过 App Extension 执行的 Intent。

因此，App Intent 的实现最好和 UI 层、业务逻辑层解耦。可以把共享逻辑放到 Swift Package 或独立模块中，让主 App 和 Extension 共用。

1. iOS 版本

App Intents 框架从 iOS 16 开始提供，另外支持：

• iPadOS 16+

• macOS 13+

• watchOS 9+

• tvOS 16+

• visionOS 1+

但 Apple Intelligence 相关能力还依赖具体系统版本、设备、地区和功能开放状态，不能简单理解为“iOS 16 设备都支持 Apple Intelligence”。

关于iOS的App Intents我们今天先聊到这里，在下一篇文章中我们来看Android的AppFunctions。