Release cnativeapi and nativeapi v0.1.1

lijy91 · lijy91 · commit 874da3ed0dbd · 2026-05-05T17:00:37.000+08:00
- Bump version to 0.1.1 for both cnativeapi and nativeapi
- Update cnativeapi dependency constraint to ^0.1.1 in nativeapi
- Add CHANGELOG entries for 0.1.1
- Update README files: add platform support table, features list,
  Work in Progress notice, and correct usage examples
diff --git a/README-ZH.md b/README-ZH.md
@@ -4,13 +4,33 @@
 
 🚧 **开发中**: 此包目前正在积极开发中。
 
+## 平台支持
+
+| Android | iOS | Linux | macOS | Windows |
+|:-------:|:---:|:-----:|:-----:|:-------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+## 功能特性
+
+- **窗口管理** — 创建、显示、隐藏、居中窗口；控制标题栏样式、视觉效果和控制按钮
+- **托盘图标** — 系统托盘图标，支持菜单和右键菜单触发
+- **多屏幕管理** — 枚举和查询多屏幕显示信息
+- **菜单** — 原生菜单系统，支持事件回调
+- **对话框** — 消息对话框及原生对话框 API
+- **辅助功能** — 无障碍管理器 API
+- **偏好设置** — 持久化键值存储
+- **安全存储** — 加密键值存储
+- **URL 打开器** — 使用系统默认浏览器/处理程序打开 URL
+- **定位策略** — 灵活的窗口定位策略和位置支持
+- **Widget** — `ContextMenuRegion` 右键菜单集成组件
+
 ## 快速开始
 
 在 `pubspec.yaml` 中添加 `nativeapi`:
 
 ```yaml
 dependencies:
-  nativeapi: ^0.1.0
+  nativeapi: ^0.1.1
 ```
 
 然后运行:
@@ -19,16 +39,45 @@ dependencies:
 flutter pub get
 ```
 
-### 使用方法
-
-> 📖 详细的文档和示例即将推出！
+## 使用方法
 
 ```dart
 import 'package:nativeapi/nativeapi.dart';
 
-// 示例用法将在此处添加
+// 窗口管理 - 获取当前窗口并进行操作
+final windowManager = WindowManager.instance;
+final window = windowManager.getCurrent();
+window?.show();
+window?.center();
+window?.titleBarStyle = TitleBarStyle.hidden;
+
+// 监听窗口事件
+windowManager.addCallbackListener<WindowFocusedEvent>((event) {
+  print('窗口获得焦点: ${event.windowId}');
+});
+
+// 托盘图标
+final trayIcon = TrayIcon();
+trayIcon.icon = Image.fromAsset('assets/tray_icon.png');
+trayIcon.contextMenu = Menu();
+trayIcon.contextMenuTrigger = ContextMenuTrigger.rightClicked;
+trayIcon.on<TrayIconClickedEvent>((event) {
+  print('托盘图标被点击');
+});
+
+// URL 打开器（同步调用）
+final result = UrlOpener.instance.open('https://example.com');
+print('打开结果: ${result.success}');
+
+// 偏好设置（同步调用，使用完记得 dispose）
+final prefs = Preferences();
+prefs.set('theme', 'dark');
+final theme = prefs.get('theme', 'light'); // 第二个参数为默认值
+prefs.dispose();
 ```
 
+> 📖 更详细的文档和示例即将推出。请查看 [`examples/`](https://github.com/libnativeapi/nativeapi-flutter/tree/main/examples) 目录中的示例应用。
+
 ## 开发
 
 ### 前置要求
diff --git a/README.md b/README.md
@@ -4,13 +4,33 @@ Flutter bindings for [nativeapi](https://github.com/libnativeapi/libnativeapi) -
 
 🚧 **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`:
 
 ```yaml
 dependencies:
-  nativeapi: ^0.1.0
+  nativeapi: ^0.1.1
 ```
 
 Then run:
