blob: ea6287f7b7251065715d1a566cc043fd2e93458e [file] [log] [blame]
Ben Murdochb0fe1622011-05-05 13:52:32 +01001This directory contains the V8 GYP files used to generate actual project files
2for different build systems.
3
4This is currently work in progress but this is expected to replace the SCons
5based build system.
6
7To use this a checkout of GYP is needed inside this directory. From the root of
Ben Murdoch257744e2011-11-30 15:57:28 +00008the V8 project do the following:
Ben Murdochb0fe1622011-05-05 13:52:32 +01009
10$ svn co http://gyp.googlecode.com/svn/trunk build/gyp
11
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000012Note for the command lines below that Debug is the default configuration,
13so specifying that on the command lines is not required.
Ben Murdochb0fe1622011-05-05 13:52:32 +010014
Ben Murdochb0fe1622011-05-05 13:52:32 +010015
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000016To generate Makefiles on Linux:
17-------------------------------
Ben Murdochb0fe1622011-05-05 13:52:32 +010018
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000019$ build/gyp_v8
Ben Murdochb0fe1622011-05-05 13:52:32 +010020
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000021This will build makefiles for ia32, x64 and the ARM simulator with names
22Makefile-ia32, Makefile-x64 and Makefile-armu respectively.
Ben Murdochb0fe1622011-05-05 13:52:32 +010023
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000024To build and run for ia32 in debug and release version do:
25
26$ make -f Makefile-ia32
27$ out/Debug/shell
28$ make -f Makefile-ia32 BUILDTYPE=Release
29$ out/Release/shell
30
31Change the makefile to build and run for the other architectures.
32
33
34To generate Xcode project files on Mac OS:
35------------------------------------------
36
37$ build/gyp_v8
38
39This will make an Xcode project for the ia32 architecture. To build and run do:
40
41$ xcodebuild -project build/all.xcodeproj
42$ samples/build/Debug/shell
43$ xcodebuild -project build/all.xcodeproj -configuration Release
44$ samples/build/Release/shell
45
Ben Murdoch257744e2011-11-30 15:57:28 +000046
47To generate Visual Studio solution and project files on Windows:
48----------------------------------------------------------------
49
50On Windows an additional third party component is required. This is cygwin in
51the same version as is used by the Chromium project. This can be checked out
52from the Chromium repository. From the root of the V8 project do the following:
53
54> svn co http://src.chromium.org/svn/trunk/deps/third_party/cygwin@66844 third_party/cygwin
55
Ben Murdoch589d6972011-11-30 16:04:58 +000056To run GYP Python is required and it is recommended to use the same version as
Ben Murdoch257744e2011-11-30 15:57:28 +000057is used by the Chromium project. This can also be checked out from the Chromium
58repository. From the root of the V8 project do the following:
59
Ben Murdoch589d6972011-11-30 16:04:58 +000060> svn co http://src.chromium.org/svn/trunk/tools/third_party/python_26@89111 third_party/python_26
Ben Murdoch257744e2011-11-30 15:57:28 +000061
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000062Now generate Visual Studio solution and project files for the ia32 architecture:
Ben Murdoch257744e2011-11-30 15:57:28 +000063
Ben Murdoch3fb3ca82011-12-02 17:19:32 +000064> third_party\python_26\python build/gyp_v8
Ben Murdoch257744e2011-11-30 15:57:28 +000065
66Now open build\All.sln in Visual Studio.