Τεχνική εις βάθος ανάλυση

Δημιουργία ενός εγγενούς Emoji Picker για macOS σε Swift

Χωρίς Electron, χωρίς περιττό βάρος

Αυτό είναι το ημερολόγιο ανάπτυξης πίσω από το Emoji Picker για macOS. Το φτιάξαμε επειδή το προεπιλεγμένο εργαλείο επιλογής διέκοπτε συνεχώς τη ροή της γραφής μας όταν συνομιλούσαμε. Η ενσωματωμένη επιλογή απαιτούσε μετάβαση στο ποντίκι και ήταν αργή. Ο στόχος ήταν απλός: πληκτρολογείτε, επιλέγετε και συνεχίζετε.

Δημοσιεύτηκε 2026-02-16 · από την inndevs GmbH

Σε αυτή την ανάλυση

Το πραγματικό πρόβλημα στη ροή εργασίας

Το macOS διαθέτει ήδη εργαλείο επιλογής emoji. Για περιστασιακή χρήση είναι μια χαρά. Σε ροές εργασίας με πολύ κείμενο, μας καθυστερούσε. Ανοίγετε το πάνελ, πηγαίνετε στο ποντίκι, επιλέγετε, κλείνετε το πάνελ, ξαναβρίσκετε τον ειρμό σας. Επαναλάβετέ το δεκάδες φορές τη μέρα και το κόστος της διακοπής γίνεται προφανές.

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

  • Οι ροές εργασίας υποστήριξης και tickets χρειάζονται γρήγορες εισαγωγές κατά τη διαλογή πολλών σύντομων μηνυμάτων.
  • Σε σχόλια αναθεώρησης κώδικα και μηνύματα commit συνήθως ξέρουμε ήδη τι θέλουμε, οπότε η περιήγηση σε κατηγορίες είναι πιο αργή από την πληκτρολόγηση μιας αναζήτησης.
  • Η εναλλαγή του πάνελ πάνω από 40 φορές τη μέρα σπάει γρήγορα τον ρυθμό της πληκτρολόγησης.

Αρχιτεκτονικές αποφάσεις

Χειρισμός καθολικών πλήκτρων συντόμευσης

Η εισαγωγή βασίζεται σε ένα Core Graphics event tap και μια προστατευμένη μηχανή καταστάσεων. Ένα περιορισμένο buffer στη μνήμη κρατά τους πιο πρόσφατους εκτυπώσιμους χαρακτήρες της εφαρμογής που βρίσκεται μπροστά, ώστε να αναγνωρίζεται το ρυθμισμένο πλήκτρο ενεργοποίησης. Μηδενίζεται όταν αλλάζει η εφαρμογή, με συντομεύσεις, μη εκτυπώσιμη εισαγωγή και ακύρωση. Μια ρυθμιζόμενη καθυστέρηση του αναδυόμενου παραθύρου κρατά τη διεπαφή ήρεμη όσο πληκτρολογείται ακόμη η αναζήτηση.

Απόφαση NSPanel έναντι NSPopover

Ξεκινήσαμε με NSPopover και περάσαμε σε NSPanel. Το NSPopover έχανε πολύ εύκολα την εστίαση στο Slack και στο Chrome κατά τις γρήγορες εναλλαγές εφαρμογών. Το NSPanel μάς έδωσε ρητό έλεγχο του κύκλου ζωής και προβλέψιμη δρομολόγηση του πληκτρολογίου ανάμεσα στις εφαρμογές.

Άδεια Προσβασιμότητας και στρατηγική εισαγωγής

Η άδεια Προσβασιμότητας επιτρέπει στο Emoji Picker να παρακολουθεί αυτά τα καθολικά συμβάντα και να στέλνει συμβάντα πληκτρολογίου πίσω στην ενεργή εφαρμογή. Απορρίψαμε την εισαγωγή μέσω προχείρου, επειδή η αντικατάσταση του περιεχομένου του προχείρου είναι απρόσμενη και δύσκολα εμπνέει εμπιστοσύνη. Η εφαρμογή δεν επιθεωρεί πεδία κειμένου μέσω AXUIElement· καταγράφει ποια εφαρμογή είναι μπροστά όταν ξεκινά μια περίοδος και επαληθεύει ότι η ίδια εφαρμογή είναι ακόμη μπροστά πριν από την εισαγωγή.

