From: Leena Miettinen Date: Thu, 3 Feb 2011 16:41:06 +0000 (+0100) Subject: Doc: project wizards X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=2a070bea6afa30d29c44759142e96066da7ffa8a;p=qt-creator-jp%2Fqt-creator-jp.git Doc: project wizards Reviewed-by: dt --- diff --git a/doc/images/qtcreator-new-project.png b/doc/images/qtcreator-new-project.png index f6996fa975..23e7843ae3 100644 Binary files a/doc/images/qtcreator-new-project.png and b/doc/images/qtcreator-new-project.png differ diff --git a/doc/qtcreator.qdoc b/doc/qtcreator.qdoc index ab33f57b18..2a357598f5 100644 --- a/doc/qtcreator.qdoc +++ b/doc/qtcreator.qdoc @@ -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 - 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 @@ -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 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 @@ -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