feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: project wizards

Browse Source 
Reviewed-by: dt
This commit is contained in:
Leena Miettinen
2011-02-03 17:41:06 +01:00
parent 38d3ddcd5b
commit 2a070bea6a
2 changed files with 88 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/images/qtcreator-new-project.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 32 KiB

157
doc/qtcreator.qdoc
View File

@@ -66,7 +66,7 @@
\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
@@ -74,6 +74,7 @@
\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}
@@ -81,7 +82,6 @@
\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
@@ -219,8 +219,8 @@
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
@@ -2621,15 +2621,45 @@
\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}
@@ -2637,7 +2667,6 @@
\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
*/
@@ -2651,63 +2680,44 @@
\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
You can use wizards to create following types of projects:
\list
\o Qt Quick Projects, which use QML to define the user interface and,
optionally, C++ or JavaScript to define the application logic
\o Qt Widget Projects, which use \QD forms to define a Qt widget based
user interface and C++ to define the application logic
\o Other Projects, such as Qt console applications, shared or static
C++ libraries, Qt unit tests, Qt Custom Designer Widgets, or
subprojects
\o
\endlist
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.
For examples of creating different types of projects, see
\l{Getting Started}.
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 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.
\image qtcreator-intro-and-location.png
\o Select the Qt versions to use as build targets for your project, and click
\gui{Next}.
\image qtcreator-new-project-qt-versions.png "Qt Versions dialog"
\note If you have only one Qt version installed, this dialog is skipped.
\o Specify the name of the class you want to create and using the
drop-down menu select its base class type.
Note that the \gui{Header file}, \gui{Source file} and
\gui{Form file} fields are automatically updated as you name your
class.
\image qtcreator-class-info.png
\o Review the project settings.
To create the project, click \gui Finish.
\image qtcreator-new-project-summary.png
\endlist
\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
@@ -2715,14 +2725,20 @@
\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 C++ class, source, or header files
\o QML files, which specify elements in Qt Quick 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 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 that you can use to write the
application logic in both Qt Quick projects and Qt widget based
projects
\o JavaScript files that you can use to write the application logic in
Qt Quick projects
\o Text files
@@ -4921,7 +4937,7 @@
\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
@@ -4954,7 +4970,8 @@
\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"
@@ -5587,12 +5604,14 @@
\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
@@ -5604,7 +5623,7 @@
\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"
@@ -7154,7 +7173,7 @@
\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