Αντικατάσταση μετρημένου κειμένου

Μια ενσωματωμένη περίοδος μετρά τους χαρακτήρες ενεργοποίησης και αναζήτησης που έφτασαν στην εφαρμογή-στόχο. Κατά την επιλογή, το Emoji Picker στέλνει ισάριθμα πατήματα Backspace και έπειτα στέλνει το επιλεγμένο κείμενο Unicode ως συνθετικό συμβάν πληκτρολογίου. Δεν αλλάζει ποτέ το πρόχειρο. Ορισμένα προσαρμοσμένα στοιχεία ελέγχου μπορεί να ερμηνεύουν διαφορετικά τα συνθετικά συμβάντα πληκτρολογίου· γι’ αυτό έχουν σημασία οι έλεγχοι της εφαρμογής-στόχου και η συμπεριφορά ακύρωσης.

Κανόνες ανίχνευσης πλαισίου

Αυτοί είναι οι πρακτικοί κανόνες που χρησιμοποιούμε για να παραμένει η ενεργοποίηση προβλέψιμη:

  • Αγνόηση των παραθύρων του ίδιου του Emoji Picker και των εφαρμογών της λίστας εξαιρέσεων του χρήστη.
  • Σύνδεση της πρόσφατης εισαγωγής και κάθε ενεργής περιόδου με την εφαρμογή που βρίσκεται μπροστά· η αλλαγή εφαρμογής ακυρώνει την περίοδο.
  • Αντιστοίχιση του ρυθμισμένου πλήκτρου ενεργοποίησης με ένα περιορισμένο τελικό τμήμα της πρόσφατης εκτυπώσιμης εισαγωγής.
  • Αποδεκτά σε ενσωματωμένη αναζήτηση είναι γράμματα, αριθμοί, κάτω παύλα, συν και ενωτικό· οποιαδήποτε άλλη εισαγωγή την ακυρώνει.
  • Εφαρμογή της λίστας αποκλεισμού αρχικών ακολουθιών του χρήστη, του ελάχιστου μήκους αναζήτησης και της καθυστέρησης του αναδυόμενου παραθύρου πριν από την εμφάνιση της διεπαφής.
  • Υποστήριξη προσαρμογής του πλήκτρου άμεσου ανοίγματος (για παράδειγμα ;; ή //) για χρήστες που προτιμούν ρητή ενεργοποίηση.

Απλοποιημένη λογική κατάστασης (συντομευμένη για αναγνωσιμότητα):

func handle(_ event: KeyEvent, frontmostApp: App) {
    guard frontmostApp != emojiPicker, !isExcluded(frontmostApp) else {
        resetRecentInput()
        return
    }

    if session == nil, recentInput.appending(event).hasSuffix(inlineTrigger) {
        session = .inline(target: frontmostApp, deleteCount: inlineTrigger.count)
    } else if session?.accepts(event) == true {
        session?.appendToQuery(event)
        showAfterConfiguredDelay()
    }
}

func commit(_ text: String) {
    guard session?.target == frontmostApp else { return cancel() }
    postBackspaceEvents(count: session?.deleteCount ?? 0)
    postUnicodeKeyboardEvent(text)
}
idle tracking open ενεργοποίηση αναζήτηση με debounce ολοκλήρωση, απώλεια εστίασης ή ακύρωση
Επισκόπηση ροής καταστάσεων: idle -> tracking -> open -> idle.

Ένα σφάλμα που μας ανάγκασε σε καλύτερο μοντέλο κατάστασης

Ένα ζήτημα στις σημειώσεις αλλαγών της v1.3 αποκάλυψε ένα τυφλό σημείο στο μοντέλο κατάστασης των ενημερώσεων: το Checking... μπορούσε να παραμένει ορατό μετά από αποτέλεσμα χωρίς ενημέρωση, και το Available μπορούσε να μένει άγνωστο. Το σφάλμα ήταν μικρό, αλλά ο αντίκτυπος στην εμπιστοσύνη μεγάλος.

Η διόρθωσή του μας ανάγκασε να αυστηροποιήσουμε τη μηχανή καταστάσεων αντί να μπαλώνουμε ετικέτες επί τόπου. Αυτό άλλαξε τον τρόπο που χειριζόμαστε την κατάσταση της διεπαφής σε όλη την εφαρμογή: ρητές μεταβάσεις, λιγότερες συναγόμενες καταστάσεις και καλύτερος συγχρονισμός ανάμεσα στους ασύγχρονους ελέγχους και την ορατή κατάσταση.

  • Σύμπτωμα: παρωχημένο κείμενο κατάστασης ενημερώσεων μετά από επιτυχείς ελέγχους χωρίς διαθέσιμη ενημέρωση.
  • Βασική αιτία: ελλιπείς μεταβάσεις κατάστασης σε ασύγχρονες επανακλήσεις ενημέρωσης.
  • Αποτέλεσμα: πλέον ρητές μεταβάσεις κατάστασης καθορίζουν την εμφάνιση της κατάστασης.

Σημειώσεις απόδοσης

Η μέτρηση που μετράει: ο χρόνος από το πλήκτρο ενεργοποίησης έως το emoji που εισάγεται. Γι’ αυτό μείναμε σε εγγενές runtime Swift + AppKit αντί για στοίβα βασισμένη σε μηχανή περιήγησης.

Μετρήθηκε σε Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, με την v1.3.1 από το διανεμόμενο ZIP. Ο χρόνος εκκίνησης παρακάτω αφορά την εκκίνηση ως ορατή διεργασία, από το open -n μέχρι να εμφανιστεί η διεργασία της εφαρμογής.

Πρώτη εκκίνηση στη συνεδρία

217.68 ms (μία εκτέλεση, εκκίνηση ως ορατή διεργασία).

Θερμή επανεκκίνηση

110.02 ms διάμεσος σε 7 επανεκκινήσεις.

Μνήμη σε αδράνεια

110.4 MB RSS μέσω ps· η Παρακολούθηση δραστηριότητας στην ίδια εκτέλεση έδειξε 99.4 MB πραγματική και 29.6 MB ιδιωτική μνήμη.

Μέγεθος πακέτου

4.49 MB ZIP, 12.96 MB πακέτο εφαρμογής στον δίσκο.

Οι μετρήσεις μνήμης παρουσιάζονται ως έχουν, επειδή χρησιμοποιούν διαφορετικά μοντέλα καταμέτρησης. Το μεγαλύτερο μέρος του RSS εδώ είναι κοινόχρηστη μνήμη του framework AppKit· η ιδιωτική μνήμη μένει κάτω από 30 MB στις δοκιμές μας.

Swift + AppKit έναντι Electron για βοηθητικά εργαλεία macOS

Για βοηθητικά εργαλεία που τρέχουν πάντα, η συμπεριφορά κατά την εκτέλεση μετράει περισσότερο από τη φορητότητα της διεπαφής. Επιλέξαμε εγγενή Swift + AppKit για αυτούς τους πρακτικούς λόγους:

  • Μικρό αρχείο διανομής και άμεση εκκίνηση χωρίς «ζέσταμα» runtime JavaScript.
  • Άμεση ενσωμάτωση προσβασιμότητας και εισαγωγής κειμένου με εγγενή API του macOS.
  • Κανένα ενσωματωμένο δέντρο διεργασιών μηχανής περιήγησης για ένα ελαφρύ βοηθητικό εργαλείο πληκτρολογίου.

Για μετρημένους χρόνους εκκίνησης του ενσωματωμένου εργαλείου, του Raycast και του Emoji Picker, δείτε τη σελίδα σύγκρισης.

Σχεδιαστικοί συμβιβασμοί

Γιατί στη γραμμή μενού

Τα εργαλεία της γραμμής μενού μένουν εύκολα ανοιχτά και καλούνται γρήγορα. Για αυτό το προϊόν, αυτό ταίριαζε με την πραγματικότητα: οι χρήστες το καλούν ξανά και ξανά σε συνομιλίες, tickets, μηνύματα commit και έγγραφα.

Γιατί σκόπιμα λιτή διεπαφή

Αφαιρέσαμε σχεδόν κάθε διακοσμητικό στοιχείο που καθυστερούσε την επιλογή. Σαφείς κατηγορίες, προφανής πλοήγηση με το πληκτρολόγιο και ελάχιστα περιττά στοιχεία λειτούργησαν καλύτερα από πλουσιότερες οπτικές λύσεις στη δική μας καθημερινή χρήση.

Πού υπερέχει ακόμη το ενσωματωμένο εργαλείο

Αν εισάγετε emoji σπάνια, το εργαλείο επιλογής του macOS είναι ήδη αρκετό και δεν χρειάζεται καμία ρύθμιση. Η εφαρμογή μας απευθύνεται σε όσους το κάνουν όλη μέρα και νιώθουν ξανά και ξανά το κόστος της διακοπής.

Γιατί προτεραιότητα στην τοπική λειτουργία

Η προτεραιότητα στην τοπική λειτουργία ήταν αδιαπραγμάτευτη. Χωρίς υποχρεωτικό λογαριασμό, χωρίς εξάρτηση από το cloud και χωρίς να περνά η πληκτρολόγηση μέσα από εξωτερικές υπηρεσίες.

Τι μας εξέπληξε

  • Τα μικρά σφάλματα κατάστασης μπορούν να βλάψουν την εμπιστοσύνη περισσότερο από τα εμφανή οπτικά σφάλματα.
  • Οι ψευδώς θετικές ενεργοποιήσεις γίνονται αμέσως αντιληπτές από τους προχωρημένους χρήστες.
  • Κανείς δεν ζήτησε περισσότερες δυνατότητες μέχρι να σταματήσουν οι λανθασμένες ενεργοποιήσεις.

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

Γνωστοί περιορισμοί

  • Η άδεια Προσβασιμότητας απαιτείται για την καθολική παρακολούθηση του πλήκτρου ενεργοποίησης και την εισαγωγή σε άλλες εφαρμογές.
  • Η εφαρμογή δεν επιθεωρεί μεταδεδομένα του ενεργού πεδίου, ούτε το αν ένα πεδίο είναι ασφαλές. Εφαρμογές στις οποίες δεν θέλετε παρακολούθηση του πλήκτρου ενεργοποίησης μπορούν να προστεθούν στη λίστα εξαιρέσεων.
  • Ορισμένα προσαρμοσμένα στοιχεία ελέγχου κειμένου ερμηνεύουν διαφορετικά τα συνθετικά συμβάντα Backspace ή Unicode πληκτρολογίου και μπορεί να μειώσουν την αξιοπιστία της εισαγωγής.
  • Η ανίχνευση του πλήκτρου ενεργοποίησης έχει δοκιμαστεί περισσότερο σε λατινικές διατάξεις πληκτρολογίου.

Υποστήριξη

Κάντε μια ερώτηση, αναφέρετε ένα πρόβλημα ή ζητήστε μια δυνατότητα στη σελίδα υποστήριξης του Emoji Picker. Δεν χρειάζεται λογαριασμός.

Δοκιμάστε το Emoji Picker

Βρήκατε κάποιο πρόβλημα; Αναφέρετέ το μαζί με την έκδοση της εφαρμογής, την έκδοση του macOS και τα βήματα αναπαραγωγής.