तांत्रिक सखोल आढावा

Swift मध्ये macOS साठी नेटिव्ह इमोजी पिकर बनवणे

Electron नाही, अनावश्यक भार नाही

ही Emoji Picker for macOS मागची बिल्ड डायरी आहे. चॅट करताना डीफॉल्ट पिकर आमच्याच लिखाणाच्या लयीत सतत व्यत्यय आणत होता, म्हणून आम्ही हे बनवले. बिल्ट-इन पर्यायासाठी माउसकडे हात न्यावा लागतो आणि तो वापरायला संथ आहे. ध्येय सोपे होते: टाइप करा, निवडा आणि पुढे चला.

प्रकाशित 2026-02-16 · inndevs GmbH

या सखोल आढाव्यात

वर्कफ्लोमधील खरी समस्या

macOS मध्ये आधीच एक इमोजी पिकर आहे. अधूनमधून वापरासाठी तो ठीक आहे. पण जास्त मजकूर लिहिण्याच्या वर्कफ्लोमध्ये तो आमचा वेग कमी करत होता. पॅनेल उघडा, हात माउसकडे न्या, निवडा, पॅनेल बंद करा, पुन्हा संदर्भ आठवा. दिवसातून डझनभर वेळा हे केल्यावर व्यत्ययाची किंमत स्पष्ट दिसू लागते.

सुरुवातीच्या अंतर्गत चाचणीत चुकून सुरू होणे किती त्रासदायक आहे हे लक्षात आले. सुरू होणे कंटाळवाणे आणि अंदाज लावता येण्याजोगे वाटेपर्यंत आम्ही नियम कडक केले: ; टाइप करा, त्याच ॲपमध्ये राहा, कीबोर्डने निवडा, लिहीत राहा.

  • अनेक छोटे संदेश हाताळताना सपोर्ट आणि तिकिट वर्कफ्लोमध्ये जलद घालणे आवश्यक असते.
  • कोड रिव्ह्यूमधील कमेंट्स आणि कमिट मेसेजेसमध्ये आम्हाला काय हवे ते सहसा आधीच माहीत असते, त्यामुळे श्रेणी ब्राउझ करण्यापेक्षा क्वेरी टाइप करणे जलद होते.
  • दिवसातून 40 पेक्षा जास्त वेळा पॅनेलची स्थिती बदलल्याने टायपिंगची लय पटकन बिघडते.

आर्किटेक्चरचे निर्णय

ग्लोबल हॉटकी हाताळणी

इनपुट एका Core Graphics इव्हेंट टॅप आणि संरक्षित स्टेट मशीनद्वारे चालते. मर्यादित आकाराचा, मेमरीतील बफर समोरच्या ॲपमधील अलीकडील प्रिंट करता येणारी अक्षरे ठेवतो, जेणेकरून कॉन्फिगर केलेला ट्रिगर ओळखता येईल. ॲप बदलल्यावर, शॉर्टकट वापरल्यावर, प्रिंट न होणारे इनपुट आल्यावर किंवा रद्द केल्यावर तो रीसेट होतो. क्वेरी टाइप होत असताना कॉन्फिगर करता येणारा पॉपअप विलंब UI शांत ठेवतो.

NSPanel विरुद्ध NSPopover निर्णय

आम्ही NSPopover ने सुरुवात केली आणि नंतर NSPanel वर गेलो. पटकन ॲप बदलताना Slack आणि Chrome मध्ये NSPopover सहज फोकस गमावत होता. NSPanel ने आम्हाला लाइफसायकलवर स्पष्ट नियंत्रण आणि ॲप्सदरम्यान अंदाज लावता येण्याजोगे कीबोर्ड राउटिंग दिले.

Accessibility परवानगी आणि घालण्याची पद्धत

Accessibility परवानगीमुळे Emoji Picker हे ग्लोबल इव्हेंट्स पाहू शकतो आणि सक्रिय ॲपला कीबोर्ड इव्हेंट्स पाठवू शकतो. क्लिपबोर्डवर आधारित घालण्याची पद्धत आम्ही नाकारली, कारण क्लिपबोर्डची स्थिती बदलणे अनपेक्षित असते आणि त्यावर विश्वास ठेवणे कठीण जाते. ॲप AXUIElement द्वारे कोणतेही टेक्स्ट फील्ड तपासत नाही; सेशन सुरू होताना कोणते ॲप समोर असायला हवे ते नोंदवते आणि घालण्यापूर्वी तेच ॲप अजून समोर आहे याची खात्री करते.

मोजून केलेले मजकूर बदल

इनलाइन सेशन ट्रिगर आणि क्वेरीची किती अक्षरे लक्ष्य ॲपपर्यंत पोहोचली ते मोजते. निवड केल्यावर Emoji Picker तितके Backspace की इव्हेंट्स पाठवतो आणि मग निवडलेला Unicode मजकूर कृत्रिम कीबोर्ड इव्हेंट म्हणून पाठवतो. तो क्लिपबोर्डमध्ये कधीही बदल करत नाही. तरीही कस्टम कंट्रोल्स कृत्रिम कीबोर्ड इव्हेंट्सचा वेगळा अर्थ लावू शकतात, म्हणूनच लक्ष्य ॲपची तपासणी आणि रद्द करण्याचे वर्तन महत्त्वाचे आहे.

