summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLiang Qi <liang.qi@qt.io>2016-08-17 10:48:24 +0200
committerLiang Qi <liang.qi@qt.io>2016-08-17 10:48:24 +0200
commitcb23e64e8615fef8e43faeba064e4f641b63dca7 (patch)
treeca25c10eb674dd4a45b60de294a94186978e492b
parentae0d84b354ea7ad8f260d68fdcb24f95d6f4d6bd (diff)
parentd737321990acbaea2073e025bffff339ab7a216c (diff)
Merge remote-tracking branch 'origin/5.7' into devv5.8.0-alpha1
-rw-r--r--doc/src/deployment/deployment.qdoc47
-rw-r--r--doc/src/images/qt-logo.pngbin5149 -> 1214 bytes
-rw-r--r--doc/src/legal/licenses.qdoc16
-rw-r--r--doc/src/modules-qml.qdoc15
-rw-r--r--doc/src/platforms/android.qdoc2
-rw-r--r--doc/src/platforms/emb-linux.qdoc19
-rw-r--r--doc/src/platforms/windows.qdoc42
-rw-r--r--doc/src/snippets/brushstyles/qt-logo.pngbin1422 -> 15518 bytes
-rw-r--r--doc/src/snippets/declarative/pathview/pics/qtlogo.pngbin2991 -> 1936 bytes
-rw-r--r--doc/src/snippets/declarative/pics/qtlogo.pngbin2991 -> 1936 bytes
10 files changed, 52 insertions, 89 deletions
diff --git a/doc/src/deployment/deployment.qdoc b/doc/src/deployment/deployment.qdoc
index be121794d..b354427b3 100644
--- a/doc/src/deployment/deployment.qdoc
+++ b/doc/src/deployment/deployment.qdoc
@@ -32,9 +32,7 @@
Deploying an Qt application does not require any C++
programming. All you need to do is to build Qt and your
application in release mode, following the procedures described in
- this documentation. We will demonstrate the procedures in terms of
- deploying the \l {tools/plugandpaint/app}{Plug & Paint} application
- that is provided in Qt's examples directory.
+ this documentation.
\section1 Static vs. Shared Libraries
@@ -69,42 +67,8 @@
\section1 Deploying Qt's Libraries
- \table
- \header
- \li {4,1} Qt Libraries
- \row
- \li \l{Qt Core}{QtCore}
- \li \l{Qt Network}{QtNetwork}
- \li \l{Qt GUI}{QtGui}
- \li \l{Qt SQL}{QtSql}
- \row
- \li \l{Qt Test}{QtTest}
- \li \l{Qt Widgets}{QtWidgets}
- \li \l{Qt QML}{QtQml}
- \li \l{Qt Quick}{QtQuick}
- \row
- \li \l{Qt Multimedia}{QtMultimedia}
- \li \l{Qt WebEngine}{QtWebEngine}
- \li \l{Qt WebEngine Widgets}{QtWebEngineWidgets}
- \li \l{Qt XML}{QtXml}
- \row
- \li \l{Qt XML Patterns}{QtXmlPatterns}
- \li \l{Qt SVG}{QtSvg}
- \li \l{Qt Concurrent}{QtConcurrent}
- \li \l{Qt Print Support}{QtPrintSupport}
- \row
- \li \l{Qt D-Bus}{QtDBus}
- \li \l{Qt OpenGL}{QtOpenGL}
- \li \l{ActiveQt}{QtActiveQt}
- \li \l{Qt Graphical Effects}{QtGraphicalEffects}
- \row
- \li \l{Qt Script}{QtScript}
- \li \l{Qt Quick 1}{QtDeclarative}
- \li \l{Qt Image Formats}{QtImageFormats}
- \endtable
-
- Qt is not a system library, so it must be redistributed with your
- application. The minimum is to redistribute the run-time
+ Unless Qt is part of the system libraries it must be redistributed
+ with your application. The minimum is to redistribute the run-time
of the libraries used by the application. However, with static linking,
the Qt run-times can be compiled into the executable.
@@ -117,6 +81,9 @@
require, including those for accessibility.
For more information about plugins, see \l{How to Create Qt Plugins}.
+ Applications using \l{Qt QML} also need to ship the
+ \l{All QML Modules}{QML modules} they use.
+
While deploying an application using the shared library approach,
you must ensure that the Qt libraries use the correct path to
find the Qt plugins, documentation, translation, and so on. To do this, you
@@ -158,6 +125,8 @@
\endtable
+ For more information, see \l{Third-Party Licenses Used in Qt}.
+
\section1 Platform-Specific Notes
The procedure of deploying Qt applications is different for the
diff --git a/doc/src/images/qt-logo.png b/doc/src/images/qt-logo.png
index 14ddf2a02..b63f1384b 100644
--- a/doc/src/images/qt-logo.png
+++ b/doc/src/images/qt-logo.png
Binary files differ
diff --git a/doc/src/legal/licenses.qdoc b/doc/src/legal/licenses.qdoc
index 70e9bb8bc..c15043954 100644
--- a/doc/src/legal/licenses.qdoc
+++ b/doc/src/legal/licenses.qdoc
@@ -210,6 +210,14 @@
\row \li \li \li \li
\row \li \li \li \li
+ \row \li {1,4} Qt QML
+
+ \row \li {4,1} \b{Third-party Licenses}
+ \row \li \l{JavaScriptCore Macro Assembler}
+ \li The assembly code generated use by the JIT.
+ \li BSD-style \li
+ \row \li \li \li \li
+
\row \li {1,4} Qt Quick
\row \li {4,1} \b{Third-party Licenses}
@@ -398,14 +406,6 @@
\li The header is based on OpenKODE Core 1.0 specification.
\li MIT License
- \row \li {1,4} Qt Qml
-
- \row \li {4,1} \b{Third-party Licenses}
- \row \li \l{JavaScriptCore Macro Assembler}
- \li The assembly code generated use by the JIT.
- \li BSD-style \li
- \row \li \li \li \li
-
\row \li \l{V8 double/string conversion library}
\li String conversion routines for IEEE doubles.
\li BSD-style \li
diff --git a/doc/src/modules-qml.qdoc b/doc/src/modules-qml.qdoc
index 818b381d5..3db05379c 100644
--- a/doc/src/modules-qml.qdoc
+++ b/doc/src/modules-qml.qdoc
@@ -26,19 +26,14 @@
****************************************************************************/
/*!
- \group qmlmodules
- \brief Overview of available QML Modules
- \title All QML Modules
-*/
-
-/*!
\page modules-qml.html
- \title All QML APIs by Module
+ \keyword All QML APIs by Module
\ingroup classlists
+ \title All QML Modules
- \brief A list of all QML API in Qt 5
+ \brief A list of all QML modules in Qt 5.
- These are the QML API pages for Qt 5's \l{All QML Modules}{QML modules}.
+ These are the QML API pages for Qt 5's QML modules.
- \annotatedlist {qmlmodules}
+ \generatelist qml-modules
*/
diff --git a/doc/src/platforms/android.qdoc b/doc/src/platforms/android.qdoc
index 9a1d4da00..bd03b9873 100644
--- a/doc/src/platforms/android.qdoc
+++ b/doc/src/platforms/android.qdoc
@@ -146,10 +146,10 @@ In order to use \l{Qt for Android}, you need the following:
\list
\li \l{http://developer.android.com/sdk/index.html}{The Android SDK Tools}
\li \l{http://developer.android.com/tools/sdk/ndk/index.html}{The Android NDK}
-\li \l{http://ant.apache.org/bindownload.cgi}{Apache Ant} v1.8 or later
\li \l{http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html}{Java SE Development Kit} (JDK) v6 or later. You can also use \l{http://openjdk.java.net}{OpenJDK} on Linux.
\li On Windows, you need the following additional installations:
\list
+ \li \l{http://ant.apache.org/bindownload.cgi}{Apache Ant} v1.8 or later
\li Android Debug Bridge (ADB) driver on the Windows platform to enable USB
debugging. The default USB driver on Windows does not allow debugging.
For details about how to get the USB driver, see
diff --git a/doc/src/platforms/emb-linux.qdoc b/doc/src/platforms/emb-linux.qdoc
index 3dc4bda2b..836fb1c83 100644
--- a/doc/src/platforms/emb-linux.qdoc
+++ b/doc/src/platforms/emb-linux.qdoc
@@ -753,13 +753,18 @@
\section2 eglfs with other backends
- Other backends, that are typically based on targeting the framebuffer
- directly via the vendor's EGL implementation, usually provides limited or
- no support for multiple displays. In some cases the \c {QT_QPA_EGLFS_FB}
- environment variable can be used to specify the framebuffer to target,
- similarly to linuxfb. Alternatively, driver-specific environment variables or
- kernel parameters may also be available to control the used framebuffer. Refer
- to the embedded board's documentation.
+ Other backends, that are typically based on targeting the framebuffer or a
+ composition API directly via the vendor's EGL implementation, usually provide
+ limited or no support for multiple displays. On i.MX6-based boards with
+ Vivante GPUs the \c{QT_QPA_EGLFS_FB} environment variable can be used to
+ specify the framebuffer to target, similarly to linuxfb. On the Raspberry Pi
+ the \c{QT_QPA_EGLFS_DISPMANX_ID} environment variable can be used to specify
+ the screen to output to. The value corresponds to one of the \c{DISPMANX_ID_}
+ constants, refer to the Dispmanx documentation. Note that these approaches,
+ unlike KMS/DRM, will not typically allow to output to multiple screens from
+ the same application. Alternatively, driver-specific environment variables or
+ kernel parameters may also be available as well to control the used
+ framebuffer. Refer to the embedded board's documentation.
\section2 Video Memory
diff --git a/doc/src/platforms/windows.qdoc b/doc/src/platforms/windows.qdoc
index 612ba59a9..eb66edf70 100644
--- a/doc/src/platforms/windows.qdoc
+++ b/doc/src/platforms/windows.qdoc
@@ -531,8 +531,18 @@
plugins, and translations) that are required to run the application from
that folder. It creates a sandbox for \l{Qt for WinRT}{Windows Runtime}
or an installation tree for Windows desktop applications, which can be
- easily bundled into an installation package. The tool can be found in
- QTDIR/bin/windeployqt.
+ easily bundled into an installation package.
+
+ The tool can be found in \c{QTDIR/bin/windeployqt}. It takes an \c .exe file or
+ a directory that contains an \c .exe file as an argument, and scans the executable
+ for dependencies. If a directory is passed with the \c{--qmldir} argument,
+ \c windeployqt uses the \c qmlimportscanner tool to scan QML
+ files inside the directory for QML import dependencies.
+ Identified dependencies are then copied to the executable's
+ directory. The hardcoded local paths in Qt5Core.dll are furthermore replaced
+ with relative ones.
+
+ Additional arguments are described in the tools' help output:
\badcode
Usage: windeployqt [options] [files]
@@ -694,33 +704,17 @@
is a subdirectory named \c {platforms}. \l{Qt Plugins} section has
additional information about plugins and how Qt searches for them.
- If Qt was configured to use the \l{ICU} library for unicode support, the ICU
- DLLs located in the \c bin directory of your Qt installation must be included.
- The ICU DLLs are version dependent and have to match the ones your Qt version
- was linked against.
-
If \l{ANGLE} (the default) is used, you additionally need to include both
\c libEGL.dll and \c libGLESv2.dll from Qt's 'lib' directory as well as
the HLSL compiler from DirectX. The HLSL compiler library,
d3dcompiler_XX.dll, where XX is the version number that ANGLE (libGLESv2)
was linked against.
- If your application depends on Qt WebEngine, you must deploy
- \c{<Qt install path>/bin/QtWebEngineProcess.exe} to the application install
- path. If you chose to deploy the binary to a different path, set the
- \c QTWEBENGINEPROCESS_PATH environment variable to the binary's absolute
- path (including its file name). This enables the application to find the
- binary and execute it for every instance of QWebEngineView or
- WebEngineView created. For example, a browser application with two tabs
- open should have two separate processes of \c QtWebEngineProcess.exe
- running. This is a common approach used by most modern web engines to
- provide a stable browsing experience.
-
- \note To support HTML5 videos, you must additionally deploy
- \c ffmpegsumo.dll (WebM codec plugin) into the \c qtwebengine directory
- under the application install path or under the path that the
- \c PluginsPath variable was set to in
- \c{<Qt install path>/<Qt version>/msvc2013/qt.conf}.
+ If Qt was configured to link against ICU or OpenSSL, the respective DLL's
+ need to be added to the \c release folder, too.
+
+ \note \l{Qt WebEngine} applications have additional requirements that are
+ listed in \l{Deploying Qt WebEngine Applications}.
Remember that if your application depends on compiler specific
libraries, these must be redistributed along with your
@@ -798,7 +792,7 @@
\li \c msvcp140.dll
\endtable
- If ICU was used, the archive must contain:
+ If Qt was configured to use ICU, the archive must contain:
\table 100%
\header
diff --git a/doc/src/snippets/brushstyles/qt-logo.png b/doc/src/snippets/brushstyles/qt-logo.png
index 2dc67161c..d609c1e1e 100644
--- a/doc/src/snippets/brushstyles/qt-logo.png
+++ b/doc/src/snippets/brushstyles/qt-logo.png
Binary files differ
diff --git a/doc/src/snippets/declarative/pathview/pics/qtlogo.png b/doc/src/snippets/declarative/pathview/pics/qtlogo.png
index 4f68e162d..3bc03b7c7 100644
--- a/doc/src/snippets/declarative/pathview/pics/qtlogo.png
+++ b/doc/src/snippets/declarative/pathview/pics/qtlogo.png
Binary files differ
diff --git a/doc/src/snippets/declarative/pics/qtlogo.png b/doc/src/snippets/declarative/pics/qtlogo.png
index 4f68e162d..3bc03b7c7 100644
--- a/doc/src/snippets/declarative/pics/qtlogo.png
+++ b/doc/src/snippets/declarative/pics/qtlogo.png
Binary files differ