88a3f6d65f
1. 新增TDashboard翻译类型与多语言文案 2. 完善macOS权限管理与Impeller渲染适配 3. 更新服务器部署配置与协议文件上传脚本 4. 修复翻译导入服务与根类型编译问题
702 lines
31 KiB
Swift
702 lines
31 KiB
Swift
/// ============================================================
|
||
/// 闲言APP — macOS 主窗口
|
||
/// 创建时间: 2026-06-02
|
||
/// 更新时间: 2026-06-26
|
||
/// 作用: 主窗口初始化，通过 Info.plist FLTEnableImpeller 控制 Impeller 开关，
|
||
/// 注册 apps.xy.xianyan/macos MethodChannel
|
||
/// 上次更新: 1. 修复编译错误：FlutterDartProject 在 macOS 平台无 commandLineArguments
|
||
/// 属性（该属性仅 iOS 平台可用），原实现导致编译失败。
|
||
/// 2. 修复 Impeller 开关不生效：经实测 setenv("FLUTTER_ENGINE_SWITCH_0")
|
||
/// 在 macOS 桌面 embedder 中不生效（即使在 debug 模式下也不读取）。
|
||
/// macOS 唯一可靠方式是 Info.plist 的 FLTEnableImpeller key（已添加，值为 true）。
|
||
/// 3. currentImpellerEnabled 改为固定 true（因 FLTEnableImpeller=true 为静态值）。
|
||
/// 4. 保留 setenv 调用以兼容未来 Flutter 版本可能的支持。
|
||
/// 5. 保留 hideSystemTrafficButtons(of:) 公共方法（双标题栏修复）。
|
||
/// 6. 保留 Intel Mac 与 Apple Silicon 统一窗口栏处理方案。
|
||
/// ============================================================
|
||
|
||
import Cocoa
|
||
import FlutterMacOS
|
||
import macos_window_utils
|
||
|
||
class MainFlutterWindow: NSWindow, NSTouchBarDelegate {
|
||
// ============================================================
|
||
// MARK: - 属性
|
||
// ============================================================
|
||
|
||
/// 平台通道引用，用于 Touch Bar 按钮回调 + 全屏退出事件通知
|
||
private var platformChannel: FlutterMethodChannel?
|
||
|
||
/// Touch Bar 按钮配置 [{label: "加粗", action: "bold"}, ...]
|
||
private var touchBarItems: [[String: String]] = []
|
||
|
||
/// 当前引擎实际运行的 Impeller 状态（应用启动时固定，不随用户设置改变）
|
||
///
|
||
/// 此值在 awakeFromNib 中通过 shouldEnableImpeller() 设置，
|
||
/// 表示当前 Flutter 引擎实际是否在使用 Impeller 渲染。
|
||
/// 与 UserDefaults 中的设置值不同：用户修改设置后，
|
||
/// UserDefaults 返回的是修改后的值，但引擎实际运行的仍是启动时的值，
|
||
/// 需重启应用才能让新设置生效。
|
||
static var currentImpellerEnabled: Bool = false
|
||
|
||
// ============================================================
|
||
// MARK: - CPU 架构检测
|
||
// ============================================================
|
||
|
||
/// 检测是否为 Intel Mac（x86_64）
|
||
///
|
||
/// Intel Mac 的 GPU 驱动在透明窗口 + NSVisualEffectView 环境下
|
||
/// 会出现渲染撕裂、字体割裂、闪烁等问题。
|
||
/// 检测架构后，在 Intel Mac 上禁用透明窗口特效，使用标准窗口配置。
|
||
private static func isIntelMac() -> Bool {
|
||
var systemInfo = utsname()
|
||
uname(&systemInfo)
|
||
let machineMirror = Mirror(reflecting: systemInfo.machine)
|
||
let machine = machineMirror.children.reduce("") { identifier, element in
|
||
guard let value = element.value as? Int8, value != 0 else { return identifier }
|
||
return identifier + String(UnicodeScalar(UInt8(value)))
|
||
}
|
||
return machine == "x86_64"
|
||
}
|
||
|
||
/// 读取用户设置，判断是否启用 Impeller 渲染引擎
|
||
///
|
||
/// Impeller 是 Flutter 的新一代渲染引擎（基于 Metal），
|
||
/// 在 Intel Mac 上可能出现渲染资源累积导致色差/字体割裂。
|
||
///
|
||
/// 默认值策略（用户未设置时）：
|
||
/// - Apple Silicon (arm64): 默认开启 — Impeller 在 Metal 驱动上性能更好
|
||
/// - Intel Mac (x86_64): 默认关闭 — Metal 驱动有渲染资源累积 bug
|
||
///
|
||
/// 用户可在「通用设置 → 高级」中手动覆盖此设置，修改后需重启应用生效。
|
||
///
|
||
/// - Returns: 是否启用 Impeller
|
||
private static func shouldEnableImpeller() -> Bool {
|
||
let defaults = UserDefaults.standard
|
||
// 检查用户是否已显式设置过此值
|
||
// UserDefaults.bool 对未设置的 key 返回 false，无法区分"显式关闭"和"从未设置"
|
||
// 因此用 object(forKey:) 判断 key 是否存在
|
||
if defaults.object(forKey: "xianyan_enable_impeller") != nil {
|
||
return defaults.bool(forKey: "xianyan_enable_impeller")
|
||
}
|
||
// 未设置过：Apple Silicon 默认开启，Intel Mac 默认关闭
|
||
return !Self.isIntelMac()
|
||
}
|
||
|
||
override func awakeFromNib() {
|
||
let windowFrame = self.frame
|
||
|
||
// ============================================================
|
||
// Impeller 渲染引擎控制
|
||
// ============================================================
|
||
// macOS 平台控制 Impeller 的唯一可靠方式：Info.plist 的 FLTEnableImpeller key。
|
||
// 该 key 已在 Info.plist 中设置为 true，引擎启动时读取并启用 Impeller。
|
||
//
|
||
// 已验证无效的方式：
|
||
// 1. FlutterDartProject.commandLineArguments — macOS 平台无此属性（仅 iOS 有）
|
||
// 2. setenv("FLUTTER_ENGINE_SWITCH_0", ...) — macOS 桌面 embedder 不读取此环境变量
|
||
// （即使在 debug/profile 模式下也不读取，与 Windows/Linux 桌面 embedder 行为不同）
|
||
//
|
||
// 限制：FLTEnableImpeller 为静态值，无法在运行时动态切换。
|
||
// 用户在设置中修改 Impeller 开关后，实际引擎不会改变（始终为 Info.plist 的值）。
|
||
// 但仍保留用户设置用于 UI 显示和未来 Flutter 可能支持的动态切换。
|
||
//
|
||
// 默认值：Info.plist 中 FLTEnableImpeller=true，所有 Mac 均启用 Impeller。
|
||
// 若 Intel Mac 出现渲染问题，可考虑在 Info.plist 中移除此 key 或设为 false。
|
||
let enableImpeller = Self.shouldEnableImpeller()
|
||
let impellerArg = enableImpeller ? "--enable-impeller=true" : "--enable-impeller=false"
|
||
|
||
// 尝试设置环境变量（macOS 不读取，但保留以兼容未来 Flutter 版本）
|
||
setenv("FLUTTER_ENGINE_SWITCH_0", impellerArg, 1)
|
||
NSLog("[MainFlutterWindow] Impeller 用户设置: enabled=\(enableImpeller), arg=\(impellerArg), arch=\(Self.isIntelMac() ? "x86_64" : "arm64")")
|
||
NSLog("[MainFlutterWindow] Impeller 实际状态: 由 Info.plist FLTEnableImpeller=true 控制（始终启用）")
|
||
|
||
// 缓存当前引擎实际运行的 Impeller 状态
|
||
// 由于 FLTEnableImpeller=true 在 Info.plist 中，引擎始终使用 Impeller
|
||
// 此值用于 Dart 侧查询当前实际渲染引擎（getImpellerRunningStatus）
|
||
Self.currentImpellerEnabled = true
|
||
|
||
// 创建 FlutterViewController（引擎从 Info.plist 读取 FLTEnableImpeller）
|
||
let flutterViewController = FlutterViewController()
|
||
|
||
// 关键修复：使用 MacOSWindowUtilsViewController 包装 FlutterViewController
|
||
// macos_window_utils 插件的原生方法（setMaterial/setNSVisualEffectViewState/
|
||
// addVisualEffectSubview 等）内部执行
|
||
// `contentViewController as! MacOSWindowUtilsViewController`，
|
||
// 若直接使用 FlutterViewController 作为 contentViewController 会触发
|
||
// "Could not cast value of type 'FlutterViewController' to
|
||
// 'MacOSWindowUtilsViewController'" 崩溃。
|
||
// MacOSWindowUtilsViewController.loadView() 会创建 NSVisualEffectView 作为
|
||
// 根视图并 addChild(flutterViewController)，是侧边栏毛玻璃等特效的载体。
|
||
//
|
||
// 所有 Mac（含 Intel Mac）统一使用此包装，提供 NSVisualEffectView 载体，
|
||
// 实现 macOS 原生侧边栏毛玻璃等窗口特效。
|
||
let macOSWindowUtilsViewController = MacOSWindowUtilsViewController(
|
||
flutterViewController: flutterViewController
|
||
)
|
||
self.contentViewController = macOSWindowUtilsViewController
|
||
self.setFrame(windowFrame, display: true)
|
||
|
||
// 在 Flutter 引擎启动前预设窗口透明属性，消除 Impeller 渲染期竞态
|
||
// 根因：macos_window_utils 的 setWindowBackgroundColorToClear() 在渲染期间调用
|
||
// [NSWindow setBackgroundColor:] → NSThemeFrame._updateBackdropView → removeFromSuperview，
|
||
// 与 Impeller raster 线程的 SetupRenderPass 产生竞态，导致空指针崩溃（Release 模式时序更紧）。
|
||
// 修复：将不变属性前移到引擎启动前设置，Dart 侧不再在渲染期重复调用。
|
||
//
|
||
// 标题栏透明属性（titlebarAppearsTransparent / titleVisibility / fullSizeContentView）
|
||
// 所有 Mac 统一设置：让 Flutter 自绘的 DesktopWindowTitleBar 完全接管标题栏区域，
|
||
// 避免系统标题栏残留形成"双标题栏"（系统标题栏 + Flutter 自绘标题栏）。
|
||
//
|
||
// 窗口背景透明（isOpaque / backgroundColor）所有 Mac 统一设置：
|
||
// 配合 NSVisualEffectView 实现毛玻璃效果。
|
||
self.titlebarAppearsTransparent = true
|
||
self.titleVisibility = .hidden
|
||
if !self.styleMask.contains(.fullSizeContentView) {
|
||
self.styleMask.insert(.fullSizeContentView)
|
||
}
|
||
self.isOpaque = false
|
||
self.backgroundColor = NSColor.clear
|
||
|
||
// 关键修复：提前调用 MainFlutterWindowManipulator.start(mainFlutterWindow: self)
|
||
// 让 macos_window_utils 插件的 mainFlutterWindow 静态属性先被设置。
|
||
// 否则后续 Dart 侧 WindowManipulator.initialize() → 原生 reset() 会因
|
||
// mainFlutterWindow == nil 走 start(nil) 分支，触发
|
||
// setWindowBackgroundColorToDefaultColor() → [NSWindow setBackgroundColor:]
|
||
// → NSThemeFrame._updateBackdropView → removeFromSuperview，
|
||
// 与 Impeller raster 线程的 SetupRenderPass 产生竞态导致 EXC_BAD_ACCESS 崩溃。
|
||
//
|
||
// 注意：start() 内部会调用 showTitle()/makeTitlebarOpaque()/disableFullSizeContentView()/
|
||
// setWindowBackgroundColorToDefaultColor() 覆盖上述预设属性，因此必须在 start() 之后
|
||
// 重新设置透明属性。此时 Flutter 引擎尚未启动，Impeller raster 线程未运行，
|
||
// [NSWindow setBackgroundColor:] 不会与渲染线程竞态，安全无崩溃。
|
||
//
|
||
// 由于此处传入 mainFlutterWindow: self，start() 内部 isProvidedWindow=true，
|
||
// 不会调用 configureMainFlutterWindow()（该方法会再次包装 contentViewController，
|
||
// 但因已是 MacOSWindowUtilsViewController，重复包装会导致 FlutterViewController
|
||
// 被嵌套两层，引发布局异常）。当前方案在上方已正确包装，无需 configure。
|
||
//
|
||
// 所有 Mac（含 Intel Mac）统一调用 start()，确保 macos_window_utils 插件
|
||
// 的 mainFlutterWindow 静态属性被正确设置。
|
||
MainFlutterWindowManipulator.start(mainFlutterWindow: self)
|
||
|
||
// start() 覆盖后重新设置透明属性（引擎启动前，无竞态风险）
|
||
// 所有 Mac 统一设置：start() 可能覆盖上述预设属性，需重新设置
|
||
self.titlebarAppearsTransparent = true
|
||
self.titleVisibility = .hidden
|
||
if !self.styleMask.contains(.fullSizeContentView) {
|
||
self.styleMask.insert(.fullSizeContentView)
|
||
}
|
||
self.isOpaque = false
|
||
self.backgroundColor = NSColor.clear
|
||
|
||
// 关键修复：立即隐藏系统标题栏红黄绿灯按钮
|
||
// Flutter 侧 DesktopWindowTitleBar 已自绘 macOS 风格的红黄绿按钮，
|
||
// 若不在此处隐藏系统按钮，应用启动初期会同时显示两套按钮形成"双标题栏"。
|
||
// 此前隐藏逻辑仅写在 setDarkMode 中，而 setDarkMode 有去重机制（仅主题变化时触发一次），
|
||
// 导致启动时若主题未变化则系统按钮始终可见。
|
||
// Intel Mac 同样需要隐藏（Flutter 自绘标题栏在所有桌面平台一致显示）
|
||
hideSystemTrafficButtons(of: self)
|
||
|
||
RegisterGeneratedPlugins(registry: flutterViewController)
|
||
|
||
// 在 Flutter 引擎启动前注册自定义 MethodChannel，避免 MissingPluginException
|
||
registerPlatformChannel(controller: flutterViewController)
|
||
|
||
// 注册应用级 MethodChannel（apps.xy.xianyan/macos.app）
|
||
// 必须在引擎启动 Dart 代码前注册，否则 getCpuArchitecture 等方法会 MissingPluginException
|
||
AppDelegate.registerAppChannel(controller: flutterViewController)
|
||
|
||
// 监听全屏退出：修复全屏退出后窗口背景变黑的问题
|
||
// 全屏模式下 macOS 强制窗口不透明，退出后需重新设置背景透明
|
||
NotificationCenter.default.addObserver(
|
||
self,
|
||
selector: #selector(handleFullScreenExit(_:)),
|
||
name: NSWindow.didExitFullScreenNotification,
|
||
object: self
|
||
)
|
||
|
||
// 为 mainMenu 中每个 menuItem 设置 identifier（XIB objectId）
|
||
// 以便 setMenuLanguage 能根据 identifier 查找 .strings 中的本地化标题
|
||
// 必须在 NSApp.mainMenu 从 XIB 加载后调用（awakeFromNib 时 mainMenu 已存在）
|
||
self.assignMenuItemIdentifiers()
|
||
|
||
super.awakeFromNib()
|
||
}
|
||
|
||
deinit {
|
||
NotificationCenter.default.removeObserver(self)
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - 全屏退出处理
|
||
// ============================================================
|
||
|
||
/// 全屏退出后重新应用窗口透明背景
|
||
///
|
||
/// 修复问题：通过「视图 → Enter Full Screen」进入原生全屏后，
|
||
/// 点击绿灯退出全屏（选择小窗），窗口背景变为黑色而非透明。
|
||
///
|
||
/// 根因：macos_window_utils 的 `setWindowBackgroundColorToClear()` 设置了
|
||
/// `isOpaque=false` + `backgroundColor=NSColor.clear`。但全屏模式下 macOS
|
||
/// 强制窗口不透明（`isOpaque=true`, `backgroundColor=黑色`），
|
||
/// 退出全屏后这些属性未自动恢复，导致窗口外侧显示黑色而非桌面。
|
||
/// 同时 `titlebarAppearsTransparent` 也可能被系统重置。
|
||
///
|
||
/// 修复：监听 `NSWindow.didExitFullScreenNotification`，
|
||
/// 退出全屏后立即重新设置 `isOpaque=false` + `backgroundColor=clear` +
|
||
/// `titlebarAppearsTransparent=true`，并通过 MethodChannel 通知 Dart 侧
|
||
/// 重新应用完整窗口特效（NSVisualEffectView 毛玻璃等）。
|
||
@objc private func handleFullScreenExit(_ notification: Notification) {
|
||
DispatchQueue.main.async { [weak self] in
|
||
guard let self = self else { return }
|
||
// 重新设置窗口透明属性（所有 Mac 统一处理）
|
||
// 全屏模式下 macOS 强制窗口不透明并可能重置这些属性，退出后需重新设置
|
||
self.titlebarAppearsTransparent = true
|
||
self.isOpaque = false
|
||
self.backgroundColor = NSColor.clear
|
||
// 重新隐藏系统红黄绿灯按钮
|
||
// 全屏模式下 macOS 可能重置 standardWindowButton 的可见性，
|
||
// 退出全屏后需重新隐藏，避免与 Flutter 自绘标题栏重复显示
|
||
self.hideSystemTrafficButtons(of: self)
|
||
// 触发窗口重绘
|
||
self.contentView?.needsDisplay = true
|
||
// 通知 Dart 侧重新应用完整窗口特效（NSVisualEffectView 等）
|
||
self.platformChannel?.invokeMethod("onFullScreenExited", arguments: nil)
|
||
}
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - MethodChannel 注册
|
||
// ============================================================
|
||
|
||
/// 注册 apps.xy.xianyan/macos 平台通道，对接 Dart 端 MacosPlatformService
|
||
private func registerPlatformChannel(controller: FlutterViewController) {
|
||
let channel = FlutterMethodChannel(
|
||
name: "apps.xy.xianyan/macos",
|
||
binaryMessenger: controller.engine.binaryMessenger
|
||
)
|
||
platformChannel = channel
|
||
|
||
channel.setMethodCallHandler { [weak self] (call, result) in
|
||
guard let self = self else {
|
||
result(FlutterError(code: "window_deallocated",
|
||
message: "MainFlutterWindow 已释放",
|
||
details: nil))
|
||
return
|
||
}
|
||
|
||
switch call.method {
|
||
// ---------- 主题同步 ----------
|
||
case "setDarkMode":
|
||
let isDark = (call.arguments as? Bool) ?? false
|
||
self.setDarkMode(isDark: isDark)
|
||
result(nil)
|
||
|
||
case "getSystemAppearance":
|
||
result(self.getSystemAppearance())
|
||
|
||
// ---------- 窗口管理 ----------
|
||
case "setWindowTitle":
|
||
let title = (call.arguments as? String) ?? ""
|
||
self.title = title
|
||
result(nil)
|
||
|
||
case "setTitleBarTransparent":
|
||
let transparent = (call.arguments as? Bool) ?? false
|
||
self.titlebarAppearsTransparent = transparent
|
||
result(nil)
|
||
|
||
case "setTitleBarStyle":
|
||
let style = (call.arguments as? String) ?? "auto"
|
||
self.setTitleBarStyle(style: style)
|
||
result(nil)
|
||
|
||
case "setToolbarVisible":
|
||
let visible = (call.arguments as? Bool) ?? true
|
||
if visible {
|
||
self.toolbar?.isVisible = true
|
||
} else {
|
||
self.toolbar?.isVisible = false
|
||
}
|
||
result(nil)
|
||
|
||
case "setFullscreen":
|
||
let fullscreen = (call.arguments as? Bool) ?? false
|
||
self.setFullscreen(fullscreen: fullscreen)
|
||
result(nil)
|
||
|
||
case "isFullscreen":
|
||
result(self.styleMask.contains(.fullScreen))
|
||
|
||
case "setMinSize":
|
||
guard let args = call.arguments as? [String: Any],
|
||
let width = args["width"] as? Double,
|
||
let height = args["height"] as? Double else {
|
||
result(FlutterError(code: "invalid_args",
|
||
message: "setMinSize 需要 {width, height}",
|
||
details: nil))
|
||
return
|
||
}
|
||
self.minSize = NSSize(width: width, height: height)
|
||
result(nil)
|
||
|
||
// ---------- 系统集成 ----------
|
||
case "performHapticFeedback":
|
||
let type = (call.arguments as? String) ?? "generic"
|
||
self.performHapticFeedback(type: type)
|
||
result(nil)
|
||
|
||
// ---------- Touch Bar 支持 ----------
|
||
case "setTouchBarItems":
|
||
let args = call.arguments as? [String: Any] ?? [:]
|
||
let rawItems = args["items"] as? [[String: Any]] ?? []
|
||
self.touchBarItems = rawItems.compactMap { item in
|
||
guard let label = item["label"] as? String,
|
||
let action = item["action"] as? String else { return nil }
|
||
return ["label": label, "action": action]
|
||
}
|
||
// 强制重建 Touch Bar
|
||
self.touchBar = nil
|
||
if !self.touchBarItems.isEmpty {
|
||
self.touchBar = self.makeTouchBar()
|
||
}
|
||
result(nil)
|
||
|
||
// ---------- NSSharingService 共享 ----------
|
||
case "showShareSheet":
|
||
let args = call.arguments as? [String: Any] ?? [:]
|
||
var shareItems: [Any] = []
|
||
if let text = args["text"] as? String {
|
||
shareItems.append(text)
|
||
}
|
||
if let urlString = args["url"] as? String, let url = URL(string: urlString) {
|
||
shareItems.append(url)
|
||
}
|
||
if let imageBytes = args["imageBytes"] as? FlutterStandardTypedData,
|
||
let image = NSImage(data: imageBytes.data) {
|
||
shareItems.append(image)
|
||
}
|
||
guard !shareItems.isEmpty else {
|
||
result(FlutterError(code: "no_content",
|
||
message: "没有可分享的内容",
|
||
details: nil))
|
||
return
|
||
}
|
||
let picker = NSSharingServicePicker(items: shareItems)
|
||
if let view = self.contentView {
|
||
picker.show(relativeTo: view.bounds, of: view, preferredEdge: .minY)
|
||
}
|
||
result(nil)
|
||
|
||
// ---------- 菜单栏语言切换 ----------
|
||
case "setMenuLanguage":
|
||
let args = call.arguments as? [String: Any] ?? [:]
|
||
let languageId = (args["languageId"] as? String) ?? "system"
|
||
self.setMenuLanguage(languageId: languageId)
|
||
result(nil)
|
||
|
||
default:
|
||
result(FlutterMethodNotImplemented)
|
||
}
|
||
}
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - 主题同步实现
|
||
// ============================================================
|
||
|
||
/// 设置标题栏明暗模式（影响 NSWindow.appearance）
|
||
///
|
||
/// 自定义软件样式标题栏：titlebarAppearsTransparent = true，
|
||
/// 让 Flutter 侧的 DesktopWindowTitleBar 完全接管标题栏区域。
|
||
private func setDarkMode(isDark: Bool) {
|
||
let appearance: NSAppearance = isDark
|
||
? NSAppearance(named: .darkAqua)!
|
||
: NSAppearance(named: .aqua)!
|
||
NSApp.appearance = appearance
|
||
// 同步到所有窗口
|
||
for window in NSApplication.shared.windows {
|
||
window.appearance = appearance
|
||
// 标题栏透明，由 Flutter 侧自绘标题栏
|
||
window.titlebarAppearsTransparent = true
|
||
// 标题栏高度为 0，让内容延伸到顶部
|
||
if let contentView = window.contentView {
|
||
contentView.superview?.wantsLayer = true
|
||
}
|
||
}
|
||
// 隐藏系统红黄绿灯按钮（提取为公共方法，统一三处调用点）
|
||
// 原内联代码移至 hideSystemTrafficButtons()，避免重复
|
||
hideSystemTrafficButtons()
|
||
}
|
||
|
||
/// 隐藏系统标题栏的红黄绿按钮（closeButton/miniaturizeButton/zoomButton）
|
||
///
|
||
/// Flutter 侧 DesktopWindowTitleBar 已自绘 macOS 风格的红黄绿按钮，
|
||
/// 系统原生按钮需隐藏避免重复显示形成"双标题栏"。
|
||
///
|
||
/// 调用时机：
|
||
/// 1. `awakeFromNib` — 应用启动时立即隐藏（避免启动初期显示两套按钮）
|
||
/// 2. `setDarkMode` — 主题切换时同步隐藏（兼容多窗口场景）
|
||
/// 3. `handleFullScreenExit` — 全屏退出后重新隐藏（系统可能重置可见性）
|
||
///
|
||
/// - Parameter window: 指定窗口；nil 则遍历 `NSApplication.shared.windows`，
|
||
/// 用于 setDarkMode 等多窗口场景
|
||
private func hideSystemTrafficButtons(of window: NSWindow? = nil) {
|
||
let windows = window.map { [$0] } ?? NSApplication.shared.windows
|
||
for win in windows {
|
||
win.standardWindowButton(.closeButton)?.isHidden = true
|
||
win.standardWindowButton(.miniaturizeButton)?.isHidden = true
|
||
win.standardWindowButton(.zoomButton)?.isHidden = true
|
||
}
|
||
}
|
||
|
||
/// 获取系统当前外观（light / dark）
|
||
private func getSystemAppearance() -> String {
|
||
let appearance = NSApp.effectiveAppearance.bestMatch(from: [
|
||
NSAppearance.Name.darkAqua,
|
||
NSAppearance.Name.aqua,
|
||
]) ?? NSAppearance.Name.aqua
|
||
return appearance == .darkAqua ? "dark" : "light"
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - 窗口管理实现
|
||
// ============================================================
|
||
|
||
/// 设置标题栏样式（auto / light / dark）
|
||
private func setTitleBarStyle(style: String) {
|
||
let appearance: NSAppearance?
|
||
switch style {
|
||
case "light":
|
||
appearance = NSAppearance(named: .aqua)
|
||
case "dark":
|
||
appearance = NSAppearance(named: .darkAqua)
|
||
default: // auto
|
||
appearance = nil
|
||
}
|
||
for window in NSApplication.shared.windows {
|
||
window.appearance = appearance
|
||
}
|
||
}
|
||
|
||
/// 设置窗口全屏
|
||
private func setFullscreen(fullscreen: Bool) {
|
||
let isCurrentlyFullscreen = self.styleMask.contains(.fullScreen)
|
||
if fullscreen && !isCurrentlyFullscreen {
|
||
self.toggleFullScreen(nil)
|
||
} else if !fullscreen && isCurrentlyFullscreen {
|
||
self.toggleFullScreen(nil)
|
||
}
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - 系统集成实现
|
||
// ============================================================
|
||
|
||
/// 触感反馈（macOS 通过 NSHapticFeedbackManager 实现）
|
||
private func performHapticFeedback(type: String) {
|
||
let feedbackLevel: NSHapticFeedbackManager.FeedbackPattern
|
||
switch type {
|
||
case "alignment":
|
||
feedbackLevel = .alignment
|
||
case "levelChange":
|
||
feedbackLevel = .levelChange
|
||
default:
|
||
feedbackLevel = .generic
|
||
}
|
||
NSHapticFeedbackManager.defaultPerformer.perform(
|
||
feedbackLevel,
|
||
performanceTime: .now
|
||
)
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - 菜单栏语言切换实现
|
||
// ============================================================
|
||
|
||
/// XIB 中所有 menuItem 的 objectId，按深度优先遍历顺序排列
|
||
/// 用于在 awakeFromNib 中为每个 menuItem 设置 identifier
|
||
/// 顺序：顶层菜单项 → 其子菜单项（跳过 separatorItem）
|
||
/// 与 MainMenu.xib 中 menuItem 的声明顺序一致
|
||
private static let menuItemIds: [String] = [
|
||
// App Menu（顶层 + 子菜单项）
|
||
"1Xt-HY-uBw", "5kV-Vb-QxS", "BOF-NM-1cW", "NMo-om-nkz",
|
||
"Olw-nP-bQN", "Vdr-fp-XzO", "Kd2-mp-pUS", "4sb-4s-VLi",
|
||
// Edit Menu（顶层 + 子菜单项）
|
||
"5QF-Oa-p0T", "dRJ-4n-Yzg", "6dh-zS-Vam", "uRl-iY-unG",
|
||
"x3v-GG-iWU", "gVA-U4-sdL", "WeT-3V-zwk", "pa3-QI-u2k",
|
||
"Ruw-6m-B2m",
|
||
// Edit > Find
|
||
"4EN-yA-p0u", "Xz5-n4-O0W", "YEy-JH-Tfz", "q09-fT-Sye",
|
||
"OwM-mh-QMV", "buJ-ug-pKt", "S0p-oC-mLd",
|
||
// Edit > Spelling and Grammar
|
||
"Dv1-io-Yv7", "HFo-cy-zxI", "hz2-CU-CR7", "rbD-Rh-wIN",
|
||
"mK6-2p-4JG", "78Y-hA-62v",
|
||
// Edit > Substitutions
|
||
"9ic-FL-obx", "z6F-FW-3nz", "9yt-4B-nSM", "hQb-2v-fYv",
|
||
"rgM-f4-ycn", "cwL-P1-jid", "tRr-pd-1PS", "HFQ-gK-NFA",
|
||
// Edit > Transformations
|
||
"2oI-Rn-ZJC", "vmV-6d-7jI", "d9M-CD-aMd", "UEZ-Bs-lqG",
|
||
// Edit > Speech
|
||
"xrE-MZ-jX0", "Ynk-f8-cLZ", "Oyz-dy-DGm",
|
||
// View Menu（顶层，子菜单项为空）
|
||
"H8h-7b-M4v",
|
||
// Window Menu（顶层 + 子菜单项）
|
||
"aUF-d1-5bR", "OY7-WF-poV", "R4o-n2-Eq4", "LE2-aR-0XJ",
|
||
// Help Menu（顶层，无子菜单项）
|
||
"EPT-qC-fAb",
|
||
]
|
||
|
||
/// 为 mainMenu 中每个 menuItem 设置 identifier（XIB objectId）
|
||
///
|
||
/// XIB 加载后，menuItem.identifier 默认为 nil，无法通过 objectId 查找。
|
||
/// 此方法按深度优先顺序遍历 mainMenu，将 menuItemIds 中的 objectId
|
||
/// 依次赋值给对应 menuItem.identifier，建立 objectId ↔ menuItem 映射。
|
||
/// 跳过 separatorItem（XIB 中 separator 无 objectId）。
|
||
private func assignMenuItemIdentifiers() {
|
||
var index = 0
|
||
func assign(_ menu: NSMenu) {
|
||
for item in menu.items {
|
||
if item.isSeparatorItem { continue }
|
||
if index < MainFlutterWindow.menuItemIds.count {
|
||
item.identifier = NSUserInterfaceItemIdentifier(
|
||
rawValue: MainFlutterWindow.menuItemIds[index]
|
||
)
|
||
index += 1
|
||
}
|
||
if let submenu = item.submenu {
|
||
assign(submenu)
|
||
}
|
||
}
|
||
}
|
||
guard let mainMenu = NSApp.mainMenu else {
|
||
NSLog("[assignMenuItemIdentifiers] NSApp.mainMenu 为 nil")
|
||
return
|
||
}
|
||
assign(mainMenu)
|
||
NSLog("[assignMenuItemIdentifiers] 已为 \(index) 个菜单项设置 identifier")
|
||
}
|
||
|
||
/// 切换 macOS 系统菜单栏语言
|
||
///
|
||
/// [languageId] 语言 ID：
|
||
/// - 'system' / 'auto' → 跟随系统语言（使用 preferredLocalizations）
|
||
/// - 'zh-CN' / 'zh-Hans' → 简体中文
|
||
/// - 'zh-TW' / 'zh-Hant' → 繁体中文
|
||
/// - 'en' → 英语
|
||
/// - 'ja' → 日语
|
||
/// - 'ko' → 韩语
|
||
///
|
||
/// 实现原理：
|
||
/// 1. 根据 languageId 解析对应的 lproj 目录名
|
||
/// 2. 加载对应语言的 MainMenu.strings 文件为 [String: String]
|
||
/// 3. 递归遍历 NSApp.mainMenu，根据 menuItem.identifier（XIB objectId）
|
||
/// 查找 .strings 中的 key（"id.title"）并更新标题
|
||
/// 4. 替换 "APP_NAME" 占位符为应用名（CFBundleName）
|
||
///
|
||
/// 注意：此方法仅更新菜单项标题，不重建菜单结构，不影响 action 连接。
|
||
private func setMenuLanguage(languageId: String) {
|
||
// 1. 解析 lproj 目录名
|
||
let lprojName: String
|
||
switch languageId {
|
||
case "system", "auto":
|
||
// preferredLocalizations(from:) 是 Bundle 类的静态方法，
|
||
// 返回系统首选语言在给定列表中的匹配顺序
|
||
let preferred = Bundle.preferredLocalizations(from: [
|
||
"en", "zh-Hans", "zh-Hant", "ja", "ko",
|
||
])
|
||
lprojName = preferred.first ?? "en"
|
||
case "zh-CN", "zh-Hans":
|
||
lprojName = "zh-Hans"
|
||
case "zh-TW", "zh-Hant":
|
||
lprojName = "zh-Hant"
|
||
case "en":
|
||
lprojName = "en"
|
||
case "ja":
|
||
lprojName = "ja"
|
||
case "ko":
|
||
lprojName = "ko"
|
||
default:
|
||
// 未知语言，回退到英语
|
||
lprojName = "en"
|
||
}
|
||
|
||
// 2. 加载对应语言的 MainMenu.strings
|
||
guard let stringsPath = Bundle.main.path(
|
||
forResource: "MainMenu",
|
||
ofType: "strings",
|
||
inDirectory: nil,
|
||
forLocalization: lprojName
|
||
) else {
|
||
NSLog("[setMenuLanguage] 未找到 \(lprojName).lproj/MainMenu.strings")
|
||
return
|
||
}
|
||
guard let strings = NSDictionary(contentsOfFile: stringsPath) as? [String: String] else {
|
||
NSLog("[setMenuLanguage] 加载 \(lprojName).lproj/MainMenu.strings 失败")
|
||
return
|
||
}
|
||
|
||
// 3. 递归遍历 mainMenu，更新标题
|
||
let appName = (Bundle.main.object(forInfoDictionaryKey: "CFBundleName") as? String) ?? "闲言"
|
||
var updatedCount = 0
|
||
func updateMenu(_ menu: NSMenu) {
|
||
for item in menu.items {
|
||
if item.isSeparatorItem { continue }
|
||
if let identifier = item.identifier?.rawValue {
|
||
let key = "\(identifier).title"
|
||
if let localized = strings[key] {
|
||
// 替换 APP_NAME 占位符为应用名
|
||
item.title = localized.replacingOccurrences(of: "APP_NAME", with: appName)
|
||
updatedCount += 1
|
||
}
|
||
}
|
||
if let submenu = item.submenu {
|
||
updateMenu(submenu)
|
||
}
|
||
}
|
||
}
|
||
guard let mainMenu = NSApp.mainMenu else {
|
||
NSLog("[setMenuLanguage] NSApp.mainMenu 为 nil")
|
||
return
|
||
}
|
||
updateMenu(mainMenu)
|
||
NSLog("[setMenuLanguage] 菜单栏语言已切换为 \(lprojName)，更新 \(updatedCount) 个菜单项")
|
||
}
|
||
|
||
// ============================================================
|
||
// MARK: - Touch Bar 实现
|
||
// ============================================================
|
||
|
||
/// 创建 Touch Bar（系统在需要时自动调用，仅带 Touch Bar 的 MacBook 显示）
|
||
override func makeTouchBar() -> NSTouchBar? {
|
||
guard !touchBarItems.isEmpty else { return nil }
|
||
let touchBar = NSTouchBar()
|
||
touchBar.delegate = self
|
||
touchBar.customizationIdentifier = NSTouchBar.CustomizationIdentifier("apps.xy.xianyan.touchbar")
|
||
touchBar.defaultItemIdentifiers = touchBarItems.enumerated().map {
|
||
NSTouchBarItem.Identifier("apps.xy.xianyan.touchbar.item.\($0.offset)")
|
||
}
|
||
return touchBar
|
||
}
|
||
|
||
/// NSTouchBarDelegate：按索引创建 Touch Bar 按钮
|
||
func touchBar(_ touchBar: NSTouchBar, makeItemForIdentifier identifier: NSTouchBarItem.Identifier) -> NSTouchBarItem? {
|
||
guard let index = Int(identifier.rawValue.components(separatedBy: ".").last ?? ""),
|
||
index < touchBarItems.count else {
|
||
return nil
|
||
}
|
||
let item = touchBarItems[index]
|
||
let button = NSButton(title: item["label"] ?? "", target: self, action: #selector(touchBarButtonClicked(_:)))
|
||
button.identifier = NSUserInterfaceItemIdentifier(rawValue: item["action"] ?? "")
|
||
let touchBarItem = NSCustomTouchBarItem(identifier: identifier)
|
||
touchBarItem.view = button
|
||
return touchBarItem
|
||
}
|
||
|
||
/// Touch Bar 按钮点击回调，通过 channel.invokeMethod("touchBarAction", action) 通知 Dart
|
||
@objc private func touchBarButtonClicked(_ sender: NSButton) {
|
||
guard let action = sender.identifier?.rawValue else { return }
|
||
platformChannel?.invokeMethod("touchBarAction", arguments: action)
|
||
}
|
||
}
|