Ulasan Teknis Mendalam

Membangun Emoji Picker Native untuk macOS dengan Swift

Tanpa Electron, Tanpa Bloat

Ini adalah catatan pembuatan di balik Emoji Picker untuk macOS. Kami membuatnya karena pemilih bawaan terus mengganggu alur menulis kami sendiri saat chatting. Opsi bawaan mengharuskan beralih ke mouse dan lambat digunakan. Tujuannya sederhana: ketik, pilih, lalu lanjutkan.

Diterbitkan 2026-02-16 · oleh inndevs GmbH

Dalam Ulasan Mendalam Ini

Masalah Alur Kerja yang Sebenarnya

macOS sudah menyertakan pemilih emoji. Untuk penggunaan sesekali, itu sudah cukup. Dalam alur kerja dengan banyak teks, pemilih itu memperlambat kami. Buka panel, pindahkan tangan ke mouse, pilih, tutup panel, kembali ke konteks. Ulangi puluhan kali dalam sehari dan besarnya gangguan itu jadi jelas.

Pengujian internal awal memperlihatkan betapa mengganggunya aktivasi yang salah. Kami memperketat aturannya hingga aktivasi terasa biasa saja dan dapat diprediksi: ketik ;, tetap di aplikasi saat ini, pilih dengan keyboard, lanjutkan menulis.

  • Alur kerja dukungan dan tiket membutuhkan penyisipan cepat saat memilah banyak pesan singkat.
  • Dalam komentar code review dan pesan commit, kami biasanya sudah tahu maksudnya, jadi menelusuri kategori lebih lambat daripada mengetik kueri.
  • Mengganti state panel lebih dari 40 kali sehari cepat merusak ritme mengetik.

Keputusan Arsitektur

Penanganan hotkey global

Input digerakkan oleh event tap Core Graphics ditambah state machine yang terlindungi. Buffer di memori dengan ukuran terbatas menyimpan karakter cetak terbaru untuk aplikasi terdepan agar pemicu yang dikonfigurasi dapat dikenali. Buffer ini direset saat aplikasi berganti, saat pintasan digunakan, saat ada input non-cetak, dan saat dibatalkan. Jeda popup yang dapat dikonfigurasi menjaga UI tetap tenang selama kueri masih diketik.

Keputusan NSPanel vs NSPopover

Kami memulai dengan NSPopover lalu beralih ke NSPanel. NSPopover terlalu mudah kehilangan fokus di Slack dan Chrome saat berpindah aplikasi dengan cepat. NSPanel memberi kami kendali siklus hidup yang eksplisit dan perutean keyboard yang dapat diprediksi lintas aplikasi.

Izin aksesibilitas dan strategi penyisipan

Izin Aksesibilitas memungkinkan Emoji Picker memantau peristiwa global tersebut dan mengirim kembali peristiwa keyboard ke aplikasi aktif. Kami menolak penyisipan berbasis clipboard karena menimpa isi clipboard itu mengejutkan dan sulit dipercaya. Aplikasi tidak memeriksa kolom teks melalui AXUIElement; aplikasi mencatat aplikasi terdepan yang dituju saat sesi dimulai dan memverifikasi bahwa aplikasi yang sama masih berada di depan sebelum menyisipkan.

Penggantian teks terhitung

Sesi inline menghitung karakter pemicu dan kueri yang sudah sampai ke aplikasi tujuan. Saat pilihan dibuat, Emoji Picker mengirim peristiwa tombol Backspace sebanyak itu, lalu mengirim teks Unicode yang dipilih sebagai peristiwa keyboard sintetis. Clipboard tidak pernah diubah. Kontrol kustom tetap bisa menafsirkan peristiwa keyboard sintetis secara berbeda, itulah sebabnya pemeriksaan aplikasi tujuan dan perilaku pembatalan itu penting.

Aturan Deteksi Konteks

