From c3608ec7e0e8c12d28ee46427af492f42524b6fd Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Mon, 13 Feb 2017 10:50:43 +0100 Subject: [PATCH] Doc: State that Qt Quick Projects cannot be deployed to mobile ...or embedded. Suggest creating an application, instead. Task-number: QTCREATORBUG-17708 Change-Id: I6b5b1f26bde0d281f162bc68d5cb9088e8fc79cd Reviewed-by: Mitch Curtis --- .../projects/creator-projects-creating.qdoc | 7 +++++-- doc/src/qtquick/qtquick-creating.qdoc | 19 +++++++++++++++++-- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/doc/src/projects/creator-projects-creating.qdoc b/doc/src/projects/creator-projects-creating.qdoc index addeadfc1cb..7ba898fafc8 100644 --- a/doc/src/projects/creator-projects-creating.qdoc +++ b/doc/src/projects/creator-projects-creating.qdoc @@ -178,8 +178,11 @@ \li Qt Quick UI Use a single QML file that contains the main view. You can - review Qt Quick UI projects in a \l{Previewing QML Files} - {preview tool} and you need not build them. + review \l{Creating Qt Quick UI Projects}{Qt Quick UI projects} + in a \l{Previewing QML Files}{preview tool} and you need not + build them. Qt Quick UI projects cannot be deployed to embedded + or mobile target platforms. For those platforms, create a + Qt Quick application instead. \li Qt Quick Controls UI diff --git a/doc/src/qtquick/qtquick-creating.qdoc b/doc/src/qtquick/qtquick-creating.qdoc index 0cd1984f271..33551569c92 100644 --- a/doc/src/qtquick/qtquick-creating.qdoc +++ b/doc/src/qtquick/qtquick-creating.qdoc @@ -63,10 +63,13 @@ \l{http://threejs.org}{three.js}. \li \uicontrol {Qt Quick UI} (in the \uicontrol {Other Project} - category) creates a Qt Quick UI project with a single QML file that + category) creates a \l{Creating Qt Quick UI Projects} + {Qt Quick UI project} with a single QML file that contains the main view. You can review Qt Quick UI projects in a \l{Previewing QML Files}{preview tool} and you need not build them. - They do not contain any C++ code. + Qt Quick UI projects cannot be deployed to embedded or mobile + target platforms. For those platforms, create a Qt Quick application + instead. \li \uicontrol {Qt Quick Controls UI} is like \uicontrol {Qt Quick UI}, but using Qt Quick Controls. @@ -124,6 +127,18 @@ \section1 Creating Qt Quick UI Projects + Qt Quick UI projects are useful for testing or prototyping user interfaces, + or for setting up a separate project just for QML editing, for example. You + cannot use them for application development, because they do not contain: + + \list + \li C++ code + \li Resource files (.qrc) + \li Code needed for deploying applications to mobile or embedded devices + \endlist + + To create a Qt Quick UI project: + \list 1 \li Select \uicontrol File > \uicontrol {New File or Project} >