Kupasan Teknikal Mendalam

Membina Emoji Picker Asli untuk macOS dengan Swift

Tanpa Electron, Tanpa Lebihan

Ini ialah log pembinaan di sebalik Emoji Picker untuk macOS. Kami membinanya kerana pemilih lalai sentiasa mengganggu aliran penulisan kami sendiri semasa bersembang. Pilihan terbina dalam memerlukan peralihan ke tetikus dan lambat digunakan. Matlamatnya mudah: taip, pilih dan terus bergerak.

Diterbitkan 2026-02-16 · oleh inndevs GmbH

Dalam Kupasan Mendalam Ini

Masalah Sebenar Aliran Kerja

macOS sudah menyertakan pemilih emoji. Untuk kegunaan sesekali, ia memadai. Dalam aliran kerja teks yang padat, ia melambatkan kami. Buka panel, alihkan tangan ke tetikus, pilih, tutup panel, pulihkan konteks. Ulang puluhan kali sehari dan kos gangguannya menjadi jelas.

Ujian dalaman awal mendedahkan betapa menjengkelkannya pengaktifan palsu. Kami mengetatkan peraturan sehingga pengaktifan terasa biasa dan boleh dijangka: taip ;, kekal dalam aplikasi semasa, pilih dengan papan kekunci, teruskan menulis.

  • Aliran kerja sokongan dan tiket memerlukan penyisipan pantas semasa menyaring banyak mesej pendek.
  • Dalam ulasan semakan kod dan mesej commit, kami biasanya sudah tahu apa yang dimahukan, jadi menyemak imbas kategori lebih perlahan daripada menaip pertanyaan.
  • Menukar keadaan panel lebih 40 kali sehari cepat mengganggu rentak menaip.

Keputusan Seni Bina

Pengendalian kekunci pantas global

Input dipacu oleh event tap Core Graphics berserta mesin keadaan yang dikawal. Penimbal dalam memori yang terhad menyimpan aksara boleh cetak terkini bagi aplikasi paling hadapan supaya pencetus yang dikonfigurasikan dapat dikenal pasti. Ia ditetapkan semula apabila aplikasi bertukar, apabila pintasan digunakan, apabila ada input tidak boleh cetak dan apabila dibatalkan. Kelewatan pop timbul yang boleh dikonfigurasikan memastikan UI kekal tenang semasa pertanyaan masih ditaip.

Keputusan NSPanel lwn NSPopover

Kami bermula dengan NSPopover dan beralih kepada NSPanel. NSPopover terlalu mudah hilang fokus dalam Slack dan Chrome semasa bertukar aplikasi dengan pantas. NSPanel memberikan kami kawalan kitaran hayat yang eksplisit dan penghalaan papan kekunci yang boleh dijangka merentas aplikasi.

Kebenaran kebolehcapaian dan strategi penyisipan

Kebenaran Kebolehcapaian membolehkan Emoji Picker memantau peristiwa global tersebut dan menghantar peristiwa papan kekunci kembali ke aplikasi aktif. Kami menolak penyisipan berasaskan papan klip kerana menimpa kandungan papan klip itu mengejutkan dan sukar dipercayai. Aplikasi tidak memeriksa medan teks melalui AXUIElement; ia merekodkan aplikasi paling hadapan yang dimaksudkan apabila sesi bermula dan mengesahkan bahawa aplikasi yang sama masih berada di hadapan sebelum menyisipkan.

Penggantian teks terkira

Sesi sebaris mengira aksara pencetus dan pertanyaan yang telah sampai ke aplikasi sasaran. Apabila pilihan dibuat, Emoji Picker menghantar peristiwa kekunci Backspace sebanyak itu, kemudian menghantar teks Unicode yang dipilih sebagai peristiwa papan kekunci sintetik. Papan klip tidak pernah diubah. Kawalan tersuai masih boleh mentafsir peristiwa papan kekunci sintetik secara berbeza, sebab itulah semakan aplikasi sasaran dan tingkah laku pembatalan penting.

Peraturan Pengesanan Konteks

