টেকনিক্যাল বিস্তারিত আলোচনা
Swift দিয়ে macOS-এর জন্য একটি নেটিভ ইমোজি পিকার তৈরি
Electron নেই, বাড়তি বোঝা নেই
এটি Emoji Picker for macOS তৈরির নেপথ্য বিবরণ। চ্যাট করার সময় ডিফল্ট পিকার বারবার আমাদের নিজেদের লেখার ছন্দে বাধা দিচ্ছিল বলেই আমরা এটি তৈরি করেছি। বিল্ট-ইন বিকল্পে মাউসে হাত দিতে হয় এবং তা ব্যবহারে ধীর। লক্ষ্য ছিল সহজ: টাইপ করুন, বেছে নিন, এগিয়ে চলুন।
এই বিস্তারিত আলোচনায়
ওয়ার্কফ্লোর আসল সমস্যা
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)
}
যে বাগ আমাদের আরও ভালো স্টেট মডেল বানাতে বাধ্য করেছিল
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 ভার্সন ও সমস্যাটি আবার ঘটানোর ধাপগুলো সহ জানান।