Реализация Spotlight Search интеграции для iOS-приложения
Spotlight — системный поиск iOS, доступный свайпом вниз с главного экрана. Если проиндексировать контент приложения, пользователь найдёт его прямо в Spotlight без запуска приложения. Нажатие на результат — deep link в нужный экран.
Три API для индексации: CSSearchableIndex для пользовательского контента, NSUserActivity для текущих активностей, CoreSpotlight + AppIntents для интеграции с Shortcuts (iOS 16+).
CSSearchableIndex: основной API
Каждый элемент — CSSearchableItem с уникальным uniqueIdentifier, domainIdentifier (группировка по типу) и CSSearchableItemAttributeSet (метаданные).
let attributeSet = CSSearchableItemAttributeSet(contentType: .text)
attributeSet.title = article.title
attributeSet.contentDescription = article.summary
attributeSet.keywords = article.tags
attributeSet.thumbnailData = await fetchThumbnail(article.imageURL)
let item = CSSearchableItem(
uniqueIdentifier: "article-\(article.id)",
domainIdentifier: "articles",
attributeSet: attributeSet
)
CSSearchableIndex.default().indexSearchableItems([item]) { error in
if let error { print("Index error:", error) }
}
uniqueIdentifier — это тот же строки, которые вы получите в application(_:continue:restorationHandler:) когда пользователь тапнет результат. По нему определяем, какой экран открыть.
Пакетная индексация. Индексировать по одному элементу при каждой загрузке — плохая идея. При большом каталоге (тысячи элементов) используем CSSearchableIndex.fetchLastClientState() / beginBatch() / endBatch() — это транзакционная индексация, которая быстрее и не вызывает лишних re-index.
NSUserActivity для недавних действий
NSUserActivity автоматически индексирует то, что пользователь делал в приложении — «недавно просмотренные» в Spotlight. Плюс это основа для Handoff между устройствами.
let activity = NSUserActivity(activityType: "com.yourapp.viewArticle")
activity.title = article.title
activity.userInfo = ["articleId": article.id]
activity.isEligibleForSearch = true
activity.isEligibleForHandoff = true
activity.isEligibleForPrediction = true // для Siri Suggestions
activity.becomeCurrent()
becomeCurrent() вызываем в viewDidAppear, resignCurrent() в viewDidDisappear. Частая ошибка: вызывать becomeCurrent() в viewDidLoad — активность регистрируется до того, как пользователь реально увидел контент.
Обработка deep link из Spotlight
В AppDelegate:
func application(_ application: UIApplication,
continue userActivity: NSUserActivity,
restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
if userActivity.activityType == CSSearchableItemActionType {
let identifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String
// Navigate to item with identifier
}
return true
}
В SwiftUI/SceneDelegate — через .onContinueUserActivity(CSSearchableItemActionType) модификатор.
Миграция со SceneDelegate. На iOS 13+ приложение может иметь несколько scene. Если Spotlight открывает приложение с нуля — scene(_:willConnectTo:options:) получает userActivity в connectionOptions.userActivities. Если приложение уже запущено — scene(_:continue:). Нужно обрабатывать оба случая.
Удаление и обновление индекса
Устаревший контент в Spotlight раздражает пользователей: они тапают — приложение открывается на 404. Удаляем через CSSearchableIndex.default().deleteSearchableItems(withIdentifiers:) или deleteSearchableItems(withDomainIdentifiers:) для целого типа. При удалении пользовательских данных — удаляем из индекса в том же потоке.
Не индексируем приватный контент без явного согласия пользователя — Apple проверяет это на review через HIG.
Сроки
Базовая индексация основного контента: 1–2 недели. Полная интеграция с NSUserActivity, пакетной индексацией, deep link обработкой и актуализацией индекса: 3–5 недель. Стоимость зависит от объёма каталога и сложности deep link схемы.