macOS“Big Sur”检测深色菜单栏/系统托盘

Question

从 macOS (10.16 "Beta"/11.0) "Big Sur" 开始，菜单栏和系统托盘不再支持桌面暗模式首选项，因此很难为该桌面正确设置系统托盘图标的主题。

以前，使用 shell 命令default read，可以检测到暗模式：

defaults read -g AppleInterfaceStyle
# "Dark"

这仍然适用于检测 Window 主题，但不适用于菜单栏和系统托盘主题。

由于这个区域似乎是由壁纸亮度/白度/亮度驱动的，我们如何检测黑暗的系统托盘？

如何在（例如）Objective-C/C++ 中检测到这一点？欢迎任何解决方案，因为大多数都可以调整。

问题也发布到 Apple 开发者论坛：https://developer.apple.com/forums/thread/652540

Qt5.6 有一个名为setIsMask(...) 的功能，它允许操作系统自动处理这个问题。这实际上是 NSImage::setTemplate:Yes 的别名

更多参考 macOS “黑暗模式”：

• How to detect if OS X is in dark mode?
• MenuBar Icon for Dark Mode on OS X in Java

AdoptOpenJDK 上游错误报告：

• https://github.com/AdoptOpenJDK/openjdk-support/issues/146

关键字：NSStatusBar、Menu Bar Extras

Answer 1

我遇到了同样的问题，但我想我找到了解决方案。正如AppKit Release Notes for Big Sur 中所写（请参阅NSStatusItem 的条目），您只需观察NSStatusItem 的button 的effectiveAppearance。如果effectiveAppearance 的名称中包含dark，则为暗模式。否则就是灯光模式。

我创建的将light 或dark 显示为NSStatusItem 的文本标签的示例代码可在this GitHub repo 获得，具体参见AppDelegate.m。 （我很抱歉因为使用 Objective-C 而成为近乎灭绝的恐龙。）您可以通过在 Catalina 或 Big Sur 上运行来测试它，从系统偏好设置中更改暗/亮设置或桌面图片的颜色。

编辑：事实证明，Big Sur 有时变化 effectiveAppearance 从亮到亮或从暗到暗（从某种意义上说，虽然外观实际上并没有改变，但调用了 KVO。）因此，建议在更改前后检查effectiveApparance 的值，以确认实际更改的值。

Answer 2

我刚刚提交了一份 TSI 并得到了答复：

但我不会在 NSStatusItem 的按钮上添加 NSView 直接地。文档提到使用按钮属性进行自定义 状态项的外观和行为，但它应该可以工作 在按钮本身的范围内，也就是说，它是各种 图像和文本及其位置等属性。几年前， NSStatusItem 允许自定义视图，但随后被弃用，在 为了支持基于按钮的 UI，因此允许其绘图 行为以轻松适应菜单栏外观的变化。

不幸的是，没有办法以编程方式获取这些信息。 但是，获取信息对于我的三个应用程序来说非常重要，所以我去探索了。

对我个人而言，获取此信息不会触发任何安全提示非常重要。

我想出了以下想法：

• 创建和隐藏NSStatusItem
• 设置模板NSImage
• 将CALayer 的内容渲染成NSImage

您可以使用此代码获取颜色信息（注意：NSStatusItem 永远不可见，并且不会导致现有项目移动或类似的事情）。随意调整格式和类：

我创建了一个名为 MenuBar 的类，它有一个公共属性：

public class MenuBar {
    private static var statusItem: NSStatusItem?

    public static var theme: MenuBarTheme {
        if self.statusItem == nil {
            self.statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
            self.statusItem?.button?.image = NSImage(systemSymbolName: "circle.fill", accessibilityDescription: nil)
            self.statusItem?.isVisible = false
        }
        
        if let color = self.getPixelColor() {
            return color.redComponent < 0.20 && color.blueComponent < 0.20 && color.greenComponent < 0.20 ? .light : .dark
        }
        else
        {
            return NSApplication.isDarkMode ? .dark : .light
        }
    }

    public static var tintColor: NSColor {
        return self.theme == .light ? NSColor.black : NSColor.white
  }
    
  // MARK: - Helper
  fileprivate static func getPixelColor() -> NSColor?
  {
     if let image = self.statusItem?.button?.layer?.getBitmapImage() {
        let imageRep = NSBitmapImageRep(data: image.tiffRepresentation!)
            
         if let color = imageRep?.colorAt(x: Int(image.size.width / 2.0), y: Int(image.size.height / 2.0)) {
            return color
         }
     }
        
     return nil
  }
}

public enum MenuBarTheme : String
{
    case light = "light"
    case dark = "dark"
}

public extension NSApplication
{
    class var isDarkMode: Bool
    {
        return NSApplication.shared.appearance?.description.lowercased().contains("dark") ?? false
    }
}

public extension CALayer
{
    func getBitmapImage() -> NSImage
    {
        let btmpImgRep = NSBitmapImageRep(bitmapDataPlanes: nil, pixelsWide: Int(self.frame.width), pixelsHigh: Int(self.frame.height), bitsPerSample: 8, samplesPerPixel: 4, hasAlpha: true, isPlanar: false, colorSpaceName: .deviceRGB, bytesPerRow: 0, bitsPerPixel: 32)

        let ctx = NSGraphicsContext(bitmapImageRep: btmpImgRep!)
        let cgContext = ctx!.cgContext
        
        self.render(in: cgContext)
        
        let cgImage = cgContext.makeImage()

        return NSImage(cgImage: cgImage!, size: CGSize(width: self.frame.width, height: self.frame.height))
    }
}

Answer 3

对于 Java 17，已添加此功能。它最终将被向后移植到 Java 11。

https://github.com/openjdk/jdk/pull/481

新属性是：

apple.awt.enableTemplateImages

从命令行：

• -Dapple.awt.enableTemplateImages=true

...或通过 Java：

• System.setProperty("apple.awt.enableTemplateImages", "true");

注意，盯着 Big Sur 看，图标不再是纯黑色或纯白色（而是略带阴影），因此使用模板 API 对于正确的外观和感觉很重要。

Answer 4

虽然较新的 JDK 版本 will have this setTemplate feature natively，但对于较旧的 Java 版本，此技术使用 JNA 并依赖于 https://github.com/dyorgio/macos-tray-icon-fixer 项目。在内部，它使用 Java 反射和 JNA 指针的组合来更新图像并设置setTemplate flag to true。

已经用JDK8和JDK11测试过了。如果使用带有aarch64 support 的 JNA 端口，它也可以与新的 Apple Silicon Mac 一起使用。

感谢@dyorgio 提供的技巧。

// Verify theme to choose image version
Image iconImage = MacOSTrayIconFixer.getInitialIcon(blackImage, whiteImage);
// Create your TrayIcon using image
TrayIcon icon = new TrayIcon(iconImage, "Test");
// (Optional) add action and menu
icon.addActionListener((e) -> System.out.println("examples.BasicUsage.main():" + SwingUtilities.isEventDispatchThread()));

// Include in SystemTray BEFORE call fixer
SystemTray.getSystemTray().add(icon);

// Fix
MacOSTrayIconFixer.fix(icon, blackImage, whiteImage, false, 0);