Setting Up a Generic Project
Generic project support allows you to use Qt Creator as a code editor. You can change the way your project is built by modifying the
make command in the Projects mode under Build Settings.
When you import a project, Qt Creator creates the following files that allow you to specify which files belong to your project and which include directories or defines you want to pass to your compiler:
Importing a Generic Project
To import an existing generic project:
- Select File > New Project > Import Project > Import Existing Project.
- In Import Existing Project, enter the project name and select the location of the project file you want to import.
Qt Creator automatically generates the following files in the project directory:
When the project is successfully imported, Qt Creator creates the project tree in the sidebar.
After importing a generic project into Qt Creator, open it by selecting the
Working with Generic Project Files
For a generic project, you have to manually specify which files belong to your project and which include directories or defines you want to pass to your compiler.
The list of files for a generic project is specified in the
.files file. When you first create a generic project, Qt Creator adds any files it recognizes to your project.
To add or remove files, edit the
.files file in Qt Creator. Qt Creator recreates your project tree when you save the
.files file. Alternatively, you can add and remove files or directories using the context menu in the project tree.
If you frequently need to update the
.files file, you can do so efficiently by using a script that updates the file for you. If the file is modified externally, you have to restart Qt Creator for the changes to take effect.
To update the
.files on the Git repository use the following script:
git ls-files "*.cpp" "*.h" > MyProject.files
To use precompiled headers in a generic project, add the
pch tag after a file path in the
.files file, separated by the pipe character (|). For example:
Specifying Include Paths and Framework Paths
The include paths are specified in the
.includes file, one include path per line. The paths can be either absolute or relative to the
Lines starting with "-F" are interpreted as framework paths.
The defines are specified in the
.config file. The
.config file is a regular C++ file, prepended to all your source files when they are parsed. Only use the
.config file to add lines as in the example below:
#define NAME value
Forwarding Flags to Clang Code Model
.cflags files have command line flags for the Clang code model on a single line.
For example, specify the
-std=c++11 to set the language version for parsing as C++11.
Providing Deployment Information
If you want to run your application on a remote Linux device, you first need to deploy your executable and possibly other files. Qt Creator does that for you automatically if you enter the necessary information. This works the same way as explained for CMake in Deploying to Remote Linux, except that you also need to include your application binary in the list.
Creating a Run Configuration
Qt Creator cannot automatically determine which executable to run.
In the Projects mode under Run Settings, define the executable file to run:
- Click Add and select Custom Executable.
- Define the configuration name, the location of the executable, any additional arguments and the working directory.
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.