సాంకేతిక డీప్ డైవ్
Swiftలో macOS కోసం నేటివ్ ఎమోజీ పిక్కర్ను నిర్మించడం
Electron లేదు, అనవసర భారం లేదు
ఇది macOS కోసం Emoji Picker వెనుక ఉన్న నిర్మాణ లాగ్. చాట్ చేస్తున్నప్పుడు డిఫాల్ట్ పిక్కర్ మా సొంత రచనా ప్రవాహానికి పదే పదే అంతరాయం కలిగించడంతో దీన్ని నిర్మించాము. అంతర్నిర్మిత ఎంపిక మౌస్కు మారేలా చేసింది, వాడటానికి నెమ్మదిగా ఉండేది. లక్ష్యం సరళమైనది: టైప్ చేయండి, ఎంచుకోండి, ముందుకు సాగండి.
ఈ డీప్ డైవ్లో
అసలైన వర్క్ఫ్లో సమస్య
macOSలో ఇప్పటికే ఒక ఎమోజీ పిక్కర్ ఉంది. అప్పుడప్పుడు వాడటానికి అది సరిపోతుంది. ఎక్కువ టెక్స్ట్ ఉండే వర్క్ఫ్లోలలో అది మమ్మల్ని నెమ్మదింపజేసింది. ప్యానెల్ తెరవండి, చేతిని మౌస్పైకి తీసుకెళ్లండి, ఎంచుకోండి, ప్యానెల్ మూసివేయండి, సందర్భాన్ని తిరిగి పొందండి. ఒక్క రోజులో దీన్ని డజన్ల సార్లు చేస్తే, అంతరాయం ఖరీదు స్పష్టంగా తెలుస్తుంది.
ప్రారంభ అంతర్గత పరీక్షల్లో తప్పుడు యాక్టివేషన్లు ఎంత చికాకు కలిగిస్తాయో బయటపడింది. యాక్టివేషన్ విసుగు పుట్టేంత ఊహించదగినదిగా అనిపించే వరకు నియమాలను కఠినతరం చేశాము: ; టైప్ చేయండి, ప్రస్తుత యాప్లోనే ఉండండి, కీబోర్డ్తో ఎంచుకోండి, రాయడం కొనసాగించండి.
- ఎన్నో చిన్న సందేశాలను ట్రయాజ్ చేస్తున్నప్పుడు సపోర్ట్, టికెట్ వర్క్ఫ్లోలకు వేగవంతమైన చొప్పింపులు అవసరం.
- కోడ్ రివ్యూ వ్యాఖ్యలు, commit సందేశాల్లో ఉద్దేశం సాధారణంగా ముందే తెలుస్తుంది, కాబట్టి వర్గాల వారీగా బ్రౌజ్ చేయడం క్వెరీ టైప్ చేయడం కంటే నెమ్మదిగా ఉంటుంది.
- రోజుకు 40 సార్లకు పైగా ప్యానెల్ స్థితిని మార్చడం టైపింగ్ లయను త్వరగా దెబ్బతీస్తుంది.
ఆర్కిటెక్చర్ నిర్ణయాలు
గ్లోబల్ హాట్కీ నిర్వహణ
ఇన్పుట్ ఒక Core Graphics event tap మరియు రక్షిత స్టేట్ మెషీన్ ద్వారా నడుస్తుంది. కాన్ఫిగర్ చేసిన ట్రిగ్గర్ను గుర్తించడానికి, పరిమిత ఇన్-మెమరీ బఫర్ ముందువరుస యాప్ కోసం ఇటీవలి ముద్రించదగిన అక్షరాలను ఉంచుతుంది. యాప్ మారినప్పుడు, షార్ట్కట్లు, ముద్రించలేని ఇన్పుట్, రద్దు చేసినప్పుడు ఇది రీసెట్ అవుతుంది. క్వెరీ ఇంకా టైప్ అవుతున్నప్పుడు, కాన్ఫిగర్ చేయగల పాప్అప్ ఆలస్యం UIని ప్రశాంతంగా ఉంచుతుంది.
NSPanel vs NSPopover నిర్ణయం
NSPopoverతో ప్రారంభించి NSPanelకు మారాము. త్వరగా యాప్లు మారేటప్పుడు Slack, Chromeలో NSPopover చాలా సులభంగా ఫోకస్ కోల్పోయేది. NSPanel స్పష్టమైన లైఫ్సైకిల్ నియంత్రణను, యాప్ సరిహద్దుల అంతటా ఊహించదగిన కీబోర్డ్ రౌటింగ్ను ఇచ్చింది.
Accessibility అనుమతి మరియు చొప్పింపు వ్యూహం
ఆ గ్లోబల్ ఈవెంట్లను పర్యవేక్షించడానికి, యాక్టివ్ యాప్కు కీబోర్డ్ ఈవెంట్లను తిరిగి పంపడానికి Accessibility అనుమతి Emoji Pickerను అనుమతిస్తుంది. క్లిప్బోర్డ్ స్థితిని ఓవర్రైడ్ చేయడం ఆశ్చర్యకరంగా, నమ్మడానికి కష్టంగా ఉంటుంది కాబట్టి క్లిప్బోర్డ్ ఆధారిత చొప్పింపును తిరస్కరించాము. యాప్ AXUIElement ద్వారా టెక్స్ట్ ఫీల్డ్ను పరిశీలించదు; సెషన్ ప్రారంభమైనప్పుడు ఉద్దేశించిన ముందువరుస యాప్ను నమోదు చేసి, చొప్పించే ముందు అదే యాప్ ఇంకా ముందువరుసలో ఉందో లేదో ధృవీకరిస్తుంది.
లెక్కించిన టెక్స్ట్ భర్తీ
ఇన్లైన్ సెషన్ లక్ష్య యాప్కు చేరిన ట్రిగ్గర్ అక్షరాన్ని, క్వెరీ అక్షరాలను లెక్కిస్తుంది. ఎంచుకున్నప్పుడు, Emoji Picker అన్ని Backspace కీ ఈవెంట్లను పంపి, ఆపై ఎంచుకున్న Unicode టెక్స్ట్ను సింథటిక్ కీబోర్డ్ ఈవెంట్గా పంపుతుంది. ఇది క్లిప్బోర్డ్ను ఎప్పుడూ మార్చదు. కస్టమ్ కంట్రోల్లు సింథటిక్ కీబోర్డ్ ఈవెంట్లను వేరేలా అర్థం చేసుకోవచ్చు; అందుకే లక్ష్య యాప్ తనిఖీలు, రద్దు ప్రవర్తన ముఖ్యం.
సందర్భ గుర్తింపు నియమాలు
యాక్టివేషన్ను ఊహించదగినదిగా ఉంచడానికి మేము ఉపయోగించే ఆచరణాత్మక నియమాలు ఇవి:
- Emoji Picker సొంత విండోలను, వినియోగదారుని మినహాయింపు జాబితాలోని యాప్లను విస్మరించండి.
- ఇటీవలి ఇన్పుట్ను, ప్రతి యాక్టివ్ సెషన్ను ముందువరుస యాప్తో అనుసంధానించండి; యాప్ మారితే సెషన్ రద్దవుతుంది.
- ఇటీవలి ముద్రించదగిన ఇన్పుట్ యొక్క పరిమిత చివరి భాగంతో కాన్ఫిగర్ చేసిన ట్రిగ్గర్ను సరిపోల్చండి.
- ఇన్లైన్ క్వెరీలో అక్షరాలు, అంకెలు, అండర్స్కోర్, ప్లస్, హైఫన్లను అంగీకరించండి; ఇతర ఇన్పుట్ దాన్ని రద్దు చేస్తుంది.
- UIని చూపించే ముందు, వినియోగదారుని ప్రారంభ క్రమ బ్లాక్లిస్ట్, కనీస క్వెరీ పొడవు, పాప్అప్ ఆలస్యాన్ని వర్తింపజేయండి.
- స్పష్టమైన ఇన్వొకేషన్ను ఇష్టపడే వినియోగదారుల కోసం, నేరుగా తెరిచే ట్రిగ్గర్ అనుకూలీకరణకు మద్దతు ఇవ్వండి (ఉదాహరణకు ;; లేదా //).
సరళీకృత స్టేట్ లాజిక్ (చదవడానికి వీలుగా కుదించబడింది):
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 తెలియని స్థితిలోనే ఉండవచ్చు. బగ్ చిన్నదే, కానీ నమ్మకంపై దాని ప్రభావం పెద్దది.
దాన్ని సరిచేయడానికి లేబుల్లను అక్కడికక్కడే ప్యాచ్ చేయడానికి బదులు స్టేట్ మెషీన్ను కఠినతరం చేయాల్సి వచ్చింది. అది యాప్లోని మిగతా భాగాల్లో UI స్థితిని మేము చూసే విధానాన్నే మార్చింది: స్పష్టమైన మార్పులు, తక్కువ ఊహించిన స్థితులు, async తనిఖీలకూ కనిపించే స్థితికీ మధ్య బలమైన సమకాలీకరణ.
- లక్షణం: అప్డేట్ లేదని విజయవంతంగా తనిఖీ చేసిన తర్వాత కూడా పాత అప్డేటర్ స్థితి టెక్స్ట్.
- మూల కారణం: async అప్డేట్ కాల్బ్యాక్ల సమయంలో అసంపూర్ణ స్టేట్ మార్పులు.
- ఫలితం: ఇప్పుడు స్పష్టమైన స్టేట్ మార్పులే స్థితి ప్రదర్శనను నడిపిస్తాయి.
పనితీరు గమనికలు
ముఖ్యమైన కొలమానం: ట్రిగ్గర్ నుండి ఎమోజీ చొప్పించబడే వరకు పట్టే సమయం. అందుకే బ్రౌజర్-ఇంజిన్ స్టాక్కు బదులు నేటివ్ Swift + AppKit రన్టైమ్తోనే కొనసాగాము.
Mac15,11 (Apple M3 Max), macOS 26.2 build 25C56పై, విడుదల చేసిన ZIP నుండి v1.3.1 ఉపయోగించి కొలవబడింది. కింద ఉన్న లాంచ్ సమయం అంటే open -n నుండి యాప్ ప్రాసెస్ కనిపించే వరకు ఉండే స్టార్టప్.
సెషన్లో మొదటి లాంచ్
217.68 ms (ఒకే రన్, ప్రాసెస్ కనిపించే వరకు స్టార్టప్).
వార్మ్ రీలాంచ్
7 రీలాంచ్ రన్లలో మధ్యస్థం 110.02 ms.
నిష్క్రియ మెమరీ
ps ద్వారా 110.4 MB RSS; అదే రన్లో Activity Monitor 99.4 MB రియల్ మెమరీ, 29.6 MB ప్రైవేట్ మెమరీ చూపించింది.
ప్యాకేజీ పరిమాణం
4.49 MB ZIP, డిస్క్పై 12.96 MB యాప్ బండిల్.
మెమరీ కొలమానాలు వేర్వేరు లెక్కింపు నమూనాలను ఉపయోగిస్తాయి కాబట్టి వాటిని ఉన్నది ఉన్నట్టుగా చూపించాము. ఇక్కడి RSSలో ఎక్కువ భాగం షేర్డ్ AppKit ఫ్రేమ్వర్క్ మెమరీ; మా పరీక్షల్లో ప్రైవేట్ మెమరీ 30 MB కంటే తక్కువగా ఉంటుంది.
macOS యుటిలిటీల కోసం Swift + AppKit vs Electron
ఎల్లప్పుడూ నడిచే యుటిలిటీ సాధనాలకు, UI పోర్టబిలిటీ కంటే రన్టైమ్ స్వరూపమే ముఖ్యం. ఈ ఆచరణాత్మక కారణాల వల్ల నేటివ్ Swift + AppKitను ఎంచుకున్నాము:
- చిన్న డిస్ట్రిబ్యూషన్ ఫైల్, JavaScript రన్టైమ్ వార్మ్-అప్ లేని నేరుగా స్టార్టప్ మార్గం.
- macOS నేటివ్ APIలను ఉపయోగించి నేరుగా యాక్సెసిబిలిటీ మరియు టెక్స్ట్ చొప్పింపు ఇంటిగ్రేషన్.
- తేలికైన కీబోర్డ్ యుటిలిటీ కోసం ఎంబెడెడ్ బ్రౌజర్-ఇంజిన్ ప్రాసెస్ ట్రీ లేదు.
అంతర్నిర్మిత సాధనం, Raycast మరియు Emoji Picker అంతటా కొలిచిన స్టార్టప్ సమయాల కోసం, పోలిక పేజీని చూడండి.
డిజైన్ రాజీలు
మెను బార్ ఎందుకు
మెను బార్ సాధనాలను సులభంగా నడుస్తూ ఉంచవచ్చు, త్వరగా పిలవవచ్చు. ఈ ఉత్పత్తికి అదే వాస్తవానికి సరిపోయింది: చాట్లు, టికెట్లు, commit సందేశాలు, డాక్యుమెంట్ల సమయంలో వినియోగదారులు దీన్ని పదే పదే పిలుస్తారు.
ఉద్దేశపూర్వకంగా కనీస UI ఎందుకు
ఎంపికను నెమ్మదించే దాదాపు ప్రతి అలంకార అంశాన్నీ తొలగించాము. మా రోజువారీ వినియోగంలో, సమృద్ధమైన దృశ్య రూపకల్పనల కంటే స్పష్టమైన వర్గాలు, సులువైన కీబోర్డ్ నావిగేషన్, కనీస అలంకరణే మెరుగ్గా పనిచేశాయి.
అంతర్నిర్మిత పిక్కర్ ఇప్పటికీ మెరుగ్గా ఉండే సందర్భాలు
మీరు అప్పుడప్పుడు మాత్రమే ఎమోజీ చొప్పిస్తే, macOS పిక్కర్ ఇప్పటికే సరిపోతుంది, దానికి ఎలాంటి సెటప్ అవసరం లేదు. రోజంతా ఇదే చేస్తూ, పదే పదే అంతరాయాన్ని అనుభవించే వినియోగదారుల కోసం మా యాప్.
లోకల్-ఫస్ట్ ఎందుకు
లోకల్-ఫస్ట్ విషయంలో రాజీ లేదు. ఖాతా అవసరం లేదు, క్లౌడ్పై ఆధారపడటం లేదు, టైపింగ్ ప్రవర్తనను బయటి సేవల ద్వారా పంపడం లేదు.
మమ్మల్ని ఆశ్చర్యపరిచినవి
- స్పష్టంగా కనిపించే దృశ్య బగ్ల కంటే చిన్న స్థితి బగ్లు నమ్మకాన్ని ఎక్కువగా దెబ్బతీయగలవు.
- తప్పుడు యాక్టివేషన్లను పవర్ యూజర్లు వెంటనే గమనిస్తారు.
- యాక్టివేషన్ తప్పుగా పనిచేయడం ఆగే వరకు ఎవరూ మరిన్ని ఫీచర్లు అడగలేదు.
ప్రధాన పాఠం: కీబోర్డ్ సాధనాలను కొత్తదనంతో కాదు, స్థిరత్వంతో అంచనా వేస్తారు. యాప్ ప్రతిసారీ ఒకేలా ప్రవర్తిస్తే, వర్క్ఫ్లోలో శాశ్వత స్థానం సంపాదిస్తుంది.
తెలిసిన పరిమితులు
- గ్లోబల్ ట్రిగ్గర్ పర్యవేక్షణకు, యాప్ల మధ్య చొప్పింపుకు Accessibility అనుమతి అవసరం.
- ఫీల్డ్ సురక్షితమైనదా కాదా అనే దానితో సహా, ఫోకస్లో ఉన్న ఫీల్డ్ మెటాడేటాను యాప్ పరిశీలించదు. ట్రిగ్గర్ పర్యవేక్షణ వద్దనుకునే యాప్లను మినహాయింపు జాబితాకు జోడించవచ్చు.
- కొన్ని కస్టమ్ టెక్స్ట్ కంట్రోల్లు సింథటిక్ Backspace లేదా Unicode కీబోర్డ్ ఈవెంట్లను వేరేలా అర్థం చేసుకుంటాయి, దీనివల్ల చొప్పింపు విశ్వసనీయత తగ్గవచ్చు.
- ట్రిగ్గర్ గుర్తింపు మార్గం ఎక్కువగా లాటిన్ కీబోర్డ్ లేఅవుట్లపైనే పరీక్షించబడింది.
సపోర్ట్
Emoji Picker సపోర్ట్ పేజీలో ప్రశ్న అడగండి, సమస్యను నివేదించండి లేదా ఫీచర్ను అభ్యర్థించండి. ఖాతా అవసరం లేదు.
Emoji Pickerను ప్రయత్నించండి
సమస్య కనిపించిందా? యాప్ వెర్షన్, macOS వెర్షన్ మరియు పునరుత్పాదించే దశలతో నివేదించండి.