Doc: Update info about available project wizard templates

The Qt Quick Application wizard template was simplified.

Change-Id: I716d8d03aa508b6f8204b028c5e11691e1e469c3
Reviewed-by: Alessandro Portale <alessandro.portale@qt.io>
This commit is contained in:
Leena Miettinen
2021-10-07 12:14:17 +02:00
parent a95ee64fed
commit ac2906cd60
4 changed files with 31 additions and 72 deletions

View File

@@ -89,7 +89,7 @@
files, as defined by the wizard. files, as defined by the wizard.
For example, if you choose to create a Qt Quick application, \QC generates a For example, if you choose to create a Qt Quick application, \QC generates a
QML file that you can modify in the Design mode. QML file that you can modify in the \uicontrol Edit mode.
\section1 Selecting Project Type \section1 Selecting Project Type
@@ -108,7 +108,7 @@
you can deploy, run, and debug on MCU boards. For more you can deploy, run, and debug on MCU boards. For more
information, see \l {Connecting MCUs}. information, see \l {Connecting MCUs}.
\row \row
\li {1,2} Application (Qt) \li {1,3} Application (Qt)
\li Qt Widgets Application \li Qt Widgets Application
\li Uses \QD forms to design a Qt widget based user interface for \li Uses \QD forms to design a Qt widget based user interface for
the desktop and C++ to implement the application logic. the desktop and C++ to implement the application logic.
@@ -116,23 +116,10 @@
\li Qt Console Application \li Qt Console Application
\li Uses a single main.cpp file. \li Uses a single main.cpp file.
\row \row
\li {1,4} Application (Qt Quick) \li Qt Quick Application
\li Qt Quick Application - Empty
\li Creates a Qt Quick 2 application project that can contain both \li Creates a Qt Quick 2 application project that can contain both
QML and C++ code. You can build the application and deploy it QML and C++ code. You can build the application and deploy it
to desktop, embedded, and mobile target platforms. to desktop, embedded, and mobile target platforms.
\row
\li Qt Quick Application - Scroll
\li Uses the \l{ScrollView} component to implement a scrollable
list view (requires Qt 5.9 or later).
\row
\li Qt Quick Application - Stack
\li Uses the \l{StackView} component to implement a set of pages
with a stack-based navigation model (requires Qt 5.7 or later).
\row
\li Qt Quick Application - Swipe
\li Uses the \l{SwipeView} component to implement a set of pages
with a swipe-based navigation model (requires Qt 5.7 or later).
\row \row
\li {1,4} Application (Qt for Python) \li {1,4} Application (Qt for Python)
\li Qt for Python - Empty \li Qt for Python - Empty

View File

@@ -119,7 +119,8 @@
select \uicontrol {REPL Import File}. To also import all functions from select \uicontrol {REPL Import File}. To also import all functions from
the file, select \uicontrol {REPL Import *}. the file, select \uicontrol {REPL Import *}.
Open the .ui file in the Design mode to create a widget-based UI in \QD. Open the .ui file in the \uicontrol Design mode to create a widget-based UI
in \QD.
The \uicontrol Window wizard adds similar code to the source file, without The \uicontrol Window wizard adds similar code to the source file, without
the UI bits. the UI bits.
@@ -188,7 +189,8 @@
sys.exit(app.exec_()) sys.exit(app.exec_())
\endcode \endcode
Open the .qml file in the Design mode to design a Qt Quick UI in \QMLD. Open the .qml file in the \uicontrol Edit mode to design a Qt Quick UI, or
use \QDS.
//! [python qml project wizards] //! [python qml project wizards]
*/ */

View File

