Skip to content

yingDev/QingDict

Repository files navigation

QingDict

轻量级、实用主义的词典程序 for OS X

QingDict Icon

开发QingDict是基于以下一些想法:

  • 词典是为了帮助用户记住单词,而不是让用户反复查询同一个单词
  • 工具程序不应该分散用户的注意力
  • 以“实用”为目标,不拘泥于形式

获得代码

  git clone https://github.com/yingDev/QingDict.git
  cd QingDict
  git submodule init && git submodule update

截图

QingDict Demo QingDict Demo

QingDict Demo QingDict Demo

结构

包含三个Target:

  • QingDict:主程序,处理鼠标取词事件、显示状态栏图标、生词表、偏好设置
  • QingDict-Result: 显示执行查词、显示查词结果、与主程序通信;出于减少内存占用的目的,这是一个可独立运行的app,每次执行失去焦点会自动退出
  • Launch-Helper(objc): ServiceManagement实现启动项所需

有趣的关注点

  • 取词
    虽然有Accessibility API,但是OSX中许多程序是不支持此API取词的。本项目中采取了3中手段结合取词:AX、Cmd+C、模拟DragDrop,基本能应对大多数情形。这部分实现在UserTextSelectionExtractor.swfit中。

  • 进程间通信
    主程序与结果显示程序间用到了两种简单的IPC机制:命令行参数 和 NSDistributedNotification。前者用于传递查询的单词和选项等;后者主要作为“添加到生词表”的API。

  • 可滑动删除条目的NSTableRowView

    //这个类通过派生NSTableRowView, 处理一些鼠标事件、绘制逻辑,从而可以实现生词表“滑动删除条目”功能
    class WordbookRowView : NSTableRowView ...
  • NSStatusItem Hacking
    有很多OSX程序拥有菜单栏图标(NSStatusItem),其中一些有通过自定义窗口来实现的“弹出菜单”,这类实现往往有个问题,那就是Status Item的高亮状态,与系统不匹配。

    //在 AppDelegate 的 createStatusItem() 方法中,通过这个方法拦截鼠标左键事件,阻止StatusItem被单击而引发系统默认行为,然后手动设置其高亮状态
    NSEvent.addLocalMonitorForEventsMatchingMask(NSEventMask.LeftMouseDownMask) ...
  • Swift dylibs
    QingDict-Result.app是放在QingDict.app/Contents/Resources中的。由于当前Swift运行时没有内置于OS X中,Xcode会拷贝所有swift的dylib到每个app中。这就导致QingDict-Result.appQingDict.app都包含独立的一堆dylib,浪费了7MB左右的空间。项目中采取的解决办法是,在Build Phase中把QingDict-Result.app中的dylib替换为指向QingDict.app中dylib的symlink。

    # 与QingDict.app用到的dylib重复的,替换为symlink

theDir="${TARGET_BUILD_DIR}/${TARGETNAME}.app/Contents/Frameworks" sourceDir="../../../../Frameworks" dylibs="libswiftAppKit libswiftCore libswiftCoreData libswiftCoreGraphics libswiftCoreImage libswiftDarwin libswiftDispatch libswiftFoundation libswiftObjectiveC"

for lib in $dylibs do theDylib="$theDir/$lib.dylib" rm -f $theDylib ln -s $sourceDir/$lib.dylib $theDylib done


# License
`GPL-V3`

About

Lightweight & pragmatic dictionary program for OS X. (Swift)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published