nativeapi 0.4.0 copy "nativeapi: ^0.4.0" to clipboard
nativeapi: ^0.4.0 copied to clipboard

Published 3 hours ago • verified publisherleanflutter.dev
SDKDartFlutter
PlatformAndroidiOSLinuxmacOSWindows
→

Metadata

Dart bindings for nativeapi - providing seamless, unified access to native system APIs.

More...

0.4.0 #

  • 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.

0.3.0 #

  • 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).

0.2.7 #

  • 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.

0.2.5 #

  • 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.

0.2.4 #

  • 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.

0.2.3 #

  • 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

0.2.2 #

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

0.2.1 #

  • 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

0.2.0 #

  • 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

0.1.4 #

  • 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

0.1.3 #

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

0.1.2 #

  • 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

0.1.1 #

  • 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

0.1.0 #

  • Initial release

← Metadata

30
likes
160
points
4.03k
downloads

Documentation

API reference

Publisher

verified publisherleanflutter.dev

Weekly Downloads

Metadata

Dart bindings for nativeapi - providing seamless, unified access to native system APIs.

Homepage
Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

cnativeapi, ffi

More

Packages that depend on nativeapi

Back