极客编程日历桌面版开发笔记

macOS开发

Word count: 1,115 / Reading time: 4 min

 2018/02/10   Share

#背景介绍
图灵教育推出的限量款编程日历2018，因为简约大气的设计和每周一个编程语言的介绍，在程序员中广受欢迎。

图灵教育推出的编程日历实体版

不幸的是由于限量1000款，除去赠品的300多套，真正在售的只有600多套，很快就被抢购一空。值得欣慰的是，前天下午作者将pdf版本的日历公开下载。

在简书中也无意间看到有人用python片段将壁纸与当周的日历进行了融合，这个想法让我受到了启发，从该文章下面的评论看到很多用户(特别是mac用户)反映在 macOS 下，Wand 库有点小问题，GitHub 有人提到了这个 issue。

我一直在使用的一款软件Blotter，吸附在桌面上的日历和待办事项，于是就萌生了一个将该pdf吸附在桌面上，并根据当前日期展示相应日期的应用，于是我花半天做了TuringCalendar这款应用,开源地址。欢迎有能力的开发者改进这款应用。

Blotter截图

TuringCalendar的现状

由于时间仓促，这款软件有一些缺点需要后续解决。

现在的默认将日历页放置在右上角，因为左上角被Blotter占了，后面需要做成可配置的。
现在是白底的，在浅色背景的桌面上会比较美观，在深色背景中就不那么美观了。关于这点我在简书上问过python代码的作者，他告诉我用通道混合来解决，目前尚在研究中。

TuringCalendar截图

TuringCalendar开发过程

将窗口固定在桌面上

macOS管理窗口的类是NSWindow，将窗口固定在桌面上是通过继承该类，并override 其中的某些方法做到的。

override init(contentRect: NSRect, styleMask style: NSWindow.StyleMask, backing backingStoreType: NSWindow.BackingStoreType, defer flag: Bool) {
      
      super.init(contentRect: contentRect, styleMask: style, backing: backingStoreType, defer: flag)
      
      self.level = NSWindow.Level(rawValue: NSWindow.Level.RawValue(CGWindowLevelForKey(CGWindowLevelKey.desktopWindow) - 1))
      
      self.collectionBehavior = (NSWindow.CollectionBehavior(rawValue: NSWindow.CollectionBehavior.RawValue(UInt8(NSWindow.CollectionBehavior.canJoinAllSpaces.rawValue) |
          UInt8(NSWindow.CollectionBehavior.stationary.rawValue) |
          UInt8(NSWindow.CollectionBehavior.ignoresCycle.rawValue)))
      )
      
      self.backgroundColor = NSColor.clear
      self.isOpaque = false
      
      
  }
  
  override var canBecomeMain: Bool{
      return false;
  }
  
  override var canBecomeKey: Bool{
      return false;
  }

init方法中，指定了窗口的层级为desktopWindow-1，并且指定了窗口的背景色和一些操作的影响，主要是expose操作的时候，该窗口不应该和其他普通窗口一样，收缩起来。同时override相应方法，让该窗口不可以成为Main窗口和Key窗口。

读取pdf

读取pdf是通过PDFView完成的，需要导入Quartz库。在StoryBoard中也有相关的组件，可以查到日历每页的宽高，在StoryBoard中指定为固定宽高即可。


@IBOutlet var calendarViewer: PDFView!
override func viewDidLoad() {
    super.viewDidLoad()
    
    let url = Bundle.main.url(forResource: "calendar", withExtension: "pdf")
    let pdf = PDFDocument(url: url!)
    
    let today = GetWeekByDate(date: Date())
    
    calendarViewer.document = pdf
    calendarViewer.go(to: (pdf?.page(at: today-1))!)
    
    // Do any additional setup after loading the view.
}

这里发现一个坑，PDFView是会响应鼠标事件的，上下滑会在页与页之间切换，由于PDFView是NSView的子类，因此可以override hitTest方法，让PDFView不响应相关事件，使用了extension关键字。


extension PDFView{
    open override func hitTest(_ point: NSPoint) -> NSView? {
        return nil
    }
    
}

得到今天是今年的第几周

我将原作者提供的pdf文件进行了截取，只保留了我们需要的53个周的数据。通过下面的方法获取到当天是2018年的第几周，然后让PDFView跳到相应的页面。


func GetWeekByDate(date:Date) ->Int{
     guard let calendar = NSCalendar(identifier: NSCalendar.Identifier.gregorian) else {
         return 0
     }
     let components = calendar.components([.weekOfYear,.weekOfMonth,.weekday,.weekdayOrdinal], from: date)
    
     return components.weekOfYear!;
 }

将窗口固定在右上角

控制窗口这件事是由windowController完成的，获取到相应的window，并调用setFrameOrigin方法指定窗口的初始x,y坐标即可。需要注意的是屏幕的坐标左下角是（0，0）。


override func windowDidLoad() {
    super.windowDidLoad()
    
    if let window = window, let screen = window.screen {
        let screenRect = screen.visibleFrame
        let offsetFromLeft = CGFloat(screenRect.maxX - window.frame.width)
        let offsetFromTop = CGFloat(0)
        let offsetFromBottom = screenRect.maxY - window.frame.height - offsetFromTop
        window.setFrameOrigin(NSPoint(x: offsetFromLeft, y: offsetFromBottom))
    }
}

与Python版本相比的优点

相比于python版，TuringCalendar也有自己的优势，那就是不需要手动的去生成壁纸，而且每周要定时更换；环境的配置可能有一些坑，很多人都在评论里说配置没有成功。

最后，欢迎有能力的开发者改进这款应用。

原文作者: Chih-Hao

原文链接: http://zhihaozhang.github.io/2018/02/10/TuringCal/

发表日期: February 10th 2018, 1:23:31 pm

Next Post

GoBACKSPACE————致敬Go2Shell的Finder插件
Previous Post

更优雅的文件添加方式Drag & Drop

CATALOG

1. TuringCalendar的现状
2. TuringCalendar开发过程

