macOS仅菜单栏SwiftUI应用：视图外更新MenuBarExtra图标的最佳实践

问题背景 #

我开发了一个仅支持菜单栏的macOS SwiftUI应用，核心代码如下：

// MyMainApp.swift
var body: some Scene {
    MenuBarExtra("My App", image: "LoggedOutIcon") {
        MenuBarView()
    }
}

需求是用户登录时将图标动态更新为LoggedInIcon，登出时切换回LoggedOutIcon，且登录/登出逻辑在非视图控制器中实现。

尝试的实现方式虽能正常工作，但触发紫色警告：
在MyMainApp.swift中声明：

@StateObject var myMainController = MyMainController()

在MyMainController.swift中定义发布变量：

// MyMainController.swift
@Published var loggedIn: Bool = false

修改MenuBarExtra调用：

MenuBarExtra("My App", image: myMainController.loggedIn ? "LoggedInIcon" : "LoggedOutIcon")

警告内容：

Accessing StateObject's object without being installed on a View. This will create a new instance each time.

需要解决该警告，同时实现动态切换图标的需求，以下是几种最佳实践方案：

方案一：使用@MainActor修饰的ObservableObject单例 #

由于App结构体不属于View类型，无法直接使用@StateObject，将控制器改为单例模式可确保实例唯一，且用@MainActor保证UI更新在主线程执行：

1. 修改MyMainController为单例：

// MyMainController.swift
import Combine
import SwiftUI

@MainActor
class MyMainController: ObservableObject {
    static let shared = MyMainController()
    private init() {} // 私有化构造方法，避免创建多个实例
    
    @Published var loggedIn: Bool = false
    
    // 示例登录方法
    func login() {
        loggedIn = true
    }
    
    // 示例登出方法
    func logout() {
        loggedIn = false
    }
}

2. 在MyMainApp中直接引用单例，并可注入到环境供子视图使用：

// MyMainApp.swift
import SwiftUI

@main
struct MyMainApp: App {
    private let mainController = MyMainController.shared
    
    var body: some Scene {
        MenuBarExtra("My App", image: mainController.loggedIn ? "LoggedInIcon" : "LoggedOutIcon") {
            MenuBarView()
                .environmentObject(mainController)
        }
        .environmentObject(mainController) // 全局环境注入，方便其他场景调用
    }
}

方案二：结合AppStorage持久化登录状态 #

如果需要跨应用启动保留登录状态，可将@Published替换为@AppStorage，并手动发送状态变更通知：

// MyMainController.swift
@MainActor
class MyMainController: ObservableObject {
    static let shared = MyMainController()
    private init() {}
    
    @AppStorage("isLoggedIn") var loggedIn: Bool = false {
        didSet {
            objectWillChange.send() // 手动触发视图更新
        }
    }
    
    func login() {
        loggedIn = true
    }
    
    func logout() {
        loggedIn = false
    }
}

MyMainApp中的使用方式与方案一完全一致，既实现图标动态切换，又能持久化登录状态。

方案三：将MenuBarExtra包装在View结构体中 #

让@StateObject附着在合法的View类型上，消除警告：

1. 创建菜单栏视图容器：

// MenuBarContainer.swift
import SwiftUI

struct MenuBarContainer: View {
    @StateObject private var mainController = MyMainController()
    
    var body: some View {
        MenuBarExtra("My App", image: mainController.loggedIn ? "LoggedInIcon" : "LoggedOutIcon") {
            MenuBarView()
                .environmentObject(mainController)
        }
    }
}

2. 在MyMainApp中使用该容器：

// MyMainApp.swift
@main
struct MyMainApp: App {
    var body: some Scene {
        MenuBarContainer()
    }
}

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