Phân tích kỹ thuật chuyên sâu
Xây dựng trình chọn emoji gốc cho macOS bằng Swift
Không Electron, không cồng kềnh
Đây là nhật ký phát triển của Emoji Picker cho macOS. Chúng tôi làm ra nó vì trình chọn mặc định liên tục làm gián đoạn mạch viết của chính chúng tôi khi chat. Tùy chọn tích hợp sẵn buộc phải chuyển sang chuột và dùng chậm. Mục tiêu rất đơn giản: gõ, chọn và viết tiếp.
Trong bài phân tích này
Vấn đề thực sự trong quy trình làm việc
macOS vốn đã có sẵn trình chọn emoji. Để thỉnh thoảng dùng thì ổn. Nhưng trong công việc soạn văn bản cường độ cao, nó làm chúng tôi chậm lại. Mở bảng, đưa tay sang chuột, chọn, đóng bảng, lấy lại mạch. Lặp lại hàng chục lần mỗi ngày và cái giá của sự gián đoạn trở nên rõ ràng.
Thử nghiệm nội bộ ban đầu cho thấy việc kích hoạt nhầm gây khó chịu đến mức nào. Chúng tôi siết chặt các quy tắc cho đến khi việc kích hoạt trở nên bình thường và dễ đoán: gõ ;, ở nguyên trong ứng dụng hiện tại, chọn bằng bàn phím, rồi viết tiếp.
- Quy trình hỗ trợ và xử lý ticket cần chèn nhanh khi phân loại nhiều tin nhắn ngắn.
- Khi viết nhận xét code review và commit message, chúng tôi thường đã biết mình muốn gì, nên duyệt theo danh mục chậm hơn gõ truy vấn.
- Chuyển đổi trạng thái bảng chọn hơn 40 lần mỗi ngày nhanh chóng phá vỡ nhịp gõ.
Quyết định kiến trúc
Xử lý phím tắt toàn cục
Dữ liệu nhập được xử lý bởi một Core Graphics event tap cùng một máy trạng thái có kiểm soát. Một bộ đệm giới hạn trong bộ nhớ lưu các ký tự in được gần nhất của ứng dụng đang ở phía trước để nhận ra phím kích hoạt đã cấu hình. Bộ đệm được đặt lại khi đổi ứng dụng, dùng phím tắt, nhập ký tự không in được hoặc khi hủy. Độ trễ popup có thể tùy chỉnh giúp giao diện không xáo trộn khi bạn vẫn đang gõ truy vấn.
Lựa chọn giữa NSPanel và NSPopover
Chúng tôi bắt đầu với NSPopover rồi chuyển sang NSPanel. NSPopover quá dễ mất focus trong Slack và Chrome khi chuyển ứng dụng nhanh. NSPanel cho chúng tôi kiểm soát vòng đời một cách tường minh và định tuyến bàn phím dễ đoán giữa các ứng dụng.
Quyền Trợ năng và chiến lược chèn
Quyền Trợ năng cho phép Emoji Picker theo dõi các sự kiện toàn cục đó và gửi sự kiện bàn phím trở lại ứng dụng đang hoạt động. Chúng tôi loại bỏ cách chèn qua clipboard vì việc ghi đè nội dung clipboard gây bất ngờ và khó tin cậy. Ứng dụng không kiểm tra trường văn bản qua AXUIElement; nó ghi nhận ứng dụng đang ở phía trước khi một phiên bắt đầu và xác minh rằng chính ứng dụng đó vẫn ở phía trước trước khi chèn.
Thay thế văn bản theo số ký tự đã đếm
Một phiên nội tuyến đếm số ký tự kích hoạt và truy vấn đã đến ứng dụng đích. Khi bạn chọn, Emoji Picker gửi đúng số sự kiện phím Backspace đó, rồi gửi văn bản Unicode đã chọn dưới dạng sự kiện bàn phím giả lập. Ứng dụng không bao giờ thay đổi clipboard. Các control tùy chỉnh vẫn có thể diễn giải sự kiện bàn phím giả lập theo cách khác, vì vậy việc kiểm tra ứng dụng đích và hành vi hủy rất quan trọng.
Quy tắc nhận diện ngữ cảnh
Đây là những quy tắc thực tế chúng tôi dùng để việc kích hoạt luôn dễ đoán:
- Bỏ qua các cửa sổ của chính Emoji Picker và các ứng dụng trong danh sách loại trừ của người dùng.
- Gắn các ký tự vừa nhập và mỗi phiên đang hoạt động với ứng dụng ở phía trước; chuyển ứng dụng sẽ hủy phiên.
- So khớp phím kích hoạt đã cấu hình với một hậu tố giới hạn của các ký tự in được vừa nhập.
- Chấp nhận chữ cái, chữ số, dấu gạch dưới, dấu cộng và dấu gạch nối trong truy vấn nội tuyến; mọi ký tự khác sẽ hủy truy vấn.
- Áp dụng danh sách chặn chuỗi mở đầu, độ dài truy vấn tối thiểu và độ trễ popup do người dùng thiết lập trước khi hiển thị giao diện.
- Hỗ trợ tùy chỉnh phím kích hoạt mở trực tiếp (ví dụ ;; hoặc //) cho người dùng thích gọi một cách tường minh.
Logic trạng thái đơn giản hóa (rút gọn cho dễ đọc):
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)
}
Một lỗi buộc chúng tôi xây dựng mô hình trạng thái tốt hơn
Một lỗi trong ghi chú thay đổi v1.3 đã lộ ra điểm mù trong mô hình trạng thái cập nhật của chúng tôi: Checking... có thể vẫn hiển thị sau khi không có bản cập nhật, và Available có thể vẫn ở trạng thái không xác định. Lỗi nhỏ, nhưng ảnh hưởng đến lòng tin thì lớn.
Việc sửa lỗi buộc chúng tôi siết chặt máy trạng thái thay vì vá nhãn tại chỗ. Điều đó thay đổi cách chúng tôi xử lý trạng thái giao diện trong phần còn lại của ứng dụng: chuyển trạng thái tường minh, ít trạng thái suy diễn hơn và đồng bộ chặt chẽ hơn giữa các bước kiểm tra bất đồng bộ với trạng thái hiển thị.
- Triệu chứng: dòng trạng thái cập nhật bị cũ sau khi kiểm tra thành công và không có bản cập nhật.
- Nguyên nhân gốc: chuyển trạng thái chưa đầy đủ trong các callback cập nhật bất đồng bộ.
- Kết quả: các chuyển trạng thái tường minh giờ đây quyết định cách hiển thị trạng thái.
Ghi chú hiệu năng
Chỉ số quan trọng: thời gian từ lúc kích hoạt đến khi emoji được chèn. Đó là lý do chúng tôi gắn bó với runtime Swift + AppKit gốc thay vì nền tảng dựa trên engine trình duyệt.
Đo trên Mac15,11 (Apple M3 Max), macOS 26.2 bản dựng 25C56, dùng v1.3.1 từ tệp ZIP phát hành. Thời gian khởi chạy dưới đây là thời gian từ open -n cho đến khi tiến trình ứng dụng xuất hiện.
Lần khởi chạy đầu tiên trong phiên
217.68 ms (một lần chạy, khởi động đến khi tiến trình xuất hiện).
Khởi chạy lại (nóng)
Trung vị 110.02 ms qua 7 lần khởi chạy lại.
Bộ nhớ khi rảnh
110.4 MB RSS qua ps; Activity Monitor trong cùng lần chạy cho thấy 99.4 MB bộ nhớ thực và 29.6 MB bộ nhớ riêng.
Kích thước gói
4.49 MB ZIP, gói ứng dụng 12.96 MB trên ổ đĩa.
Các chỉ số bộ nhớ được trình bày nguyên trạng vì chúng dùng các mô hình tính toán khác nhau. Phần lớn RSS ở đây là bộ nhớ dùng chung của framework AppKit; bộ nhớ riêng luôn dưới 30 MB trong các thử nghiệm của chúng tôi.
Swift + AppKit vs Electron cho tiện ích macOS
Với các tiện ích luôn chạy, đặc tính lúc chạy quan trọng hơn khả năng di động của giao diện. Chúng tôi chọn Swift + AppKit gốc vì những lý do thực tế sau:
- Gói phân phối nhỏ gọn và khởi động trực tiếp, không cần làm nóng runtime JavaScript.
- Tích hợp trực tiếp trợ năng và chèn văn bản bằng các API gốc của macOS.
- Không có cây tiến trình của engine trình duyệt nhúng cho một tiện ích bàn phím gọn nhẹ.
Để xem số liệu khởi động đo được của công cụ tích hợp sẵn, Raycast và Emoji Picker, hãy xem trang so sánh.
Đánh đổi trong thiết kế
Vì sao đặt trên thanh menu
Công cụ trên thanh menu dễ duy trì hoạt động và gọi ra nhanh. Với sản phẩm này, điều đó đúng với thực tế: người dùng gọi nó liên tục khi chat, xử lý ticket, viết commit message và tài liệu.
Vì sao giao diện tối giản có chủ đích
Chúng tôi đã loại bỏ gần như mọi chi tiết trang trí làm chậm việc chọn. Danh mục rõ ràng, điều hướng bàn phím dễ hiểu và giao diện tối giản hiệu quả hơn các hiệu ứng hình ảnh cầu kỳ trong chính việc sử dụng hằng ngày của chúng tôi.
Khi nào trình chọn tích hợp sẵn vẫn tốt hơn
Nếu bạn hiếm khi chèn emoji, trình chọn của macOS đã đủ tốt và không cần thiết lập gì. Ứng dụng của chúng tôi dành cho những ai làm việc này cả ngày và liên tục cảm nhận cái giá của sự gián đoạn.
Vì sao ưu tiên xử lý cục bộ
Ưu tiên xử lý cục bộ là điều không thể thỏa hiệp. Không yêu cầu tài khoản, không phụ thuộc đám mây và không chuyển hành vi gõ phím qua dịch vụ bên ngoài.
Điều khiến chúng tôi bất ngờ
- Những lỗi trạng thái nhỏ có thể làm tổn hại lòng tin hơn cả lỗi hiển thị dễ thấy.
- Người dùng chuyên sâu nhận ra ngay những lần kích hoạt nhầm.
- Không ai đòi thêm tính năng cho đến khi việc kích hoạt hết bị nhầm.
Bài học chính: công cụ bàn phím được đánh giá qua sự nhất quán, không phải sự mới lạ. Nếu ứng dụng hoạt động giống nhau mọi lần, nó sẽ có chỗ đứng lâu dài trong quy trình làm việc.
Giới hạn đã biết
- Cần quyền Trợ năng để theo dõi phím kích hoạt toàn cục và chèn giữa các ứng dụng.
- Ứng dụng không kiểm tra siêu dữ liệu của trường đang được chọn, kể cả việc trường đó có phải trường bảo mật hay không. Bạn có thể thêm vào danh sách loại trừ những ứng dụng không muốn bị theo dõi phím kích hoạt.
- Một số control văn bản tùy chỉnh diễn giải sự kiện Backspace hoặc sự kiện bàn phím Unicode giả lập theo cách khác và có thể làm giảm độ tin cậy khi chèn.
- Cơ chế nhận diện phím kích hoạt được thử nghiệm nhiều nhất trên các bố cục bàn phím Latinh.
Hỗ trợ
Đặt câu hỏi, báo cáo sự cố hoặc đề xuất tính năng trên trang hỗ trợ Emoji Picker. Không cần tài khoản.
Dùng thử Emoji Picker
Phát hiện sự cố? Hãy báo cáo kèm phiên bản ứng dụng, phiên bản macOS và các bước để tái hiện.