esp-idf/tools/test_apps/system/cxx_build_test/README.md

| Supported Targets | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-P4 | ESP32-S2 | ESP32-S3 |
| ----------------- | ----- | -------- | -------- | -------- | -------- | --------- | -------- | -------- | -------- | -------- |

# C++ build test

This build-only app can be used to check if certain headers, macros or features can be successfully compiled in a C++ source file. It furthermore checks the current C++ language standard set in IDF is the expected one.

**Note:** C++ compatibility of all public header files is checked by [general public header check](../../../ci/check_public_headers.py) already.

## This App Broke My Build :(

It is possible that the language standard for IDF has been changed without changing the test in this application.

## Adding New Test
Create a new file `main/test_<name>.cpp` and add it to main/CMakeLists.txt. If you need to check specific compiler flags, use `set_source_files_properties` CMake function to adjust the compilation flags for the given source file.
feat(esp32c61): disable unsupported build test 2024-04-29 07:55:27 -04:00			`\| Supported Targets \| ESP32 \| ESP32-C2 \| ESP32-C3 \| ESP32-C5 \| ESP32-C6 \| ESP32-C61 \| ESP32-H2 \| ESP32-P4 \| ESP32-S2 \| ESP32-S3 \|`
			`\| ----------------- \| ----- \| -------- \| -------- \| -------- \| -------- \| --------- \| -------- \| -------- \| -------- \| -------- \|`
docs: changes docs supported targets tables 2022-07-12 22:41:36 -04:00
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00			`# C++ build test`

cmake: Corrected setting of C++ language standard * reverted old faulty mechanism to set different standard according to the toolchain * Using -std=gnu++2b now for both gcc and clang * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-28 03:01:15 -04:00			`This build-only app can be used to check if certain headers, macros or features can be successfully compiled in a C++ source file. It furthermore checks the current C++ language standard set in IDF is the expected one.`
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00
refactor(tools): public header check also checks c++ now * Also changed --only-dir argument to accept system-wide directories instead of directories from IDF root 2023-08-09 02:12:21 -04:00			`Note: C++ compatibility of all public header files is checked by [general public header check](../../../ci/check_public_headers.py) already.`

cmake: Corrected setting of C++ language standard * reverted old faulty mechanism to set different standard according to the toolchain * Using -std=gnu++2b now for both gcc and clang * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-28 03:01:15 -04:00			`## This App Broke My Build :(`
soc: make register access macros compatible with C++20 In C++20, using the result of an assignment to a 'volatile' value is deprecated. Breaking change: register "setter" or modification macros can no longer be used as expressions. Closes https://github.com/espressif/esp-idf/issues/9170 2022-06-17 10:43:31 -04:00
refactor(tools): public header check also checks c++ now * Also changed --only-dir argument to accept system-wide directories instead of directories from IDF root 2023-08-09 02:12:21 -04:00			`It is possible that the language standard for IDF has been changed without changing the test in this application.`
cmake: Corrected setting of C++ language standard * reverted old faulty mechanism to set different standard according to the toolchain * Using -std=gnu++2b now for both gcc and clang * Added a build test app to check the C++ standard in IDF * Updated english docs to reflect the change to C++23 2023-04-28 03:01:15 -04:00
			`## Adding New Test`
			Create a new file `main/test_<name>.cpp` and add it to main/CMakeLists.txt. If you need to check specific compiler flags, use `set_source_files_properties` CMake function to adjust the compilation flags for the given source file.