nativeapi

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

🚧 Work in Progress: This package is currently under active development.

Platform Support

Android	iOS	Linux	macOS	Windows
✅	✅	✅	✅	✅

Features

• Window Management — create, show, hide, center windows; control title bar style, visual effects, and control buttons
• Tray Icon — system tray icon with menu and context menu trigger support
• Display Management — enumerate and query multi-screen display info
• Menu — native menu system with event callbacks
• Dialogs — message dialogs and native dialog APIs
• Accessibility — accessibility manager API
• Preferences — persistent key-value storage
• Secure Storage — encrypted key-value storage
• URL Opener — open URLs with the system default browser/handler
• Positioning — flexible window positioning strategies and placement support
• Widgets — ContextMenuRegion for context menu integration

Getting Started

Add nativeapi to your pubspec.yaml:

dependencies:
nativeapi: ^0.1.1

Then run:

flutter pub get

Usage

import'package:nativeapi/nativeapi.dart';
// Window management - get the current window and manipulate itfinal windowManager =WindowManager.instance;
final window = windowManager.getCurrent();
window?.show();
window?.center();
window?.titleBarStyle =TitleBarStyle.hidden;
// Listen to window events
windowManager.addCallbackListener<WindowFocusedEvent>((event) {
print('Window focused: ${event.windowId}');
});
// Tray iconfinal trayIcon =TrayIcon();
trayIcon.icon =Image.fromAsset('assets/tray_icon.png');
trayIcon.contextMenu =Menu();
trayIcon.contextMenuTrigger =ContextMenuTrigger.rightClicked;
trayIcon.on<TrayIconClickedEvent>((event) {
print('Tray icon clicked');
});
// URL opener (synchronous)final result =UrlOpener.instance.open('https://example.com');
print('Opened: ${result.success}');
// Preferences (synchronous, dispose when done)final prefs =Preferences();
prefs.set('theme', 'dark');
final theme = prefs.get('theme', 'light'); // second arg is default value
prefs.dispose();

📖 More detailed documentation and examples are coming soon. See the examples/ directory for working sample apps.

Development

Prerequisites

• Flutter (>=3.35.0)
• Dart SDK (>=3.9.0)

Setup

1. Clone the repository:

git clone https://github.com/libnativeapi/nativeapi-flutter.git
cd nativeapi-flutter

2. Initialize submodules:

git submodule update --init --recursive

3. Install dependencies:

melos bootstrap

4. Run an example app:

cd examples/display_example
flutter run

FFI Bindings

This project uses ffigen to generate Dart FFI bindings from C headers. To regenerate the bindings:

cd packages/cnativeapi
dart run ffigen --config ffigen.yaml

The ffigen configuration is defined in packages/cnativeapi/ffigen.yaml. You typically need to regenerate bindings when:

• The native C library (libnativeapi/nativeapi) is updated
• The ffigen configuration is modified

License

MIT