iOS9 每日学习第1天:Search APIs

在 iOS9 之前,你只能在 spotlight 中输入关键字,比如应用名字,搜索到应用。在 iOS9 中苹果提供了一套 Search APIs。允许开发者选择应用的内容,索引起来供 spotlight 进行搜索,同时可以设置在 spotlight 中的展示效果,以及点击之后如何响应。

3个新的搜索相关API

NSUserActivity

NSUserAcitivity 在介绍 iOS8 的 Handoff 时引入,iOS9 中允许对这些 activities 进行搜索。你可以提供元数据给这些 activities, 这意味着 sptlight 可以索引这些内容。类似于浏览器展示网页的做法(你打开过的历史页面被记录了下来),用户可以快速的在 Spotlight中搜索,打开最近的 activities。

Web Markup

Web Markup 允许应用镜像自己的内容,并在 Spotlight 中建立索引。用户并不需要应用安装在自己的设备上来展示搜索结果。苹果的爬虫自己去抓取你网站上打了 markup 的内容,这些内容稍后会提供给 Safari 和 Spotlight。

事实上,这个重要的特性,甚至并不需要用户安装了你的应用在自己的设备上。这样可以将你的应用展示给更多的潜在用户。苹果的云服务,将你的应用的内容索引起来,让你的应用和 public Search APIs 保持一个深度连接。更多关于Web Markup 的内容,可以阅读苹果官方的文档 《Use Web Markup to Make App Content Searchable》

CoreSpotlight

CoreSpotlight 是 iOS9 提供的新 Freamework,允许你索引你的应用内容。当使用它的 Api,你可以方便的将你喜欢的数据,索引起来,NSUserActivity  帮助存储用户的使用历史。它让你的应用可以底层的和 CoreSpotlight 进行连接,将索引存储在用户设备上。

使用 Core Spotlight APIs

NSUserActivity 和 Markup 更简单和容易使用一些, CoreSpotlight 则相对复杂一些。为了示范Core Spotlight APIs 是怎么工作的,让我们来创建一个简单的应用。这个应用展示我的一个朋友列表,点击朋友的名字可以查看照片。你可以在 Github 上找到源文件。

这个应用有一个简单的 storyboard, 包含两个 controller,  FriendTableViewController 展示一个列表,每行显示一个朋友的名字, FriendViewController 展示朋友的详细信息。

首先,我们重载 Datasource 类的 init() 方法,创建和存储一个包含 Person 对象的数组。你可能希望从数据库中,或者你的服务器加载数据,这里只是为了展示,所以我们选择创建简单的模拟数据。

一旦数据存储到了 People 这个数组中,Datasource 类就准备好可以用了。

现在数据准备好了,在FriendTableViewController 中创建一个 instance, 给 table 的 cell 来展示数据。

在 cellForRowAtIndexPath 方法中,展示内容

现在,模拟数据已经准备好了。我们用 iOS9 提供的新 API  把他们存储到 Core Spotlight 中。回到Datasource 类中,我们创建一个 savePeopleToIndex 方法。这个可以在FriendTableViewController的视图加载完成后调用。

最后一步是调用 CSSearchableIndex的indexSearchableItems 方法。它会真正的把 items 存储到CoreSpotlight 中,这样用户就可以搜索和展示出结果了。

好了,当你运行一下你的应用后,数据就索引起来了,当你在 spotlight 中搜索时,朋友的信息出来了。

响应用户的选中事件

现在用户看到了搜索的结果,希望他们会点击一下。但是,如果现在他们点击了,会怎么样呢?只会打开你的应用。如果你希望跳转至展示用户点击的朋友的详细信息,你还需要再做一点点工作。当用户用点击的方式打开应用时。,我们可以通过 UIApplicationDelegate 中的continueUserActivity,具体规定应用的行为。

如你所见,我们之前,通过 indexSearchableItems 方法,存储在 CoreSpotligh t中的信息,现在可以让 userActivity.userInfo 字典使用了。我们唯一感兴趣的是 friend ID, 之前我们 items 的 kCSSearchableItemActivityIdentifier 存储在了索引中。

一旦我们从 userInfo 字典中拿到数据,我们找到应用的 navigation controller, 然后退到root(不用动画,以免用户察觉异样),然后调用 showFriend 方法。我不详细讲这些了。总之,大体上就是根据 friend ID, 找到 friend 的详细信息的数据,然后 push 了一个新的 ViewController 来展示他。这就是所有的操作了,现在,当用户点击一个结果时,应用被打开,同时到了这个朋友的详细页面。

如你所见,在应用左上角有一个“回到搜索”的按钮,可以让用户直接快速的返回到Spotlight,当然也可以在应用中,点击标准按钮,来切换页面。

Demo 总结

在上面的demo中,我们展示了,多么简单就可以把应用的内容索引到 CoreSpotlight 中,对于用户搜索特定内容多么有帮助,多么强大的吸引用户打开你的应用。

我们没有展示如何从索引中移除数据。这对你来说很重要,要时刻保持 spotlight 中的数据是最新的。要了解怎么移除旧的数据,可以翻阅相关文档,查看deleteSearchableItemsWithIdentifiers, deleteSearchableItemsWithDomainIdentifiers 和 deleteAllSearchableItemsWithCompletionHandler这三个方法。

好公民准则的重要性

看起来存储尽可能多的内容到 Spotlight 和 Safari 中是个好主意,但是希望大家能够在 iOS 的生态系统中做个好公民,遵守让用户高兴的准则。并且 Apple 也会注意到你的行为,他们设置了相关的规则,一旦发现恶意的使用 Spotlight,你的内容很容易被移到搜索的最后。

延伸阅读

想了解更多的关于Search APIs的内容,推荐你收看WWDC 2015的 session 709,Introducing Search APIs. 你也会对阅读文档《NSUserActivity Class Reference》《documentation for CoreSpotlight》感兴趣。

最后,别忘了,如果你想试一试我们刚创建的demo,可以到Githubthub中去下载。

1 4 收藏 评论

可能感兴趣的话题



直接登录
跳到底部
返回顶部