summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@digia.com>2013-05-23 14:14:33 +0200
committerThe Qt Project <gerrit-noreply@qt-project.org>2013-05-24 16:11:02 +0200
commit13b4b6c4cdbefb4dd313a5541426c15e4001664b (patch)
tree2258663a05dd8b4ad1329b3142af84c47b076c9c
parentf42aa7611cb0fc8cf9dfa206d4f00f1ebb30335e (diff)
downloadqtdoc-13b4b6c4cdbefb4dd313a5541426c15e4001664b.tar.gz
Add information on using plugins/imports on Android
Since Qt Creator doesn't know what dependencies the plugins or imports used by your app has ahead of time, this needs to be maintained manually. Add information about this to the documentation. Change-Id: I7285d93581b4e71243d2ad5537ff19c19ee52f83 Reviewed-by: Jerome Pasion <jerome.pasion@digia.com> Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
-rw-r--r--doc/src/platforms/android.qdoc7
-rw-r--r--doc/src/platforms/platform-notes-android.qdoc18
2 files changed, 25 insertions, 0 deletions
diff --git a/doc/src/platforms/android.qdoc b/doc/src/platforms/android.qdoc
index 98af19da..27fe5e18 100644
--- a/doc/src/platforms/android.qdoc
+++ b/doc/src/platforms/android.qdoc
@@ -137,6 +137,13 @@ application to Android using the qrc approach:
\note You can change the default settings for application icons and
identifier.
+ \li If your application uses imports or plugins which depend on special Qt
+ modules, these Qt modules should be added to the .pro file. For example, if
+ your app uses the \l{Qt Multimedia} import in QML, you should add the
+ following to your .pro file:
+ \code
+ QT += multimedia
+ \endcode
\li Save the changes to your project and run the application.
\endlist
diff --git a/doc/src/platforms/platform-notes-android.qdoc b/doc/src/platforms/platform-notes-android.qdoc
index 67e2c4fa..9605b6e4 100644
--- a/doc/src/platforms/platform-notes-android.qdoc
+++ b/doc/src/platforms/platform-notes-android.qdoc
@@ -95,6 +95,24 @@
opening the \b Run settings of your project, expanding \b{Deploy Configurations} and choosing
\b{Deploy local Qt libraries}. Make sure the \b{Use local Qt libraries} check box is also ticked.
+ \section1 Plugins and Imports Special Considerations
+
+ If an application uses plugins or imports that depend on other modules, these modules have to
+ be listed in the application's dependencies. This is because Qt Creator does not know ahead
+ of time which imports or plugins your application will end up loading.
+
+ For example, if your application's QML code imports \l{Qt Multimedia}, then the Qt Multimedia module
+ must explicitly be made a dependency of the application. You can do this by adding it to the
+ application .pro file:
+
+ \code
+ QT += multimedia
+ \endcode
+
+ It is also possible to manually enable dependencies on Qt libraries by opening the
+ \gui Run settings of your project, expanding \gui{Package configurations} and selecting the
+ \gui Libraries tab. Manually check the libraries that are dependencies of your project.
+
\section1 OpenGL Special Considerations
Qt for Android provides two separate platform plugins: One which is suited for traditional