@@ -19,16 +39,45 @@ Then run:
 flutter pub get
 ```
 
-### Usage
-
-> 📖 Detailed documentation and examples are coming soon!
+## Usage
 
 ```dart
 import 'package:nativeapi/nativeapi.dart';
 
-// Example usage will be added here
+// Window management - get the current window and manipulate it
+final 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 icon
+final 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/`](https://github.com/libnativeapi/nativeapi-flutter/tree/main/examples) directory for working sample apps.
+
 ## Development
 
 ### Prerequisites
@@ -57,7 +106,7 @@ git submodule update --init --recursive
 melos bootstrap
 ```
 
-4. Run the example app:
+4. Run an example app:
 
 ```bash
 cd examples/display_example
diff --git a/packages/cnativeapi/CHANGELOG.md b/packages/cnativeapi/CHANGELOG.md
@@ -1,3 +1,13 @@
+## 0.1.1
+
+* Add multi-platform FFI C bindings (Android, iOS, Linux, macOS, Windows)
+* Migrate iOS and macOS native bindings to SwiftPM
+* Add UrlOpener C bindings
+* Add autostart and global shortcuts C bindings
+* Add window visual effects and color C bindings
+* Add title bar style and control button C bindings
+* Introduce bindgen code generation toolchain
+
 ## 0.1.0
 
 * Initial release
diff --git a/packages/cnativeapi/README.md b/packages/cnativeapi/README.md
@@ -1,3 +1,38 @@
 # cnativeapi
 
-Native API C bindings for Flutter
+Native API C bindings for Flutter, auto-generated via [ffigen](https://pub.dev/packages/ffigen) from the [libnativeapi](https://github.com/libnativeapi/nativeapi) C library.
+
+> This package provides low-level FFI bindings and is typically used as an internal dependency of [`nativeapi`](https://pub.dev/packages/nativeapi). You generally don't need to depend on it directly.
+
+## Platform Support
+
+| Android | iOS | Linux | macOS | Windows |
+|:-------:|:---:|:-----:|:-----:|:-------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+## Usage
+
+If you need to use the raw C bindings directly:
+
+```dart
+import 'package:cnativeapi/cnativeapi.dart';
+```
+
+For higher-level Dart APIs, use the [`nativeapi`](https://pub.dev/packages/nativeapi) package instead.
+
+## Regenerating Bindings
+
+Bindings are generated from C headers using `ffigen`. To regenerate:
+
+```bash
+cd packages/cnativeapi
+dart run ffigen --config ffigen.yaml
+```
+
+Regeneration is needed when:
+- The native C library ([libnativeapi/nativeapi](https://github.com/libnativeapi/nativeapi)) is updated
+- The `ffigen.yaml` configuration is modified
+
+## License
+
+[MIT](./LICENSE)
diff --git a/packages/cnativeapi/pubspec.yaml b/packages/cnativeapi/pubspec.yaml
@@ -1,6 +1,6 @@
 name: cnativeapi
 description: "Native API C bindings for Flutter"
-version: 0.1.0
+version: 0.1.1
 homepage: https://github.com/libnativeapi/nativeapi-flutter
 resolution: workspace
 
diff --git a/packages/nativeapi/CHANGELOG.md b/packages/nativeapi/CHANGELOG.md
@@ -1,3 +1,17 @@
+## 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
diff --git a/packages/nativeapi/pubspec.yaml b/packages/nativeapi/pubspec.yaml
@@ -1,6 +1,6 @@
 name: nativeapi
 description: "Flutter bindings for nativeapi - providing seamless, unified access to native system APIs."
-version: 0.1.0
+version: 0.1.1
 homepage: https://github.com/libnativeapi/nativeapi-flutter
 resolution: workspace
 
@@ -12,7 +12,7 @@ dependencies:
   ffi: ">=1.2.1 <3.0.0"
   flutter:
     sdk: flutter
-  cnativeapi: ^0.1.0
+  cnativeapi: ^0.1.1
   path: ^1.9.1
   meta: ^1.16.0
 
