Commit 26d50474 authored by Leena Miettinen's avatar Leena Miettinen

Doc: opening projects

Task-number: QTCREATORBUG-2426

Reviewed-by: Tobias Hunger
parent f73d4bcb
......@@ -73,6 +73,7 @@
\o \l{Managing Projects}
\o \l{Creating a Project}
\o \l{Opening a Project}
\o \l{Setting Up a qmake Project}
\o \l{Adding Libraries to qmake Projects}
\o \l{Setting Up a CMake Project}
......@@ -1968,6 +1969,7 @@
\o \l{Creating a Project}
\o \l{Opening a Project}
\o \l{Setting Up a qmake Project}
\o \l{Adding Libraries to qmake Projects}
\o \l{Setting Up a CMake Project}
......@@ -1985,7 +1987,7 @@
\contentspage index.html
\previouspage creator-project-managing.html
\page creator-project-creating.html
\nextpage creator-project-qmake.html
\nextpage creator-project-opening.html
\title Creating a Project
......@@ -2131,6 +2133,69 @@
\contentspage index.html
\previouspage creator-project-creating.html
\page creator-project-opening.html
\nextpage creator-project-qmake.html
\title Opening a Project
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 \gui No and enter
the information again in the \gui {Project Setup} dialog.
The \gui {Project Setup} dialog displays a list of development environments for
target platforms (such as desktop, Maemo devices, and Symbian devices) that are
installed on the development PC. Select the Qt versions that you want to use to build
the project for each target.
\image qtcreator-open-project-targets.png "Qt Versions dialog"
The status \gui New indicates that Qt Creator did not find an existing build
for a particular development environment (Qt version) and target. Therefore,
Qt Creator starts out from a clean slate, and creates a new build in the directory
listed in the \gui {Build Directory} field.
By default, Qt Creator does a \l{glossary-shadow-build}{shadow build} and also
creates the directory. However, shadow building is not supported for the Symbian
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. The \gui Status column displays the status \gui Import if Qt creator
found an existing build of the project. The status is displayed for each
available development environment.
If you know you have a build, but it is not listed, click \gui {Import Existing
Shadow 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 with \gui Import status.
You can edit the build configuration later. For more information, see
\l{Editing Build Configurations}.
To open a project:
\list 1
\o Select \gui File > \gui{Open File or Project} and select the project
to open.
\o In the \gui {Project Setup} dialog, select the Qt versions to use as
build targets for your project, and click \gui{Next}.
\note If you have only one development environment installed, this dialog
is skipped.
\contentspage index.html
\previouspage creator-project-managing-sessions.html
......@@ -2593,7 +2658,7 @@
\contentspage index.html
\previouspage creator-project-creating.html
\previouspage creator-project-opening.html
\page creator-project-qmake.html
\nextpage creator-project-qmake-libraries.html
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment