AuroraMiddleware/scuffed-code
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
abdf0e667d
scuffed-code/docs/ide4c/vscode
History
Hugo van der Merwe 8e2651828a ICU-21137 Adjust VSCode IDE settings and README. 
ICU Pull Request #1159.

- Set intltest's Current Working Directory correctly to enable finding
  resources.
- Adds c_cpp_properties.json, primarily for the includePath settings.
- Load average takes a while to respond, specify -j24 to always limit
  parallel jobs to a maximum of 24.
- make's "-l" parameter is system load average, not CPU percentage.
  A load average of 90 makes my laptop unusable, changing to -l20.
- Make running all tests the unit-testing default.
- Document the adjustments that can be made in the README.
- Skip these json files when checking for copyright notices. Pure json
  does not permit comments, so c_cpp_properties.json cannot have
  comments.
- defines += U_DISABLE_RENAMING=1 to simplify reference following.

Rebased from 00a5d6dd5c.
2020-06-18 03:15:42 +02:00
..
c_cpp_properties.json ICU-21137 Adjust VSCode IDE settings and README. 2020-06-18 03:15:42 +02:00
launch.json ICU-21137 Adjust VSCode IDE settings and README. 2020-06-18 03:15:42 +02:00
README.md ICU-21137 Adjust VSCode IDE settings and README. 2020-06-18 03:15:42 +02:00
tasks.json ICU-21137 Adjust VSCode IDE settings and README. 2020-06-18 03:15:42 +02:00

README.md

Configuring VS Code for ICU4C

  • Create a .vscode folder in icu4c/source
  • Copy the tasks.json, launch.json and c_cpp_properties.json files into the .vscode folder.
  • To test only specific test targets, specify them under args in launch.json.
  • To adjust the parallelism when building, adjust the args in tasks.json.
    • -l20 tells VSCode to not launch jobs if the system load average is above 20 (note that the system load average is not a CPU usage percentage).
    • -j24 limits the number of jobs launched in parallel to 24. The system load average takes a while to respond, reducing this number helps the initial bad system performance when a new build is launched.

NOTE: Run the ./runConfigureICU command before building icu4c from VSCode.