使用 NSEventMaskKeyDown 掩码添加全局监视器不会触发

Question

我正在开发一个 MacOS 菜单栏应用程序，该应用程序需要跟踪一些全局快捷方式，以便于调整外部显示器上的显示亮度。但是，我无法让它在任何与键盘相关的事件上触发处理程序（鼠标事件工作得很好）。

我正在使用以下代码检查可访问性

NSDictionary *options = @{CFBridgingRelease(kAXTrustedCheckOptionPrompt): @YES};
BOOL accessibilityEnabled = AXIsProcessTrustedWithOptions((CFDictionaryRef)options);

然后，我使用以下方法添加全局事件监视器：

self.eventMonitor = [NSEvent addGlobalMonitorForEventsMatchingMask:NSEventMaskKeyDown handler:^(NSEvent * event) {
    NSLog(@"Some event");
}];

如果我将NSEventMaskKeyDown 切换到NSEventMaskMouseMove 或其他与鼠标相关的东西，一切正常。如果我尝试NSEventMaskAny，则不会再次触发（这看起来很奇怪，因为它仍然应该在鼠标上触发）。

Answer 1

NSEventMaskMouseMove 有效但NSEventMaskKeyDown 无效这一事实清楚地表明您的应用当前没有满足跟踪关键事件所需的所有要求。 NSEventMaskMouseMove 不被视为需要特殊安全保护的事件，甚至在AXIsProcessTrustedWithOptions 返回false 时有效。

Charles Srstka 在this answer 中提到的关键事件需要更多权限：

这不起作用的原因是因为 .keyDown 的全局监视器 事件需要比其他一些事件处理程序更多的权限， 包括有人认为这是副本的那个。这个 主要是因为全局 .keyDown 监视器可用于恶意 用途，例如键盘记录程序。所以有额外的安全性 采取措施确保我们是合法的：

1) 您的应用需要进行代码签名。

2) 您的应用无需启用应用沙盒，并且：

3) 您的应用需要在安全和隐私中注册 首选项窗格，在辅助功能下。

您需要在应用目标的“常规”窗格中启用代码签名。确保设置了“团队”和“签名证书”：

您还必须在 Capabilities 窗格中禁用“App Sandbox”：

请注意，为了满足第三个要求，您还需要将 Xcode 本身添加到 Accessibility 窗格中。否则，您希望能够调试您的事件监控。

关于关键事件的另外两个提示：

• 全局监控仅报告其他应用程序中发生的事件。要监控您自己的应用中的事件，您需要使用 addLocalMonitorForEventsMatchingMask 或来自 Cocoa Event Handling Guide 的实现。
• 发送到安全文本字段的关键事件被屏蔽，正如Jeff 在this answer 中提到的那样：

发送到NSSecureTextField（或NSSecureTextFieldCell）的关键事件被屏蔽，因此没有事件监视器可以拦截或读取它们。这是一项安全功能，可防止应用程序在输入密码时窃取密码，并且没有 API 可以绕过它。

关于与 AppStore 兼容的全局快捷方式的说明：很明显，您无法将应用上传到已禁用沙盒的 AppStore。如果您计划通过 Mac AppStore (MAS) 分发您的应用程序，您必须使用不同的 API。 This thread 提到了一堆对 MAS 友好的解决方案。他们使用旧的Carbon 时代的RegisterEventHotKey API。 Apple promised不拒绝使用它的应用程序。