| .. |
| ******************************************************************************* |
| Copyright (c) 2021 in-tech GmbH |
| |
| This program and the accompanying materials are made available under the |
| terms of the Eclipse Public License 2.0 which is available at |
| http://www.eclipse.org/legal/epl-2.0. |
| |
| SPDX-License-Identifier: EPL-2.0 |
| ******************************************************************************* |
| |
| .. _qtcreator: |
| |
| Working with Qt Creator |
| ======================= |
| |
| Settings (MSYS2) |
| ---------------- |
| |
| Setup CMake-Kit |
| ~~~~~~~~~~~~~~~ |
| |
| #. Add CMake under ``Tools -> Options -> Kits -> CMake`` |
| |
| .. figure:: _static/images/qtcreator_settings_cmake.png |
| :align: center |
| :scale: 60% |
| |
| |
| #. Add C and C++ Compilers under ``Tools -> Options -> Kits -> Compilers`` |
| |
| .. figure:: _static/images/qtcreator_settings_g++.png |
| :align: center |
| :scale: 60% |
| |
| |
| .. figure:: _static/images/qtcreator_settings_gcc.png |
| :align: center |
| :scale: 60% |
| |
| |
| #. Add Debugger under ``Tools -> Options -> Kits -> Debuggers`` |
| |
| .. figure:: _static/images/qtcreator_settings_gdb.png |
| :align: center |
| :scale: 60% |
| |
| |
| #. Add Kit under ``Tools -> Options -> Kits -> Kits`` |
| |
| .. figure:: _static/images/qtcreator_settings_kit.png |
| :align: center |
| :scale: 60% |
| |
| |
| #. Adjust ``CMake Generator`` under ``Tools -> Options -> Kits -> Kits`` to ``MSYS Makefiles`` |
| |
| .. figure:: _static/images/qtcreator_settings_cmake_generator.png |
| :align: center |
| :scale: 60% |
| |
| .. note:: |
| |
| Change the environment variable to ``MAKEFLAGS=-j4`` (or similar) to enable parallel building on the kit level. |
| |
| Setup Project |
| ~~~~~~~~~~~~~~ |
| |
| #. Load the project by opening a ``CMakeLists.txt`` file and configure it to use the new kit. |
| |
| #. Setup missing CMake flags (c.f. :ref:'CMake') |
| |
| .. todo:: The configuration is still "itchy", as Qt creator changes the interface with every version |
| |
| |
| Settings (Linux) |
| ---------------- |
| |
| Setup Kit |
| ~~~~~~~~~ |
| |
| Qt Creator should be able to come up with a suiteable kit for developing |op| on its own. |
| If not, check if all :ref:`prerequisites` are met. Also, the steps above should be a good indicator, where to look for potential troubles. |
| |
| Setup Project |
| ~~~~~~~~~~~~~~ |
| |
| #. Load the project by opening a ``CMakeLists.txt`` file and configure it to use a proper kit. |
| |
| #. Setup missing CMake flags (c.f. :ref:'CMake') |
| |
| .. todo:: The configuration is still "itchy", as Qt creator changes the interface with every version |
| |
| Alternative Method |
| ------------------ |
| |
| .. admonition:: Version Issues |
| |
| Qt Creator is constantly improving the CMake integration. |
| Unfortunatly, some versions seem to be **buggy**. |
| |
| Tested Versions: 4.13.2 | 4.12.2 |
| |
| #. Follow the install instructions to invoke cmake from within your own build directory. |
| - Execute the step for ``build-release`` |
| - Execute the step for ``build-debug`` |
| #. Open Qt Creator |
| #. Open ``CMakeLists.txt`` |
| #. Qt Creator should find the configured build directories and create a temporary kit |
| |
| .. figure:: _static/images/qtcreator_project_cmake.png |
| :align: center |
| :scale: 60% |
| |
| .. figure:: _static/images/qtcreator_project_loaded.png |
| :align: center |
| :scale: 60% |
| |
| .. figure:: _static/images/qtcreator_project_cmake_settings.png |
| :align: center |
| :scale: 60% |