SettingsAccess

To call openSettingsLegacy() from any subview, you must first attach the .openSettingsAccess() view modifier to a base view in your view hierarchy (typically the root view of your WindowGroup).

Step 1: Attach the modifier to your App's root view

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .openSettingsAccess()
        }
        
        Settings { SettingsView() }
    }
}

Step 2: Use the environment method in a subview

struct ContentView: View {
    @Environment(\.openSettingsLegacy) private var openSettingsLegacy
  
    var body: some View {
        Button("Open Settings") { try? openSettingsLegacy() }
    }
}

Note on Xcode 16+: Xcode 16 makes Apple's openSettings environment method public. For projects targeting macOS 14+, you may use the native openSettings. Use openSettingsLegacy() for compatibility with older macOS versions.

You can replace the standard 'About' menu item to open the Settings window at a specific tab by using SettingsLink with a preAction that updates a shared state (like @AppStorage).

Example Implementation:

1. Define a shared state (e.g., selectedSettingsPage) using @AppStorage.
2. In your CommandGroup, use SettingsLink to set that state in the preAction closure.
3. In your Settings view, use a TabView bound to that same state.

@main
struct MyApp: App {
    @AppStorage("selectedSettingsPage") private var selectedSettingsPage: SettingsPage = .general
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .commands {
            CommandGroup(replacing: .appInfo) {
                SettingsLink {
                    Text("About...")
                } preAction: {
                    selectedSettingsPage = .about
                } postAction: {
                    // none
                }
            }
        }
        
        Settings { SettingsView() }
    }
}

enum SettingsPage: String {
    case general
    case about
}

struct SettingsView: View {
    @AppStorage("selectedSettingsPage") private var selectedSettingsPage: SettingsPage = .general
    
    var body: some View {
        TabView(selection: $selectedSettingsPage) {
            GeneralView()
                .tabItem { Label("General", systemImage: "gear") }
                .tag(SettingsPage.general)
                
            AboutView()
                .tabItem { Label("About", systemImage: "info.bubble.fill") }
                .tag(SettingsPage.about)
        }
    }
}