前言
一直覺得 Spotlight 是個挺實用的功能,既能提升用戶活躍度,也能增加應用內容的曝光機會。
一、實現(iOS 9.0 及以上)
1.1 添加索引
var searchableItems = [CSSearchableItem]()
for app in apps {
let searchableItemAttributeSet = CSSearchableItemAttributeSet(itemContentType: kUTTypeText as String)
searchableItemAttributeSet.title = app.label
searchableItemAttributeSet.contentDescription = "Watch \(app.label) LIVE on Shou"
let searchableItem = CSSearchableItem(uniqueIdentifier: app.id, domainIdentifier: "youappbundlerid.apps", attributeSet: searchableItemAttributeSet)
searchableItems.append(searchableItem)
}
CSSearchableIndex.defaultSearchableIndex().indexSearchableItems(searchableItems, completionHandler: { (error: NSError?) in
if error == nil {
print("initSpotlight...completed")
} else {
print("\(error)")
}
})一定要注意把上面這段代碼放到子線程執行,它略微耗時。實踐中的做法是在 AppDelegate 裡等服務器數據請求完成後再加索引。
1.2 接收點擊事件
@available(iOS 8.0, *)
func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {
if #available(iOS 9.0, *) {
if userActivity.activityType == CSSearchableItemActionType {
if let uniqueIdentifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String, let label = userActivity.title {
// 頁面跳轉
}
}
}
return true
}二、實踐經驗
2.1 CSSearchableItemAttributeSet:可以不設置 thumbnailData,這樣默認會用當前應用的圖標。另外注意 thumbnailURL 並不是用來指定網絡圖片地址的,所以若要展示縮略圖,得先把網絡圖片下載到本地再設置。
2.2 CSSearchableItem:默認有效期為一個月;另外發現無法攜帶更多自定義數據——通過 attributeSet 的 setValue 塞進去的內容,在 userActivity 那邊收不到。
2.3 關於索引條數上限:官方文檔裡沒找到明確限制。 stackoverflow 上也有同樣的提問,暫無結論。實測添加索引確實偏慢,而那個批量索引接口我沒完全摸透,感覺更適合同時存在刪除與新增的場景。
2.4 關於重新索引:沒找到專門的接口。不過重複調用不會有問題,只要 uniqueIdentifier 一致就會覆蓋舊數據。
2.5 關於提升排名:沒找到相關接口,看起來系統會用一套自己的算法來排序。
總結:以上就是 Core Spotlight 在 iOS 中的實作要點與踩坑經驗,希望能幫到正在做搜索接入的同學。