تحليل تقني مفصّل
بناء Emoji Picker أصلي لنظام macOS باستخدام Swift
بلا Electron، وبلا تضخم
هذا هو سجل البناء وراء Emoji Picker for macOS. بنيناه لأن أداة الاختيار الافتراضية كانت تقطع تدفق كتابتنا أثناء الدردشة. كان الخيار المدمج يتطلب الانتقال إلى الماوس وكان بطيئًا في الاستخدام. وكان الهدف بسيطًا: اكتب، واختر، وتابع.
في هذا التحليل المفصّل
مشكلة سير العمل الحقيقية
يأتي macOS مع أداة لاختيار الإيموجي. وهي مناسبة للاستخدام العرضي. لكنها كانت تبطئنا في سير العمل النصي الكثيف: افتح اللوحة، وانقل يدك إلى الماوس، واختر، وأغلق اللوحة، واستعد السياق. كرّر ذلك عشرات المرات في اليوم وستتضح تكلفة المقاطعة.
كشفت الاختبارات الداخلية المبكرة مدى إزعاج حالات التفعيل الخاطئة. فشدّدنا القواعد حتى صار التفعيل مملًا ومتوقعًا: اكتب ;، وابقَ في التطبيق الحالي، واختر بلوحة المفاتيح، وتابع الكتابة.
- يحتاج سير عمل الدعم والتذاكر إلى إدراج سريع أثناء فرز رسائل قصيرة كثيرة.
- في تعليقات مراجعة الشيفرة ورسائل الإيداع، نعرف عادةً ما نريده مسبقًا، لذا يكون تصفّح الفئات أبطأ من كتابة استعلام.
- تبديل حالة اللوحة أكثر من 40 مرة يوميًا يكسر إيقاع الكتابة بسرعة.
قرارات البنية
معالجة مفاتيح الاختصار العامة
يعتمد الإدخال على event tap من Core Graphics مع آلة حالات محمية. يحتفظ مخزن مؤقت محدود في الذاكرة بأحدث الأحرف القابلة للطباعة للتطبيق الموجود في المقدمة، حتى يمكن التعرف على المشغّل المضبوط. ويُعاد تعيينه عند تبديل التطبيقات، وعند استخدام الاختصارات، وعند الإدخال غير القابل للطباعة، وعند الإلغاء. ويُبقي تأخير النافذة المنبثقة القابل للضبط الواجهةَ هادئة ريثما تُكتب الاستعلامات.
قرار 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)
}
خلل أجبرنا على نموذج حالة أفضل
كشفت مشكلة في ملاحظات الإصدار v1.3 نقطة عمياء في نموذج حالة أداة التحديث: كان من الممكن أن تبقى Checking... ظاهرة بعد نتيجة «لا يوجد تحديث»، وأن تبقى Available مجهولة. كان الخلل صغيرًا، لكن أثره على الثقة كان كبيرًا.
أجبرنا إصلاحه على إحكام آلة الحالات بدلًا من ترقيع التسميات في مكانها. وغيّر ذلك طريقة تعاملنا مع حالة الواجهة في بقية التطبيق: انتقالات صريحة، وحالات مستنتَجة أقل، وتزامن أقوى بين عمليات التحقق غير المتزامنة والحالة الظاهرة.
- العَرَض: نص قديم لحالة أداة التحديث بعد عمليات تحقق ناجحة لم تجد تحديثًا.
- السبب الجذري: انتقالات حالة غير مكتملة في استدعاءات التحديث غير المتزامنة.
- النتيجة: أصبحت انتقالات الحالة الصريحة هي التي تحدد عرض الحالة.
ملاحظات حول الأداء
المقياس الذي يهمّ: الوقت من المشغّل حتى إدراج الإيموجي. ولهذا بقينا مع بيئة Swift + AppKit الأصلية بدلًا من حزمة تقنيات قائمة على محرك متصفح.
قيس على Mac15,11 (Apple M3 Max)، وmacOS 26.2 بنسخة البناء 25C56، باستخدام v1.3.1 من ملف ZIP المنشور. ويُقصد بزمن التشغيل أدناه بدء التشغيل من open -n حتى ظهور عملية التطبيق.
التشغيل الأول في الجلسة
217.68 ms (تشغيل واحد، بدء التشغيل حتى ظهور العملية).
إعادة التشغيل الدافئ
110.02 ms وسيط 7 عمليات إعادة تشغيل.
الذاكرة في وضع الخمول
110.4 MB RSS عبر ps؛ وأظهر Activity Monitor في التشغيل نفسه 99.4 MB ذاكرة فعلية و29.6 MB ذاكرة خاصة.
حجم الحزمة
4.49 MB بصيغة ZIP، و12.96 MB لحزمة التطبيق على القرص.
تُعرض مقاييس الذاكرة كما هي لأنها تعتمد نماذج حساب مختلفة. معظم RSS هنا ذاكرة مشتركة لإطار عمل AppKit؛ وتبقى الذاكرة الخاصة دون 30 MB في اختباراتنا.
Swift + AppKit مقابل Electron لأدوات macOS المساعدة
في الأدوات المساعدة التي تعمل دائمًا، يهمّ شكل التشغيل أكثر من قابلية نقل الواجهة. اخترنا Swift + AppKit الأصليين لهذه الأسباب العملية:
- ملف توزيع صغير ومسار بدء تشغيل مباشر دون تهيئة بيئة تشغيل JavaScript.
- تكامل مباشر مع تسهيلات الاستخدام وإدراج النص باستخدام واجهات برمجة macOS الأصلية.
- لا شجرة عمليات لمحرك متصفح مدمج في أداة لوحة مفاتيح خفيفة.
لأزمنة بدء التشغيل المقيسة للأداة المدمجة وRaycast وEmoji Picker، راجع صفحة المقارنة.
مفاضلات التصميم
لماذا شريط القوائم
أدوات شريط القوائم سهلة الإبقاء قيد التشغيل وسريعة الاستدعاء. وفي هذا المنتج تطابق ذلك مع الواقع: يستدعيه المستخدمون مرارًا أثناء المحادثات والتذاكر ورسائل الإيداع والمستندات.
لماذا واجهة بسيطة عن قصد
أزلنا تقريبًا كل عنصر زخرفي كان يبطئ الاختيار. فقد أثبتت الفئات الواضحة والتنقل الجلي بلوحة المفاتيح والإطار البسيط فعاليةً أكبر من المعالجات البصرية الغنية في استخدامنا اليومي.
حيث تتفوّق أداة الاختيار المدمجة
إذا كنت تُدرج الإيموجي نادرًا، فأداة الاختيار في macOS جيدة بما يكفي ولا تتطلب أي إعداد. أما تطبيقنا فهو لمن يفعلون ذلك طوال اليوم ويشعرون بتكلفة المقاطعة مرارًا.
لماذا المحلي أولًا
كان مبدأ «المحلي أولًا» غير قابل للتفاوض. لا حاجة إلى حساب، ولا اعتماد على السحابة، ولا تمرير لسلوك الكتابة عبر خدمات خارجية.
ما فاجأنا
- قد تضرّ أخطاء الحالة الصغيرة بالثقة أكثر من الأخطاء المرئية الواضحة.
- يلاحظ المستخدمون المتقدمون حالات التفعيل الخاطئة فورًا.
- لم يطلب أحد ميزات إضافية حتى توقف التفعيل الخاطئ.
الدرس الأساسي: تُقيَّم أدوات لوحة المفاتيح باتساقها لا بجدّتها. إذا تصرّف التطبيق بالطريقة نفسها في كل مرة، استحق مكانًا دائمًا في سير العمل.
القيود المعروفة
- إذن تسهيلات الاستخدام مطلوب لمراقبة مفاتيح التشغيل على مستوى النظام وللإدراج عبر التطبيقات.
- لا يفحص التطبيق بيانات الحقل النشط، بما في ذلك ما إذا كان الحقل آمنًا. ويمكن إضافة التطبيقات التي لا تريد مراقبة المشغّل فيها إلى قائمة الاستثناء.
- بعض عناصر التحكم النصية المخصصة تفسّر أحداث Backspace أو Unicode الاصطناعية بشكل مختلف، وقد يقلل ذلك من موثوقية الإدراج.
- اختُبر مسار اكتشاف المشغّل بشكل مكثف على تخطيطات لوحة المفاتيح اللاتينية أكثر من غيرها.
دعم
اطرح سؤالًا أو أبلغ عن مشكلة أو اطلب ميزة في صفحة دعم Emoji Picker. دون الحاجة إلى حساب.
جرّب Emoji Picker
وجدت مشكلة؟ أبلغ عنها مع ذكر إصدار التطبيق وإصدار macOS وخطوات إعادة إنتاجها.