@@ -32,7 +32,7 @@
/*! /*!
\previouspage creator-visual-editor.html \previouspage creator-visual-editor.html
\page quick-projects.html \page quick-projects.html
\nextpage creator-using-qt-quick-designer.html \nextpage quick-converting-ui-projects.html
\title Creating Qt Quick Projects \title Creating Qt Quick Projects
@@ -47,23 +47,11 @@
\li Wizard Template \li Wizard Template
\li Purpose \li Purpose
\row \row
\li {1,4} Application (Qt Quick) \li Application (Qt)
\li Qt Quick Application - Empty \li Qt Quick Application
\li Creates a Qt Quick 2 application project that can contain both \li Creates a Qt Quick 2 application project that can contain both
QML and C++ code. You can build the application and deploy it QML and C++ code. You can build the application and deploy it
to desktop, embedded, and mobile target platforms. to desktop, embedded, and mobile target platforms.
\row
\li Qt Quick Application - Scroll
\li Uses the \l{ScrollView} component to implement a scrollable
list view (requires Qt 5.9 or later).
\row
\li Qt Quick Application - Stack
\li Uses the \l{StackView} component to implement a set of pages
with a stack-based navigation model (requires Qt 5.7 or later).
\row
\li Qt Quick Application - Swipe
\li Uses the \l{SwipeView} component to implement a set of pages
with a swipe-based navigation model (requires Qt 5.7 or later).
\row \row
\li Application (Qt for Python) \li Application (Qt for Python)
\li Qt for Python - Qt Quick Application \li Qt for Python - Qt Quick Application
@@ -72,14 +60,13 @@
\row \row
\li Other Project \li Other Project
\li Qt Quick UI Prototype \li Qt Quick UI Prototype
\li Creates a \l{Creating Qt Quick UI Projects}{Qt Quick UI project} \li Creates a Qt Quick UI project with a single QML file that
with a single QML file that contains the main view. You can contains the main view. You can preview Qt Quick 2 UI projects
preview Qt Quick 2 UI projects in the in the QML Scene preview tool. You do not need to build them,
\l{Validating with Target Hardware}{QML Scene preview tool}. because they do not contain any C++ code.
You do not need to build them, because they do not contain any
C++ code.
Use this template only if you are prototyping. You cannot create This project type is compatible with \QDS. However, use this
template only if you are prototyping. You cannot create
a full application by using this template. a full application by using this template.
Qt Quick UI projects cannot be deployed to embedded or mobile Qt Quick UI projects cannot be deployed to embedded or mobile
@@ -104,24 +91,17 @@
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New File or Project} > \li Select \uicontrol File > \uicontrol {New File or Project} >
\uicontrol {Application (Qt Quick)}. \uicontrol {Application (Qt)} > \uicontrol {Qt Quick Application}
> \uicontrol Choose.
\li Select the application type: \li In the \uicontrol {Project Location} dialog, \uicontrol Name field,
\list enter a name for the project. Keep in mind that you cannot easily
\li \uicontrol {Qt Quick Application - Empty} change the project name later.
\li \uicontrol {Qt Quick Application - Scroll}
\li \uicontrol {Qt Quick Application - Stack}
\li \uicontrol {Qt Quick Application - Swipe}
\endlist
\li Select \uicontrol Choose to open the \uicontrol {Project Location}
dialog.
\li In the \uicontrol Name field, enter a name for the application.
\li In the \uicontrol {Create in} field, enter the path for the project \li In the \uicontrol {Create in} field, enter the path for the project
files. Select the \uicontrol {Use as default project location} check files. Select the \uicontrol {Use as default project location} check
box to create new projects in this folder by default. box to create new projects in this folder by default. You can move
project folders later without problems.
\li Select \uicontrol Next (or \uicontrol Continue on \macos) to open \li Select \uicontrol Next (or \uicontrol Continue on \macos) to open
the \uicontrol {Define Build System} dialog. the \uicontrol {Define Build System} dialog.
@@ -143,9 +123,8 @@
\note If you have not installed the Qt Virtual Keyboard module when \note If you have not installed the Qt Virtual Keyboard module when
you installed Qt, an error message will appear when you try to open you installed Qt, an error message will appear when you try to open
the \e main.qml in the \uicontrol {Form Editor} in the Design mode. \e main.qml for editing. You can use the \l {Installing Qt}
You can use the \l {Installing Qt}{Qt Maintenance Tool} to install {Qt Maintenance Tool} to install Qt Virtual Keyboard.
Qt Virtual Keyboard.
\li Select \uicontrol Next to open the \uicontrol {Translation File} \li Select \uicontrol Next to open the \uicontrol {Translation File}
dialog. dialog.
@@ -179,14 +158,8 @@
\endlist \endlist
For the Empty and Scroll applications, \QC creates a QML file, \QC creates a QML file, \e main.qml, that you can modify in the
\e main.qml, that you can modify in the \uicontrol {Form Editor} \uicontrol Edit mode.
or the \uicontrol {Text Editor}.
For the Stack and Swipe applications, \QC generates two \l{UI Files}{UI files},
\e Page1Form.ui.qml and \e Page2Form.ui.qml, that you can modify in the
\uicontrol {Form Editor} and a QML file, \e main.qml, that you can
modify in the \uicontrol {Text Editor} to add the application logic.
\include creator-python-project.qdocinc python qml project wizards \include creator-python-project.qdocinc python qml project wizards
@@ -240,9 +213,7 @@
\note If you have not installed the Qt Virtual Keyboard module when \note If you have not installed the Qt Virtual Keyboard module when
you installed Qt, an error message will appear when you try to open you installed Qt, an error message will appear when you try to open
the \e main.qml in the \uicontrol {Form Editor} in the Design mode. \e main.qml.
You can use the \l {Installing Qt}{Qt Maintenance Tool} to install
Qt Virtual Keyboard.
\li Select \uicontrol Next to open the \uicontrol {Kit Selection} \li Select \uicontrol Next to open the \uicontrol {Kit Selection}
dialog. dialog.

View File

@@ -31,8 +31,7 @@
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New File or Project} > \li Select \uicontrol File > \uicontrol {New File or Project} >
\uicontrol {Application (Qt Quick)} > \uicontrol {Application (Qt)} > \uicontrol {Qt Quick Application}.
\uicontrol {Qt Quick Application - Empty}.
\li Select \uicontrol Choose to open the \li Select \uicontrol Choose to open the
\uicontrol {Project Location} dialog. \uicontrol {Project Location} dialog.
@@ -82,8 +81,8 @@
\endlist \endlist
For more information about the settings that you skipped, see For more information about the settings that you skipped and the other
\l{Creating Qt Quick Applications}. templates available, see \l{Creating Qt Quick Applications}.
//! [qtquick empty application] //! [qtquick empty application]
*/ */