Skip to content

doc: add ccache 4 windows for speeding up buiding section #52255

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
congzhangzh wants to merge 10 commits into from
Closed

doc: add ccache 4 windows for speeding up buiding section #52255

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
7b17abd
doc: add ccache suport 4 windows
congzhangzh Mar 28, 2024
2d7668a
doc: minor fix
congzhangzh Mar 28, 2024
70a6f1a
Merge branch 'nodejs:main' into doc_buiding_speed_up_4_windows
congzhangzh Mar 30, 2024
512436f
doc: speed building on windows platform
congzhangzh Mar 30, 2024
a0e6ef0
doc: fix lint-md failed
congzhangzh Mar 30, 2024
05ccae1
Merge branch 'nodejs:main' into doc_buiding_speed_up_4_windows
congzhangzh Mar 30, 2024
ea09c43
Merge branch 'nodejs:main' into doc_buiding_speed_up_4_windows
congzhangzh Mar 30, 2024
28900c9
doc: minor fix
congzhangzh Mar 30, 2024
8902e84
Merge branch 'nodejs:main' into doc_buiding_speed_up_4_windows
congzhangzh Apr 4, 2024
f1725db
Merge branch 'nodejs:main' into doc_buiding_speed_up_4_windows
congzhangzh Apr 4, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
doc: speed building on windows platform
  • Loading branch information
@congzhangzh
congzhangzh authored Mar 30, 2024
commit 512436f235242397e8896cb9bfc0a4f79787c03e
31 changes: 8 additions & 23 deletions BUILDING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -559,32 +559,17 @@ export LDFLAGS="-fuse-ld=mold" # add to ~/.zshrc or other shell config file

On Windows:

Tips: follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>
Tips: follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>, and you should
notice that obj file will be bigger the normal one.

First, create props\_4\_ccache.props, which is a props to force using old
debug format needed by ccache

```bash
tee props_4_ccache.props <<'EOF'
<Project>
<ItemDefinitionGroup>
<ClCompile>
<!-- /Z7 of cl.exe, ref: https://learn.microsoft.com/en-us/cpp/build/reference/z7-zi-zi-debug-information-format -->
<DebugInformationFormat>OldStyle</DebugInformationFormat>
<ObjectFileName>$(IntDir)%(FileName).obj</ObjectFileName>
</ClCompile>
</ItemDefinitionGroup>
</Project>
EOF
```

Second, set msbuild\_args to enable ccache, assume ccache install on c:\ccache,
and copy c:\ccache\ccache.exe to c:\ccache\cl.exe
First, install ccache, assume ccache install to c:\ccache， copy c:\ccache\ccache.exe
to c:\ccache\cl.exe

```powershell
set ccache_path=c:\ccache\
set props_4_ccache_path=%CD%\props_4_ccache.props
set msbuild_args=/p:UseMultiToolTask=True /p:TrackFileAccess=false /p:CLToolPath=%ccache_path% /p:ForceImportAfterCppProps=%props_4_ccache_path%
set TrackFileAccess=false
set UseMultiToolTask=True
Comment thread
congzhangzh marked this conversation as resolved.
Outdated
set CLToolPath=c:\ccache\
set ForceImportAfterCppProps=%CD%\tools\msvc\props_4_ccache.props
# run vcbuild to build node, rerun should be fast even after out dir be deleted
.\vcbuild
```
Expand Down
9 changes: 9 additions & 0 deletions tools/msvs/props_4_ccache.props
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<Project>
<ItemDefinitionGroup>
<ClCompile>
<!-- /Z7 of cl.exe, ref: https://learn.microsoft.com/en-us/cpp/build/reference/z7-zi-zi-debug-information-format -->
<DebugInformationFormat>OldStyle</DebugInformationFormat>
<ObjectFileName>$(IntDir)%(FileName).obj</ObjectFileName>
</ClCompile>
</ItemDefinitionGroup>
</Project>