nodejs / node-gyp

node-gyp é uma ferramenta de linha de comando multi-plataforma escrita em Node.js para compilação de módulos addon nativos para Node.js. Ele contém uma cópia vendida do projeto thegyp-next que foi usado anteriormente pela equipe Chromium, estendida para suportar o desenvolvimento de addons nativos do Node.js.

Nota que node-gyp não é usada para construir o próprio Node.js.

Versões alvo múltiplas do Node.js são suportadas (ou seja, 0.8, …, 4, 5, 6,etc.), independentemente de qual versão do Node.js está realmente instalada no seu sistema(node-gyp descarrega os ficheiros de desenvolvimento ou cabeçalhos necessários para a versão alvo).

Características

• Os mesmos comandos de compilação funcionam em qualquer uma das plataformas suportadas
• Suporta a segmentação de diferentes versões do Node.js

Instalação

Pode instalar node-gyp usando :

npm install -g node-gyp

Dependente do seu sistema operativo, terá de instalar:

Em Unix

• Python v3.6, v3.7, v3.8, ou v3.9
• make
• Uma cadeia de ferramentas do compilador C/C++, como GCC

Em macOS

ATENÇÃO: Se o seu Mac foi actualizado para macOS Catalina (10.15), por favor leia macOS_Catalina.md.

• Python v3.6, v3.7, v3.8, ou v3.9
• Xcode
  • É necessário também instalar o XCode Command Line Tools, executando xcode-select --install. Alternativamente, se você já tiver o Xcode completo instalado, você pode encontrá-los no menu Xcode -> Open Developer Tool -> More Developer Tools.... Este passo irá instalar clang, clang++, e make.

No Windows

Instalar a versão atual do Python a partir do pacote Microsoft Store.

Instalar ferramentas e configuração manualmente:

• Instalar o Ambiente de Compilação Visual C++: Visual Studio Build Tools(usando a carga de trabalho “Visual C++ build tools”) ou Visual Studio 2017 Community(usando a carga de trabalho “Desktop development with C++”)
• Launch cmd, npm config set msvs_version 2017

Se os passos acima não funcionaram para você, visite o Node.js Guidelines for Windows da Microsoft para obter dicas adicionais.

Para ter como alvo o Node.js nativo do ARM64 no Windows 10 no ARM, adicione os componentes “Visual C++ compiladores e bibliotecas para o ARM64” e “Visual C++ ATL para o ARM64”.

Configurar a dependência do Python

node-gyp requer que você tenha instalado uma versão compatível do Python, uma das seguintes: v3.6, v3.7,v3.8, ou v3.9. Se você tiver múltiplas versões Python instaladas, você pode identificar qual versão Pythonversion node-gyp deve usar de uma das seguintes maneiras:

1. definindo a opção de linha de comando --python, e.g.:

node-gyp <command> --python /path/to/executable/python

1. Se node-gyp for chamado por meio de npm, e você tiver múltiplas versões de Python instaladas, então você pode definir a chave de configuração ‘python’ de npm para o valor apropriado:

npm config set python /path/to/executable/python

1. Se a variável de ambiente PYTHON for definida para o caminho de um executável Python, então essa versão será usada, se for uma versão compatível.

2. Se a variável de ambiente NODE_GYP_FORCE_PYTHON estiver definida para o caminho de um executável Python, ela será usada ao invés de qualquer outro caminho de pesquisa Python configurado oubuiltin Python. Se não for uma versão compatível, nenhuma pesquisa adicional será feita.

Como Usar

Para compilar seu addon nativo, primeiro vá para seu diretório raiz:

cd my_node_addon

> O próximo passo é gerar os arquivos de compilação de projeto apropriados para a plataforma atual. Use configure para isso:

node-gyp configure

Auto-detecção falha para Visual C+++ Build Tools 2015, então --msvs_version=2015necessário adicionar (não necessário quando executado por npm como configurado acima):

node-gyp configure --msvs_version=2015

node-gyp build

{ "targets": } ]}

export npm_config_devdir=/tmp/.gyp

set npm_config_devdir=c:\temp\.gyp

npm config set devdir /tmp/.gyp