Respect Window::focused when requesting macOS app activation on startup and window creation

[ariofrio]

Objective

• Allow the first window to be unfocused on macOS
• Fixes bug: cannot create an unfocused window on Mac for dev #15025

Solution

The design principle is that focused should result in similar behavior on macOS as in other supported platforms (i.e. Windows). This means managing app activation to result in the expected window focusing behavior.

• Set with_activate_ignoring_other_apps to false if the primary window should be unfocused on startup, or if there is no primary window
• Call focus_window when a focused window is created to ensure app activation is requested, so that apps that delay creating the first window can still activate the app if desired.

Alternatives Considered

• Adding a dedicated macOS-only macos_activate_ignoring_other_apps setting to bevy_winit. This is poorly discoverable and has footguns, e.g. what happens when a focused window is created when the app is not activated.

Testing

Tested programmatically on macOS Tahoe 26.5 by checking NSWorkspace.shared.frontmostApplication before and after creating an additional window using bevy_remote:

Startup case	Before	After
Window { focused: true }	App became frontmost; window was focused	Same
Window { focused: false }	App became frontmost; window was focused despite focused: false	App stayed behind current app; window remained unfocused
Mixed startup windows, at least one with focused: true	App became frontmost; a window was focused	Same
primary_window: None	App stayed behind current app	Same

After-startup case	Before	After
primary_window: None, then create visible Window { focused: true }	App became frontmost; window was focused	Same
primary_window: None, then create visible Window { focused: false }	App became frontmost; window was focused despite focused: false	App stayed behind current app; window remained unfocused
Startup Window { focused: false }, then set focused = true	Window was already focused from startup	App became frontmost; window was focused

Showcase

See migration guide.

[github-actions]

You added a new feature but didn't add a description for it. Please update the root Cargo.toml file.