README.txt
1 This directory contains Microsoft Visual Studio project files for including v8 2 in a Visual Studio/Visual C++ Express solution. All these project files have 3 been created for use with Microsoft Visual Studio 2005. They can however also 4 be used in both Visual Studio 2008 and Visual C++ 2008 Express Edition. When 5 using the project files in the 2008 editions minor upgrades to the files will 6 be performed by Visual Studio. 7 8 v8_base.vcproj 9 -------------- 10 Base V8 library containing all the V8 code but no JavaScript library code. This 11 includes third party code for string/number convertions (dtoa). 12 13 v8.vcproj 14 --------- 15 V8 library containing all the V8 and JavaScript library code embedded as source 16 which is compiled as V8 is running. 17 18 v8_mksnapshot.vcproj 19 -------------------- 20 Executable v8_mksnapshot.exe for building a heap snapshot from a running V8. 21 22 v8_snapshot_cc.vcproj 23 --------------------- 24 Uses v8_mksnapshot.exe to generate snapshot.cc, which is used in 25 v8_snapshot.vcproj. 26 27 v8_snapshot.vcproj 28 ------------------ 29 V8 library containing all the V8 and JavaScript library code embedded as a heap 30 snapshot instead of source to be compiled as V8 is running. Using this library 31 provides significantly faster startup time than v8.vcproj. 32 33 The property sheets common.vsprops, debug.vsprops and release.vsprops contains 34 most of the configuration options and are inhireted by the project files 35 described above. The location of the output directory used are defined in 36 common.vsprops. 37 38 With regard to Platform SDK version V8 has no specific requriments and builds 39 with either what is supplied with Visual Studio 2005 or the latest Platform SDK 40 from Microsoft. 41 42 When adding these projects to a solution the following dependencies needs to be 43 in place: 44 45 v8.vcproj depends on v8_base.vcproj 46 v8_mksnapshot.vcproj depends on v8.vcproj 47 v8_snapshot_cc.vcproj depends on v8_mksnapshot.vcproj 48 v8_snapshot.vcproj depends on v8_snapshot_cc.vcproj and v8_base.vcproj 49 50 A project which uses V8 should then depend on v8_snapshot.vcproj. 51 52 If V8 without snapshot if preferred only v8_base.vcproj and v8.vcproj are 53 required and a project which uses V8 should depend on v8.vcproj. 54 55 Two sample project files are available as well. These are v8_shell_sample.vcproj 56 for building the sample in samples\shell.cc and v8_process_sample.vcproj for 57 building the sample in samples\process.cc. Add either of these (or both) to a 58 solution with v8_base, v8, v8_mksnapshot and v8_snapshot set up as described 59 solution with v8_base, v8, v8_mksnapshot and v8_snapshot set up as described 60 above and have them depend on v8_snapshot. 61 62 Finally a sample Visual Studio solution file for is provided. This solution file 63 includes the two sample projects together with the V8 projects and with the 64 dependencies configured as described above. 65 66 Python requirements 67 ------------------- 68 When using the Microsoft Visual Studio project files Python version 2.4 or later 69 is required. Make sure that python.exe is on the path before running Visual 70 Studio. The use of Python is in the command script js2c.cmd which is used in the 71 Custom Build Step for v8natives.js in the v8.vcproj project. 72
