SuperAPI AI 工具集

apple-app-intents

编程与开发

查看项目

更新于 11-05 21:04

技能介绍

Apple App Intents 是一份面向 Swift 开发者的参考与示例技能,主题是 Apple 的 App Intents 框架——一套把应用功能与数据开放给 Siri、Shortcuts、Spotlight、Apple Intelligence、Visual Intelligence 等系统体验的 Swift API。

【用途与覆盖范围】 技能围绕 App Intents 框架组织文档,覆盖 Intent 声明与执行控制、实体建模与查询、参数与结果定义、App Shortcuts、App Schema、系统集成、功能集成以及测试等主题,并提供若干典型实现示例。

【内容组织】 技能以目录结构组织资料:SKILL.md 为入口,references/ 下按类别分设子目录,包括 intents(AppIntent 本体、执行控制、依赖管理)、intent-types(系统定义的 Intent 种类,如 OpenIntent、DeleteIntent、URLRepresentableIntent 等)、entities(AppEntity、AppEnum、EntityProperty、DisplayRepresentation、IndexedEntity)、queries(EntityQuery 及排序与比较运算符)、parameters-results(IntentParameter、ParameterSummary、IntentResult、IntentDialog、参数解析与确认)、data-types(IntentFile、IntentPerson、IntentItemCollection 等值类型)、app-shortcuts(AppShortcut、AppShortcutsProvider、SiriTipView)、app-schemas(AppIntent(schema:) 宏及各领域 schema)、shortcuts-schema-domains(Shortcuts 向 schema 领域)、system-integration(Spotlight、donation、snippet、UIKit/AppKit 与场景联动)、feature-integrations(Widget、Control、Live Activity、Focus Filter、Workout)、visual-intelligence(搜索集成)与 testing(App Intents Testing 框架)。每个子目录含 README.md 作为索引。samples/ 目录提供示例说明与索引(共 19 件,索引见 samples/README.md)。资料注明不存在 scripts/ 目录。

【使用方式】 资料给出的探索流程为:先从任务映射到对应类别,再查阅该类别 README.md 定位具体页面,然后阅读对应 .md 文件获取细节;典型实现步骤则从 samples/README.md 查找相应示例。资料中附带“任务 → 类别”映射表,列举了声明 AppIntent 并实现 perform()、配置执行模式与取消/Undo、注册依赖与跨 target 共享、使用系统定义 Intent 种类、从 SiriKit 自定义 Intent 迁移、以 AppEntity/AppEnum 建模数据、定义 EntityQuery 与排序比较、定义参数与结果、解析与确认参数、使用值类型、提供 App Shortcuts 与 SiriTipView、通过 App Schema 向 Apple Intelligence 与 Siri 暴露功能、查阅各领域 schema、Intent donation 与建议、场景引导与数据源联动、Widget/Control/Live Activity/Focus Filter/Workout 集成、Visual Intelligence 搜索呈现、以及测试 App Intents 等任务所对应的类别入口。

【版本信息】 资料说明其来源为 developer.apple.com 的 DocC JSON,因 URL 无版本号而以获取日期 2026-10-16 固定;目标 SDK 为 iOS / iPadOS / macOS / tvOS / visionOS / watchOS 27.0(Xcode 27.0),updates/appintents 最新一节为 2026 年 6 月,所获取的 1258 个 JSON 中无 beta 标记。框架引入版本:App Intents 为 iOS 16.0 / macOS 13.0 / watchOS 9.0 / visionOS 1.0;Visual Intelligence 为 iOS 26.0 / macOS 27.0;App Intents Testing 为全 OS 27.0。个别 API 的引入版本以各页面描述为准。

【适用场景与限制】 适用于需要为 Apple 平台应用接入 Siri、Shortcuts、Spotlight、Apple Intelligence 等系统能力的 Swift 开发者,作为 API 查阅与示例参考。资料未说明收费、价格或额外平台要求;技能本身不包含可执行脚本,内容为参考文档与示例说明。使用时应以目标 SDK 版本与各 API 页面记载为准。