तकनीकी डीप डाइव

Swift में macOS के लिए नेटिव इमोजी पिकर बनाना

न Electron, न फ़ालतू बोझ

यह Emoji Picker for macOS के बनने की कहानी है। हमने इसे इसलिए बनाया, क्योंकि चैट करते समय डिफ़ॉल्ट पिकर बार-बार हमारे लिखने के प्रवाह को तोड़ता था। बिल्ट-इन विकल्प में माउस पर जाना पड़ता था और वह धीमा था। लक्ष्य सीधा था: टाइप करें, चुनें और आगे बढ़ें।

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

इस डीप डाइव में

वर्कफ़्लो की असली समस्या

macOS में पहले से एक इमोजी पिकर मौजूद है। कभी-कभार के इस्तेमाल के लिए वह ठीक है। ज़्यादा टेक्स्ट वाले वर्कफ़्लो में वह हमें धीमा कर रहा था। पैनल खोलें, हाथ माउस पर ले जाएँ, चुनें, पैनल बंद करें, फिर से संदर्भ में लौटें। दिन में दर्जनों बार यही दोहराएँ, तो रुकावट की कीमत साफ़ दिखने लगती है।

शुरुआती इंटरनल टेस्टिंग में पता चला कि गलत एक्टिवेशन कितने परेशान करने वाले थे। हमने नियमों को तब तक कसा, जब तक एक्टिवेशन सीधा-सादा और पूर्वानुमेय न लगने लगा: ; टाइप करें, उसी ऐप में रहें, कीबोर्ड से चुनें, लिखना जारी रखें।

  • सपोर्ट और टिकट वर्कफ़्लो में ढेरों छोटे संदेशों को छाँटते समय तेज़ इंसर्शन चाहिए।
  • कोड रिव्यू कमेंट और कमिट मैसेज में हमें आम तौर पर पहले से पता होता है कि क्या चाहिए, इसलिए श्रेणियाँ ब्राउज़ करना क्वेरी टाइप करने से धीमा पड़ता है।
  • दिन में 40+ बार पैनल की स्थिति बदलने से टाइपिंग की लय जल्दी टूट जाती है।

आर्किटेक्चर से जुड़े फ़ैसले

ग्लोबल हॉटकी को संभालना

इनपुट एक Core Graphics event tap और एक सुरक्षित स्टेट मशीन से चलता है। एक सीमित, इन-मेमोरी बफ़र सबसे आगे वाले ऐप के हाल के प्रिंट होने योग्य वर्ण रखता है, ताकि कॉन्फ़िगर किया गया ट्रिगर पहचाना जा सके। ऐप बदलने, शॉर्टकट, गैर-प्रिंट होने योग्य इनपुट और रद्द करने पर यह रीसेट हो जाता है। कॉन्फ़िगर की जा सकने वाली पॉपअप देरी से 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 वर्ज़न और समस्या दोहराने के चरणों के साथ रिपोर्ट करें।