iOS9中的Spotlight和Safari搜索可以直接搜到App内部的内容(注意不是app),Apple提供了让用户更容易找到他们想要的内容,哪怕这个内容是在某个App内部的,从而提高App的使用度和曝光度
-
应用示例:
- 腾讯新闻app
- app
- 新浪微博app
为了演示Core Spotlight是怎样工作的,我们创建一个比较简单的Demo用来展示朋友列表。然后你点击任意一个朋友的名字,你可以看到朋友的头像的具体信息。在演示具体的流程之前,我们先看看最终效果图。
- 在演示效果中可以看到,我在spotlight中检索相关朋友信息,可以看到他们的大致信息,然后点击一条信息,便可以跳转到自己app中的具体的朋友详情(注意是具体详情界面,而腾讯新闻app则是打开app而已,并没有跳转到详情页面)。
代码分析:
一.程序的入口
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
self.window = [[UIWindow alloc] init];
FriendTableViewController *vc = [[FriendTableViewController alloc] init];
UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:vc];
self.window.rootViewController = nav;
[self.window makeKeyAndVisible];
return YES;
}
二.模型Person
-每一条用户信息对应一个模型
Person.h声明:
@interface Person : NSObject
@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *identifer;
@property (nonatomic, copy) NSString *icon;
- (instancetype)initWithName:(NSString *)name identifer:(NSString *)identifer icon:(NSString *)icon;
Person.m实现:
@implementation Person
- (instancetype)initWithName:(NSString *)name identifer:(NSString *)identifer icon:(NSString *)icon {
if (self = [super init]) {
self.name = name;
self.identifer = identifer;
self.icon = icon;
}
return self;
}
@end
三.所有的朋友数据信息,我们用一个管理类来管理。我们定义为DataSource。这个管理类的职责:
- 1.存储所有的朋友数据信息。
- 2.保存用户信息到Core Spotlight的索引器中。
DataSource.h方法列表
@interface DataSource : NSObject
// 获取所有的用户列表数据信息
- (NSArray *)dataList;
// 保存所有用户数据信息到Core Spotlight的索引器中
- (void)savePeopleToIndex;
@end
DataSource.m方法实现
- 注意先将framework导入
工程->Build Phases->Link Binary With Libraries->搜索CoreSpotlight
// 导入头文件
#import
@implementation DataSource
- (NSArray *)dataList {
Person *becky = [[Person alloc] initWithName:@"Becky" identifer:@"1" icon:@"becky"];
Person *ben = [[Person alloc] initWithName:@"Ben" identifer:@"2" icon:@"ben"];
Person *jane = [[Person alloc] initWithName:@"Jane" identifer:@"3" icon:@"jane"];
Person *pete = [[Person alloc] initWithName:@"Pete" identifer:@"4" icon:@"pete"];
Person *ray = [[Person alloc] initWithName:@"Ray" identifer:@"5" icon:@"ray"];
Person *tom = [[Person alloc] initWithName:@"Tom" identifer:@"6" icon:@"tom"];
return @[becky, ben, jane, pete, ray, tom];
}
- (void)savePeopleToIndex {
// 设置搜索属性
NSMutableArray *searchableItems = [NSMutableArray array];
for (Person *p in self.dataList) {
CSSearchableItemAttributeSet *attributeSet = [[CSSearchableItemAttributeSet alloc] initWithItemContentType:@"image"];
attributeSet.title = p.name;
attributeSet.keywords = @[p.name];
attributeSet.contentDescription = [NSString stringWithFormat:@"这个家伙名字叫 %@", p.name];
attributeSet.thumbnailData = UIImagePNGRepresentation([UIImage imageNamed:p.icon]);
CSSearchableItem *item = [[CSSearchableItem alloc] initWithUniqueIdentifier:p.identifer domainIdentifier:@"chuanzhang" attributeSet:attributeSet];
// 过期的日期,默认过期的日期是一个月
// item.expirationDate = ;
[searchableItems addObject:item];
}
// 保存,将信息一项一项存入CoreSpotlight,以便用户搜索,显示搜索结果
// 单例
[[CSSearchableIndex defaultSearchableIndex] indexSearchableItems:searchableItems completionHandler:^(NSError * _Nullable error) {
if (error) {
NSLog(@"error message:%@", error.localizedDescription);
}
}];
}
代码的关键部分就是savePeopleToIndex方法,定义的searchableItems就是用来存储相关的可检索的信息;而代码中的CSSearchableIndex的单例方法indexSearchableItems是真正的将searchableItems中的内容存储到Core Spotlight中的操作
四.展示数据
4.1 FriendTableViewController.h方法声明
@class Person;
@interface FriendTableViewController : UITableViewController
// 根据用户Id获取模型数据
- (Person *)findFriendWithId:(NSString *)identifer;
@end
FriendTableViewController.m方法实现
这个比较简单,不解释了!
@interface FriendTableViewController ()
/*** 存放模型的数组 ***/
@property (nonatomic,strong) NSArray *dataList;
/*** person ***/
@property (nonatomic,strong) Person *person;
@end
@implementation FriendTableViewController
static NSString * const ID = @"cell";
- (void)viewDidLoad {
[super viewDidLoad];
DataSource *dataSource = [[DataSource alloc] init] ;
self.dataList = [dataSource dataList];
[dataSource savePeopleToIndex];
[self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:ID];
}
- (Person *)findFriendWithId:(NSString *)identifer {
for (Person *p in self.dataList) {
if ([p.identifer isEqualToString:identifer]) {
return p;
}
}
return nil;
}
#pragma mark - Table view data source
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.dataList.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID forIndexPath:indexPath];
Person *person = self.dataList[indexPath.row];
cell.textLabel.text = person.name;
return cell;
}
#pragma mark - Table view delegate
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
Person *person = self.dataList[indexPath.row];
DXViewController *vc = [[DXViewController alloc] init];
vc.person = person;
[self.navigationController pushViewController:vc animated:YES];
}
4.2详情界面展示代码:
DXViewController.h
@class Person;
@interface DXViewController : UIViewController
/*** 模型 ***/
@property (nonatomic,strong) Person *person;
@end
DXViewController.m
#import "DXViewController.h"
#import "Person.h"
@interface DXViewController ()
@property (weak, nonatomic) IBOutlet UIImageView *imageV;
@property (weak, nonatomic) IBOutlet UILabel *nameLable;
@end
@implementation DXViewController
- (void)viewDidLoad {
[super viewDidLoad];
Person *person = self.person;
self.imageV.image = [UIImage imageNamed:person.icon];
self.nameLable.text = person.name;
}
此时尝试点击一项,但是它不会跳转到app的指定区域,只会跳转到对应的app,因为我们还没有指定要跳转的指定区域;
五.跳转到指定界面(详情界面)
在AppDelegate中实现
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
{
// 获取你在spotlight中点击的朋友的id
NSString *friendID = userActivity.userInfo[@"kCSSearchableItemActivityIdentifier"];
NSLog(@"%@",friendID);
// 获取到根的导航控制,并且pop掉栈中所有的控制器
UINavigationController *navigationController = (UINavigationController *)self.window.rootViewController;
[navigationController popToRootViewControllerAnimated:NO];
FriendTableViewController *friendVC = (FriendTableViewController *)navigationController.viewControllers.firstObject;
DXViewController *vc = [[DXViewController alloc] init];
vc.person = [friendVC findFriendWithId:friendID];
[friendVC showViewController:vc sender:self];
return YES;
}