GYP can Generate Your Projects.
It is a pre-build system that uses a json config to generate optimized project files for various build tools like make, xcode, visual studio.
For example, it is able to generate make or scons files that run fast.
It is also able to generate xcode and visual studio files.
It's a bit like cmake, except: http://code.google.com/p/gyp/wiki/GypVsCMake
This demo shows how to build:
- a hello world c++ library (called 'mylib')
- a command line program that uses/links to it
- a node.js module that depends on mylib via it gyp file
See also:
Just grab this sample project and build it:
git clone git://github.com/springmeyer/hello-gyp.git
cd hello-gyp
make
To learn more about how to do this manually, or for different plaforms, read on.
The below commands assume you have gyp installed globally. You can do this like:
git clone https://chromium.googlesource.com/external/gyp.git
cd gyp
sudo python setup.py install
gyp mylib.gyp --depth=. -f make --generator-output=./build/makefiles
V=1 make -C ./build/makefiles/
$ ./build/makefiles/out/Release/myapp
hello
And the node module:
npm install node-gyp
node_modules/.bin/node-gyp configure build
Test the node module:
$ node -e "console.log(require('./build/Release/modulename.node').hello())"
hello
gyp mylib.gyp --depth=. -f scons --generator-output=./build/sconsfiles
scons -C ./build/sconsfiles/
$ ./build/sconsfiles/Release/myapp
hello
gyp mylib.gyp --depth=. -f xcode --generator-output=./build/xcodefiles
xcodebuild -project ./build/xcodefiles/mylib.xcodeproj
# xcode does not respect subdirectory so `build` goes into the main directory
$ ./build/Release/myapp
hello
Ninja is a build system designed to be ultra fast.
Install it like:
git clone git://github.com/martine/ninja.git
cd ninja
./bootstrap.py
cp ninja /usr/local/bin/
Make sure it works:
$ ninja
ninja: no work to do.
Now go back to the hello-gyp project folder and build the sample:
gyp mylib.gyp --depth=. -f ninja
ninja -v -C out/Release/ -f build.ninja
$ ./out/Release/myapp
hello
Note, this assumes you've downloaded and installed the free 2010 C++ studio.
python gyp/gyp mylib.gyp --depth=. -f msvs -G msvs_version=2010
msbuild mylib.sln
c:\hello-gyp>Release\myapp.exe
hello
Other formats are some some gyp-specific debugging output