iOS实现APP支持SpotLight搜索
#import
CoreSpotlight.framework
NSUserActivity（参考：http://www.jianshu.com/p/2ec61e2c00cb）
NSUserActivity包含了一些新的方法和属性来帮助我们实现索引activities和应用状态使他们在搜索结果中可用。每一个应用都可以利用NSUserActivity API来生成对于用户来说更有用的内容。顺便提一句NSUserActivity在iOS8中的Handoff就已经被引入了。
@interface LilithViewController ()
// 注意:必须是强引用
@property (nonatomic, strong)NSUserActivity *activity;
@end
@implementation LilithViewController
- (void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = [UIColor whiteColor];
self.navigationItem.title =@"Lilith";
[selfaddUserActivity];
}
- (void)addUserActivity{
// 使用唯一标识符 @"lilith"创建一个新的NSUserActivity对象
// 这个工程已经被配置成确保使用这个标识符时要保证它不会被改变
_activity = [[NSUserActivity alloc]initWithActivityType:@"lilith"];
// 这就是将会在Spotlight搜索结果里出现的内容
_activity.title = @"Lilith";
// 搜索的关键字
// 为了确保可搜寻的内容不仅止限于应用的标题，你也要提供一系列的关键字
_activity.keywords = [NSSet setWithArray:@[@"Lilith"]];
// 是否将用户活动转交到其他设备
_activity.eligibleForHandoff = NO;
// 是否显示历史搜索记录
_activity.eligibleForSearch = YES;
// 它自动的被加入到了设备的搜索结果索引中
[_activity becomeCurrent];
// 过期时间,比如新闻一周后就过期
// _activity.expirationDate =
// 每个控制器的user activity和搜索结果都是仅当应用曾经被打开过时而创建的
// _activity.eligibleForPublicIndexing = YES;
[_activity becomeCurrent];
}
********************
在AppDelegate方法中监听Spotlight中的点击
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *_Nullable))restorationHandler
{
UINavigationController *navi = (UINavigationController *)self.window.rootViewController;
[navi.topViewControllerrestoreUserActivityState:userActivity];
returnYES;
}
在ViewController中实现跳转
- (void)restoreUserActivityState:(NSUserActivity *)activity{
if ([activity.titleisEqualToString:@"Adam"]) {
AdamViewController *adamView = [[AdamViewControlleralloc]init];
[self.navigationController pushViewController:adamView animated:YES];
}elseif([activity.titleisEqualToString:@"Lilith"]){
LilithViewController *lilithView = [[LilithViewControlleralloc]init];
[self.navigationController pushViewController:lilithView animated:YES];
}else if([activity.titleisEqualToString:@"Eve"]){
EveViewController *eveView = [[EveViewControlleralloc]init];
[self.navigationController pushViewController:eveView animated:YES];
}
}
====================Web Markup
这一特性允许应用镜像自己的内容，并在Spotlight中建立自己的引用。苹果的爬虫会抓取你的网站上打了markup的内容，而这些内容会提供给Safari和Spotlight。这个特性的神奇之处在于。用户不需要将你的应用安装在手机上。这样你的应用可以更多的展示给潜在用户。苹果的云服务会索引你的内容，让你的应用与Public Search API保持深度的链接会让你收益颇多。
Core Spotlight
新的CoreSpotlight(framework)是iOS9提供的一组新的API来帮助你建立起你的应用中的索引。CoreSpotlight是用来处理用户数据的比如：文档，照片以及其他类型的由用户产生的内容。
- (void)saveData{
NSMutableArray *seachableItems = [NSMutableArraynew];
[self.titleArrenumerateObjectsUsingBlock:^(NSString *__nonnull obj,NSUInteger idx, BOOL *__nonnull stop) {
/*创建属相集合，应用内搜索，想搜索到多少个界面就要创建多少个set，每个set都要对应一个item，*/
CSSearchableItemAttributeSet *attributeSet = [[CSSearchableItemAttributeSetalloc] initWithItemContentType:@"views"];//ContentType就是做一个标记
attributeSet.title = obj;//主标题
attributeSet.contentDescription = [NSStringstringWithFormat:NSLocalizedString(@"spotlight测试 %@", nil),obj];//详细标题
attributeSet.contactKeywords = @[@"自己做的",@"obj02",@"obj03"];//搜索关键字
//设置图片----可以通过data设置，可以通过url设置
UIImage *thumbImage = [UIImageimageNamed:@"tg"];//缩略图
attributeSet.thumbnailData =UIImagePNGRepresentation(thumbImage);
//这里的url也必须是本地文件路径，而不是网络图片url
// firstSet.thumbnailURL = [NSURL URLWithString:@"http://www."];
//一个条目中的属性集合和搜索的唯一标示UniqueIdentifier和删除的唯一标识domainIdentifier绑定。UniqueIdentifier每个搜索都有一个唯一标示，当用户点击搜索到得某个内容的时候，系统会调用代理方法，会将这个唯一标示传给你，以便让你确定是点击了哪一，方便做页面跳转
//domainIdentifier搜索域标识，删除条目的时候调用的delegate会传过来这个值
CSSearchableItem *item = [[CSSearchableItemalloc] initWithUniqueIdentifier:obj domainIdentifier:@"com.kdanmobile.CoreSpotlightDemo" attributeSet:attributeSet];
[seachableItems addObject:item];//条目集合
}];
//吧条目集合添加上索引
[[CSSearchableIndexdefaultSearchableIndex] indexSearchableItems:seachableItems
completionHandler:^(NSError *__nullable error) {
if (!error)
NSLog(@"%@",error.localizedDescription);
}];
}
=======实现例子二：
- (void)setupSpotlight
{
if ([UIDevicecurrentDevice].systemVersion.floatValue < 9.0) {
return;
}
//搜索的时候是根据title（主标题），contentDescription（副标题），contactKeywords（关键字集合），来搜索的。
/*应用内搜索，想搜索到多少个界面就要创建多少个set，每个set都要对应一个item*/
CSSearchableItemAttributeSet *firstSet = [[CSSearchableItemAttributeSetalloc]initWithItemContentType:@"第一"];
//标题
firstSet.title =@"one";
//详细描述
firstSet.contentDescription =@"第一个";
//关键字
firstSet.contactKeywords = @[@"first",@"测试",@"firstView"];
//设置图片
//这里的url也必须是本地文件路径，而不是网络图片url
// firstSet.thumbnailURL = [NSURL URLWithString:@"http://www."];
//也可以用这个图片加载方法
firstSet.thumbnailData =UIImagePNGRepresentation([UIImageimageNamed:@"tg"]);
/*
这里有个小细节：
设置的图片展示的效果系统并不会给你处理，意思是说，如果你传了一张长方形的图片做封面icon，你在搜索列表上展示的icon就是长方形的，如果长宽比很大的话，很很难看，所以这里尽量保证图片趋近去正方形，使得展示效果好看点。
或者在自己裁剪处理下趋近正方形。
*/
CSSearchableItemAttributeSet *secondSet = [[CSSearchableItemAttributeSetalloc]initWithItemContentType:@"第二"];
secondSet.title =@"two";
secondSet.contentDescription =@"第二个";
secondSet.contactKeywords = @[@"second",@"测试",@"secondView"];
secondSet.thumbnailData =UIImagePNGRepresentation([UIImageimageNamed:@"lczq"]);
//一个条目中的属性集合和搜索的唯一标示UniqueIdentifier和删除的唯一标识domainIdentifier绑定。UniqueIdentifier每个搜索都有一个唯一标示，当用户点击搜索到得某个内容的时候，系统会调用代理方法，会将这个唯一标示传给你，以便让你确定是点击了哪一，方便做页面跳转
//domainIdentifier搜索域标识，删除条目的时候调用的delegate会传过来这个值
CSSearchableItem *firstItem = [[CSSearchableItemalloc] initWithUniqueIdentifier:@"firstItem"domainIdentifier:@"first"attributeSet:firstSet];
CSSearchableItem *secondItem = [[CSSearchableItemalloc] initWithUniqueIdentifier:@"secondItem"domainIdentifier:@"second"attributeSet:secondSet];
NSArray *items = @[firstItem,secondItem];
//把上面的设置item都添加进入
[[CSSearchableIndexdefaultSearchableIndex] indexSearchableItems:items completionHandler:^(NSError *_Nullable error) {
if (error) {
NSLog(@"失败%@",error);
}
else {
NSLog(@"成功");
}
}];
}
现在我们点击搜索到相应的项还只能打开我们的应用，如果要实现跳转还需要进行一小步的工作：在AppDelegate中实现
//在APPdelegate中实现这个方法
//点击搜索到的结果，会自动掉用下面的方法，根据搜索标识跳转到相应界面
- (BOOL)application:(nonnullUIApplication *)application continueUserActivity:(nonnullNSUserActivity *)userActivity restorationHandler:(nonnullvoid (^)(NSArray *__nullable))restorationHandler{
//获取点击的搜索唯一标识
NSString *identifier = userActivity.userInfo[@"kCSSearchableItemActivityIdentifier"];
UIViewController *VC =self.window.rootViewController;
if([identifierisEqualToString:@"firstItem"]){
[VC presentViewController:[[OneVCalloc]init]animated:YEScompletion:nil];
}elseif([identifier isEqualToString:@"secondItem"]){
[VC presentViewController:[[TwoVCalloc]init]animated:YEScompletion:nil];
}
returnYES;
}
====删除的方法=========
我们有时候并不是创建完Spotlight索引就没其他事了，可能会在用户的账号退出的时候去对索引进行一个清除，及换账号时候的重建，这时候我们会用到删除索引的功能，apple提供给我们三个方法去：
- (void)deleteSearchableItemsWithIdentifiers:(NSArray<NSString *> *)identifiers completionHandler:(void (^__nullable)(NSError *__nullable error))completionHandler{
//根据搜索标志来删除条目
}
//根据删除标识来删除条目
- (void)deleteSearchableItemsWithDomainIdentifiers:(NSArray<NSString *> *)domainIdentifiers completionHandler:(void (^__nullable)(NSError *__nullable error))completionHandler{
}
- (void)deleteAllSearchableItemsWithCompletionHandler:(void (^__nullable)(NSError *__nullable error))completionHandler{
//删除所有的条目
}