SuperAPI AI 工具集

axiom-app-shortcuts-ref

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

本技能是 App Shortcuts 框架的综合参考,用于让 App 的操作在安装后立即出现在 Siri、Spotlight、操作按钮、控制中心等系统入口,无需用户配置。需区分 App Intents(动作本体)与 App Shortcuts(让动作被系统即时发现的预配置表层)。

适用场景:实现 AppShortcutsProvider;添加 Siri 调用短语;配置 Spotlight 即时可用;创建带参数、可跳过 Siri 追问的快捷指令;使用 NegativeAppShortcutPhrase 防止误触发(iOS 17+);用 SiriTipView 推广;通过 updateAppShortcutParameters() 动态更新;调试快捷指令未出现的问题;在 App Intents 与 App Shortcuts 之间选择。不适用:通用 App Intents 实现(用 app-intents-ref)、Core Spotlight 索引(core-spotlight-ref)、整体可发现性策略(app-discoverability)。

核心概念:一个 App 只能有一个类型遵循 AppShortcutsProvider;用 @AppShortcutsBuilder 定义 appShortcuts 数组;AppShortcut 由 intent、phrases、shortTitle、systemImageName 组成;短语用 (.applicationName) 插值;支持条件与循环生成。参数化短语可预填参数以跳过追问,但快捷指令过多会增加 Shortcuts 中的杂乱。

发现 UI:SiriTipView 需该 intent 已用于某个 AppShortcut,否则显示空视图;ShortcutsLink 可打开 App 在 Shortcuts 中的页面;shortcutTileColor 设定磁贴颜色。动态更新时可在数据变化后调用 updateAppShortcutParameters()。

平台支持 iOS 16+、iPadOS 16+、macOS 13+、tvOS 16+、watchOS 9+;negativePhrases 需 iOS 17+ 等更高版本。资料未提供收费、价格与效果数据。