{"id":37631,"date":"2016-07-14T16:26:42","date_gmt":"2016-07-14T10:56:42","guid":{"rendered":"http:\/\/www.tothenew.com\/blog\/?p=37631"},"modified":"2022-01-13T14:32:35","modified_gmt":"2022-01-13T09:02:35","slug":"introduction-to-core-spotlight-framework","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/introduction-to-core-spotlight-framework\/","title":{"rendered":"Introduction to Core Spotlight Framework"},"content":{"rendered":"

Core Spotlight APIs introduced in iOS 9<\/a> that allows your content searchable to users. Core Spotlight Framework has a design different than NSUserActivity that also allows apps content to be Searchable. It follows a database-style design and allows you to provide more information about a searchable content.<\/p>\n

For more on NSUserActivity read Spotlight Search APIs and Introduction to NSUserActivity.<\/p>\n

Indexing Data For The Spotlight<\/h2>\n

Now let’s say we have a list and on selection, it shows some details for the selected item. We need these items to show up in our spotlight results.<\/p>\n

To make this happen we index the searchable items with Core Spotlight API. But neither our app nor the CS API decides what kind of data this is going to be. It\u2019s our responsibility to prepare that data and provide it to the API in a specific format. Each searchable result is represented by a single CSSearchableItem object which contains all the attributes with details of the searchable item.<\/p>\n

For your reference, please refer to official documentation link<\/a> so that you check out all the supported properties.<\/p>\n

Indexing the data for the Spotlight is the last action that should always be done. The usual and normal flow involve the following steps (including indexing):<\/p>\n

Set the attributes for each CSSearchableItemAttributeSet object.
\nInitialise a searchable item for each CSSearchableItem object.
\nCollect all searchable items into an array.
\nIndex the data for the Spotlight using the above array.<\/p>\n

We need import two frameworks first:<\/p>\n

import CoreSpotlight
\nimport MobileCoreServices<\/code><\/p>\n

Method to index the items for search is as follows.<\/p>\n

func setupSearchableContent() {
\n\/\/
\nvar searchableItems = [CSSearchableItem]()
\nfor i in 0...(moviesInfo.count - 1) {
\nlet movie = moviesInfo[i] as! [String: String]
\n\/\/ ----- Set the attributes for each CSSearchableItemAttributeSet object.------
\nlet searchableItemAttributeSet = CSSearchableItemAttributeSet(itemContentType: kUTTypeText as String)
\n\/\/ Set the title.
\nsearchableItemAttributeSet.title = movie[\"Title\"]!
\n\/\/ Set the movie image.
\nlet imagePathParts = movie[\"Image\"]!.componentsSeparatedByString(\".\")
\nsearchableItemAttributeSet.thumbnailURL = NSBundle.mainBundle().URLForResource(imagePathParts[0], withExtension: imagePathParts[1])
\n\/\/ Set the description.
\nsearchableItemAttributeSet.contentDescription = movie[\"Description\"]!
\nvar keywords = [String]()
\nlet movieCategories = movie[\"Category\"]!.componentsSeparatedByString(\", \")
\nfor movieCategory in movieCategories {
\nkeywords.append(movieCategory)
\n}
\nlet stars = movie[\"Stars\"]!.componentsSeparatedByString(\", \")
\nfor star in stars {
\nkeywords.append(star)
\n}
\nsearchableItemAttributeSet.keywords = keywords
\n\/\/ ----- Initialise a searchable item for each CSSearchableItem object. -----
\nlet searchableItem = CSSearchableItem(uniqueIdentifier: \u201ccom.ttnd.appName\u201d, domainIdentifier: \"movies\", attributeSet: searchableItemAttributeSet)
\n\/\/ ----- Collect all searchable items into an array. -----
\nsearchableItems.append(searchableItem)
\n}
\n\/\/ ----- Index the data for the Spotlight using the above array -----
\nCSSearchableIndex.defaultSearchableIndex().indexSearchableItems(searchableItems) { (error) -> Void in
\nif error != nil {
\nprint(error?.localizedDescription)
\n}
\n}
\n}<\/code><\/p>\n

Implementing Targeted Landing<\/h2>\n

For now, we made the item searchable. It won’t take us to details page just yet, it will only open the application. Now we need to make the action wherein the user selects the result.
\nFor this, we need to implement two methods in our Application.<\/p>\n

application(_:continueUserActivity:restorationHandler:)
\nrestoreUserActivityState(_:)<\/code><\/p>\n

Implement the application(_:continueUserActivity:restorationHandler:) method in the AppDelegate class as follows.<\/p>\n

func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {
\nlet viewController = (window?.rootViewController as! UINavigationController).viewControllers[0] as! ViewController
\nviewController.restoreUserActivityState(userActivity)
\nreturn true
\n}<\/code><\/p>\n

Now in viewController implement the restoreUserActivityState(_:) method as follows.<\/p>\n

override func restoreUserActivityState(activity: NSUserActivity) {
\nif activity.activityType == CSSearchableItemActionType {
\nif let userInfo = activity.userInfo {
\nlet selectedMovie = userInfo[CSSearchableItemActivityIdentifier] as! String
\nselectedMovieIndex = Int(selectedMovie.componentsSeparatedByString(\".\").last!)
\nperformSegueWithIdentifier(\"idSegueShowMovieDetails\", sender: self)
\n}
\n}
\n}<\/code><\/p>\n

Check out the gif example below which shows the app “Programmers” with Search API Implemented and performing the search using keywords.<\/p>\n

http:\/\/resizeimage.net\/viewimg\/nNqKlt5C6f2qH3sF\/qIfm6\/ezgif-com-video-to-gif.gif<\/p>\n","protected":false},"excerpt":{"rendered":"

Core Spotlight APIs introduced in iOS 9 that allows your content searchable to users. Core Spotlight Framework has a design different than NSUserActivity that also allows apps content to be Searchable. It follows a database-style design and allows you to provide more information about a searchable content. For more on NSUserActivity read Spotlight Search APIs […]<\/p>\n","protected":false},"author":326,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"aside","meta":{"iawp_total_views":5},"categories":[1400,1772,1994,1],"tags":[4848,3207,3566,2703,3752],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/37631"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/326"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=37631"}],"version-history":[{"count":1,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/37631\/revisions"}],"predecessor-version":[{"id":54648,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/37631\/revisions\/54648"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=37631"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=37631"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=37631"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}