Χρησιμοποιώντας το API του πυρήνα Ios για να ενεργοποιήσετε την αναζήτηση περιεχομένου στην εφαρμογή σας

Δεν απαιτείται καμία πρόσθετη ρύθμιση του εξυπηρετητή ή άδεια χρήστη. Η ευρετηρίαση συμβαίνει ασύγχρονα στο παρασκήνιο.

Δημιουργία και ευρετηρίαση αναζητήσιμων αντικειμένων

Ο πυρήνας του Core Spotlight είναι το αντικείμενο . Κάθε αντικείμενο αποτελείται από:

• A μοναδικός αναγνωριστικός κωδικός (π.χ., ) ⁇ χρησιμοποιείται αργότερα για να χειριστεί την επιλογή ή τις ενημερώσεις.
• Ένα προαιρετικό αναγνωριστικό τομέα ⁇ στοιχεία που σχετίζονται με ομάδες (π.χ., ).
• Ένα σετ χαρακτηριστικών ([]] ⁇ περιγράφει το περιεχόμενο με ιδιότητες όπως , , ], ], και άλλα.

Εδώ είναι ένα πλήρες παράδειγμα Swift που ευρετηριάζει μια μόνο σημείωση:

import CoreSpotlight
import MobileCoreServices

func indexNote(note: Note) {
 let attributeSet = CSSearchableItemAttributeSet(itemContentType: kUTTypeText as String)
 attributeSet.title = note.title
 attributeSet.contentDescription = note.body
 attributeSet.keywords = [note.title] + note.tags
 if let imageData = note.thumbnail?.pngData() {
 attributeSet.thumbnailData = imageData
 }

 let item = CSSearchableItem(
 uniqueIdentifier: "com.yourapp.note.\(note.id)",
 domainIdentifier: "com.yourapp.notes",
 attributeSet: attributeSet
 )
 // Optionally set expiration date (default is one month)
 // item.expirationDate = Date.distantFuture

 CSSearchableIndex.default().indexSearchableItems([item]) { error in
 if let error = error {
 print("Indexing error: \(error.localizedDescription)")
 } else {
 print("Note indexed successfully.")
 }
 }
}

Ιδιότητες ρύθμισης χαρακτηριστικών

Η κληρονομεί από [] και προσφέρει δεκάδες ιδιοκτησίες. Για τις περισσότερες εφαρμογές τα ακόλουθα είναι απαραίτητα:

• ⁇ Σύντομο, περιγραφικό κείμενο που εμφανίζεται εξέχοντα.
• ⁇ Ένα μακρύτερο κομμάτι που φαίνεται κάτω από τον τίτλο.
• ⁇ Εντολή του για εναλλακτικούς όρους αναζήτησης.
• ή ⁇ Οπτική προεπισκόπηση.
• ⁇ Συνδέει στοιχεία μαζί (π.χ., σημειώσεις γονέα ⁇ παιδιού).

Για το περιεχόμενο των μέσων, χρησιμοποιήστε ιδιότητες τύπου όπως , ] ή .

Ενημέρωση και διαγραφή ευρετηρίου περιεχομένου

Όταν αλλάζει το περιεχόμενο της εφαρμογής σας, πρέπει να διατηρείτε το ευρετήριο σε συγχρονισμό. Χρησιμοποιήστε τις ίδιες [[LFT:23]] μεθόδους:

Ενημέρωση ενός αντικειμένου

Καλέστε με το ίδιο μοναδικό αναγνωριστικό ⁇ το API αντικαθιστά αυτόματα την παλιά καταχώρηση.

Διαγραφή αντικειμένων

Χρήση ή για την αφαίρεση του μπαγιάτικου περιεχομένου:

CSSearchableIndex.default().deleteSearchableItems(withIdentifiers: ["com.yourapp.note.123"]) { error in
 // handle
}

Οι εργασίες παρτίδας είναι αποτελεσματικές: περνούν τις συστοιχίες σε [[LFT:28]] ή [[LFT:29]]. Για πλήρη επαναφορά, χρησιμοποιήστε [[LFT:30]] (μεγάλη ανάγκη).

Χειρισμός Δραστηριότητας χρήστη και Βαθιά σύνδεση

Όταν ένας χρήστης χρησιμοποιεί ένα αποτέλεσμα Spotlight, η εφαρμογή σας λαμβάνει κλήση μέσω της συνέχειας. Εφαρμογή της ακόλουθης μεθόδου ανάθεσης στην ] ή :

