OSDN Git Service

Doc: project wizards
authorLeena Miettinen <riitta-leena.miettinen@nokia.com>
Thu, 3 Feb 2011 16:41:06 +0000 (17:41 +0100)
committerLeena Miettinen <riitta-leena.miettinen@nokia.com>
Thu, 3 Feb 2011 17:00:46 +0000 (18:00 +0100)
Reviewed-by: dt
doc/images/qtcreator-new-project.png
doc/qtcreator.qdoc

index f6996fa..23e7843 100644 (file)
Binary files a/doc/images/qtcreator-new-project.png and b/doc/images/qtcreator-new-project.png differ
index ab33f57..2a35759 100644 (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
 
     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