搜尋套件、儲存庫與 APP 分類

套件詳情v0.6.1

nativeapi

Dart 綁定 nativeapi - 提供對原生系統 API 的無縫統一存取。

AndroidiOSLinuxmacOSWindows
近 30 天下載
7.5萬
喜歡數
36
Pub 分數
160

安裝套件

flutter pub add nativeapi

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

NativeAPI 提供 Dart 繫結,可在多個平台間無縫且統一地存取原生系統 API。它讓 Flutter 應用能直接與底層作業系統功能(如檔案系統、硬體感測器和裝置管理)互動,並抽象化平台相關的複雜性。此套件專為希望在不撰寫平台特定程式碼的情況下實現低階系統整合的開發者設計,確保在 Android、iOS、Linux、macOS 及 Windows 上行為一致。該套件非常適合需要深入系統互動卻又能維持跨平台相容性的應用。

適用情境

  • 存取原生檔案系統
  • 讀取硬體感測器資料
  • 管理設備權限
  • 與作業系統層級服務整合
  • 跨平台系統操作

主要特色

  • 跨平台統一 API
  • 底層系統存取
  • 跨平台一致性
  • 最小化樣板程式碼
  • 官方 Dart 綁定

適合對象

  • 系統級應用開發
  • 跨平台實用工具
  • 效能關鍵應用
  • DevOps 工具
  • 嵌入式或物聯網應用

使用建議

  • 需要平台特定的設定
  • 可能需要提升權限
  • 有限的文件
  • 存在平台特定的錯誤
  • 不適合用於UI密集型應用

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

nativeapi

Unified access to native system APIs — windows, tray icons, menus, displays, keyboard, dialogs, storage and more — from Dart/Flutter, Rust, C#, JavaScript/TypeScript, Python and Go, all built on one C++ core.

Android iOS Linux macOS Windows
✅ ✅ ✅ ✅ ✅

🚧 Work in Progress: the API is under active development.

This repository is the home of every binding: the Dart, Rust, C#, JS, Python and Go bindings, the code generator, the design specs and the shared tooling live here directly, and the C++ core (nativeapi-core) is checked out as a git submodule. A core change and its regenerated bindings (core → codegen → bindings) are made and tracked together.

Bindings

Binding Packages Status
Dart / Flutter nativeapi, cnativeapi on pub.dev; nativeapi_flutter (not yet published) published
Rust nativeapi, cnativeapi on crates.io published
C# NativeAPI not yet on NuGet; build from source
JavaScript / TypeScript nativeapi (Node-API addon for Node.js, Deno and Bun) not yet on npm
Python nativeapi (ctypes, Python 3.10+) prototype, not yet on PyPI
Go github.com/libnativeapi/nativeapi/bindings/go (cgo, Go 1.22+) build from source

Each binding's README covers installation and usage.

History

This repository was nativeapi-flutter, then nativeapi-workspace, and is now nativeapi; the old names redirect here, and its history, issues and stars carry over. The histories of the former workspace, nativeapi-rust and nativeapi-csharp repositories are merged in, so the Rust and C# bindings keep their full history under bindings/. The old nativeapi-rust and nativeapi-csharp repositories are archived.

Layout

Path Description
core submodule: the C++ core library (nativeapi-core)
bindings/dart Dart binding (packages nativeapi, cnativeapi, nativeapi_flutter)
bindings/rust Rust binding (crates nativeapi, cnativeapi)
bindings/csharp C# binding
bindings/js JavaScript / TypeScript binding (Node-API addon)
bindings/python Python binding (ctypes)
bindings/go Go binding (cgo)
examples example apps of every binding, prefixed by binding: flutter_*, rust_*, csharp_*, js_*, python_*, go_*, …
tools/codegen the C ABI and binding generators
specs design rules for the core's public API

Getting started

git clone --recursive https://github.com/libnativeapi/nativeapi.git

Already cloned without --recursive?

git submodule update --init --recursive

The root pubspec.yaml is the pub workspace (and melos) root for the Dart packages and the Flutter examples, and the root Cargo.toml is the cargo workspace for the Rust crates and examples, so flutter pub get and cargo build run from the repository root. The C# solution is bindings/csharp/NativeAPI.slnx.

Code generation

tools/codegen generates the C ABI and all language bindings from the C++ headers in core/. Run it via the wrapper script:

./codegen         # full run: C ABI, then all bindings
./codegen check   # verify generated files are up to date (CI mode)
./codegen readme  # copy the shared README sections (tools/readme/) into every README
./codegen sync    # after a core change: regenerate everything, rerun
                  #   bindgen/ffigen, and commit core, then this repo
                  #   (add --push to also push, -m "..." for the core message)

See tools/codegen/README.md for details.

Common tasks

make status   # working-tree status of this repo and the core submodule
make sync     # fast-forward core to origin/main
make bump     # stage the updated core pointer for commit

Work on the bindings, the tooling and the specs is committed here directly. Work inside core is committed and pushed from that subdirectory as if it were a standalone clone; this repository then records the updated pointer once the combination is known to be compatible.

Issues

Releases

Each binding is released from a tag of its own: v<version> publishes the Dart packages to pub.dev (dart-release.yml), rust-v<version> publishes the crates to crates.io (rust-release.yml). The C#, JS, Python and Go bindings are not published yet.

License

MIT

所屬分類

依賴

依賴清單 2 項

原始碼儲存庫

使用此套件的專案

所在榜單