$ npm install -g node-gyp

Du skal også installere:

• • Python (v2.7.3 anbefales, v3.x.x er ikke understøttet)
  • Windows XP/Vista/7:
    • Microsoft Visual Studio C++ 2010 (Express-versionen fungerer godt)
    • For 64-bit builds af node- og native moduler skal du også bruge Windows 7 64-bit SDK
      • Hvis installationen mislykkes, skal du prøve at afinstallere enhver C++ 2010 x64&x86 Redistributable, som du har installeret, først.
    • Hvis du får fejl om, at 64-bit compilere ikke er installeret, har du muligvis også brug for compileropdateringen til Windows SDK 7.1
  • Windows 7/8:
    • Microsoft Visual Studio C++ 2012 for Windows Desktop (Express-versionen fungerer godt)

Bemærk, at OS X blot er en variant af Unix og derfor har brug for python, make og C/C++.En nem måde at få disse på er at installere XCode fra Apple,og derefter bruge den til at installere kommandolinjeværktøjerne (under Preferences -> Downloads).

Sådan bruger du

For at kompilere din native tilføjelse skal du først gå til dens rodmappe:

$ cd my_node_addon

Det næste trin er at generere de relevante projektbygningsfiler til den aktuelle platform. Brug configure til det:

$ node-gyp configure

Bemærk: Trin configure leder efter filen binding.gyp i den aktuellemappe til processs. Se nedenfor for instruktioner om oprettelse af binding.gyp-filen.

Nu har du enten en Makefile (på Unix-platforme) eller en vcxproj-fil(på Windows) i build/-mappen. Dernæst påkalder du kommandoen build:

$ node-gyp build

Nu har du din kompilerede .node bindingsfil! De kompilerede bindinger ender i build/Debug/ eller build/Release/, afhængigt af byggetilstand. På dette tidspunkt kan du kræve .node-filen med Node og køre dine tests!

OBS: For at oprette en Debug-bygning af bindingsfilen, skal du indsætte kontakten --debug (eller-d), når du kører enten configure eller build-kommandoen.

Filen “binding.gyp”

Tidligere, da Node havde node-waf, skulle du skrive en wscript-fil. I stedet for det er binding.gyp-filen, som beskriver konfigurationen til at bygge dit modul i et JSON-lignende format. Denne fil placeres i roden af din pakke, sammen med filen package.json.

En barebones gyp-fil, der er velegnet til at bygge en nodetilføjelse, ser således ud:

{ "targets": } ]}

Nogle yderligere ressourcer til at skrive gyp-filer:

• “Hello World” nodetilføjelse eksempel
• gyp brugerdokumentation
• gyp inputformat reference
• “binding.gyp” filer out in the wild wikiside

Kommandoer

node-gyp reagerer på følgende kommandoer:

Licens

(MIT-licensen)

Copyright (c) 2012 Nathan Rajlich <[email protected]>

Permission er hermed givet, gratis til enhver person, der modtager en kopi af denne software og tilhørende dokumentationsfiler (softwaren), til at handle med softwaren uden begrænsning, herunder uden begrænsning retten til at bruge, kopiere, ændre, sammenføje, offentliggøre, distribuere, underlicensere og/eller sælge kopier af softwaren og til at tillade personer, som softwaren leveres til, at gøre dette, med forbehold af følgende betingelser:

Overstående meddelelse om ophavsret og denne meddelelse om tilladelse skal være indeholdt i alle kopier eller væsentlige dele af softwaren.

SOFTWAREN LEVERES “SOM DEN ER”, UDEN NOGEN FORM FOR GARANTI, UDTRYKKELIG ELLER UNDERFORSTÅET, HERUNDER, MEN IKKE BEGRÆNSET TIL, GARANTIERNE FOR SALGBARHED, EGNETHED TIL ET BESTEMT FORMÅL OG IKKE-KRÆNKELSE. UNDER INGEN OMSTÆNDIGHEDER ER FORFATTERNE ELLER INDEHAVERNE AF OPHAVSRETTEN ANSVARLIGE FOR KRAV, SKADER ELLER ANDET ANSVAR, UANSET OM DET ER I ET KONTRAKTLIGT, ERSTATNINGSRETLIGT ELLER ANDET, DER OPSTÅR AF, UD AF ELLER I FORBINDELSE MED SOFTWAREN ELLER BRUGEN ELLER ANDEN HANDEL MED SOFTWAREN.