Reviewed by Timothy.
[WebKit-https.git] / JavaScriptCore / README-Win32.txt
1 Notes about building JavaScriptCore on Win32:
2
3 The build has been tested with Visual Studio 2003 (7.1) and Visual Studio
4 2005 Beta 2. It should also work with Microsft's free
5 http://msdn.microsoft.com/visualc/vctoolkit2003 (which is basically
6 the same compiler & linker that is a part of VS 2003 but without the IDE)
7 but it has not been tested.
8
9 It doesn't build with VS 6.
10
11 To build:
12  * make sure that the tools are in the path. VS comes with vcvars32.bat
13    batch file somewhere under installation directory which sets all the
14    proper env variables. I usually rename it to e.g. vc7.bat and put
15    in my %PATH% for easy invocation)
16  * you need to download ICU (http://www-306.ibm.com/software/globalization/icu/index.jsp)
17    pre-built DLLs and header files. I've tested it with VS 7.1
18    (ftp://ftp.software.ibm.com/software/globalization/icu/3.4/icu-3.4-Win32-msvc7.1.zip)
19    Set ICUDIR to where you've downloaded the files.
20  * you need perl for generating *.lut.h files
21  * you need bison for generating parser from grammar.y (I use http://gnuwin32.sourceforge.net/packages/bison.htm)
22  * nmake -f Makefile.vc clean
23  * nmake -f Makefile.vc
24  or
25  * nmake -f Makefile.vc DEBUG=1
26
27 What do you get: in bin subdirectory you'll find testkjs.exe executable
28 which is a javascript interpreter. It can be used to run javascript
29 tests in tests\mozilla (see \WebKitTools\scripts\run-javascriptcore-tests
30 for an example on how to run them; you can use this script if you
31 just replace "testkjs" with a full path to testkjs.exe.
32
33 TODO
34
35 Currently only testkjs.exe is built. It should also build a static
36 .lib library so that it's easy to build programs incorporating the core.
37 It should also build as a dynamic DLL. It's just a matter of fiddling
38 with the makefile.