極客程式設計日曆桌面版for mac開發筆記[swift]

zhihaozhang發表於2018-03-08
程式設計Mac筆記Swift

背景介紹

圖靈教育推出的限量款程式設計日曆2018，因為簡約大氣的設計和每週一個程式語言的介紹，在程式設計師中廣受歡迎。

極客程式設計日曆桌面版for mac開發筆記[swift]

圖靈教育推出的程式設計日曆實體版

不幸的是由於限量1000款，除去贈品的300多套，真正在售的只有600多套，很快就被搶購一空。值得欣慰的是，前天下午作者將pdf版本的日曆公開下載。

在簡書中也無意間看到有人用python片段將桌布與當週的日曆進行了融合，這個想法讓我受到了啟發，從該文章下面的評論看到很多使用者(特別是mac使用者)反映在 macOS 下，Wand 庫有點小問題，GitHub 有人提到了這個 issue。

我一直在使用的一款軟體Blotter，吸附在桌面上的日曆和待辦事項，於是就萌生了一個將該pdf吸附在桌面上，並根據當前日期展示相應日期的應用，於是我花半天做了TuringCalendar這款應用,github開源地址。歡迎有能力的開發者改進這款應用。

極客程式設計日曆桌面版for mac開發筆記[swift]

Blotter截圖

TuringCalendar的現狀

由於時間倉促，這款軟體有一些缺點需要後續解決。

  • 現在的預設將日曆頁放置在右上角，因為左上角被Blotter佔了，後面需要做成可配置的。
  • 現在是白底的，在淺色背景的桌面上會比較美觀，在深色背景中就不那麼美觀了。關於這點我在簡書上問過python程式碼的作者，他告訴我用通道混合來解決，目前尚在研究中。

極客程式設計日曆桌面版for mac開發筆記[swift]

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也有自己的優勢，那就是不需要手動的去生成桌布，而且每週要定時更換；環境的配置可能有一些坑，很多人都在評論裡說配置沒有成功。

最後，歡迎有能力的開發者從githubfork並改進這款應用

相關文章