Teknik inceleme

Swift ile macOS için yerel bir emoji seçici geliştirmek

Electron yok, şişkinlik yok

Bu, Emoji Picker for macOS'in geliştirme günlüğü. Onu, varsayılan seçici sohbet ederken yazma akışımızı sürekli böldüğü için geliştirdik. Yerleşik seçenek fareye geçmeyi gerektiriyordu ve kullanımı yavaştı. Hedef basitti: yaz, seç, devam et.

Yayımlanma: 2026-02-16 · inndevs GmbH

Bu teknik incelemede

Asıl iş akışı sorunu

macOS zaten bir emoji seçiciyle geliyor. Ara sıra kullanım için gayet iyi. Yoğun metin iş akışlarında ise bizi yavaşlatıyordu. Paneli aç, eli fareye götür, seç, paneli kapat, kaldığın yeri yeniden bul. Bunu günde onlarca kez tekrarlayınca bölünmenin bedeli açıkça ortaya çıkıyor.

İlk dahili testler, hatalı tetiklenmelerin ne kadar can sıkıcı olduğunu gösterdi. Kuralları, tetiklenme sıkıcı derecede öngörülebilir hâle gelene kadar sıkılaştırdık: ; yazın, aynı uygulamada kalın, klavyeyle seçin, yazmaya devam edin.

  • Destek ve talep iş akışlarında, çok sayıda kısa mesajı ayıklarken hızlı ekleme gerekir.
  • Kod inceleme yorumlarında ve commit mesajlarında ne istediğimizi genellikle zaten biliriz; bu yüzden kategorilere göz atmak, sorgu yazmaktan daha yavaştır.
  • Paneli günde 40'tan fazla kez açıp kapatmak yazma ritmini hızla bozar.

Mimari kararlar

Genel kısayol tuşlarının işlenmesi

Giriş, bir Core Graphics event tap ve korumalı bir durum makinesi tarafından yönetilir. Sınırlı boyutta, bellekte tutulan bir arabellek, yapılandırılmış tetikleyicinin tanınabilmesi için ön plandaki uygulamaya ait en son yazdırılabilir karakterleri saklar. Uygulama değiştiğinde, kısayol kullanıldığında, yazdırılamayan bir giriş geldiğinde ve iptal edildiğinde sıfırlanır. Ayarlanabilir bir açılır pencere gecikmesi, sorgu hâlâ yazılırken arayüzü sakin tutar.

NSPanel mi, NSPopover mı?

NSPopover ile başladık ve NSPanel'e geçtik. NSPopover, Slack ve Chrome'da hızlı uygulama geçişleri sırasında odağı çok kolay kaybediyordu. NSPanel ise yaşam döngüsü üzerinde açık denetim ve uygulamalar arasında öngörülebilir klavye yönlendirmesi sağladı.

Erişilebilirlik izni ve ekleme stratejisi

Erişilebilirlik izni, Emoji Picker'ın bu genel olayları izlemesine ve klavye olaylarını etkin uygulamaya geri göndermesine olanak tanır. Panoya dayalı eklemeyi reddettik, çünkü pano içeriğinin üzerine yazılması şaşırtıcıdır ve güven vermez. Uygulama, bir metin alanını AXUIElement üzerinden incelemez; oturum başladığında hedeflenen ön plandaki uygulamayı kaydeder ve eklemeden önce aynı uygulamanın hâlâ ön planda olduğunu doğrular.

Sayılmış metin değiştirme

Satır içi bir oturum, hedef uygulamaya ulaşan tetikleyici ve sorgu karakterlerini sayar. Seçim yapıldığında Emoji Picker o sayıda Backspace tuş olayı gönderir, ardından seçilen Unicode metnini yapay bir klavye olayı olarak gönderir. Panoyu asla değiştirmez. Özel denetimler yapay klavye olaylarını yine de farklı yorumlayabilir; hedef uygulama denetimlerinin ve iptal davranışının önemi de buradan gelir.

Bağlam algılama kuralları

