The data contained in this repository can be downloaded to your computer using one of several clients.
Please see the documentation of your version control software client for more information.
Please select the desired protocol below to get the URL.
This URL has Read-Only access.
main_repo / deps / v8 / tools / visual_studio / README.txt @ 40c0f755
History | View | Annotate | Download (3.07 KB)
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. |