패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.6.1

cnativeapi

nativeapi C API에 대한 원시 Dart FFI 바인딩. 네이티브 라이브러리는 빌드 후크에서 소스로부터 빌드됩니다.

AndroidiOSLinuxmacOSWindows
30일 다운로드
7.6만
좋아요
2
Pub 점수
160

패키지 설치

flutter pub add cnativeapi

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

cnativeapi는 네이티브API C API에 대한 원시 Dart FFI 바인딩을 제공하여 Flutter 애플리케이션에서 네이티브 시스템 기능에 직접 접근할 수 있게 합니다. 네이티브 라이브러리는 빌드 프로세스 중 빌드 후크를 통해 소스에서 컴파일되며, 플랫폼 간 호환성을 보장합니다. 이 패키지는 시스템 리소스에 저수준으로 접근하거나 성능이 중요한 작업이 필요한 개발자에게 적합합니다. Android, iOS, Linux, macOS, Windows를 지원하여 크로스플랫폼 네이티브 통합에 적합합니다.

사용 사례

  • 저수준 시스템 API에 접근하기
  • 성능 중심 작업
  • 크로스 플랫폼 네이티브 통합
  • 사용자 지정 하드웨어 상호작용
  • 시스템 레벨 디버깅

주요 기능

  • 원시 FFI 바인딩
  • 빌드 시 네이티브 라이브러리 컴파일
  • 크로스 플랫폼 지원
  • 직접 C API 접근
  • 최소의 런타임 오버헤드

적합한 대상

  • 고급 플러터 개발자
  • 시스템 레벨 애플리케이션 개발
  • 임베디드 및 IoT 프로젝트
  • 고성능 컴퓨팅 작업
  • 플랫폼별 기능 구현

고려 사항

  • C 및 FFI에 대한 지식이 필요합니다
  • 빌드 프로세스가 복잡성을 추가합니다
  • 원시 바인딩에서의 오류 처리 제한
  • 잠재적인 플랫폼별 문제
  • 초보자에게 추천되지 않습니다

원본 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

카테고리

의존성

의존성 목록 5 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.

순위