Opening Projects
Qt Creator stores information that it needs to build projects in a .user file. If Qt Creator cannot find the file when you open an existing project, it prompts you to enter the information. If you created the project by using another Qt Creator instance, Qt Creator asks whether you want to use the old settings. The settings are specific to the development environment, and should not be copied from one environment to another. Therefore, we recommend that you click No and enter the information again in the Configure Project tab.
The Configure Project tab displays a list of development environments for target platforms that are installed on the development PC. Select the Qt versions that you want to use to build the project for each target.
Even if you do not intend to build the project, the C++ and QML code models need a Qt version and tool chain to offer code completion. To specify them, select the options link, or select Tools > Options > Build & Run > Unconfigured Project.
If Qt Creator cannot find an existing build for a particular development environment (Qt version) and target, it starts out from a clean slate, and creates a new build in the specified directory. Qt Creator suggests a name and location for the directory that you can change.
By default, Qt Creator does a shadow build and also creates the directory. However, shadow building is not supported for the following targets on Windows:
- Maemo5
- MeeGo Harmattan
- Symbian Devices
If you have built the project before, Qt Creator can use the existing build configuration to make the exact same build as found in the directory available to Qt Creator.
If you know you have a build, but it is not listed, click Add Build to locate it. Select a directory, and Qt Creator scans it (including subdirectories) for additional builds of the project. Qt Creator adds the found builds to the target list.
You can edit the build configuration later. For more information, see Editing Build Configurations.
To open a project:
- Select File > Open File or Project and select the project to open.
- In the Project Setup dialog, select the Qt versions to use as build targets for your project, and click Finish.
Note: If you have only one development environment installed, this dialog is skipped.
Qt Creator parses all the source files in the project and performs a semantic analysis to build up the information that it needs for functions such as navigation and finding usages. A progress bar is displayed during parsing.