संदर्भ ओळखण्याचे नियम

सुरू होणे अंदाज लावता येण्याजोगे ठेवण्यासाठी आम्ही वापरत असलेले व्यावहारिक नियम:

  • Emoji Picker च्या स्वतःच्या विंडोज आणि वापरकर्त्याच्या वगळलेल्या यादीतील ॲप्सकडे दुर्लक्ष केले जाते.
  • अलीकडील इनपुट आणि प्रत्येक सक्रिय सेशन समोरच्या ॲपशी जोडलेले असते; ॲप बदलल्यास सेशन रद्द होते.
  • अलीकडील प्रिंट करता येणाऱ्या इनपुटच्या मर्यादित शेवटच्या भागाशी कॉन्फिगर केलेला ट्रिगर जुळवला जातो.
  • इनलाइन क्वेरीमध्ये अक्षरे, अंक, अंडरस्कोर, प्लस आणि हायफन स्वीकारले जातात; इतर कोणतेही इनपुट क्वेरी रद्द करते.
  • UI दाखवण्यापूर्वी वापरकर्त्याची सुरुवातीच्या अक्षरक्रमांची ब्लॉकलिस्ट, क्वेरीची किमान लांबी आणि पॉपअपचा विलंब लागू केला जातो.
  • जे वापरकर्ते स्पष्टपणे बोलावणे पसंत करतात त्यांच्यासाठी थेट उघडण्याचा ट्रिगर कस्टमाइझ करण्याची सोय (उदा. ;; किंवा //).

सोपे केलेले स्टेट लॉजिक (वाचायला सोपे जावे म्हणून छाटलेले):

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 ट्रिगर डिबाउन्स केलेली क्वेरी निश्चित, फोकस गमावणे किंवा रद्द
स्टेट फ्लोचा आढावा: idle -> tracking -> open -> idle.

एक बग ज्याने आम्हाला अधिक चांगले स्टेट मॉडेल बनवायला भाग पाडले

v1.3 चेंजलॉग नोट्समधील एका समस्येने आमच्या अपडेटर स्टेटस मॉडेलमधील एक दुर्लक्षित बाजू उघड केली: अपडेट न मिळाल्यानंतरही Checking... दिसत राहू शकत होते आणि Available अज्ञात राहू शकत होते. बग छोटा होता, पण विश्वासावर त्याचा परिणाम मोठा होता.

हे दुरुस्त करताना लेबल्सवर ठिगळे लावण्याऐवजी आम्हाला स्टेट मशीनच कडक करावे लागले. त्यामुळे उर्वरित ॲपमध्ये UI स्थिती हाताळण्याची आमची पद्धतही बदलली: स्पष्ट ट्रान्झिशन्स, कमी अनुमानित स्थिती आणि async तपासण्या व दिसणारी स्थिती यांच्यात अधिक मजबूत ताळमेळ.

  • लक्षण: अपडेट नसल्याची यशस्वी तपासणी झाल्यानंतरही अपडेटरचा जुना स्टेटस मजकूर दिसत राहणे.
  • मूळ कारण: async अपडेट कॉलबॅक्सदरम्यान अपूर्ण स्टेट ट्रान्झिशन्स.
  • परिणाम: आता स्पष्ट स्टेट ट्रान्झिशन्सच स्टेटस दाखवणे नियंत्रित करतात.

परफॉर्मन्स टिपा

महत्त्वाचे मेट्रिक: ट्रिगरपासून इमोजी घातला जाईपर्यंतचा वेळ. म्हणूनच आम्ही ब्राउझर-इंजिन स्टॅकऐवजी नेटिव्ह Swift + AppKit रनटाइमवरच राहिलो.

Mac15,11 (Apple M3 Max), macOS 26.2 बिल्ड 25C56 वर, प्रकाशित ZIP मधील v1.3.1 वापरून मोजले. खालील लाँच वेळ म्हणजे open -n पासून ॲपची प्रोसेस दिसेपर्यंतचा स्टार्टअप.

सेशनमधील पहिले लाँच

217.68 ms (एक रन, प्रोसेस दिसेपर्यंतचा स्टार्टअप).

वॉर्म रीलाँच

7 रीलाँच रनमध्ये मीडियन 110.02 ms.

निष्क्रिय स्थितीतील मेमरी

ps नुसार 110.4 MB RSS; त्याच रनमध्ये Activity Monitor ने 99.4 MB रिअल आणि 29.6 MB प्रायव्हेट मेमरी दाखवली.

पॅकेजचा आकार

4.49 MB ZIP, डिस्कवर 12.96 MB ॲप बंडल.

मेमरी मेट्रिक्स जसे आहेत तसे दाखवले आहेत, कारण त्यांच्या हिशोबाच्या पद्धती वेगळ्या आहेत. इथला बहुतेक RSS शेअर केलेल्या AppKit फ्रेमवर्कची मेमरी आहे; आमच्या चाचण्यांत प्रायव्हेट मेमरी 30 MB पेक्षा कमी राहते.

macOS युटिलिटीजसाठी Swift + AppKit विरुद्ध Electron

सतत चालू असणाऱ्या युटिलिटी टूल्ससाठी UI च्या पोर्टेबिलिटीपेक्षा रनटाइमची रचना जास्त महत्त्वाची असते. या व्यावहारिक कारणांसाठी आम्ही नेटिव्ह Swift + AppKit निवडले:

  • छोटी डिस्ट्रिब्युशन फाइल आणि JavaScript रनटाइम वॉर्म-अपशिवाय थेट स्टार्टअप.
  • macOS च्या नेटिव्ह API वापरून थेट Accessibility आणि मजकूर घालण्याचे इंटिग्रेशन.
  • हलक्या कीबोर्ड युटिलिटीसाठी एम्बेडेड ब्राउझर-इंजिनचे प्रोसेस ट्री नाही.

बिल्ट-इन, Raycast आणि Emoji Picker यांच्या मोजलेल्या स्टार्टअप वेळांसाठी तुलना पेज पाहा.

डिझाइनमधील तडजोडी

मेनू बार का

मेनू बार टूल्स सहज चालू ठेवता येतात आणि पटकन बोलावता येतात. या प्रॉडक्टसाठी हेच वास्तवाशी जुळले: चॅट्स, तिकिटे, कमिट मेसेजेस आणि डॉक्स लिहिताना वापरकर्ते ते वारंवार बोलावतात.

जाणीवपूर्वक किमान UI का

निवड संथ करणारा जवळजवळ प्रत्येक सजावटी घटक आम्ही काढून टाकला. आमच्या स्वतःच्या रोजच्या वापरात स्पष्ट श्रेणी, सहज समजणारे कीबोर्ड नेव्हिगेशन आणि किमान सजावट यांनी अधिक भरगच्च व्हिज्युअल्सपेक्षा चांगले काम केले.

बिल्ट-इन पिकर अजूनही कुठे सरस ठरतो

तुम्ही क्वचितच इमोजी घालत असाल, तर macOS चा पिकर पुरेसा आहे आणि त्याला कोणताही सेटअप लागत नाही. आमचे ॲप त्यांच्यासाठी आहे जे दिवसभर हे करतात आणि वारंवार येणाऱ्या व्यत्ययाची किंमत जाणवते.

लोकल-फर्स्ट का

लोकल-फर्स्टबाबत तडजोड नव्हती. अकाउंटची गरज नाही, क्लाउडवर अवलंबित्व नाही आणि टायपिंगची माहिती बाहेरच्या कोणत्याही सेवेमार्फत जात नाही.

आम्हाला कशाने आश्चर्य वाटले

  • छोटे स्टेटस बग्स उघड दिसणाऱ्या व्हिज्युअल बग्सपेक्षा जास्त विश्वास गमावू शकतात.
  • चुकून सुरू होणे अनुभवी वापरकर्त्यांच्या लगेच लक्षात येते.
  • चुकून सुरू होणे थांबेपर्यंत कोणीही आणखी फीचर्स मागितले नाहीत.

मुख्य धडा: कीबोर्ड टूल्सचे मूल्यमापन नावीन्यावर नव्हे, तर सातत्यावर होते. ॲप प्रत्येक वेळी सारखेच वागले, तरच त्याला वर्कफ्लोमध्ये कायमची जागा मिळते.

ज्ञात मर्यादा

  • ग्लोबल ट्रिगरवर लक्ष ठेवण्यासाठी आणि वेगवेगळ्या ॲप्समध्ये घालण्यासाठी Accessibility परवानगी आवश्यक आहे.
  • ॲप फोकस असलेल्या फील्डचा मेटाडेटा तपासत नाही, फील्ड सुरक्षित आहे की नाही हेदेखील नाही. ज्या ॲप्समध्ये ट्रिगरवर लक्ष ठेवणे नको आहे ती वगळलेल्या यादीत जोडता येतात.
  • काही कस्टम टेक्स्ट कंट्रोल्स कृत्रिम Backspace किंवा Unicode कीबोर्ड इव्हेंट्सचा वेगळा अर्थ लावतात आणि त्यामुळे घालण्याची विश्वासार्हता कमी होऊ शकते.
  • ट्रिगर ओळखण्याचा मार्ग सर्वाधिक प्रमाणात लॅटिन कीबोर्ड लेआउट्सवर तपासला गेला आहे.

सपोर्ट

Emoji Picker सपोर्ट पेजवर प्रश्न विचारा, समस्या कळवा किंवा फीचरची विनंती करा. अकाउंटची गरज नाही.

Emoji Picker वापरून पाहा

काही समस्या आढळली? ॲप व्हर्जन, macOS व्हर्जन आणि समस्या पुन्हा घडवण्याच्या पायऱ्यांसह ती कळवा.