@@ -40,6 +40,7 @@ file a new issue. |
40 | 40 | * [Option 2: Automated install with WinGet](#option-2-automated-install-with-winget) |
41 | 41 | * [Option 3: Automated install with Boxstarter](#option-3-automated-install-with-boxstarter) |
42 | 42 | * [Building Node.js](#building-nodejs-2) |
| 43 | + * [Using ccache](#using-ccache) |
43 | 44 | * [Android](#android) |
44 | 45 | * [`Intl` (ECMA-402) support](#intl-ecma-402-support) |
45 | 46 | * [Build with full ICU support (all locales supported by ICU)](#build-with-full-icu-support-all-locales-supported-by-icu) |
@@ -577,42 +578,6 @@ export CC="ccache cc" # add to ~/.zshrc or other shell config file |
577 | 578 | export CXX="ccache c++" # add to ~/.zshrc or other shell config file |
578 | 579 | ``` |
579 | 580 |
|
580 | | -On Windows: |
581 | | - |
582 | | -Follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>, and you |
583 | | -should notice that obj file will be bigger than the normal one. |
584 | | - |
585 | | -First, install ccache. Assuming the installation of ccache is in `c:\ccache` |
586 | | -(where you can find `ccache.exe`), copy `c:\ccache\ccache.exe` to `c:\ccache\cl.exe` |
587 | | -with this command. |
588 | | - |
589 | | -```powershell |
590 | | -cp c:\ccache\ccache.exe c:\ccache\cl.exe |
591 | | -``` |
592 | | - |
593 | | -With newer version of Visual Studio, it may need the copy to be `clang-cl.exe` |
594 | | -instead. If the output of `vcbuild.bat` suggestion missing `clang-cl.exe`, copy |
595 | | -it differently: |
596 | | - |
597 | | -```powershell |
598 | | -cp c:\ccache\ccache.exe c:\ccache\clang-cl.exe |
599 | | -``` |
600 | | - |
601 | | -When building Node.js, provide a path to your ccache via the option: |
602 | | - |
603 | | -```powershell |
604 | | -.\vcbuild.bat ccache c:\ccache\ |
605 | | -``` |
606 | | - |
607 | | -This will allow for near-instantaneous rebuilds when switching branches back |
608 | | -and forth that were built with cache. |
609 | | - |
610 | | -To use it with ClangCL, run this instead: |
611 | | - |
612 | | -```powershell |
613 | | -.\vcbuild.bat clang-cl ccache c:\ccache\ |
614 | | -``` |
615 | | - |
616 | 581 | ##### Loading JS files from disk instead of embedding |
617 | 582 |
|
618 | 583 | When modifying only the JS layer in `lib`, it is possible to externally load it |
@@ -810,6 +775,42 @@ To test if Node.js was built correctly: |
810 | 775 | Release\node -e "console.log('Hello from Node.js', process.version)" |
811 | 776 | ``` |
812 | 777 |
|
| 778 | +##### Using ccache: |
| 779 | + |
| 780 | +Follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>, and you |
| 781 | +should notice that obj file will be bigger than the normal one. |
| 782 | + |
| 783 | +First, install ccache. Assuming the installation of ccache is in `c:\ccache` |
| 784 | +(where you can find `ccache.exe`), copy `c:\ccache\ccache.exe` to `c:\ccache\cl.exe` |
| 785 | +with this command. |
| 786 | + |
| 787 | +```powershell |
| 788 | +cp c:\ccache\ccache.exe c:\ccache\cl.exe |
| 789 | +``` |
| 790 | + |
| 791 | +With newer version of Visual Studio, it may need the copy to be `clang-cl.exe` |
| 792 | +instead. If the output of `vcbuild.bat` suggestion missing `clang-cl.exe`, copy |
| 793 | +it differently: |
| 794 | + |
| 795 | +```powershell |
| 796 | +cp c:\ccache\ccache.exe c:\ccache\clang-cl.exe |
| 797 | +``` |
| 798 | + |
| 799 | +When building Node.js, provide a path to your ccache via the option: |
| 800 | + |
| 801 | +```powershell |
| 802 | +.\vcbuild.bat ccache c:\ccache\ |
| 803 | +``` |
| 804 | + |
| 805 | +This will allow for near-instantaneous rebuilds when switching branches back |
| 806 | +and forth that were built with cache. |
| 807 | + |
| 808 | +To use it with ClangCL, run this instead: |
| 809 | + |
| 810 | +```powershell |
| 811 | +.\vcbuild.bat clang-cl ccache c:\ccache\ |
| 812 | +``` |
| 813 | + |
813 | 814 | ### Android |
814 | 815 |
|
815 | 816 | Android is not a supported platform. Patches to improve the Android build are |
|