\o \l{Getting Started}
\list
\o \l{Building and Running an Example Application}
- \o \l{Creating a Qt C++ Application}
+ \o \l{Creating a Qt Widget Based Application}
\o \l{Creating a Mobile Application with Qt SDK}
\o \l{Creating a Qt Quick Application}
\endlist
\list
\o \l{Creating a Project}
\o \l{Opening a Project}
+ \o \l{Adding New Custom Wizards}
\o \l{Setting Up a qmake Project}
\o \l{Adding Libraries to qmake Projects}
\o \l{Setting Up a CMake Project}
\o \l{Setting Up Development Environment for Maemo}
\o \l{Setting Up Development Environment for Symbian}
\o \l{Managing Sessions}
- \o \l{Adding New Custom Wizards}
\endlist
\o \l{Using the Editor}
\list
Setting up a new project in Qt Creator is aided by a wizard that guides
you step-by-step through the project creation process. In the first step, you
- select the type of the project from the categories: Qt C++ project, Qt Quick
- Project, or other project. Next, you select a location for the project and
+ select the type of the project from the categories: Qt Quick project, Qt widget
+ project, or other project. Next, you select a location for the project and
specify settings for it.
\image qtcreator-new-qt-quick-project-wizard.png
\title Managing Projects
- One of the major advantages of Qt Creator is that it allows a team of
- developers to share a project across different development platforms with a common
- tool for development and debugging.
+ To set up a project, you first have to decide what kind of an
+ application you want to develop: whether you want a Qt Quick user interface
+ or a Qt widget based user interface. For a Qt Quick project, you must also
+ choose the language to implement the application logic: C++ or JavaScript.
+ You can also create other kinds of projects, such as Qt console
+ applications, shared or static C++ libraries, or subprojects.
+
+ You can use wizards to create and import projects. The wizards prompt you
+ to enter the settings needed for that particular type of project and create
+ the necessary files for you. You can add your own custom wizards to
+ standardize the way subprojects and classes are added to a project.
+
+ You also need to choose a build system for the project. Qt Creator is
+ integrated with cross-platform systems for build automation: qmake and
+ CMake. In addition, you can import generic projects that do not use qmake
+ or CMake, and specify that Qt Creator ignores your build system.
+
+ If you want to develop applications for Symbian devices, you must choose
+ qmake or a compilation service at Forum Nokia to build the applications for
+ the Symbian devices target. The interface to the compilation service, Remote
+ Compiler, is installed as a part of the \QSDK. For more information, see
+ \l{Building with Remote Compiler}.
+
+ When you install the \QSDK, the build and run settings for the Maemo and
+ Symbian targets are set up automatically. However, you need to install and
+ configure some additional software on the devices to be able to connect to
+ them from the development PC.
+
+ You can use sessions to store personal data, such as bookmarks and
+ breakpoints that are usually not of interest to other developers working on
+ the same projects. Sessions allow you to quickly switch between projects
+ when you work on several projects.
The following sections describe how to manage projects:
\list
\o \l{Creating a Project}
\o \l{Opening a Project}
+ \o \l{Adding New Custom Wizards}
\o \l{Setting Up a qmake Project}
\o \l{Adding Libraries to qmake Projects}
\o \l{Setting Up a CMake Project}
\o \l{Setting Up Development Environment for Maemo}
\o \l{Setting Up Development Environment for Symbian}
\o \l{Managing Sessions}
- \o \l{Adding New Custom Wizards}
\endlist
*/
\title Creating a Project
- You use wizards to create and import several types of projects and files, such
- as Qt GUI or console applications and Qt Quick applications.
- You can use wizards also to add individual files to your projects.
-
- The wizards prompt you to enter the settings needed
- for that particular type of project and create the necessary files for you.
- To display other types of files in the \gui Projects pane, specify them in
- the project file.
-
\image qtcreator-new-project.png
- To change the location of the project directory, and to make changes in
- the build and run settings, select \gui{Tools} > \gui{Options...} >
- \gui{Projects} > \gui{General}.
-
- \section1 Using Project Wizards
-
- To create a new project:
- \list 1
- \o Select \gui File > \gui{New File or Project} and select the type of your
- project.
-
- The contents of the following dialogs depend on the project type.
- Follow the instructions of the wizard.
- This example uses \gui {Qt Gui Application}.
-
- \o Name the project and set its path, and then click \gui Next.
-
- Do not use spaces and special characters in the project name and
- path.
+ You can use wizards to create following types of projects:
- \image qtcreator-intro-and-location.png
+ \list
- \o Select the Qt versions to use as build targets for your project, and click
- \gui{Next}.
+ \o Qt Quick Projects, which use QML to define the user interface and,
+ optionally, C++ or JavaScript to define the application logic
- \image qtcreator-new-project-qt-versions.png "Qt Versions dialog"
+ \o Qt Widget Projects, which use \QD forms to define a Qt widget based
+ user interface and C++ to define the application logic
- \note If you have only one Qt version installed, this dialog is skipped.
+ \o Other Projects, such as Qt console applications, shared or static
+ C++ libraries, Qt unit tests, Qt Custom Designer Widgets, or
+ subprojects
- \o Specify the name of the class you want to create and using the
- drop-down menu select its base class type.
+ \o
- Note that the \gui{Header file}, \gui{Source file} and
- \gui{Form file} fields are automatically updated as you name your
- class.
+ \endlist
- \image qtcreator-class-info.png
- \o Review the project settings.
+ To create a new project, select \gui File > \gui{New File or Project} and
+ select the type of your
+ project.
+ The contents of the wizard dialogs depend on the project type.
+ Follow the instructions of the wizard.
- To create the project, click \gui Finish.
+ For examples of creating different types of projects, see
+ \l{Getting Started}.
- \image qtcreator-new-project-summary.png
- \endlist
+ For more information about creating Qt Quick projects, see
+ \l {Creating Qt Quick Projects}.
+ To change the location of the project directory, and to make changes in
+ the build and run settings, select \gui{Tools} > \gui{Options...} >
+ \gui{Projects} > \gui{General}.
\section1 Adding Files to Projects
+ You can use wizards also to add individual files to your projects.
You can create the following types of files:
\list
\o Qt resource files, which allow you to store binary files in the
application executable
- \o \QD forms and Qt QML files, which specify parts of application user
- interfaces
+ \o \QD forms and \QD form classes, which specify parts of user
+ interfaces in Qt widget based projects
+
+ \o QML files, which specify elements in Qt Quick projects
+
+ \o GLSL files that define fragment and vertex shaders in both Qt Quick
+ projects and Qt widget based projects
- \o C++ class, source, or header files
+ \o C++ class, source, or header files that you can use to write the
+ application logic in both Qt Quick projects and Qt widget based
+ projects
- \o GLSL files that define fragment and vertex shaders in the Open GL/ES
- 2.0 Shading Language (GLSL/ES) or in the Desktop OpenGL Shading
- Language (GLSL)
+ \o JavaScript files that you can use to write the application logic in
+ Qt Quick projects
\o Text files
\list
\o \l{Building and Running an Example Application}
- \o \l{Creating a Qt C++ Application}
+ \o \l{Creating a Qt Widget Based Application}
\o \l{Creating a Mobile Application with Qt SDK}
\o \l{Creating a Qt Quick Application}
\endlist
\list 1
- \o Select \gui{File > New File or Project > Qt C++ Project > Mobile Qt
+ \o Select \gui{File > New File or Project > Qt Widget Project > Mobile
+ Qt
Application > Choose}.
\image qtcreator-new-mobile-project.png "New File or Project dialog"
\page creator-writing-program.html
\nextpage creator-mobile-example.html
- \title Creating a Qt C++ Application
+ \title Creating a Qt Widget Based Application
This tutorial describes how to use Qt Creator
to create a small Qt application, Text Finder. It is a simplified version of the
QtUiTools \l{http://doc.qt.nokia.com/4.7/uitools-textfinder.html}{Text Finder}
example.
+ The application user interface is constructed from Qt widgets by using \QD.
+ The application logic is written in C++ by using the code editor.
\image qtcreator-textfinder-screenshot.png
\list 1
- \o Select \gui{File > New File or Project > Qt C++ Project > Qt Gui
+ \o Select \gui{File > New File or Project > Qt Widget Project > Qt Gui
Application > Choose}.
\image qtcreator-new-project.png "New File or Project dialog"
\title Debugging the Example Application
- This section uses the \l{Creating a Qt C++ Application}{TextFinder} example to
+ This section uses the \l{Creating a Qt Widget Based Application}{TextFinder} example to
illustrate how to debug Qt C++ applications in the \gui Debug mode.
TextFinder