Tetiklenmeyi öngörülebilir tutmak için kullandığımız pratik kurallar şunlar:

  • Emoji Picker'ın kendi pencerelerini ve kullanıcının hariç tutma listesindeki uygulamaları yok say.
  • Son girişi ve her etkin oturumu ön plandaki uygulamaya bağla; uygulama değiştirmek oturumu iptal eder.
  • Yapılandırılmış tetikleyiciyi son yazdırılabilir girişin sınırlı bir son ekiyle eşleştir.
  • Satır içi sorguda harf, rakam, alt çizgi, artı ve kısa çizgi kabul edilir; başka bir giriş sorguyu iptal eder.
  • Arayüzü göstermeden önce kullanıcının açılış dizisi engel listesini, minimum sorgu uzunluğunu ve açılır pencere gecikmesini uygula.
  • Açık çağırmayı tercih eden kullanıcılar için doğrudan açma tetikleyicisinin özelleştirilmesini destekle (örneğin ;; veya //).

Basitleştirilmiş durum mantığı (okunabilirlik için kısaltıldı):

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 tetikleyici gecikmeli sorgu onayla, odağı kaybet veya iptal et
Durum akışına genel bakış: idle -> tracking -> open -> idle.

Bizi daha iyi bir durum modeline zorlayan hata

v1.3 değişiklik günlüğü notlarındaki bir sorun, güncelleyici durum modelimizdeki bir kör noktayı ortaya çıkardı: güncelleme bulunamadığında Checking... ekranda kalabiliyor, Available ise bilinmez durumda kalabiliyordu. Hata küçüktü ama güvene etkisi büyüktü.

Düzeltmek için etiketleri yerinde yamamak yerine durum makinesini sıkılaştırmamız gerekti. Bu, uygulamanın geri kalanında arayüz durumunu ele alış biçimimizi değiştirdi: açık geçişler, daha az çıkarımsal durum ve eşzamansız denetimlerle görünen durum arasında daha güçlü bir senkronizasyon.

  • Belirti: güncelleme bulunamadığı başarılı denetimlerden sonra güncelleyici durum metninin eski kalması.
  • Kök neden: eşzamansız güncelleme geri çağrılarında eksik durum geçişleri.
  • Sonuç: durum gösterimini artık açık durum geçişleri belirliyor.

Performans notları

Önemli olan ölçüt: tetikleyiciden emojinin eklenmesine kadar geçen süre. Tarayıcı motoru tabanlı bir yığın yerine yerel Swift + AppKit çalışma zamanında kalmamızın nedeni bu.

Mac15,11 (Apple M3 Max), macOS 26.2 derleme 25C56 üzerinde, dağıtılan ZIP'teki v1.3.1 ile ölçüldü. Aşağıdaki başlatma süresi, open -n komutundan uygulama süreci görünene kadar geçen süreyi ifade eder.

Oturumdaki ilk başlatma

217.68 ms (tek ölçüm, sürecin görünür hâle gelmesine kadar).

Sıcak yeniden başlatma

7 yeniden başlatmada medyan 110.02 ms.

Boştaki bellek

ps ile 110.4 MB RSS; aynı ölçümde Etkinlik Monitörü 99.4 MB gerçek ve 29.6 MB özel bellek gösterdi.

Paket boyutu

4.49 MB ZIP, diskte 12.96 MB uygulama paketi.

Bellek ölçümleri farklı hesaplama modelleri kullandığından olduğu gibi sunulmuştur. Buradaki RSS'in büyük bölümü paylaşılan AppKit çerçeve belleğidir; testlerimizde özel bellek 30 MB altında kalıyor.

macOS yardımcı araçları için Swift + AppKit mi, Electron mı?

Sürekli açık kalan yardımcı araçlarda çalışma zamanı yapısı, arayüz taşınabilirliğinden daha önemlidir. Şu pratik nedenlerle yerel Swift + AppKit'i seçtik:

  • Küçük dağıtım dosyası ve JavaScript çalışma zamanının ısınmasını beklemeyen doğrudan başlatma yolu.
  • macOS'in yerel API'leriyle doğrudan erişilebilirlik ve metin ekleme entegrasyonu.
  • Hafif bir klavye aracı için gömülü tarayıcı motoru süreç ağacı yok.

Yerleşik araç, Raycast ve Emoji Picker'ın ölçülmüş başlatma süreleri için karşılaştırma sayfasına bakın.

Tasarım ödünleşimleri

Neden menü çubuğu?

Menü çubuğu araçlarını açık tutmak kolaydır ve hızlıca çağrılırlar. Bu ürün için bu, gerçeklikle örtüşüyordu: kullanıcılar onu sohbetler, destek talepleri, commit mesajları ve belgeler sırasında tekrar tekrar çağırıyor.

Neden bilinçli olarak sade arayüz?

Seçimi yavaşlatan neredeyse tüm süs öğelerini kaldırdık. Kendi günlük kullanımımızda net kategoriler, belirgin klavye gezinmesi ve en az arayüz çerçevesi, daha zengin görsel tasarımlardan daha iyi sonuç verdi.

Yerleşik seçicinin hâlâ üstün olduğu yerler

Emojiyi nadiren ekliyorsanız macOS'in seçicisi zaten yeterince iyidir ve hiç kurulum gerektirmez. Bizim uygulamamız bunu gün boyu yapan ve bölünmenin bedelini tekrar tekrar hisseden kullanıcılar için.

Neden yerel öncelik?

Yerel öncelik tartışmaya kapalıydı. Hesap zorunluluğu yok, buluta bağımlılık yok ve yazma davranışı harici hizmetlerden geçirilmiyor.

Bizi şaşırtanlar

  • Küçük durum hataları, göze batan görsel hatalardan daha fazla güven kaybına yol açabilir.
  • Hatalı tetiklenmeler, deneyimli kullanıcıların hemen dikkatini çeker.
  • Tetiklenme hatasız çalışana kadar kimse yeni özellik istemedi.

Ana ders: klavye araçları yenilikle değil, tutarlılıkla değerlendirilir. Uygulama her seferinde aynı şekilde davranırsa iş akışında kalıcı bir yer edinir.

Bilinen kısıtlamalar

  • Genel tetikleyici izleme ve uygulamalar arası ekleme için Erişilebilirlik izni gereklidir.
  • Uygulama, odaktaki alanın meta verilerini (alanın güvenli olup olmadığı dahil) incelemez. Tetikleyici izlemesi istenmeyen uygulamalar hariç tutma listesine eklenebilir.
  • Bazı özel metin denetimleri yapay Backspace veya Unicode klavye olaylarını farklı yorumlar ve eklemenin güvenilirliğini azaltabilir.
  • Tetikleyici algılama yolu en çok Latin klavye düzenlerinde test edildi.

Destek

Emoji Picker destek sayfasında soru sorun, sorun bildirin ya da özellik isteyin. Hesap gerekmez.

Emoji Picker'ı deneyin

Bir sorun mu buldunuz? Uygulama sürümü, macOS sürümü ve sorunu yeniden oluşturma adımlarıyla bildirin.