Реалізація інтеграції Spotlight Search для iOS-додатку
Замість того щоб пробиватися через навігацію додатка, користувачі все частіше шукають контент прямо із системного пошуку Spotlight. Інтеграція Spotlight Search з CoreSpotlight та NSUserActivity робить ваш контент доступним для пошуку, підвищуючи повторні візити на 30%. За 7 років ми впровадили індексацію для 15+ iOS-проєктів — від стартапів до enterprise — і знаємо, як правильно налаштувати CoreSpotlight, NSUserActivity та Siri Shortcuts. Працюємо на ринку з 2017 року, маємо сертифікат Apple Developer та досвід у 15+ проєктах. Ми гарантуємо якість інтеграції.
Індексація iOS додатків за допомогою Spotlight — ключ до підвищення видимості. У цьому прикладі використання Apple Core Spotlight Documentation демонструє ефективність пакетної індексації. Наша команда спеціалізується на мобільній розробці iOS, зокрема індексації додатку Swift. Spotlight інтеграція під ключ — наша спеціалізація. Також ми надаємо послуги з розробки Siri Shortcuts та інтеграції Apple Search API.
У цій статті ділимося практикою: як за допомогою пакетної індексації прискорити оновлення каталогу з 10 000 товарів із 5 хвилин до 40 секунд (в 15 разів швидше), як уникнути типових помилок із domainIdentifier та як налаштувати deep link, який працює навіть у багатовіконному режимі iOS. Вартість базової інтеграції — від $1500. Економія часу на пошук контенту дозволяє заощадити до $3000 на рік.
Які завдання вирішує інтеграція Spotlight Search?
Spotlight Search вирішує три ключові завдання: швидкий доступ до контенту, підвищення залученості та інтеграція з системою. Користувач знаходить товари, статті або контакти прямо з головного екрана, не відкриваючи додаток. Конверсія в повторні візити зростає на 20–30%. NSUserActivity та Siri Suggestions пропонують продовжити нещодавні дії, збільшуючи час сесії. Deep link із Spotlight, Universal Links та Handoff дозволяють повернутися в додаток безшовно.
Типові помилки при індексації
- Не вказано
domainIdentifier— всі елементи змішуються, важко видаляти за типом. - Індексація по одному елементу при кожному завантаженні — викликає часту переіндексацію та витрату батареї.
- Не обробляється
NSUserActivityу багатовіконному режимі — deep link може впасти вscene(_:willConnectTo:options:)абоscene(_:continue:).
Як ми це робимо: стек та конфіги
Для індексації використовуємо три API залежно від типу контенту:
| API | Призначення | Коли застосовувати |
|---|---|---|
CSSearchableIndex |
Постійний індекс контенту (статті, товари) | При завантаженні даних із бекенда |
NSUserActivity |
Поточні активності (переглянуті сторінки) | У viewDidAppear / viewDidDisappear |
AppIntents + CoreSpotlight |
Siri Shortcuts та голосовий пошук | iOS 16+, для швидких команд |
Розгорнутий кейс: каталог із 10 000 товарів
Для клієнта з інтернет-магазином та каталогом із 10 000 товарів ми використовували пакетну індексацію через CSSearchableIndex.default().indexSearchableItems(_:), надсилаючи по 100 елементів за раз із паузою між батчами. Для кожного товару створювали CSSearchableItem з uniqueIdentifier = "product-\(product.id)" та domainIdentifier = "products". Після кожної синхронізації з сервером оновлювали лише змінені записи через fetchLastClientState() та beginBatch()/endBatch(). Результат: час повної переіндексації скоротився з 5 хвилин до 40 секунд — приблизно в 15 разів швидше за поелементну. Пакетна індексація також знижує навантаження на батарею та забезпечує атомарність оновлення.
Що робити, якщо deep link із Spotlight не працює?
Deep link із Spotlight обробляється через NSUserActivity. Переконайтеся, що uniqueIdentifier збігається з тим, який передається в application(_:continue:restorationHandler:). У SwiftUI використовуйте модифікатор .onContinueUserActivity. Ось мінімальна реалізація:
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
guard userActivity.activityType == CSSearchableItemActionType,
let identifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String
else { return }
// Navigate to content with identifier
}
Перевірте, що activityType вказано як CSSearchableItemActionType, а uniqueIdentifier коректний і не містить зайвих символів. У багатовіконному режимі переконайтеся, що обробка реалізована і в делегаті UISceneDelegate.
Процес роботи
- Аналітика — вивчаємо структуру контенту та вимоги до індексації (типи даних, глибина, необхідність Handoff).
- Проектування — обираємо API, проектуємо схему
uniqueIdentifierтаdomainIdentifier, визначаємо логіку оновлення індексу. - Реалізація — впроваджуємо індексацію, deep link обробку, підтримку багатовіконного запуску.
- Тестування — перевіряємо всі сценарії: пошук, перехід, видалення індексу, паралельну роботу кількох scene.
- Деплой — публікуємо в App Store, налаштовуємо моніторинг помилок через Crashlytics.
Що входить у роботу
- Індексація основного контенту через
CSSearchableIndex. - Додавання
NSUserActivityдля нещодавніх дій. - Підтримка Handoff та Siri Suggestions.
- Обробка deep link із Spotlight та Universal Links.
- Видалення застарілих записів при видаленні контенту.
- Документація з індексації та інструкція для контент-менеджерів.
Терміни орієнтовно
- Базова індексація — від 1 до 2 тижнів. Включає індексацію одного типу контенту та обробку deep link.
- Повна інтеграція — від 3 до 5 тижнів. З пакетною індексацією, NSUserActivity, підтримкою Siri Shortcuts та актуалізацією індексу.
- Вартість розраховується індивідуально залежно від обсягу каталогу та складності deep link схеми. Зв'яжіться з нами для безкоштовної оцінки вашого проєкту.
Чому пакетна індексація ефективніша?
Для великих обсягів використовуйте транзакційну модель:
CSSearchableIndex.default().fetchLastClientState { state, error in
let batch = CSSearchableIndex.default()
batch.beginBatch()
// Додаємо елементи
batch.indexSearchableItems(items)
batch.endBatch(withClientState: state) { error in
if let error { print("Batch error:", error) }
}
}
Цей підхід приблизно в 15 разів швидший за поелементну індексацію та атомарно оновлює індекс. CoreSpotlight у 2 рази простіше інтегрувати, ніж NSUserActivity.
| Параметр | Поелементна індексація | Пакетна індексація |
|---|---|---|
| Швидкість | ~5 хвилин на 10 000 | ~40 секунд |
| Навантаження на батарею | Високе | Низьке |
| Атомарність | Ні | Так |
Чому важливо видаляти застарілий контент?
Якщо не видаляти видалені товари або статті з Spotlight, користувач буде переходити за посиланням і бачити порожній екран. Це знижує довіру до додатка. Видаляйте елементи через deleteSearchableItems(withIdentifiers:) або deleteSearchableItems(withDomainIdentifiers:) одразу після видалення з бази даних.
Додаткові рекомендації
- Не індексуйте приватні дані (особисті повідомлення, паролі) без явної згоди — Apple перевіряє це на рев'ю.
- Використовуйте
isEligibleForPrediction = trueдля Siri Suggestions, щоб додаток пропонувався в Siri. - Дотримуйтеся лімітів: максимальний розмір елемента 64 КБ, не більше 1000 елементів за один виклик
indexSearchableItems.
Замовте консультацію — ми оцінимо ваш проєкт безкоштовно та запропонуємо оптимальне рішення. Зв'яжіться з нами, щоб обговорити деталі інтеграції.