Berikut aturan praktis yang kami gunakan agar aktivasi tetap dapat diprediksi:

  • Abaikan jendela milik Emoji Picker sendiri dan aplikasi yang ada di daftar pengecualian pengguna.
  • Kaitkan input terbaru dan setiap sesi aktif dengan aplikasi terdepan; berpindah aplikasi akan membatalkan sesi.
  • Cocokkan pemicu yang dikonfigurasi dengan akhiran terbatas dari input cetak terbaru.
  • Terima huruf, angka, garis bawah, tanda plus, dan tanda hubung dalam kueri inline; input lain akan membatalkannya.
  • Terapkan daftar blokir urutan pembuka milik pengguna, panjang kueri minimum, dan jeda popup sebelum menampilkan UI.
  • Mendukung kustomisasi pemicu buka langsung (misalnya ;; atau //) bagi pengguna yang lebih suka pemanggilan eksplisit.

Logika state yang disederhanakan (dipangkas agar 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 pemicu kueri dengan debounce commit, blur, atau batal
Gambaran alur state: idle -> tracking -> open -> idle.

Bug yang Memaksa Model State yang Lebih Baik

Satu masalah dalam catatan log perubahan v1.3 mengungkap titik buta dalam model status updater kami: Checking... bisa tetap terlihat setelah hasil tidak ada pembaruan, dan Available bisa tetap tidak diketahui. Bug-nya kecil, tetapi dampaknya terhadap kepercayaan besar.

Perbaikannya memaksa kami memperketat state machine alih-alih menambal label di tempat. Hal itu mengubah cara kami menangani status UI di seluruh aplikasi: transisi eksplisit, lebih sedikit state yang disimpulkan, dan sinkronisasi yang lebih kuat antara pemeriksaan async dan status yang terlihat.

  • Gejala: teks status updater yang usang setelah pemeriksaan berhasil tanpa pembaruan.
  • Akar masalah: transisi state yang tidak lengkap pada callback pembaruan async.
  • Hasil: transisi state yang eksplisit kini mengendalikan tampilan status.

Catatan Performa

Metrik yang penting: waktu dari pemicu hingga emoji tersisip. Itulah sebabnya kami tetap menggunakan runtime Swift + AppKit native, bukan stack berbasis mesin browser.

Diukur pada Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56, menggunakan v1.3.1 dari ZIP yang dirilis. Waktu peluncuran di bawah berarti waktu mulai dari open -n hingga proses aplikasi muncul.

Peluncuran pertama dalam sesi

217.68 ms (satu kali pengujian, waktu mulai hingga proses terlihat).

Peluncuran ulang warm

Median 110.02 ms dari 7 kali peluncuran ulang.

Memori saat idle

110.4 MB RSS melalui ps; Activity Monitor pada pengujian yang sama menunjukkan memori nyata 99.4 MB dan memori pribadi 29.6 MB.

Ukuran paket

ZIP 4.49 MB, bundle aplikasi 12.96 MB di disk.

Metrik memori disajikan apa adanya karena menggunakan model perhitungan yang berbeda. Sebagian besar RSS di sini adalah memori framework AppKit bersama; memori pribadi tetap di bawah 30 MB dalam pengujian kami.

Swift + AppKit vs Electron untuk Utilitas macOS

Untuk utilitas yang selalu aktif, karakter runtime lebih penting daripada portabilitas UI. Kami memilih Swift + AppKit native karena alasan praktis berikut:

  • Artefak distribusi yang kecil dan jalur startup langsung tanpa pemanasan runtime JavaScript.
  • Integrasi aksesibilitas dan penyisipan teks secara langsung menggunakan API native macOS.
  • Tanpa pohon proses mesin browser tersemat untuk utilitas keyboard yang ringan.

Untuk waktu mulai terukur dari alat bawaan, Raycast, dan Emoji Picker, lihat halaman perbandingan.

Kompromi Desain

Mengapa di bilah menu

Alat bilah menu mudah dibiarkan tetap berjalan dan cepat dipanggil. Untuk produk ini, hal itu sesuai dengan kenyataan: pengguna memanggilnya berulang kali saat chatting, mengerjakan tiket, menulis pesan commit, dan dokumen.

Mengapa UI sengaja dibuat minimal

Kami menghapus hampir semua elemen dekoratif yang memperlambat pilihan. Kategori yang jelas, navigasi keyboard yang gamblang, dan bingkai antarmuka minimal terbukti lebih baik daripada tampilan visual yang lebih kaya dalam pemakaian kami sehari-hari.

Di mana pemilih bawaan masih unggul

Jika Anda jarang menyisipkan emoji, pemilih bawaan macOS sudah cukup baik dan tidak perlu pengaturan apa pun. Aplikasi kami ditujukan bagi pengguna yang melakukannya sepanjang hari dan berulang kali merasakan gangguannya.

Mengapa mengutamakan lokal

Mengutamakan lokal adalah harga mati. Tanpa kewajiban akun, tanpa ketergantungan cloud, dan tanpa meneruskan aktivitas mengetik melalui layanan eksternal.

Yang Mengejutkan Kami

  • Bug status kecil bisa merusak kepercayaan lebih parah daripada bug visual yang jelas.
  • Aktivasi yang salah langsung disadari oleh pengguna mahir.
  • Tidak ada yang meminta fitur tambahan sampai aktivasi berhenti salah picu.

Pelajaran utamanya: alat keyboard dinilai dari konsistensinya, bukan kebaruannya. Jika aplikasi berperilaku sama setiap saat, ia layak mendapat tempat permanen dalam alur kerja.

Batasan yang Diketahui

  • Izin Aksesibilitas diperlukan untuk memantau pemicu global dan menyisipkan lintas aplikasi.
  • Aplikasi tidak memeriksa metadata kolom yang sedang aktif, termasuk apakah kolom tersebut aman. Aplikasi yang tidak ingin dipantau pemicunya dapat ditambahkan ke daftar pengecualian.
  • Beberapa kontrol teks kustom menafsirkan peristiwa keyboard Backspace atau Unicode sintetis secara berbeda sehingga dapat mengurangi keandalan penyisipan.
  • Jalur deteksi pemicu paling banyak diuji pada tata letak keyboard Latin.

Dukungan

Ajukan pertanyaan, laporkan masalah, atau minta fitur di halaman dukungan Emoji Picker. Tanpa perlu akun.

Coba Emoji Picker

Menemukan masalah? Laporkan dengan menyertakan versi aplikasi, versi macOS, dan langkah-langkah untuk mereproduksinya.