Full Changelog: v0.5.9...v0.5.10

Full Changelog: v0.5.8...v0.5.9

Full Changelog: v0.5.7...v0.5.8

What's Changed

• fix(macos): link ServiceManagement weakly so the library loads on macOS 12 by @yx-wh in #20

New Contributors

• @yx-wh made their first contribution in #20

Full Changelog: v0.5.6...v0.5.7

Full Changelog: v0.5.5...v0.5.6

Full Changelog: v0.5.4...v0.5.5

Full Changelog: v0.5.3...v0.5.4

Full Changelog: v0.5.2...v0.5.3

Full Changelog: v0.5.1...v0.5.2

Full Changelog: v0.5.0...v0.5.1

• Window.setMaximizeButtonBounds(): tell the window where a custom title bar draws its maximize button, so Windows 11 opens the snap layouts on it again. Hover, press and release still reach the app's button. Windows only; Window.isMaximizeButtonBoundsSupported() says whether it applies.

• Window.occlusionState and WindowOcclusionChangedEvent: whether any part of a window can be seen (visible, occluded, or unknown where the platform cannot tell), to pause rendering or video nobody sees. macOS uses the system's own state; Windows computes it from the windows above; Linux knows only hidden and minimized windows.

• WindowPropertyChangedEvent: a window's title, resizable / movable / minimizable / maximizable / full-screenable / closable state, control button visibility, always-on-top / on-bottom and title bar style report each change, whether a setter on any wrapper or the system or other code changed the native window. Read the new value through the getter WindowProperty names.

