iOS App添加Spotlight搜索（附Swift Demo）

原创Blog，转载请注明出处
http://blog.csdn.net/hello_hwc?viewmode=list
我的stackoverflow

前言：最近实在太忙了，已经一周没空写博客了。而且，本来这个月会持续更新设计模式相关的东西，但是还是要抽出时间来写这一篇关于iOS 9新特性的文章。
Why？因为最近要对iOS 9这部分用户提高用户体验，所以整理一下iOS 9这部分的内容

资料/Demo

我习惯性的会把资料放在最前面，因为很多同学其实不会找资料

WWDC对应的视频
一篇还不错的博客

效果
在Spotlight中输入leo，搜到DemoApp的数据，然后点击搜索结果，跳到指定的页面（App为启动，前后台均可以）

Demo下载（Demo是用Swift写的），感兴趣的同学可以下载下来看看
http://download.csdn.net/detail/hello_hwc/9368337

添加SpotLight搜索内容－CSSearchableItem

每个CSSearchableItem由一个CSSearchableItemAttributeSet来描述它呈现在搜索结果中的样子。

先创建一个`CSSearchableItemAttributeSet`来描述展示在搜索结果中的样子

  let attributeSet = CSSearchableItemAttributeSet(itemContentType: kUTTypeImage as String)attributeSet.title = profile.titleattributeSet.contentDescription = profile.subTitleattributeSet.phoneNumbers = [profile.phone]attributeSet.supportsPhoneCall = NSNumber(int: 1)attributeSet.thumbnailData = UIImagePNGRepresentation(profile.image)attributeSet.keywords = ["leo"]

对照着效果，我们来看看都指向哪一部分内容，

当然，CSSearchableItemAttributeSet 还可以提供更多的属性，这里就不一一列举了，看看文档很容易就知道了，Demo中列出的就是常用的。

搜索的时候会根据字符串进行搜索，所以，及时不设置keywords也能搜索到

然后，创建CSSearchableItem

let item = CSSearchableItem(uniqueIdentifier: "\(index)", domainIdentifier: "com.leo.demo", attributeSet: attributeSet)

这里的

uniqueIdentifier用来唯一确认一个搜索Item，通过这个uniqueIdentifier可以知道用户点击了哪个item，也可以通过它来删除制定的item
domainIdentifier，域的概念，用来管理一组items，可以一次性删除一个域下的所有item

然后，添加到CSSearchableIndex中

  CSSearchableIndex.defaultSearchableIndex().indexSearchableItems([item], completionHandler: { (error) -> Void inif error != nil{print(error?.localizedDescription)}})

更新CSSearchableItem

更新和添加CSSearchableItem使用同样的API，只要uniqueIdentifier已经存在了，就是更新

删除CSSearchableItem

有一点要记住，添加，删除，更新的时候，使用的类都是CSSearchableIndex

一次删除一组Identifiers

 CSSearchableIndex.defaultSearchableIndex().deleteSearchableItemsWithIdentifiers([identifier!], completionHandler: { (error) -> Void inif error != nil{print(error)}})

也可以一次删除一个域下的所有item

CSSearchableIndex.defaultSearchableIndex().deleteSearchableItemsWithDomainIdentifiers

删除全部items

  CSSearchableIndex.defaultSearchableIndex().deleteAllSearchableItemsWithCompletionHandler({ (error) -> Void in})

过期时间

可以设置CSSearchableItem的这个属性，来设置过期时间，过期之后device index会自动删除这个item

expirationDate

代理CSSearchableIndexDelegate

Device Index反馈给App处理的结果
例如当batch创建item的时候，有可能在提交的device index的时候失败，通过这个代理来告诉app失败了，要重新提交

//需要重新提交所有items到device index中
searchableIndex:reindexAllSearchableItemsWithAcknowledgementHandler://重新提交指定identifiers到device index中
searchableIndex:reindexSearchableItemsWithIdentifiers:acknowledgementHandler:

处理点击SpotLight中的搜索结果

在这个代理函数中处理

func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool

其中，返回true表示app已经处理了NSUserActivity

Demo中，采用Notification的方式来传递给管理的Controller，也可以直接获取ViewController的指针（根据viewController层次关系）

    func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {if #available(iOS 9.0, *) {//别忘记检查iOS 9if userActivity.activityType == CSSearchableItemActionType{let identifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? StringNSNotificationCenter.defaultCenter().postNotificationName("ContiuneUserActivityNotification", object: NSString(string:identifier!))//发送通知if identifier != nil{ CSSearchableIndex.defaultSearchableIndex().deleteSearchableItemsWithIdentifiers([identifier!], completionHandler: { (error) -> Void inif error != nil{print(error)}})}} else {// Fallback on earlier versions}return true;}

抛砖引玉，这部分不难，感兴趣的同学好好研究下我提到的那三个类就可以了。