func application(_ application: UIApplication,
 continue userActivity: NSUserActivity,
 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {

 if userActivity.activityType == CSSearchableItemActionType {
 if let userInfo = userActivity.userInfo,
 let identifier = userInfo[CSSearchableItemActivityIdentifier] as? String {
 // Navigate to the item with this identifier
 navigateToContent(identifier: identifier)
 return true
 }
 }
 return false
}

Κράτος αποκατάστασης

Για μια ομαλότερη εμπειρία, εφαρμόστε επίσης για να εμφανίσετε κατάσταση φόρτωσης. Σε εφαρμογές με βάση τη σκηνή (iOS 13+), χρησιμοποιήστε τη μέθοδο .

Βαθιά σύνδεση με την NSUSerActivity

Το κεντρικό φως λειτουργεί επίσης με το μηχανισμό . Αν έχετε ήδη ευρετηριάσει δραστηριότητες μέσω [[LFT:39]]], μπορείτε να προσθέσετε τη σημαία [[LFT:40]]. Ωστόσο, για τον λεπτομετρημένο έλεγχο των τίτλων και των περιγραφών, χρησιμοποιήστε [[[LFT:41]] απευθείας.

Βέλτιστες πρακτικές για την αποτελεσματική ευρετηρίαση

Ακολουθώντας αυτές τις οδηγίες, το περιεχόμενο σας παραμένει σχετικό και performant:

1. Δείκτης μόνο σημαντικό περιεχόμενο

Μην index κάθε μικροσκοπικό κομμάτι των δεδομένων. Εστίαση σε στοιχεία οι χρήστες είναι πιθανό να αναζητήσουν: πρόσφατα έγγραφα, σελίδες υψηλής αξίας, ή σελιδοδείκτη περιεχόμενο.

2. Καθορίστε τις ημερομηνίες λήξης της κατάλληλης περιόδου

Εξ ορισμού, τα στοιχεία λήγουν μετά από ένα μήνα. Για στατικό περιεχόμενο, ρυθμίστε [[LFT:42]]. Για δεδομένα ευαίσθητα στο χρόνο (π.χ. υπενθυμίσεις γεγονότων), χρησιμοποιήστε μια ρεαλιστική ημερομηνία.

3. Χρησιμοποιήστε τους αναγνωριστικούς τομέα Σοφά

Τα αναγνωριστικά τομέα σας επιτρέπουν να διαγράψετε όλα τα αντικείμενα από μια ομάδα ταυτόχρονα. Για παράδειγμα, αν ένας χρήστης διαγράψει ένα φάκελο, καλέστε .

4. Παρέχετε σημαντικές λέξεις-κλειδιά

Περιλαμβάνουν συνώνυμα, κοινά ορθογραφικά, και εναλλακτικές ονομασίες. Αποφύγετε την υπερφόρτωση? 5 ⁇ 10 καλά-επιλεγμένες λέξεις-κλειδιά είναι αρκετά.

5. Αποφύγετε την ευρετηρίαση διπλής περιεχομένου

Αν αναπαραγάγετε αντικείμενα (π.χ. τον ίδιο τίτλο σε διαφορετικούς τομείς), οι χρήστες βλέπουν συγκεχυμένα αποτελέσματα. Αποτυπώστε στο επίπεδο εφαρμογής.

6. Επιχειρήσεις παρτίδας για μαζικές ενημερώσεις

Κατά τον συγχρονισμό πολλών αντικειμένων (π.χ., μετά από μια αποκατάσταση σύννεφου), τα τοποθετείτε σε συστοιχίες 50 ⁇ 100 για να αποφύγετε το μπλοκάρισμα του κύριου νήματος. Χρησιμοποιήστε [[LFT:44]] με μια συστοιχία, όχι πολλαπλές μεμονωμένες κλήσεις.

Επιδόσεις και παρατηρήσεις μπαταρίας

Το κεντρικό φως του φωτός τρέχει μια διαδικασία φόντου χαμηλής προτεραιότητας.

• Συχνότητα επαναindexing περιορισμών ⁇ Μόνο reindex όταν τα δεδομένα αλλάζουν πραγματικά, όχι σε κάθε app λανσάρουν.
• Μεγάλες λειτουργίες ⁇ Χρήση και [διαθέσιμη στις ]) για ατομικές ενημερώσεις.
• Αποφύγετε τις βαριές εικόνες ⁇ θα πρέπει να είναι μικρές (π.χ., 64×64 βαθμοί, JPEG συμπιεσμένες).
• Χρησιμοποιήστε τον προεπιλεγμένο δείκτη ⁇ είναι αρκετό για όλες σχεδόν τις εφαρμογές. Σπάνια απαιτείται η δημιουργία προσαρμοσμένων ευρετηρίων.

Η τεκμηρίωση του Core Spotlight της Apple τονίζει ότι η ευρετηρίαση πρέπει να αντιμετωπίζεται ως “πυρκαγιά και λησμονιά” ⁇ μην περιμένετε συγχρονισμένα για την ολοκλήρωση των κλήσεων στο κύριο νήμα.