a8d56df41e
When "README.md" is named "README-es.md", github doesn't show it's preview automatically. So I removed "-es" from all the docs.
2.3 KiB
Utilizando módulos Node nativos
Los módulos Node nativos son soportados por Electron, pero dado que Electron está utilizando una versión distinta de V8, debes especificar manualmente la ubicación de las cabeceras de Electron a la hora de compilar módulos nativos.
Compatibilidad de módulos nativos
A partir de Node v0.11.x han habido cambios vitales en la API de V8. Es de esperar que los módulos escritos para Node v0.10.x no funcionen con Node v0.11.x. Electron utiliza Node v.0.11.13 internamente, y por este motivo tiene el mismo problema.
Para resolver esto, debes usar módulos que soporten Node v0.11.x, muchos módulos soportan ambas versiones. En el caso de los módulos antiguos que sólo soportan Node v0.10.x, debes usar el módulo nan para portarlos a v0.11.x.
¿Cómo instalar módulos nativos?
La forma fácil
La forma más sencilla de recompilar módulos nativos es a través del paquete
electron-rebuild,
el cual abstrae y maneja los pasos de descargar las cabeceras y compilar los módulos nativos:
npm install --save-dev electron-rebuild
# Ejecuta esto cada vez que ejecutes npm install
./node_modules/.bin/electron-rebuild
La forma node-gyp
Para compilar módulos Node con las cabeceras de Electron, debes indicar a node-gyp
desde dónde descargar las cabeceras y cuál versión usar:
$ cd /path-to-module/
$ HOME=~/.electron-gyp node-gyp rebuild --target=0.29.1 --arch=x64 --dist-url=https://atom.io/download/atom-shell
Los cambios en HOME=~/.electron-gyp fueron para especificar la ruta de las cabeceras.
La opción --target=0.29.1 es la versión de Electron. La opción --dist-url=... especifica
dónde descargar las cabeceras. --arch=x64 indica que el módulo será compilado para un sistema de 64bit.
La forma npm
También puedes usar npm para instalar módulos, los pasos son exactamente igual a otros módulos Node,
con la excepción de que necesitas establecer algunas variables de entorno primero:
export npm_config_disturl=https://atom.io/download/atom-shell
export npm_config_target=0.29.1
export npm_config_arch=x64
HOME=~/.electron-gyp npm install module-name