react-native-node-api

KO | EN

gitlite — search

#javascript #python #typescript #android #rust #deep-learning #macos #java #nodejs #awesome #kubernetes #vue #openai #open-source

react-native-node-api

(★ 186)

Node-API Modules for React Native

react-native-node-api Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  Node-API Modules<br/>for React Native
</h1>

<p align="center">
  <strong>Write once, run anywhere:</strong><br/>
  Build native modules for <a href="https://reactnative.dev/">React Native</a> with <a href="https://nodejs.org/api/n-api.html">Node-API</a>.
</p>

## Getting started

> [!WARNING]
> This library is still under active development. Feel free to hack around, but use at your own risk.

## How does this work?

> [!IMPORTANT]
> This library builds Hermes from a pinned commit on its `static_h` branch, which carries [Hermes' first-party Node-API implementation](https://github.com/facebook/hermes/tree/static_h/API/napi).
> React Native has not shipped that Hermes yet, so the range of supported React Native versions is very limited — see the `react-native` peer dependency of the [host package](packages/host/package.json) for the version we currently build against.
> We expect this restriction to be lifted once React Native ships a Hermes with Node-API included.

> [!NOTE]
> This library only works for iOS and Android and we want to eventually support React Native for Windows, macOS, visionOS and other out-of-tree platforms too.

See the document on ["how it works"](./docs/HOW-IT-WORKS.md) for a detailed description of what it's like to write native modules using this package.

## Packages

This mono-repository hosts the development of a few packages:

### [`react-native-node-api`](packages/host)

Responsible for adding Node-API support to your React Native application:

- Declares a Podspec which vendors Hermes from a pinned commit on its `static_h` branch, where Node-API is implemented,
  - instructing React Native's Hermes Podspecs to compile from this checkout.
  - we expect this to eventually be removed, as React Native starts shipping a Hermes with Node-API included.
- Automatically discovers and adds Node-API binaries, matching the [the prebuilt binary specification](./docs/PREBUILDS.md)
  - This is driven by the platform specific build tools (through the Podspec on iOS and eventually Gradle on Android)
- Implements a TurboModule with a `requireNodeAddon` function responsible for
  - Loading dynamic libraries
  - Node-API module registration and (per `jsi::Runtime`) initialization.
- Provides ways of transforming `require("./addon.node")` and `require("bindings")("addon")` calls into `requireNodeAddon` calls.

Note: We'll sometimes refer to this as the "host package", as it can be seen as a host of Node-API modules in React Native apps.

### [`cmake-rn`](packages/cmake-rn)

A wrapper around CMake making it easier to produce [prebuilt binaries](./docs/PREBUILDS.md) targeting iOS and Android matching the [the prebuilt binary specification](./docs/PREBUILDS.md).

Serves the same purpose as `cmake-js` does for the Node.js community and could potentially be upstreamed into `cmake-js` eventually.

### [`ferric-cli`](packages/ferric)

A wrapper around [Cargo](https://doc.rust-lang.org/cargo/) making it easier to produce prebuilt binaries targeting iOS and Android matching the the prebuilt binary specification as well as [napi.rs](https://napi.rs/) to generate Node-API bindings from annotated Rust code.

### [`gyp-to-cmake`](packages/gyp-to-cmake)

A tool to transform `binding.gyp` files into `CMakeLists.txt` files, intended for `cmake-js` or `cmake-rn` to build from.

### [`@react-native-node-api/node-addon-examples`](packages/node-addon-examples)

A wrapper around the examples in the [nodejs/node-addon-examples](https://github.com/nodejs/node-addon-examples) repo, using `gyp-to-cmake` and `cmake-rn` to prepare prebuilds and scaffolding for loading the addons.

The main purpose is to use these as tests to verify the implementation. We choose to use this as our first signal for compliance, over the [js-native-api tests in the Node.js project](https://github.com/nodejs/node/tree/main/test/js-native-api), because the examples depends much less on Node.js built-in runtime APIs.

### [`@react-native-node-api/test-app`](apps/test-app)

A test app using `react-native-test-app` to exercise the implementation of it all.

### [`@react-native-node-api/ferric-example`](packages/ferric-example)

A simple example of using the `ferric` CLI to build a Node-API module for React Native in Rust.

react-native-node-api

react-native-node-api Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

react-native-node-api

react-native-node-api Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README