• Apps that also target the web can depend on nativeapi again (leanflutter/tray_manager#108). On the web package:nativeapi resolves to a pure-Dart mirror without dart:ffi: the same classes, enums, value types and events, minus the members that expose the C form (raw, fromNative, allocNative, nativeObject, raw pointers). Every platform call there throws UnsupportedError, so guard it with kIsWeb.

• Event listeners run on their registering isolate, including native events from foreign UI threads. Callbacks may return a Future; event payloads and borrowed handles remain valid until completion. Removing a listener skips queued callbacks that have not started.

• Add shared EventRequest and owned EventDecision primitives for cancellation and deferred confirmation. Programmatic Application.quit() now waits for listener Futures and deferred decisions; cancellation leaves the application running. macOS native quit queries now share this confirmation; approval continues the host decision, including Flutter's asynchronous exit callback. Mandatory native termination invalidates old votes and cannot be vetoed.

• Add object-level Window listeners and Window.close() confirmation on macOS, Windows and GTK (X11 or Wayland). Native aliases share pending votes; approval continues the host close handler, and forced native destruction invalidates old decisions. Mobile platforms report close as unsupported.

• On macOS, initializing Application preserves an existing host delegate and activation policy. Native lifecycle listeners observe quit requests and preserve the host's decision without bypassing Flutter's exit confirmation.

• On macOS, empty backgrounds in a hidden window's original title-bar band perform the preferred double-click action automatically. Controls and custom mouse handlers keep their gestures. The native Fill action is requested when the OS provides it.

• Adds Window.performTitleBarDoubleClick() for custom title bars, respecting the macOS Maximize, Minimize and None preferences.

• Window.setIgnoreMouseEvents(ignore, forward) now returns whether the native policy was applied. Linux implements pass-through and restores input shapes; macOS, Windows and X11 can forward hover movement while clicks pass through. Use isMouseMoveForwardingEnabled and isMouseMoveForwardingSupported() to inspect forwarding. Wayland rejects forwarding without changing the policy. This method replaces the isIgnoreMouseEvents setter; the getter is retained.

• Window.showSystemMenu(Point) and Window.isSystemMenuSupported(): native system window menu on Windows and supporting Linux window managers. Positions are logical pixels relative to the content area. Windows keeps command states current; Wayland requires an active pointer press in the target window.

• Window.setContentProtection(), isContentProtected and Window.isContentProtectionSupported(): native capture policy on Windows and macOS. Recent macOS ScreenCaptureKit ignores the legacy sharing policy; Linux and mobile platforms return false.

• Window.setCornerPreference(), cornerPreference and isCornerPreferenceSupported(): Windows 11's compositor corner policy (default, square, rounded or small rounding), with the native title bar kept. Returns false on other platforms; the getter reports the accepted preference, not the radius Windows chooses for maximized, snapped or shaped windows.

• TrayIcon.createWithIdentifier() and the read-only identifier: a persistent tray host name, set before registration. Linux defaults to the GApplication ID or executable name, with suffixes for additional live icons; macOS uses NSStatusItem.autosaveName. Windows records the name. The numeric object ID remains separate.

• Windows and Linux: Window.isFocusable and isNonActivating take effect; disabling focus releases a keyboard focus the window holds.

• Window.focus() is reliable, and blur() hands the focus back to where it was.

• Linux: window hooks and shortcuts shut down safely; X11 always-on-top state is read back from the window manager; one window ID on both GTK objects.

• TrayIcon.contentView: any View in place of the icon and title, on macOS. The menu bar item is as wide as the view (its preferredSize, or what a Row or Column needs) and follows it as it changes; clicks outside buttons and text fields still reach the tray icon's events. Recorded only on Windows and Linux.
• runNativeApp(): windows and native views from a plain Dart program, no Flutter needed. The app runs in an isolate of its own on the platform's UI thread, with Dart's timers, futures and streams working in between; on macOS that is the process's first thread, taken over from the Dart VM. nativeapi_flutter does not re-export it.
• Row and Column containers size to their content: a container's intrinsicSize is what its subviews need, so nested rows and columns no longer collapse to zero without a preferredSize.
• macOS: View.create() no longer crashes (the container was released as soon as it was created); buttons are no longer clipped in a process linked against an older macOS SDK, such as the Dart VM; destroying a view that holds the focused text field no longer emits ViewBlurredEvent into the tree being torn down, which crashed at exit.
• Application.quit() from a host-run loop now emits ApplicationExitingEvent on Windows and Linux as well, and ends the process on Linux, as documented. On Windows it destroys the windows before the loop ends, so a Flutter app's engine shuts down cleanly instead of crashing in its teardown.
• Windows: screen coordinates are one logical space across monitors with different scale factors, laid out side by side as Chromium does. A window's position and bounds survive being saved and restored on any monitor, and moving a window onto a monitor with another factor keeps the size asked for. Display positions change where monitors have different factors (they overlapped before); TrayIcon.bounds and menu positions are logical now, like everything else, instead of physical pixels.
• Application.show(), Application.hide() and Application.isVisible(): application-level hiding on macOS (-[NSApplication hide:]), which the Dock understands, unlike hiding every window. They return false on other platforms.
• WindowEnteredFullScreenEvent and WindowExitedFullScreenEvent, on macOS and Linux whoever changes the state, on Windows for Window.isFullScreen.
• Windows: setting Window.titleBarStyle on a full-screen window no longer puts a title bar on it; leaving full screen shows the title bar asked for.
• Windows: a window with a hidden title bar keeps the system's frame (thin border, shadow and rounded corners) instead of a classic-theme border on its sides and bottom. Without a shadow, with a custom shadow or with a shape it has no frame at all and resizes from every edge and corner, also through a Flutter view that covers it, without the classic frame flickering in while resizing. The content stays in place when the frame comes or goes.
• Linux: a hidden title bar's shadow gutter no longer leaves an empty band around the content, and no longer inflates the window on compositors that report every window as tiled, such as Hyprland.

• ViewBackend and View.isBackendSupported, View.setDefaultBackend, View.getDefaultBackend and View.backend: on Windows builds with the WinUI 3 backend, views are WinUI 3 XAML controls by default.
• Native views: View (a container with Absolute, Row and Column layout), Label, Button, TextField and ImageView, plus Window.contentView to put them in a window. A control is a View, so it can be passed wherever a View is expected. Events: ButtonClickedEvent, TextFieldChangedEvent, TextFieldSubmittedEvent, ViewFocusedEvent, ViewBlurredEvent.
• EdgeInsets value type (EdgeInsets.all, EdgeInsets.symmetric).
• Breaking: event classes keep their C++ names. KeyboardKeyPressedEvent, KeyboardKeyReleasedEvent and KeyboardModifierKeysChangedEvent are now KeyPressedEvent, KeyReleasedEvent and ModifierKeysChangedEvent.
• Breaking: nativeapi is a plain Dart package and no longer depends on Flutter; Flutter apps depend on nativeapi_flutter instead, which re-exports it.
  • Point, Size, Rectangle and Color are nativeapi's own value types instead of dart:ui's Offset, Size, Rect and Color. nativeapi_flutter converts between them (toOffset(), toSize(), toRect(), toColor(), and toNative() on the dart:ui types).
  • The widgets (DragToMoveArea, DragToResizeArea, DragOutArea, DropRegion, ContextMenuRegion), ImageAsset and package:nativeapi/windowing.dart moved to nativeapi_flutter (package:nativeapi_flutter/windowing.dart).
• Value types (Point, Size, Rectangle, Color, KeyboardAccelerator, UrlOpenResult, ShortcutOptions) compare and print by value: they have ==, hashCode and toString over their data fields. Callback fields are left out.
• Callbacks are released once the core lets them go, instead of being kept for the life of the isolate: a listener when it is removed or its emitter destroyed, a replaced setCallback / setWill{Show,Hide}Hook callback, a shortcut's callback when it is unregistered or the shortcut destroyed, and any callback whose registration failed. A listener still lives until then, whether or not the wrapper that added it is collected.
• ShortcutOptions.callback is installed by registerWithOptions and Shortcut.createWithIdAndOptions; it used to be dropped.
• WindowShadow, Window.setCustomShadow and customShadow: core-rendered custom shadows on desktop windows with a hidden title bar. hasShadow toggles the shadow without discarding its configuration.
• WindowShape, Window.setShape, isShaped and isShapeSupported for polygonal desktop windows; the new flutter_shaped_window_example shows circle, star and speech-bubble shapes.
• Window.setInputShape, isInputShaped and isInputShapeSupported restrict pointer and touch input to a region on Linux (X11 and Wayland).
• Breaking: TitleBarStyle.hidden now means the same thing on every platform — no title bar and no window control buttons. On macOS it used to leave the traffic lights on a transparent bar, which Windows and Linux never did. A window that wants them back sets isWindowControlButtonsVisible = true after the style, and one that wanted the transparent bar all along wants the new call below.
• Window.setContentUnderTitleBar(bool) takes the title bar into the content area: it becomes a transparent overlay, the window buttons stay on it, and a background colour or visual effect runs unbroken to the top edge. It returns whether the platform can do it, and Window.isContentUnderTitleBarSupported() answers beforehand — macOS only. On Windows the client area can be given the caption band, but the caption buttons stop hit-testing once it is client area; on Linux a GTK header bar is a sibling above the content, not an overlay over it.
• Window.titleBarStyle no longer forces the window control buttons visible on macOS as a side effect; it sets them to what the style implies, which a following isWindowControlButtonsVisible overrides.
• Breaking: the Window.visualEffect setter is now bool setVisualEffect(effect): it returns whether the effect is in force, and Window.isVisualEffectSupported(effect) answers beforehand. The getter stays, and now reports the effect the native window really has - none on Linux, where there are no visual effects, and after a refused call - instead of the last value that was set.
• A visual effect shows in a Flutter window. On macOS the effect view used to end up either over the Flutter content or behind its opaque black backing; the backing is now clear while an effect is active and comes back with VisualEffect.none. The window's backgroundColor is kept (and no longer reset on macOS) but not shown meanwhile. What Flutter paints is the app's business: use a transparent scaffold, or no MaterialApp at all as the new visual_effect_example does.
• Windows: every effect now works on Windows 10 as well, where it is a blur-behind kind — before, all of them needed Windows 11 22H2 and did nothing at all below it. On Windows 11 22H2 and later every effect is a system backdrop, which covers the title bar too; a blur-behind reaches the client area only, so on Windows 10 blur stops at the title bar.
• New effects micaAlt (Windows 11 Mica Alt), hud, popover and menu (macOS materials; Acrylic on Windows).
• Windows: Window.backgroundColor of a window created with Window.create() no longer changes every other such window with it.
• LaunchAtLogin on Windows: an app running from an MSIX package gets a shortcut in the user's Startup folder, because the Run registry key an MSIX container writes is virtualized and never read. IsEnabled() also reads Explorer's StartupApproved\Run flag and Enable() clears it, so an entry the user switched off in Task Manager is not reported as enabled and enabling it again really enables it. The registry is written through the wide API, so a non-ASCII identifier or path survives.
• LaunchAtLogin on macOS: setProgram() naming the running application registers that application whatever the identifier says, instead of failing because the identifier does not name a bundled login item helper. Arguments are recorded but never delivered — SMAppService starts the app bundle, nothing else — where before any argument made enable() fail.

• Breaking: requires Flutter 3.47 / Dart 3.13.
• Add package:nativeapi/windowing.dart: controller.nativeWindow / nativeWindowOf() turn a window created with Flutter's experimental multi-window API into a nativeapi Window, so Flutter-rendered secondary windows can be styled, positioned and observed from Dart alone. It is a separate library because it imports Flutter's internal windowing libraries, whose names change between releases; it follows the stable channel. Stable has no flutter config --enable-windowing, so an app switches the API on itself with isWindowingEnabled = true before its binding starts. See floating_toolbar_example, browser_tabs_example and detachable_window_example.
• Windows: a Window.backgroundColor with alpha now really makes the window see-through — the alpha was ignored before; the compositor draws the color. (macOS since 0.2.7.)
• Linux: a Window.backgroundColor with alpha makes a Flutter window see-through there too (the Flutter view's black backing takes the color), and Window.setParentWindow now reaches a Wayland compositor when the child happens to be shown before its parent.
• Linux: Window.titleBarStyle = hidden on a window that is not shown yet no longer leaves its content 52 px short in both directions on Wayland (it now hides GTK's own header bar instead of un-decorating the window).
• Linux: Window.hasShadow = false works on windows with client-side decorations — every toplevel on Wayland, and windows with a header bar on X11. A window the window manager decorates keeps its shadow, and hasShadow keeps saying so. contentSize of a window created by this library is no longer measured with the shadow margin and the title bar included on Wayland.
• Linux: building no longer asks for libayatana-appindicator3-dev (see cnativeapi).

• Add WindowCreatedEvent and WindowClosedEvent. WindowManager.addListener now reports a window the first time it is shown and when it is closed for good, whoever created or closed it — including windows made with Flutter's multi-window API. A window that is never shown emits neither; hiding is not closing.
• Add Window.setParentWindow / Window.parentWindow for child windows — floating toolbars, palettes, inspectors. A child stays above its parent and hides when the parent is minimized. On macOS it also moves with its parent; on Windows and Linux follow the parent's WindowMovedEvent for that. On Windows a child is destroyed with its parent.
• WindowEvent and the other event base classes now expose what every variant carries (event.windowId, …), so reading it no longer needs a match on the concrete type.
• macOS: a Window.backgroundColor with alpha now really makes the window see-through — the window is marked non-opaque, and a Flutter view in it drops its black backing.
• Add floating_toolbar_example: a transparent, frameless Flutter window attached to the main window, from Dart alone.
• Add TrayIcon.isIconTemplate, iconSize and iconPosition (with TrayIconPosition). Behaviour change on macOS: an icon is no longer forced to be a template image, so coloured icons keep their colours — set isIconTemplate = true for a monochrome glyph that should follow the menu bar. The default size is still 18 x 18 points; a zero size draws the image at its own size. The Image given to icon is no longer modified. Windows and Linux record the three values without using them.
• Windows: tray icons come back after Explorer restarts instead of disappearing for good.
• Linux: every tray icon gets its own D-Bus connection, so a second icon in the same process appears instead of failing to register, and a disposed icon leaves the panel at once.
• Linux: window size and position are measured by the frame and the content instead of the GdkWindow.
• Windows: a menu item's click event is emitted before Menu.open returns, and open reports failure from whether the menu was actually shown.
• Fix a crash when a window message arrived for a menu that had already been destroyed.

• Add drag and drop: DropTarget / DragSource bindings, and the DropRegion and DragOutArea widgets for dropping files and text onto a window and dragging them out of it.
• Add DragToMoveArea and DragToResizeArea widgets for custom window chrome, with optional target windows and configurable resize handles.
• Add WindowDragSession and WindowManager.getWindowAtPoint for tear-off windows that follow the cursor and can dock back into another window.
• Add Window.isVisibleInTaskbar for keeping a window out of the taskbar — the skipTaskbar counterpart, inverted so it reads like the other flags. Windows adds and removes the taskbar button (and keeps it away across hide/show), Linux sets the window manager's skip-taskbar hint, macOS drops the window from the app's Window menu.
• Window events now actually fire. WindowResizedEvent, WindowMovedEvent, WindowMinimizedEvent, WindowMaximizedEvent and WindowRestoredEvent existed all the way through the bindings but were never emitted — only focused and blurred worked. Wayland cannot report moves or minimization to a client, so those stay silent there.
• Fix Window.hasShadow doing nothing on Windows: turning it off now removes the window's drop shadow, which is what a frameless window usually wants.
• Fix Window.titleBarStyle on Windows: hiding the title bar now takes effect straight away instead of only after a fullscreen round trip, the content fills the space the title bar left, and the top edge stays resizable.
• Fix Window.isFullScreen on Windows being answered from the window's rectangle, so moving or centering a full screen window left it stuck in full screen for good. Also fix Window.isMinimized always being false there, which made restore() a no-op.
• Fix Window.startDragging not moving the window on Windows, and on macOS the gesture after a startDragging / startResizing being ignored; implement it on Linux.
• Linux fixes: WindowManager.getCurrent() and Window.isFocused now find the focused window, an app no longer exits immediately instead of running, opening a context menu relative to a window no longer crashes, and the display getters survive monitors being replaced or the screen blanking.
• Windows fixes: window hit testing and late drag starts, submenu detach/reattach, and Top End menu placement.
• Add window_drag_areas_example, drag_drop_example, detachable_window_example and browser_tabs_example.

• Update to cnativeapi 0.2.4 with Windows DLL export and Apple build fixes.
• Fix storage example initialization and collection access by using the all getter.
• Sync generated Dart bindings with the updated core.

• Add Window.isNonActivating. A non-activating window can be shown on top and take keyboard input without activating the app, so the previously active app keeps its activation and the app's other windows stay put when it is hidden. Only macOS has observable behavior (the window becomes a non-activating NSPanel in place); Windows and Linux record the flag
• macOS: Window.isFocusable = false now actually prevents the window from becoming key

• Fix macOS build failure in 0.2.1 coming from cnativeapi — see its changelog

• Add AppInfo API for the running app's name, identifier, version and build number
• Add DeviceInfo API for the machine's name, model, manufacturer, OS, kernel and architecture
• Fix WindowFocusedEvent and WindowBlurredEvent never firing — the native layer dispatched no window events at all, so WindowManager.addListener was silent

• Breaking: regenerate the Dart API from the new code generator; the object identity/lifecycle model is unified and many signatures changed
• Breaking: rework the event system — EventEmitter and the separate WindowEvent/MenuEvent/TrayIconEvent classes are replaced by typed event listeners on each object
• Add Application API
• Add KeyboardMonitor API
• Add Shortcut and ShortcutManager APIs for global shortcuts
• Add ImageAsset widget helper
• Fix tray icon bounds on multi-display setups (macOS)
• Fix macOS global shortcuts never firing

• Fix macOS menu item disabled state not being respected
• Fix Windows window SetMinimumSize/SetMaximumSize not working
• Add per-monitor DPI scaling for Windows display and window geometry
• Track menu item enabled state and update flags on Windows
• Adjust Linux tray icon menu trigger handling
• Enhance window example UI with event logging and three-tab interface
• Add menu example enhancements (disabled menu items, bug repro)
• Remove CocoaPods artifacts from macOS Xcode project

• Remove CocoaPods integration from the storage example
• Update Darwin example integration to use Swift Package Manager

• Add LaunchAtLogin API for managing app startup at user login
• Fix bindgen Dart template generation for LaunchAtLogin string-array arguments
• Fix bindgen Dart template generation for static native API calls

• Add WindowManager API with full lifecycle support (show, hide, center, pre-show/pre-hide hooks, visual effects, title bar style, control buttons)
• Add TrayManager / TrayIcon API with context menu trigger support
• Add DisplayManager / Display multi-screen management API
• Add Menu / MenuEvent menu system
• Add MessageDialog / Dialog APIs
• Add AccessibilityManager API
• Add Preferences storage
• Add SecureStorage secure storage
• Add UrlOpener API
• Add PositioningStrategy / Placement window positioning support
• Add ContextMenuRegion widget

• Initial release