OpenEmbedded layer for latest Node.js releases.

ℹ️ As an official extension of this layer, installing meta-nodejs-contrib is highly recommended for community contributed Node.js based package recipes and Bitbake helper classes.

meta-nodejs depends on following layers:

• openembedded-core

Node.js v7 ships with V8 v5.5 that requires native (host) compilation of some internal build tools (mkpeephole and mksnapshot). These internal tools must be built with "bitness" matching the cross-compilation target (eg. 32-bit ARM).

If you encounter build errors related to mkpeephole or mksnapshot you most likely need to install appropriate multilib compilers and libraries to to your host system.

Prerequisites for compiling for 32-bit ARM with x86_64 Ubuntu 16.04 Xenial (or newer):

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install g  -multilib libssl-dev:i386 libcrypto  -dev:i386 zlib1g-dev:i386

• nodejs
• nodejs-npm
• nodejs-dtrace
• nodejs-systemtap
• nodejs-wafadmin (only with Node.js 0.8)

Layer installation varies depending on your OpenEmbedded distribution. These instructions are generic.

1. Fetch meta-nodejs layer from https://github.com/imyller/meta-nodejs.git

2. Add meta-nodejs layer to EXTRALAYERS in conf/bblayers.conf. For example:

   	EXTRALAYERS  =" \
   		${TOPDIR}/sources/meta-nodejs \
   	"

As an official extension of this layer, installing meta-nodejs-contrib is highly recommended for community contributed Node.js based package recipes and Bitbake helper classes.

To build latest stable Node.js package:

	bitbake nodejs

Add Node.js as a dependency in recipe with RDEPENDS (for runtime) or DEPENDS (for build):

	DEPENDS  = " nodejs"
	RDEPENDS_${PN}  = " nodejs"

Inherit npm-install build task class in your recipe.

meta-nodejs layer adds few Node.js related helper classes.

npm-base class defines following functions:

• oe_runnpm: call cross-compiling npm
• oe_runnpm_native: call native-compiling npm

For example:

  inherit npm-base

  do_install() {
	oe_runnpm install     # Installs dependencies defined in package.json
  }

• NPM_FLAGS: Extra command line arguments for npm calls made by oe_runnpm()
• NPM_ARCH: Override npm target architecture (defaults to TARGET_ARCH)
• NPM_REGISTRY: override npm registry URL

npm-install class inherits npm-base class and adds following build tasks (listed in their run order):

• npm_install: runs npm install in source directory
• npm_shrinkwrap: runs npm shrinkwrap in source directory
• npm_dedupe: runs npm dedupe in source directory

You can disable one or more of these build tasks in the recipe with do_<taskname>[noexec] = "1":

  do_npm_shrinkwrap[noexec] = "1"

• NPM_INSTALL_FLAGS: Extra command line arguments for npm calls made in npm_install task
• NPM_INSTALL: Parameters for npm install command (such as specific package names)

npm-install-global class inherits npm-base class and installs the selected package globally. This is done in the do_install task of the class.

• NPM_INSTALL_FLAGS: Extra command line arguments for npm calls made in do_install and do_configure task