Create Qt tests | Qt Creator Documentation

- Qt Creator Documentation
- Create Qt tests
- Qt Creator 19.0.1

Create Qt Quick tests ◦ Create Squish test suites

# Create Qt tests

Qt Creator integrates the Qt Test framework for unit testing Qt applications and libraries.

Note: Running Qt tests and displaying their results is supported in Qt 5 or later.

To create a Qt test:

1. Go to File > New Project > Test Project.
2. Select Qt Test Project > Choose.
3. In the Project and Test Information dialog, specify settings for the project and test.

4. In Test case name, enter a name for the test case.
5. Select Requires QApplication to add the include statement for QApplication to the `main.cpp` file of the project.
6. Select GUI Application to create a Qt application.
7. Select Generate initialization and cleanup code to add functions to your test that the testing framework executes to initialize and clean up the test.
8. In Build system, select the build system to use for building the project: CMake, qmake, or Qbs. To build with CMake when developing with Qt 5 or Qt 6.4 or earlier, select CMake with Qt 5 Compatibility.

Qt Creator creates the test in the specified project directory. Edit the `.cpp` file to add private slots for each test function in your test.

For more information about creating Qt tests, see Creating a Test.

Note: While scanning for tests, the parser takes into account only files that directly or indirectly include QTest or QtTest or its equivalent `QtTest/qtest.h` and get linked against `QTestLib` when building the project. Files that currently will not be built will be ignored.

Note: If General > Process arguments is enabled, you can execute tests and write one or more additional log files in parallel. Use the output format option `-o filename,format` to do so. Using standard out for `filename` is not allowed as Qt Creator is using this output channel.

See also How To: Test, Select the build system, Testing, and Logging Options.

Create Qt Quick tests ◦ Create Squish test suites