Core Spotlight 是 iOS 提供的一項實用框架,可讓 App 內的內容出現在系統 Spotlight 搜尋中。對於內容型或檔案型 App 而言,這是一個增加曝光與喚回使用者的好方法。

簡單來說,Core Spotlight 允許開發者把 App 內可被搜尋的內容註冊到系統索引。當使用者在 Spotlight 搜尋時,若關鍵字符合,就可能顯示對應項目,點擊後可回到 App 內的特定內容。

Core Spotlight 的核心物件是 CSSearchableItem。每個項目通常需要三個資訊:
uniqueIdentifier:項目唯一標識,可用於後續開啟特定內容。
domainIdentifier:可用來分組,方便批次刪除或管理。
attributeSet:描述搜尋結果顯示的標題、內容摘要與縮圖。
建立 attributeSet 時,可指定內容型態,例如純文字,再設定 title、contentDescription 與 thumbnailData。接著建立 CSSearchableItem,並呼叫 indexSearchableItems 完成註冊。
當使用者從 Spotlight 點擊結果進入 App,系統會呼叫 AppDelegate 的 continueUserActivity 方法。此時可判斷 activityType 是否為 CSSearchableItemActionType,並從 userInfo 中取出 uniqueIdentifier。
在我們的案例中,若 uniqueIdentifier 是檔案路徑,就可以直接開啟對應檔案;若是文章 ID,也可導向該篇文章頁面。
內容更新時,需重新註冊新的 searchable item;內容刪除時,也要移除對應索引。Core Spotlight 提供依 uniqueIdentifier 刪除、依 domainIdentifier 刪除,以及刪除全部索引的能力。
合理使用 Core Spotlight,不只是增加搜尋入口,也能讓使用者更快回到上次有興趣的內容,提升整體體驗。