## 2020-11-02, Version 0.6.2 (Current)
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.3.2`, which updates the engine to `v12.19.0` LTS.
* Support Rust neon-bindings for native modules on iOS.
### Commits
* [[`b8b7d60`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/b8b7d60be696d633f0b6e1ab34e36737309451a0)] - core: update nodejs-mobile v0.3.2 (Jaime Bernardo)
* [[`7e40004`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7e4000466c93b2f053e2922e589de5bb4a5dac9d)] - ios: support neon-bindings (Rust) native modules (Andre Staltz)
## 2020-05-25, Version 0.6.1
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.3.1`, which updates the engine to `v12.16.3` LTS.
### Commits
* [[`bfe78e7`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/bfe78e7c0a503193d9075e9809ebb17c33832e14)] - core: update nodejs-mobile v0.3.1 (Jaime Bernardo)
* [[`736900c`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/736900c18c0cf69023180fc3964dde09ad35b4e0)] - android: build reproducible dir and file lists (Corey)
* [[`b2d3fe9`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/b2d3fe943d8bc90f13542eeef9a9290c8b432ae1)] - doc: add mention to iOS 11.0 or later support (Jaime Bernardo)
## 2020-04-27, Version 0.6.0
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.3.0`, which updates the engine to `v12.16.0` LTS and uses V8 on iOS.
### Commits
* [[`1a58bcf`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/1a58bcf53321d83165b9f607587650a3a0bf8aba)] - core: update nodejs-mobile v0.3.0 (Jaime Bernardo)
* [[`b12b309`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/b12b309f4da0d303a400c4bd6b2c74acaf1cfb32)] - android: rust cargo build environment variables (stoically)
## 2019-09-17, Version 0.5.0
### Notable Changes
* Support for `react-native v0.60+`, breaking compatibility with previous versions.
* TypeScript type definitions added.
### Commits
* [[`7cd4a01`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7cd4a01f41fd937628fff9e001de5eda6a001cb9)] - plugin: support react-native 0.60+ (Jaime Bernardo)
* [[`dd7c67a`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/dd7c67a5d7bee803105e9370e020633e2a3a4131)] - plugin: add typescript type definitions (Ivan Schurawel)
* [[`71c401d`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/71c401d0fe7aa6e7b0c5a330bed3645c7a1ea036)] - plugin: update xcode to 2.0.0 (Rajiv Shah)
## 2019-06-10, Version 0.4.3
### Notable Changes
* Fix a compatibility issue with newer versions of Gradle when building for Android.
### Commits
* [[`aafb0a5`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/aafb0a56b6960b2b116ad9ef9b673738d99a4512)] - android: use input and output dir syntax in Gradle (Jaime Bernardo)
## 2019-06-03, Version 0.4.2
### Notable Changes
* Update `nodejs-mobile-gyp` to `v0.3.1`, fixing a potential security issue.
### Commits
* [[`14c5554`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/14c555472bb1626b8a0ed56bd5d72ce7ed37b646)] - plugin: update nodejs-mobile-gyp to 0.3.1 (Julia Friesel)
## 2019-04-24, Version 0.4.1
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.2.1`, fixing an App Store submission error.
### Commits
* [[`13e15a4`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/13e15a44d3af89454669ee2423642a67c592e376)] - plugin: patch node-pre-gyp libc replacement (Jaime Bernardo)
* [[`bb93132`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/bb9313234715472229e16907f567deb95174f56b)] - android: use minSdkVersion to build native modules (Jaime Bernardo)
* [[`5e37e7a`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/5e37e7a1ef7532afa78aededfb33f00643f839b8)] - core: update nodejs-mobile v0.2.1 (Jaime Bernardo)
* [[`829ec3a`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/829ec3ad804aae958813026ab544055faf7dfbba)] - android: Use ReactModule annotation from 0.58 (André Staltz)
## 2019-04-04, Version 0.4.0
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.2.0`, which updates the engine to `v10.13.0` LTS.
### Commits
* [[`844fce9`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/844fce9cf8329f2c816de4e7f2d1efeeeee88439)] - docs: mention metro.config.js in Troubleshooting (Jaime Bernardo)
* [[`9655d3a`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/9655d3af08102a463891052772e848e94e4c14be)] - android: fix libc++_shared packaging in 0.59 (Jaime Bernardo)
* [[`c6d9a23`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/c6d9a239d3422a78bcfe95ab745e4f06408a2379)] - android: fix gradle compile deprecation warning (Jaime Bernardo)
* [[`81567e4`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/81567e4e605329a2659e9f7ec4c25ade20c4fdc5)] - core: update nodejs-mobile v0.2.0 (Jaime Bernardo)
## 2019-03-18, Version 0.3.4
### Notable Changes
* Hotfix release: fix postlink script paths for `react-native >= 0.59`.
### Commits
* [[`ba9d5d4`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ba9d5d48c413550a890aeb9ec2e895db93eeb5bb)] - plugin: update script paths for react-native 0.59 (Jaime Bernardo)
## 2019-02-19, Version 0.3.3
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.1.9`.
* Add 64 bit binaries for Android.
### Commits
* [[`9357f13`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/9357f139e6c9594b1746c3672eb111d1a7c0c529)] - android: build native modules for every arch (Jaime Bernardo)
* [[`fbab03e`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/fbab03e7372167a2ccba766d043a8559b309586e)] - android: add 64 bit binaries (Jaime Bernardo)
* [[`db830fe`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/db830fe3ec75092c3b865d8ed1f1d8189aa0ec71)] - core: update nodejs-mobile v0.1.9 (Jaime Bernardo)
## 2018-11-21, Version 0.3.2
### Notable Changes
* Hotfixes the node thread stack size on iOS, when starting the runtime with a node project folder.
### Commits
* [[`082cbc0`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/082cbc0d4815d435a8c06cd34bea4c0a6d573dec)] - ios: set node project thread stack size to 2MB (Jaime Bernardo)
## 2018-11-07, Version 0.3.1
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.1.8`, fixing exceptions on Apple A12 CPUs for iOS and being built with NDK r18b for Android.
### Commits
* [[`0e6ffe9`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/0e6ffe9cfb26bf0fa2b8ba8a823067d4ad35ab9c)] - core: update nodejs-mobile v0.1.8 (Jaime Bernardo)
* [[`ed727ed`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ed727edea17e8a9e1a85cef3413becc83b8a0328)] - docs: duplicate module name instructions (Jaime Bernardo)
## 2018-09-03, Version 0.3.0
### Notable Changes
* Add new channel APIs.
### Commits
* [[`085e047`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/085e04762b98859354738611cd4e9fc0828c679e)] - docs: document os.tmpdir behavior in node (Jaime Bernardo)
* [[`2ccc542`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/2ccc54290d59cc014d930d1b4bac7c8486bc6316)] - android: show alternative to misleading error log (Jaime Bernardo)
* [[`ff308a6`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ff308a6107c1857e7ec94599420ede1b712e0931)] - docs: document the new channel API, app channel (Jaime Bernardo)
* [[`1116698`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/11166985ef65b253fcb7080289619c31466ead7a)] - plugin: add app.datadir API to get writable path (Jaime Bernardo)
* [[`10c1d3e`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/10c1d3e75af44f1f5b473c0dba552363e13cfe49)] - plugin: add app channel for pause-resume events (Jaime Bernardo)
* [[`7c922f9`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7c922f9751e577154cbc95215bb8c83dbe2254b1)] - plugin: improved events channel (Jaime Bernardo)
## 2018-07-30, Version 0.2.1
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.1.7`, built with NDK r17b, to solve Android 7 C++ STL runtime issues.
* Use project-wide properties from react-native, for compatibility with recent react-native releases.
### Commits
* [[`f813ec9`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/f813ec973879506b52ba73b57928deaf8ab0e51e)] - core: update nodejs-mobile v0.1.7 (Jaime Bernardo)
* [[`5e35c75`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/5e35c750f706d600440e4b69b97303e82ae1847c)] - android: use react-native project-wide properties (Jaime Bernardo)
## 2018-07-09, Version 0.2.0
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.1.6`, with concurrent GC for iOS.
* Improve native modules support.
* Automatically detect native modules.
* Remove simulator strip when building for iOS devices.
* Include memory optimizations.
### Commits
* [[`b0a55d6`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/b0a55d6cc9244d519c53e026b1f3a5ca9ada288b)] - core: update nodejs-mobile v0.1.6 (Jaime Bernardo)
* [[`dc6e1ed`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/dc6e1ed4a0de202567d08beae1b58b81067e64c8)] - docs: add native modules instructions to README (Jaime Bernardo)
* [[`eb960e0`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/eb960e02cd64d0a1d4229e249d472c6500eaf67e)] - plugin: add automatic native modules detection (Jaime Bernardo)
* [[`ded08e5`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ded08e5ddf0de5402ddd74e27205561fa8474e55)] - android: use original .bin for native modules (Jaime Bernardo)
* [[`209f541`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/209f5410b6e35c8b3f5fc94049f09c0fa92ca975)] - android: release node-rn JNI local references (Jaime Bernardo)
* [[`fd958ed`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/fd958edc6079061f5ccc6ee637be30d7d910c945)] - ios: release memory from node-react messages (Jaime Bernardo)
* [[`d356d70`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/d356d70ac15ce1e59d6916ef143aca4cc6e5a6e5)] - core: update nodejs-mobile v0.1.5 (Jaime Bernardo)
* [[`cba49e1`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/cba49e1baa457a7be7b094ec06d5fdf2cc396498)] - ios: building for device removes the x86_64 arch (Jaime Bernardo)
* [[`22e6286`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/22e62863c30a215fc9227672da867fa88e8e7d0e)] - android: check if native modules assets exist (Jaime Bernardo)
* [[`222f953`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/222f9539b62e18c0fb090f7972e3ea3f599bd83f)] - plugin: use alternative nodejs-mobile-gyp path (Jaime Bernardo)
* [[`757294e`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/757294e9567cdd0fd1723f25c4a37b8918a8f193)] - ios: delete .deps gyp paths from app build (Jaime Bernardo)
* [[`5f5447d`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/5f5447db4ab0ebc0e610cbfff598774bb83c2eb1)] - ios: build native modules as frameworks (Jaime Bernardo)
* [[`89ce6b3`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/89ce6b335ab71943b856215e3be973d71b9b8b87)] - ios: rewrite build phases when linking (Jaime Bernardo)
## 2018-03-05, Version 0.1.4
### Notable Changes
* Include the nodejs-project in the runtime NODE_PATH.
* Update `nodejs-mobile` binaries to `v0.1.4`.
* Include experimental native modules build code.
* Increase the iOS node thread stack size to 1MB.
### Commits
* [[`7780f20`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7780f2017817723de53123a268578c89b96235e1)] - plugin: remove native modules detection (Jaime Bernardo)
* [[`99f3400`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/99f3400895d0b8626dbea37f8382f13e6aeb7ebb)] - docs: rephrasing of some README.md sections (Jaime Bernardo)
* [[`940fcfe`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/940fcfe5f14baf9976d8714b3aa321fc094821b7)] - ios: increase node's thread stack size to 1MB (Jaime Bernardo)
* [[`409b5d4`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/409b5d4e35ae0ad8fe102c26b778e6aa77888f1c)] - docs: Add native modules instructions (Jaime Bernardo)
* [[`62af6f1`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/62af6f1ed876756135ca24ec47075dee5665d7c6)] - ios: use file to override native modules build (Jaime Bernardo)
* [[`fabbd6b`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/fabbd6b6a3757af1e624c52503c7f5e8e07a6e9e)] - android: use file to override native modules build (Jaime Bernardo)
* [[`41f7dce`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/41f7dcedbf0ecaa25ea256cd069c1c6b6c94d626)] - android: use script to call npm and node on macOS (Jaime Bernardo)
* [[`3cc78d6`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/3cc78d66a313fb8ec80ba568990f907f182c2d47)] - android: use gradle tasks inputs and outputs (Jaime Bernardo)
* [[`8a7688f`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/8a7688f9b8942f0977483d7929ead7a19fbf473f)] - plugin: Build native modules automatically (Jaime Bernardo)
* [[`7ae4dd5`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7ae4dd569b5bcc9e560ba75bbff2bdf29904a8d8)] - plugin: use nodejs-mobile-gyp for native modules (Jaime Bernardo)
* [[`d933954`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/d9339545465c67b846cbe5b9b09e5180e4846cb6)] - plugin: patch node-pre-gyp module path variables (Jaime Bernardo)
* [[`62c2670`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/62c2670b743bc60da817e8a686622fad597f1737)] - ios: native modules support (Jaime Bernardo)
* [[`af82e39`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/af82e3974d4b206b84ed20a24646a4901ae81f32)] - android: native modules support (Jaime Bernardo)
* [[`448c9ae`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/448c9ae32e70e1d2ec5239fa9d95ce22179f6eca)] - core: update nodejs-mobile v0.1.4 (Jaime Bernardo)
* [[`d478d02`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/d478d029d76e7d1de8b52d1cd5c51f7d61067b31)] - plugin: set NODE_PATH to include the project root (Enrico Giordani)
## 2018-01-16, Version 0.1.3
### Notable Changes
* Breaking change:
- The `start` function from the plugin now takes the node entrypoint filename as a mandatory argument. This means current `react-native` project will have to update every `start()` call to `start('main.js')` to maintain behaviour.
* Updates `react-native` dependency version to `0.52`.
* Optimizes assets copy.
* Adds option argument to disable redirecting `stdout` and `stderr` to logcat.
### Commits
* [[`6de9bb6`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/6de9bb674e1d513547fcba2a62f0a91b556ea1d5)] - plugin: node.js entrypoint filename as argument (Jaime Bernardo)
* [[`b7f145d`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/b7f145d9945df4794f02ef1a98529b623df93958)] - plugin: Add options argument to start methods (Jaime Bernardo)
* [[`ae837b2`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ae837b29c928bdd964db79abff06ddf925af097a)] - android: optimize assets copy (Enrico Giordani)
* [[`c32ace3`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/c32ace3e432f9ee29f5c05964f12c966611a5ddf)] - rn: add requiresMainQueueSetup and update to 0.52 (Rayron Victor)
## 2017-10-31, Version 0.1.2
### Notable Changes
* Update `nodejs-mobile` binaries to `v0.1.3`.
* Adds iOS simulator support.
* Updates node version and headers to `v8.6.0`.
* Shows stdout and stderr in Android logcat.
### Commits
* [[`3c5b16e`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/3c5b16e9a8a2b3eba3f513ad310adc433e0732d3)] - docs: Add mention to simulator support in README (Jaime Bernardo)
* [[`7069d4b`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/7069d4bd84d66c264eda7ea99599ef3957b36de9)] - core: update nodejs-mobile v0.1.3 (Jaime Bernardo)
* [[`70c9ac3`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/70c9ac3798ca1fa06447ffb5430a1ba7259bccbc)] - bridge: emit message event inside a setImmediate (Jaime Bernardo)
* [[`e5fbfd0`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/e5fbfd0748757a9c77dc57e4b6c11a68d13aaeac)] - android: Redirect stdout and stderr to logcat (Jaime Bernardo)
* [[`ece0079`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/ece0079d9cd798e045936048c4f65788554090de)] - meta: Update package.json fields (Jaime Bernardo)
* [[`1a5cf5e`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/1a5cf5e3c8d11a92eb88726dbb301a15dc30efa4)] - meta: Add Reporting Issues section to README.md (Jaime Bernardo)
* [[`da767ba`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/da767babc69b59e4efd9ef244766dbbf75999cc5)] - Create LICENSE (Alexis Campailla)
## 2017-10-02, Version 0.1.1
### Notable Changes
* Initial release.
### Commits
* [[`d1601e4`](https://github.com/janeasystems/nodejs-mobile-react-native/commit/d1601e494cf14ae4704ee7e781b0b89a645f5c50)] - Initial commit for the React Native Module (Jaime Bernardo)
================================================
FILE: LICENSE
================================================
MIT License
Copyright (c) 2017 Janea Systems, Inc. and Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
================================================
FILE: README.md
================================================
[](https://www.repostatus.org/#unsupported)
:warning: The project is no longer being actively maintained by Janea Systems.
Forks of the repos have been created on a dedicated Github org to allow community-driven development to continue:
https://github.com/nodejs-mobile
# The Node.js for Mobile Apps React Native plugin
## Reporting Issues
We have a [central repo](https://github.com/janeasystems/nodejs-mobile/issues) where we manage all the issues related to Node.js for Mobile Apps, including issues specific to this plugin. Please, report your issue [there](https://github.com/janeasystems/nodejs-mobile/issues).
## Installation
`$ npm install nodejs-mobile-react-native --save`
For iOS, run `pod install` for linking the native code parts:
`$ cd iOS && pod install`
### iOS
Universal binaries are included in the plugin, so you can run in both iOS simulators and devices.
`nodejs-mobile-react-native` supports iOS 11.0 or later. In order to archive the application, the deployment target needs to be `iOS 11.0` or later.
### Android
You may need to open your app's `/android` folder in `Android Studio`, so that it detects, downloads and cofigures requirements that might be missing, like the `NDK` and `CMake` to build the native code part of the project.
You can also set the environment variable `ANDROID_NDK_HOME`, as in this example:
```sh
export ANDROID_NDK_HOME=/Users/username/Library/Android/sdk/ndk-bundle
```
## Usage
### `Node.js` project
When `nodejs-mobile-react-native` was installed through npm, it created a `nodejs-assets/nodejs-project/` path inside your application. This path will be packaged with your application and the background project will be started using the `main.js` file inside. It contains a `sample-main.js` and `sample-package.json` files under `nodejs-assets/nodejs-project/`.
The `sample-main.js` and `sample-package.json` files contain a sample echo project. We advise to rename `sample-main.js` to `main.js` and `sample-package.json` to `package.json` to get you started easily.
> Attention: The `sample-main.js` and `sample-package.json` will be overwritten with installs/updates of `nodejs-mobile-react-native`.
The sample `main.js` contents:
```js
var rn_bridge = require('rn-bridge');
// Echo every message received from react-native.
rn_bridge.channel.on('message', (msg) => {
rn_bridge.channel.send(msg);
} );
// Inform react-native node is initialized.
rn_bridge.channel.send("Node was initialized.");
```
Recent versions of `react-native` (since 0.57) throw an error during the bundling of the project. Please look at [the Troubleshooting Duplicate module name section](#duplicate-module-name) for instructions on how to configure the `react-native` bundler to ignore the `nodejs-project` folder.
The Node.js runtime accesses files through Unix-based pathnames, so in Android the node project is copied from the project's apk assets into the default application data folder at startup, during the first run or after an update, under `nodejs-project/`.
> Attention: Given the project folder will be overwritten after each application update, it should not be used for persistent storage.
To expedite the process of extracting the assets files, instead of parsing the assets hierarchy, a list of files `file.list` and a list of folders `dir.list` are created when the application is compiled and then added to the application assets. On Android 6.x and older versions, this allows to work around a serious perfomance bug in the Android assets manager.
#### Node Modules
Node modules can be added to the project using `npm install` inside `nodejs-assets/nodejs-project/`, as long as there's a `package.json` already present.
#### Native Modules
On Linux and macOS, there is support for building modules that contain native code.
The plugin automatically detects native modules inside your `nodejs-project` folder by searching for `.gyp` files. It's recommended to have the build prerequisites mentioned in `nodejs-mobile` for [Android](https://github.com/janeasystems/nodejs-mobile#prerequisites-to-build-the-android-library-on-linux-ubuntudebian) and [iOS](https://github.com/janeasystems/nodejs-mobile#prerequisites-to-build-the-ios-framework-library-on-macos). For Android it's also recommended that you set the `ANDROID_NDK_HOME` environment variable in your system.
Building native modules for Android can take a long time, since it depends on building a standalone NDK toolchain for each required architecture. The resulting `.node` binaries are then included in the final application in a separate asset path for each architecture and the correct one will be chosen at runtime.
While the plugin tries to detect automatically the presence of native modules, there's a way to override this detection and turn the native modules build process on or off, by creating the `nodejs-assets/BUILD_NATIVE_MODULES.txt` file and setting its contents to `1` or `0`, respectively. This can be used to start your application like this:
```sh
echo "1" > nodejs-assets/BUILD_NATIVE_MODULES.txt
react-native run-android
```
```sh
echo "1" > nodejs-assets/BUILD_NATIVE_MODULES.txt
react-native run-ios
```
### `React-Native` application
To communicate with Node.js from your `react-native` application, first import `nodejs-mobile-react-native`.
```js
import nodejs from 'nodejs-mobile-react-native';
```
Then add this to your Application's main component's `componentWillMount` lifecycle event:
```js
componentWillMount()
{
nodejs.start("main.js");
nodejs.channel.addListener(
"message",
(msg) => {
alert("From node: " + msg);
},
this
);
}
```
This will tell the native code to start a dedicated thread running Node.js starting at the `main.js` file in `nodejs-assets/nodejs-project/`, as described above. It will then register a listener to show alert boxes with each message sent from Node.js.
> Attention: The Node.js project runs on a dedicated thread and as a singleton, so only the first `nodejs.start()` command will make any effect, as further calls will not start new threads. This means that if you use `react-native`'s hotreload functionality you won't see any changes in the Node.js project.
We can then define a button in our interface to send messages to our Node.js project:
```js