qt5base-lts/coin/instructions
Joerg Bornemann fb21a5ce1a CMake: Name QT_NO_MAKE_*/BUILD_* variables consistently
For consistency, apply the following renamings:
QT_NO_MAKE_EXAMPLES -> QT_BUILD_EXAMPLES_BY_DEFAULT
QT_NO_MAKE_TESTS    -> QT_BUILD_TESTS_BY_DEFAULT
QT_NO_MAKE_TOOLS    -> QT_BUILD_TOOLS_BY_DEFAULT
BUILD_EXAMPLES      -> QT_BUILD_EXAMPLES
BUILD_TESTING       -> QT_BUILD_TESTS

This should help to better convey the difference between "BUILD" and
"NO_MAKE".

To configure tests, but not to build them by default, pass the
following to CMake:
-DQT_BUILD_TESTS=ON -DQT_BUILD_TESTS_BY_DEFAULT=OFF

Analoguous for examples:
-DQT_BUILD_EXAMPLES=ON -DQT_BUILD_EXAMPLES_BY_DEFAULT=OFF

Tools can be excluded from the default build with:
-DBUILD_TOOLS_BY_DEFAULT=OFF

The variable BUILD_TESTING is still available and initialized with the
value of QT_BUILD_TESTS.

Pick-to: 6.0 6.0.0
Change-Id: Ie5f29dfbdca8bfa8d687981dfe8c19c0397ca080
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-11-20 20:38:03 +01:00
..
call_cmake_for_standalone_tests.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
call_cmake.yaml CMake: Use the same generator when building other repositories 2020-05-19 10:16:16 +02:00
call_host_cmake.yaml CMake: Use the same generator when building other repositories 2020-05-19 10:16:16 +02:00
call_host_install.yaml CMake: Use custom install script to support Ninja Multi-Config builds 2020-05-19 10:16:11 +02:00
call_target_cmake.yaml CMake: Use the same generator when building other repositories 2020-05-19 10:16:16 +02:00
call_target_install.yaml CMake: Use custom install script to support Ninja Multi-Config builds 2020-05-19 10:16:11 +02:00
cmake_build_and_upload_test_artifacts_host.yaml Read test specific configure arguments from environment 2020-09-28 05:28:22 +00:00
cmake_build_and_upload_test_artifacts_target.yaml Read test specific configure arguments from environment 2020-09-28 05:28:22 +00:00
cmake_build_and_upload_test_artifacts.yaml CMake: Provide a qt-internal-configure-tests script 2020-10-26 15:23:25 +01:00
cmake_cross_compilation_module_build_instructions.yaml CMake: Name QT_NO_MAKE_*/BUILD_* variables consistently 2020-11-20 20:38:03 +01:00
cmake_cross_compilation_qtbase_build_instructions.yaml CMake: Name QT_NO_MAKE_*/BUILD_* variables consistently 2020-11-20 20:38:03 +01:00
cmake_module_build_instructions.yaml CMake: Name QT_NO_MAKE_*/BUILD_* variables consistently 2020-11-20 20:38:03 +01:00
cmake_qtbase_build_instructions.yaml CMake: Name QT_NO_MAKE_*/BUILD_* variables consistently 2020-11-20 20:38:03 +01:00
cmake_regular_test_instructions_common.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
cmake_regular_test_instructions_enforced.yaml CMake: Add support for enforcing passing CI tests per repository 2020-07-03 11:14:11 +02:00
cmake_regular_test_instructions.yaml CMake: Add support for enforcing passing CI tests per repository 2020-07-03 11:14:11 +02:00
cmake_run_ctest_enforce_exit_code.yaml Respect abort testing on failure flag 2020-09-25 23:31:02 +03:00
cmake_run_ctest_ignore_exit_code.yaml Respect abort testing on failure flag 2020-09-25 23:31:02 +03:00
cmake_setup_running_tests_env_vars.yaml CMake: Skip / ignore failing tests on CMake platforms 2020-07-01 14:55:29 +02:00
coin_module_build_template_v2.yaml CMake: Add instructions for building and testing qemu configs 2020-06-25 14:11:56 +02:00
coin_module_test_android_start_emulator.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
coin_module_test_qemu_env_vars.yaml CMake: Add instructions for building and testing qemu configs 2020-06-25 14:11:56 +02:00
coin_module_test_template_common.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
coin_module_test_template_v2.yaml CMake: Add support for enforcing passing CI tests per repository 2020-07-03 11:14:11 +02:00
coin_module_test_template_v3.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
coin_qtbase_build_template_v2.yaml Add coin instructions to run Android test in emulator 2020-11-20 13:28:31 +00:00
prepare_building_env.yaml CMake: Don't use mkspec set by sourcing b2qt environment script 2020-10-26 13:46:49 +01:00
README.md CMake: Add support for enforcing passing CI tests per repository 2020-07-03 11:14:11 +02:00

Information about Coin instruction templates

Build templates

  • coin_qtbase_build_template_v2.yaml did not exist. The build instructions were directly embedded into module_config.yaml and did not support repos outside of qtbase, also no cross-compilation.
  • coin_qtbase_build_template_v2 introduced support for building other repos, and also enabled build cross-compiling targets like Android and iOS. A bit later the template gained the ability to build qemu cross-compiling configurations. The counterpart to qtbase to build other repositories is coin_module_build_template_v2

Test templates

  • coin_module_test_template_v1 did not exist. The test instructions were directly embedded into module_config.yaml and did not support repos outside of qtbase, also no cross-compilation.
  • coin_module_test_template_v2 introduced support for building tests for other repos, and made sure not to build and run tests on cross-compiling configuration. A bit later the template gained the ability to build and run tests for qemu cross-compiling configurations.
  • coin_module_test_template_v3 changed the run test instructions to not ignore the exit code and thus enforce that tests pass in the CI.