Berikut ialah peraturan praktikal yang kami gunakan untuk memastikan pengaktifan boleh dijangka:

  • Abaikan tetingkap Emoji Picker sendiri dan aplikasi dalam senarai pengecualian pengguna.
  • Kaitkan input terkini dan setiap sesi aktif dengan aplikasi paling hadapan; menukar aplikasi akan membatalkan sesi.
  • Padankan pencetus yang dikonfigurasikan dengan akhiran terhad daripada input boleh cetak terkini.
  • Terima huruf, nombor, garis bawah, tanda tambah dan tanda sempang dalam pertanyaan sebaris; input lain akan membatalkannya.
  • Gunakan senarai sekatan jujukan pembuka pengguna, panjang pertanyaan minimum dan kelewatan pop timbul sebelum memaparkan UI.
  • Menyokong penyesuaian pencetus buka terus (contohnya ;; atau //) bagi pengguna yang lebih suka panggilan eksplisit.

Logik keadaan yang dipermudah (dipendekkan supaya mudah dibaca):

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 pencetus pertanyaan dengan nyahlantun commit, blur atau batal
Gambaran aliran keadaan: idle -> tracking -> open -> idle.

Pepijat yang Memaksa Model Keadaan yang Lebih Baik

Satu isu dalam nota log perubahan v1.3 mendedahkan titik buta dalam model status pengemas kini kami: Checking... boleh kekal kelihatan selepas keputusan tiada kemas kini, dan Available boleh kekal tidak diketahui. Pepijatnya kecil, tetapi kesannya terhadap kepercayaan besar.

Pembetulannya memaksa kami mengetatkan mesin keadaan dan bukannya menampal label di tempatnya. Ini mengubah cara kami mengendalikan status UI di seluruh aplikasi: peralihan yang eksplisit, kurang keadaan yang disimpulkan dan penyegerakan yang lebih kukuh antara semakan tak segerak dengan status yang kelihatan.

  • Gejala: teks status pengemas kini yang lapuk selepas semakan berjaya tanpa kemas kini.
  • Punca sebenar: peralihan keadaan yang tidak lengkap dalam panggilan balik kemas kini tak segerak.
  • Hasil: peralihan keadaan yang eksplisit kini memacu paparan status.

Nota Prestasi

Metrik yang penting: masa daripada pencetus hingga emoji disisipkan. Sebab itulah kami kekal dengan masa jalan Swift + AppKit asli dan bukannya timbunan berasaskan enjin pelayar.

Diukur pada Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, menggunakan v1.3.1 daripada ZIP yang dikeluarkan. Masa pelancaran di bawah bermaksud masa permulaan daripada open -n sehingga proses aplikasi muncul.

Pelancaran pertama dalam sesi

217.68 ms (satu ujian, masa permulaan sehingga proses kelihatan).

Pelancaran semula warm

Median 110.02 ms daripada 7 kali pelancaran semula.

Memori ketika melahu

110.4 MB RSS melalui ps; Activity Monitor pada ujian yang sama menunjukkan memori sebenar 99.4 MB dan memori peribadi 29.6 MB.

Saiz pakej

ZIP 4.49 MB, bundle aplikasi 12.96 MB pada cakera.

Metrik memori dibentangkan sebagaimana adanya kerana ia menggunakan model perakaunan yang berbeza. Kebanyakan RSS di sini ialah memori rangka kerja AppKit yang dikongsi; memori peribadi kekal di bawah 30 MB dalam ujian kami.

Swift + AppKit lwn Electron untuk Utiliti macOS

Bagi utiliti yang sentiasa aktif, ciri masa jalan lebih penting daripada kemudahalihan UI. Kami memilih Swift + AppKit asli atas sebab praktikal berikut:

  • Artifak pengedaran yang kecil dan laluan permulaan terus tanpa pemanasan masa jalan JavaScript.
  • Integrasi kebolehcapaian dan penyisipan teks secara terus menggunakan API asli macOS.
  • Tiada pepohon proses enjin pelayar terbenam untuk utiliti papan kekunci yang ringan.

Untuk masa permulaan terukur bagi alat terbina dalam, Raycast dan Emoji Picker, lihat halaman perbandingan.

Pertukaran Reka Bentuk

Mengapa bar menu

Alat bar menu mudah dibiarkan berjalan dan pantas dipanggil. Bagi produk ini, itu memang sesuai dengan realiti: pengguna memanggilnya berulang kali semasa bersembang, mengendalikan tiket, menulis mesej commit dan dokumen.

Mengapa UI sengaja minimum

Kami membuang hampir semua elemen hiasan yang melambatkan pilihan. Kategori yang jelas, navigasi papan kekunci yang nyata dan bingkai antara muka yang minimum lebih berkesan daripada paparan visual yang lebih mewah dalam penggunaan harian kami sendiri.

Di mana pemilih terbina dalam masih unggul

Jika anda jarang menyisipkan emoji, pemilih macOS sudah cukup baik dan tidak memerlukan sebarang persediaan. Aplikasi kami untuk pengguna yang melakukannya sepanjang hari dan berulang kali merasai kos gangguannya.

Mengapa mengutamakan setempat

Mengutamakan setempat tidak boleh dikompromi. Tiada keperluan akaun, tiada kebergantungan awan dan tiada aktiviti menaip yang disalurkan melalui perkhidmatan luar.

Perkara yang Mengejutkan Kami

  • Pepijat status yang kecil boleh merosakkan kepercayaan lebih teruk daripada pepijat visual yang ketara.
  • Pengaktifan palsu disedari serta-merta oleh pengguna mahir.
  • Tiada siapa meminta ciri tambahan sehingga pengaktifan berhenti tersalah cetus.

Pengajaran utama: alat papan kekunci dinilai berdasarkan konsistensi, bukan kebaharuan. Jika aplikasi bertindak sama setiap kali, ia layak mendapat tempat tetap dalam aliran kerja.

Kekangan Diketahui

  • Kebenaran Kebolehcapaian diperlukan untuk pemantauan pencetus global dan penyisipan merentas aplikasi.
  • Aplikasi tidak memeriksa metadata medan yang difokuskan, termasuk sama ada medan itu selamat. Aplikasi yang tidak mahu dipantau pencetusnya boleh ditambah ke senarai pengecualian.
  • Sesetengah kawalan teks tersuai mentafsir peristiwa papan kekunci Backspace atau Unicode sintetik secara berbeza dan boleh mengurangkan kebolehpercayaan penyisipan.
  • Laluan pengesanan pencetus paling banyak diuji pada susun atur papan kekunci Latin.

Sokongan

Tanya soalan, laporkan isu atau minta ciri di halaman sokongan Emoji Picker. Tiada akaun diperlukan.

Cuba Emoji Picker

Menemui masalah? Laporkannya berserta versi aplikasi, versi macOS dan langkah untuk menghasilkannya semula.