用途:帮助 iOS 应用在 Spotlight 搜索、Siri 建议、操作按钮、控制中心等系统入口中被发现。核心原则是通过多个 API 提供元数据,由系统按用户实际使用情况决定何时展示;单一 API 无法覆盖全面可发现性。
主要能力与六步策略:一、添加 App Intents(如 OrderCoffeeIntent)作为基础,支撑 Spotlight、Siri 与快捷指令建议;二、实现 AppShortcutsProvider,用含 (.applicationName) 的 suggestedPhrase 让操作安装后即时可用;三、用 Core Spotlight(CSSearchableItem)索引有价值的内容,如订单、文档、笔记;四、对高价值屏幕用 NSUserActivity 标记 isEligibleForSearch、isEligibleForPrediction,并通过 appEntityIdentifier 与 App Intents 打通;五、提供明确、面向动作的 intent 标题、描述与自然语言 parameterSummary;六、系统按实际调用自动提升常用快捷指令与活动,若无人使用则隐藏。
使用方式:资料给出“一晚完成最小可用可发现性”的捷径,包括定义 1–3 个核心 App Intent、创建 AppShortcutsProvider(含 3–5 个快捷指令)、仅索引最近或重要内容、在详情页添加 NSUserActivity,并在快捷指令应用、Spotlight 和 Siri 中验证。大批量索引建议每批 100 条、后台执行、使用 domainIdentifier 分组;5 万条以上可用 CSSearchableIndex.beginBatch()/endBatch()。可用 SiriTipView 在应用内向用户推广快捷指令。
适用场景:计划设计可发现性架构、排查“为什么我的应用不出现在建议中”、为操作按钮或系统级内容搜索做接入。
限制与注意事项:不要索引全部内容,避免配额与性能问题;标识符需稳定;删除内容时应调用 deleteSearchableItems 清理;不要给设置、引导、错误页标记预测或搜索资格;只有具体 API 参考需求时应改用 app-intents-ref、app-shortcuts-ref、core-spotlight-ref。收费、价格、平台支持与具体效果资料暂未提供。