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