如何追踪NSWindow的onActiveSpace属性变化及KVO失效排查

一、onActiveSpace是否支持KVO？ #

NSWindow的onActiveSpace属性不支持KVO。这个属性属于AppKit中未适配KVO的属性，系统不会在其值变化时自动发送KVO通知，所以你用常规KVO监听无法收到回调。

二、如何确认属性是否支持KVO？ #

可以通过以下几种方式判断：

• 查官方文档：苹果API文档会明确标注属性是否“Key-Value Observing Compliant”，有标注的才支持KVO；没提的基本不支持。
• 代码验证：调用类的automaticallyNotifiesObserversForKey:方法直接判断：

  BOOL isCompliant = [NSWindow automaticallyNotifiesObserversForKey:@"onActiveSpace"];
  NSLog(@"onActiveSpace支持KVO：%d", isCompliant);
  

  返回YES表示支持自动发送KVO通知，NO则不支持。
• 看属性实现逻辑：如果是自定义类的属性，需满足：要么是自动合成的@property，要么自定义setter中手动调用了willChangeValueForKey:和didChangeValueForKey:。但系统属性的实现不可见，所以优先看文档或用代码验证。

三、追踪onActiveSpace变化的替代方案 #

既然KVO行不通，推荐用以下可靠方法：

监听NSWorkspace空间切换通知 #

通过监听NSWorkspaceActiveSpaceDidChangeNotification，在空间切换时主动检查窗口的onActiveSpace状态：

// 初始化时添加通知监听
- (instancetype)initWithWidgetSpaceTracker:(WidgetSpaceTracker*)owner {
  if ((self = [super init])) {
    DCHECK(owner);
    _owner = owner;
    // 添加空间变化通知监听
    [[NSWorkspace sharedWorkspace] addObserver:self
                                      selector:@selector(handleActiveSpaceChange:)
                                          name:NSWorkspaceActiveSpaceDidChangeNotification
                                        object:nil];
  }
  return self;
}

// 空间变化回调
- (void)handleActiveSpaceChange:(NSNotification *)note {
  NSWindow* window = _owner->GetNSWindow();
  if (window) {
    BOOL isOnActiveSpace = window.onActiveSpace;
    _owner->OnSpaceActiveChanged(isOnActiveSpace);
  }
}

// 记得在dealloc中移除观察者
- (void)dealloc {
  [[NSWorkspace sharedWorkspace] removeObserver:self name:NSWorkspaceActiveSpaceDidChangeNotification object:nil];
}

其他可选方案 #

• 窗口遮挡状态回调：实现NSWindowDelegate的windowDidChangeOcclusionState:方法，结合遮挡状态辅助判断，但该方法主要针对窗口是否被遮挡，不如空间通知直接。
• 定期轮询（不推荐）：用NSTimer定期查询onActiveSpace的值，这种方法效率低，仅适合临时调试场景。

内容的提问来源于stack exchange，提问作者Klauxs