用途:把应用内的高价值动作与领域数据暴露到系统层,供 Siri、快捷指令、Spotlight 搜索、可配置小组件、控制中心按钮以及 Apple Intelligence 调用。目标环境为 Swift 6.3 / iOS 26+。
主要能力与系统对应:Siri 与快捷指令用 AppIntent;可配置小组件用 WidgetConfigurationIntent;控制中心用 ControlConfigurationIntent;Spotlight 索引用 IndexedEntity;Apple Intelligence 用 @AppIntent(schema:);交互式片段用 SnippetIntent(iOS 26+)。
使用流程:先挑 1–3 个脱离应用也有意义的用户任务;为意图引用的领域数据建立可标识的 AppEntity 影子模型;用 @Parameter 定义参数并实现 perform() async throws -> some IntentResult;通过 AppShortcutsProvider 注册自然语音短语;最后在快捷指令、Spotlight 搜索和小组件配置中验证可发现性。
实体与查询:AppEntity 需提供 defaultQuery、typeDisplayRepresentation 与 displayRepresentation;EntityQuery 负责用 entities(for:) 解析标识、用 suggestedEntities() 给出建议选项。语音短语中应使用 (.applicationName) 令牌而非硬编码应用名。
常见错误:在 perform() 内直接做 UI 导航或视图呈现而不返回 OpenURLIntent 或导航结果;自定义 @Parameter 实体类型缺少 EntityQuery 导致快捷指令无法选参数;在 perform() 中做长时间网络调用却不检查 Task.isCancelled 或提供进度对话;AppEntity 未实现 typeDisplayRepresentation。
审查要点:意图符合 AppIntent 或对应系统协议;参数标题清晰且有有效默认/建议值;实体实现 entities(for:) 与 suggestedEntities();perform() 返回合适 IntentResult(如 .result()、.result(dialog:));破坏性动作先声明 requestConfirmation();敏感动作按需设备认证。
限制:资料未提供具体安装命令、价格与其它平台支持信息。