1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
# Windows Build Instructions
## Setting up Windows
You must set your Windows system locale to English, or else you may get
build errors about "The file contains a character that cannot be
represented in the current code page."
### Setting up the environment for Visual Studio
You must build with Visual Studio 2013 Update 4 or Visual Studio 2015
Update 1, no other versions are supported.
You must have Windows 7 x64 or later. x86 OSs are unsupported.
1. Get
[depot\_tools](http://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up).
2. Follow the appropriate path below:
### Open source contributors
####For building with Visual Studio 2015 (default compiler as of March 11, 2016):
> Install Visual Studio 2015 Update 2 or later - Community Edition
> should work if its license is appropriate for you. Use the Custom Install option
> and select:
>
> - Visual C++, which will select three sub-categories including MFC
> - Universal Windows Apps Development Tools > Tools
> - Universal Windows Apps Development Tools > Windows 10 SDK (10.0.10586)
>
> You must have the 10586 SDK installed or else you will hit compile errors such
> as redefined macros.
#### For building with Visual Studio 2013 (no longer default as of March 11, 2016, and not recommended - requires setting `GYP_MSVS_VERSION=2013`):
> Install [Visual Studio 2013
> Community](http://www.visualstudio.com/products/visual-studio-community-vs)
> or [Visual Studio 2013
> Professional](http://www.visualstudio.com/products/visual-studio-professional-with-msdn-vs)
> depending on which license is appropriate for you. You can deselect
> the default options if you want, but you must make sure to install
> "Microsoft Foundation Classes for C++".
>
> You should also install the [Windows 10
> SDK](https://dev.windows.com/en-us/downloads/windows-10-sdk) to the
> default install location. You must have SDK version 10.0.10586 or
> greater installed.
Run `set DEPOT_TOOLS_WIN_TOOLCHAIN=0`, or set that variable in your
global environment.
Visual Studio Express 2013 is **not** supported and will not be able to
build Chromium.
Compilation is done through ninja, **not** Visual Studio.
### Google employees
Run: `download_from_google_storage --config` and follow the
authentication instructions. **Note that you must authenticate with your
@google.com credentials**, not @chromium.org. Enter "0" if asked for a
project-id.
Once you've done this, the toolchain will be installed automatically for
you in Step 3, below (near the end of the step).
The toolchain will be in `depot_tools\win_toolchain`, and windbg can be
found in `depot_tools\win_toolchain\vs2013_files\win8sdk\Debuggers`.
If you want the IDE for debugging and editing, you will need to install
it separately, but this is optional and not needed to build Chromium.
## Getting the Code
Follow the steps to [check out the
code](https://www.chromium.org/developers/how-tos/get-the-code) (largely
`fetch chromium`).
## Building
Build the target you are interested in.
```shell
ninja -C out\Debug chrome
```
Alternative (Graphical user interface): Open a generated .sln
file such as all.sln, right-click the chrome project and select build.
This will invoke the real step 4 above. Do not build the whole solution
since that conflicts with ninja's build management and everything will
explode.
Substitute the build directory given to `-C` with `out\Debug_x64` for
[64-bit
builds](https://www.chromium.org/developers/design-documents/64-bit-support)
in GYP, or whatever build directory you have configured if using GN.
### Performance tips
1. Have a lot of fast CPU cores and enough RAM to keep them all busy.
(Minimum recommended is 4-8 fast cores and 16-32 GB of RAM)
2. Reduce file system overhead by excluding build directories from
antivirus and indexing software.
3. Store the build tree on a fast disk (preferably SSD).
4. If you are primarily going to be doing debug development builds, you
should use the component build:
- for [GYP](https://www.chromium.org/developers/gyp-environment-variables)
set `GYP_DEFINES=component=shared_library`
- for [GN](https://www.chromium.org/developers/gn-build-configuration),
set the build arg `is_component_build = true`.
This will generate many DLLs and enable incremental linking, which makes
linking **much** faster in Debug.
Still, expect build times of 30 minutes to 2 hours when everything has to
be recompiled.
|
