iOS9推出后，为了顺应时代，给自己项目加了个Spotlight搜索功能，下面是使用过程中的一点记录

在iOS9中提供了新的APIs，允许你去索引APP里面的内容或者界面状态，通过Spotlight来快速显示APP中的内容。 这些新的搜索APIs的三大组件为：

• NSUserActivity （iOS8 出现的类，提供handoff功能支持）
• Core Spotlight （新库，提供Spotlight索引APP内容的功能）
• web markup（鬼知道什么东西，看名字不像APP开发用的）

---

1、NSUserActivity

最开始NSUserActivity是iOS8的新特性：HandOff功能所使用的API，用于保存和复原APP的状态。由于项目对HandOff并没啥友好性，所以去年也没有太多的研究，顺道学习一下。
学习链接

简单的说，使用NSUserActivity主要有以下几点：

• unique identifier（唯一的标识符，通过此标识符，可以链接不同设备的同一APP，也是能实现HandOff功能的基础）

 <key>NSUserActivityTypes</key>
 <array>
  <string>com.xxx.iOS-9-Search.displayShow</string>
 </array>

• 保存一个UserActivity

NSUserActivity * activity = [[NSUserActivity alloc] initWithActivityType:@"com.xxx.iOS-9-Search.displayShow"];
        
activity.title = @"test";
activity.userInfo = [NSDictionary dictionaryWithObjectsAndKeys:item.name, @"name", item.id, @"id", nil];
        
[activity becomeCurrent];

• 恢复restore

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler

• update UserActivity

[activity addUserInfoEntriesFromDictionary:dic];

---

上面4点是NSUserActivity使用过程中需要用到的主要情景。实例化的NSUserActivity对象，可以通过属性retain住，根据情况调用update方法，更新userActivity的userInfo（dictionary）

• 其他
  eligibleForHandoff，eligibleForSearch：两个属性，区分HandOff和SpotLight。

  expirationDate：当这个属性被设置时，你的user activity 只会在设置的时期之前才会展示在搜索结果里。
  

2、Core Spotlight

当然，先导入最新的库CoreSpotlight.framework
使用起来非常简单，通常在获取网络数据返回后，讲获得数据item，添加到searchIndex中。

    NSMutableArray *items = [NSMutableArray array];
    for (likeItem *item in self.Model.likeItems) {
        CSSearchableItemAttributeSet * attrSet = [[CSSearchableItemAttributeSet alloc] initWithItemContentType:@"text"];
        NSString *title = item.forumName;
        [attrSet setTitle:title];
        NSString *desc = [NSString stringWithFormat:@"bar"];
        [attrSet setContentDescription:desc];
        CSSearchableItem *item = [[CSSearchableItem alloc] initWithUniqueIdentifier:item.uniqueIdentifier domainIdentifier:@"like items" attributeSet:attrSet];
        [items addObject:item];
    }
    [[CSSearchableIndex defaultSearchableIndex] indexSearchableItems:items completionHandler:^(NSError * _Nullable error) {
        
    }];

添加完搜索索引以后，与userActivity相同，通过spotLight搜索到的内容，点击需要跳转到我们自己的app中，并能够跳转到对应的界面。

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
{
    UITabBarController *tabBarController = (UITabBarController *)[self getTabBarController];
    UIViewController *vc = [tabBarController viewControllerAtIndex:0];
    [vc restoreUserActivityState:userActivity];
    return YES;
}

3、NSUserActivity与Spotlight相结合

在iOS9中NSUserActivity类的新增特性就是contentAttributeSet属性。这个属性允许你赋予一个CSSearchableItemAttributeSet， 正如你先前创建的那个。这个属性集合（attribute set）允许NSUserActivity对象的搜索结果可以展示如同 Core Spotlight搜索结果那样的相同数量的详细信息。

但是，在尝试两者结合时，遇到了一些问题，首先，activity中构造的userInfo字典不能够搜索完了restore，userInfo中只包涵一个key：（妈蛋，为啥上不了图）

  kCSSearchableItemActivityIdentifier

这个key从哪来的呢？

     CSSearchableItem *item = [[CSSearchableItem alloc] initWithUniqueIdentifier:item.uniqueIdentifier domainIdentifier:@"like items" attributeSet:attrSet];

就是这句话，kCSSearchableItemActivityIdentifier的Value就是CSSearchableItem初始化时，传入的参数uniqueIdentifier

再看下文档里怎么说：

// When opening a document from Spotlight, the application's application:willContinueUserActivityWithType:
// method will get called with CSSearchableItemActionType, followed by  application:continueUserActivity:restorationHandler: with an NSUserActivity where the userInfo dictionary has a single key value pair where CSSearchableItemActivityIdentifier is the key and the value is the uniqueIdentifier used when creating the item.
CORESPOTLIGHT_EXPORT NSString * const CSSearchableItemActionType CS_AVAILABLE(NA, 9_0);
CORESPOTLIGHT_EXPORT NSString * const CSSearchableItemActivityIdentifier CS_AVAILABLE(NA, 9_0);

CS_CLASS_AVAILABLE(NA, 9_0)
@interface CSSearchableItem : NSObject <NSSecureCoding, NSCopying>

- (instancetype)initWithUniqueIdentifier:(nullable NSString *)uniqueIdentifier //Can be null, one will be generated
                        domainIdentifier:(nullable NSString *)domainIdentifier
                            attributeSet:(CSSearchableItemAttributeSet *)attributeSet;

// Should be unique to your application group.
// REQUIRED since this is the way you will refer to the item to update the index / delete it from the index
// Starts with an UUID for ease of use, but you can replace it with an UID of your own before the item is first indexed if you wish.
@property (copy) NSString *uniqueIdentifier;

英文不好也能看懂，关键的方法：
application:willContinueUserActivityWithType:
会自动生成一个NSUserActivity对象，该对象的userInfo中只有一个Key，也就是上面看到的那个key。而对应的value就是在初始化CSSearchableItem时，传入的参数，相对于你的app，它必须是唯一的，同时，你可以传一个nil，但是，app会自动给你生成一个唯一的，作为restore时的唯一标识。

由此可见可以在CSSearchableItem初始化时，控制传入的参数，达到自己目的。比如，在我的项目中，我希望可以搜索两种信息，简单的说就是希望可以判断搜索内容的类型，并根据该类型跳转到对应ViewController，我是用的方法就是通过传入的uniqueIdentifier来做判断，进而根据其他参数初始化ViewController，跳转到该vc。

这样做挺low的，但是确实实现了我的需求，想来苹果不会搞出这么low的方法，先这样，等下篇文章（2）中，在对实现这个小需求中遇到的问题做进一步的探索，对NSUserActivity与Spotlight的结合问题再搞搞，搞清楚点，特别是那个userinfo字典，到底啥机制，好像初始化了没啥卵用哦，就为了多点信息？