تکنیکی ڈیپ ڈائیو
Swift میں macOS کے لیے نیٹو ایموجی پِکر بنانا
نہ Electron، نہ فالتو بوجھ
یہ Emoji Picker for macOS کے بننے کی روداد ہے۔ ہم نے اسے اس لیے بنایا کہ چیٹ کرتے وقت ڈیفالٹ پِکر بار بار ہمارے لکھنے کی روانی توڑتا تھا۔ بلٹ اِن آپشن میں ماؤس کی طرف جانا پڑتا تھا اور وہ استعمال میں سست تھا۔ مقصد سادہ تھا: ٹائپ کریں، منتخب کریں اور آگے بڑھیں۔
اس ڈیپ ڈائیو میں
ورک فلو کا اصل مسئلہ
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)
}
ایک بگ جس نے بہتر اسٹیٹ ماڈل پر مجبور کیا
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 کی نیٹو APIs کے ذریعے براہِ راست Accessibility اور متن داخل کرنے کا انٹیگریشن۔
- ایک ہلکی پھلکی کی بورڈ یوٹیلٹی کے لیے کوئی ایمبیڈڈ براؤزر انجن پراسیس ٹری نہیں۔
بلٹ اِن ٹول، Raycast اور Emoji Picker کے پیمائش شدہ اسٹارٹ اپ اوقات کے لیے موازنے کا صفحہ دیکھیں۔
ڈیزائن کے سمجھوتے
مینو بار کیوں
مینو بار ٹولز کو چلتا رکھنا آسان ہے اور انہیں فوراً بلایا جا سکتا ہے۔ اس پروڈکٹ کے لیے یہ حقیقت سے میل کھاتا تھا: صارفین چیٹس، ٹکٹس، کمٹ پیغامات اور دستاویزات کے دوران اسے بار بار کھولتے ہیں۔
جان بوجھ کر کم سے کم UI کیوں
ہم نے انتخاب کو سست کرنے والا تقریباً ہر آرائشی عنصر ہٹا دیا۔ ہمارے اپنے روزمرہ استعمال میں واضح زمرے، صاف کی بورڈ نیویگیشن اور کم سے کم سجاوٹ زیادہ بھرپور بصری انداز سے بہتر ثابت ہوئے۔
جہاں بلٹ اِن پِکر اب بھی بہتر ہے
اگر آپ کبھی کبھار ہی ایموجی داخل کرتے ہیں تو macOS کا پِکر کافی ہے اور اس کے لیے کوئی سیٹ اپ نہیں کرنا پڑتا۔ ہماری ایپ ان صارفین کے لیے ہے جو دن بھر یہی کرتے ہیں اور بار بار کی رکاوٹ کو محسوس کرتے ہیں۔
لوکل فرسٹ کیوں
لوکل فرسٹ پر کوئی سمجھوتا ممکن نہیں تھا۔ نہ اکاؤنٹ کی شرط، نہ کلاؤڈ پر انحصار، اور نہ ہی ٹائپنگ سے متعلق کچھ بھی بیرونی سروسز سے گزرتا ہے۔
کن باتوں نے ہمیں حیران کیا
- اسٹیٹس کے چھوٹے بگ واضح بصری بگز سے زیادہ اعتماد کو نقصان پہنچا سکتے ہیں۔
- پاور یوزرز غلط ایکٹیویشن کو فوراً محسوس کر لیتے ہیں۔
- جب تک ایکٹیویشن غلط وقت پر ہونا بند نہیں ہوا، کسی نے مزید فیچرز نہیں مانگے۔
سب سے بڑا سبق: کی بورڈ ٹولز کو نیاپن نہیں بلکہ یکسانیت سے پرکھا جاتا ہے۔ اگر ایپ ہر بار ایک جیسا برتاؤ کرے تو وہ ورک فلو میں مستقل جگہ بنا لیتی ہے۔
معلوم حدود
- گلوبل ٹرگر پر نظر رکھنے اور ایک ایپ سے دوسری ایپ میں داخل کرنے کے لیے Accessibility اجازت ضروری ہے۔
- ایپ فوکس شدہ فیلڈ کے میٹا ڈیٹا کا معائنہ نہیں کرتی، یہ بھی نہیں کہ فیلڈ محفوظ ہے یا نہیں۔ جن ایپس میں ٹرگر کی نگرانی نہیں چاہیے، انہیں اخراج فہرست میں شامل کیا جا سکتا ہے۔
- کچھ کسٹم ٹیکسٹ کنٹرولز مصنوعی Backspace یا Unicode کی بورڈ ایونٹس کو مختلف انداز میں سمجھتے ہیں، جس سے داخل کرنے کی قابلِ اعتمادی کم ہو سکتی ہے۔
- ٹرگر پہچاننے کے عمل کو سب سے زیادہ لاطینی کی بورڈ لے آؤٹس پر آزمایا گیا ہے۔
سپورٹ
Emoji Picker سپورٹ صفحے پر سوال پوچھیں، مسئلہ رپورٹ کریں یا کسی فیچر کی درخواست کریں۔ کسی اکاؤنٹ کی ضرورت نہیں۔
Emoji Picker آزمائیں
کوئی مسئلہ ملا؟ ایپ ورژن، macOS ورژن اور مسئلہ دہرانے کے مراحل کے ساتھ رپورٹ کریں۔