HotKey

Version Carthage compatible CocoaPods compatible

macOS 中的简单全局快捷键。HotKey 封装了 Carbon API,用于处理全局快捷键,使其易于在 Swift 中使用。

安装

Swift Package Manager

要使用 Swift Package Manager 进行安装,只需将以下内容添加到您的 Package.swift

.package(url: "https://github.com/soffes/HotKey", from: "0.2.1")

Carthage

要使用 Carthage 进行安装,只需将以下内容添加到您的 Cartfile

github "soffes/HotKey"

CocoaPods

要使用 CocoaPods 进行安装,只需将以下内容添加到您的 Podfile

pod 'HotKey'

用法

只需使用一个键和修饰符初始化一个 HotKey

// Setup hot key for ⌥⌘R
let hotKey = HotKey(key: .r, modifiers: [.command, .option])

这是一个方便的初始化器,可以为您创建一个 KeyCombo。如果您喜欢老式的方式,也可以使用 Carbon 键代码和 Carbon 修饰符标志进行初始化。

现在您可以设置 keyDownHandler 并在按下热键时获取回调

hotKey.keyDownHandler = {
  print("Pressed at \(Date())")
}

如果您愿意,也可以实现 hotKey.keyUpHandler

您无需考虑何时注册和注销处理程序。这一切都会根据 HotKey 对象的生命周期自动发生。

致谢

HotKey 很大程度上受到了 PTHotKey 的启发。