From 5fe74434c1c13d4147d44919c61b66a80f527fa2 Mon Sep 17 00:00:00 2001
From: Venugopal Shivashankar <venugopal.shivashankar@digia.com>
Date: Tue, 11 Jun 2013 14:23:35 +0200
Subject: [PATCH] Doc: tutorial for developing an Android app
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
This tutorial explains how to create an app
that uses Qt Sensors QML module to move an
SVG image based on the changing accelerometer
values.
Change-Id: Id4d9c8b389c5b8ebb330c6dba2dee783a475ba17
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
---
.../creator_android_tutorial_ex_app.png | Bin 0 -> 5181 bytes
doc/snippets/qml/tutorial_finalmainqml.qml | 118 +++++++
doc/snippets/qml/tutorial_initialqml.qml | 47 +++
doc/snippets/qml/tutorial_updatedmainview.qml | 62 ++++
doc/snippets/tutorial_accelbubble.pro | 7 +
doc/snippets/tutorial_main.cpp | 50 +++
.../android/creator-android-app-tutorial.qdoc | 288 ++++++++++++++++++
doc/src/overview/creator-tutorials.qdoc | 5 +
.../projects/creator-projects-overview.qdoc | 2 +-
doc/src/qtcreator.qdoc | 1 +
doc/src/widgets/qtdesigner-app-tutorial.qdoc | 2 +-
11 files changed, 580 insertions(+), 2 deletions(-)
create mode 100755 doc/images/creator_android_tutorial_ex_app.png
create mode 100644 doc/snippets/qml/tutorial_finalmainqml.qml
create mode 100644 doc/snippets/qml/tutorial_initialqml.qml
create mode 100644 doc/snippets/qml/tutorial_updatedmainview.qml
create mode 100644 doc/snippets/tutorial_accelbubble.pro
create mode 100644 doc/snippets/tutorial_main.cpp
create mode 100644 doc/src/android/creator-android-app-tutorial.qdoc
diff --git a/doc/images/creator_android_tutorial_ex_app.png b/doc/images/creator_android_tutorial_ex_app.png
new file mode 100755
index 0000000000000000000000000000000000000000..84e876d5f95ff45da384e6c6758d5879d2f430b3
GIT binary patch
literal 5181
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
OZW9A@{c^<3xPJkWO7`*q
literal 0
HcmV?d00001
diff --git a/doc/snippets/qml/tutorial_finalmainqml.qml b/doc/snippets/qml/tutorial_finalmainqml.qml
new file mode 100644
index 00000000000..1332a86c634
--- /dev/null
+++ b/doc/snippets/qml/tutorial_finalmainqml.qml
@@ -0,0 +1,118 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+** * Redistributions of source code must retain the above copyright
+** notice, this list of conditions and the following disclaimer.
+** * Redistributions in binary form must reproduce the above copyright
+** notice, this list of conditions and the following disclaimer in
+** the documentation and/or other materials provided with the
+** distribution.
+** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
+** of its contributors may be used to endorse or promote products derived
+** from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+import QtQuick 2.1
+import QtQuick.Controls 1.0
+
+//! [sensorimport]
+import QtSensors 5.0
+//! [sensorimport]
+
+
+ApplicationWindow {
+ title: "Accelerate Bubble"
+ id: mainWindow
+ width: 320
+ height: 480
+ visible: true
+
+ Accelerometer {
+ id: accel
+ dataRate: 100
+ active:true
+
+
+//! [readingchanged]
+ onReadingChanged: {
+ var newX = (bubble.x + calcRoll(accel.reading.x, accel.reading.y, accel.reading.z) * 0.1)
+ var newY = (bubble.y - calcPitch(accel.reading.x, accel.reading.y, accel.reading.z) * 0.1)
+
+ if (newX < 0)
+ newX = 0
+
+ if (newX > mainWindow.width - bubble.width)
+ newX = mainWindow.width - bubble.width
+
+ if (newY < 18)
+ newY = 18
+
+ if (newY > mainWindow.height - bubble.height)
+ newY = mainWindow.height - bubble.height
+
+ bubble.x = newX
+ bubble.y = newY
+ }
+//! [readingchanged]
+ }
+
+//! [jsfunctions]
+ function calcPitch(x, y, z) {
+ return -(Math.atan(y / Math.sqrt(x * x + z * z)) * 57.2957795);
+ }
+ function calcRoll(x, y, z) {
+ return -(Math.atan(x / Math.sqrt(y * y + z * z)) * 57.2957795);
+ }
+//! [jsfunctions]
+
+ Image {
+ id: bubble
+ source: "Bluebubble.svg"
+ smooth: true
+ property real centerX: mainWindow.width / 2
+ property real centerY: mainWindow.height / 2;
+ property real bubbleCenter: bubble.width / 2
+ x: centerX - bubbleCenter
+ y: centerY - bubbleCenter
+
+//! [smoothedanim]
+ Behavior on y {
+ SmoothedAnimation {
+ easing.type: Easing.Linear
+ duration: 100
+ }
+ }
+ Behavior on x {
+ SmoothedAnimation {
+ easing.type: Easing.Linear
+ duration: 100
+ }
+ }
+//! [smoothedanim]
+ }
+}
diff --git a/doc/snippets/qml/tutorial_initialqml.qml b/doc/snippets/qml/tutorial_initialqml.qml
new file mode 100644
index 00000000000..56f55c678bf
--- /dev/null
+++ b/doc/snippets/qml/tutorial_initialqml.qml
@@ -0,0 +1,47 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+** * Redistributions of source code must retain the above copyright
+** notice, this list of conditions and the following disclaimer.
+** * Redistributions in binary form must reproduce the above copyright
+** notice, this list of conditions and the following disclaimer in
+** the documentation and/or other materials provided with the
+** distribution.
+** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
+** of its contributors may be used to endorse or promote products derived
+** from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+//! [initialcode]
+import QtQuick 2.0
+
+Rectangle {
+ width: 100
+ height: 62
+}
+//! [initialcode]
diff --git a/doc/snippets/qml/tutorial_updatedmainview.qml b/doc/snippets/qml/tutorial_updatedmainview.qml
new file mode 100644
index 00000000000..bb4dfba0474
--- /dev/null
+++ b/doc/snippets/qml/tutorial_updatedmainview.qml
@@ -0,0 +1,62 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+** * Redistributions of source code must retain the above copyright
+** notice, this list of conditions and the following disclaimer.
+** * Redistributions in binary form must reproduce the above copyright
+** notice, this list of conditions and the following disclaimer in
+** the documentation and/or other materials provided with the
+** distribution.
+** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
+** of its contributors may be used to endorse or promote products derived
+** from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+//! [imports]
+import QtQuick 2.1
+import QtQuick.Controls 1.0
+//! [imports]
+
+ApplicationWindow {
+ title: "Accelerate Bubble"
+ id: mainWindow
+ width: 320
+ height: 480
+ visible: true
+
+ Image {
+ id: bubble
+ source: "Bluebubble.svg"
+ smooth: true
+ property real centerX: mainWindow.width / 2
+ property real centerY: mainWindow.height / 2
+ property real bubbleCenter: bubble.width / 2
+ x: centerX - bubbleCenter
+ y: centerY - bubbleCenter
+ }
+}
diff --git a/doc/snippets/tutorial_accelbubble.pro b/doc/snippets/tutorial_accelbubble.pro
new file mode 100644
index 00000000000..430e671df39
--- /dev/null
+++ b/doc/snippets/tutorial_accelbubble.pro
@@ -0,0 +1,7 @@
+RESOURCES += \
+ accelbubble.qrc
+
+SOURCES += \
+ main.cpp
+
+QT += quick sensors svg xml
diff --git a/doc/snippets/tutorial_main.cpp b/doc/snippets/tutorial_main.cpp
new file mode 100644
index 00000000000..e5ba8ab34a0
--- /dev/null
+++ b/doc/snippets/tutorial_main.cpp
@@ -0,0 +1,50 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+** * Redistributions of source code must retain the above copyright
+** notice, this list of conditions and the following disclaimer.
+** * Redistributions in binary form must reproduce the above copyright
+** notice, this list of conditions and the following disclaimer in
+** the documentation and/or other materials provided with the
+** distribution.
+** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
+** of its contributors may be used to endorse or promote products derived
+** from this software without specific prior written permission.
+**
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+#include <QtGui/QGuiApplication>
+#include <QtQml/QQmlApplicationEngine>
+
+int main(int argc, char *argv[])
+{
+ QGuiApplication app(argc, argv);
+ QQmlApplicationEngine engine(QUrl("qrc:///accelbubble.qml"));
+
+ return app.exec();
+}
+
diff --git a/doc/src/android/creator-android-app-tutorial.qdoc b/doc/src/android/creator-android-app-tutorial.qdoc
new file mode 100644
index 00000000000..ecf946ab848
--- /dev/null
+++ b/doc/src/android/creator-android-app-tutorial.qdoc
@@ -0,0 +1,288 @@
+/****************************************************************************
+**
+** Copyright (c) 2013 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of Qt Creator
+**
+**
+** GNU Free Documentation License
+**
+** Alternatively, this file may be used under the terms of the GNU Free
+** Documentation License version 1.3 as published by the Free Software
+** Foundation and appearing in the file included in the packaging of this
+** file.
+**
+**
+****************************************************************************/
+
+// **********************************************************************
+// NOTE: the sections are not ordered by their logical order to avoid
+// reshuffling the file each time the index order changes (i.e., often).
+// Run the fixnavi.pl script to adjust the links to the index order.
+// **********************************************************************
+
+/*!
+ \contentspage index.html
+ \previouspage creator-writing-program.html
+ \page creator-android-app-tutorial.html
+ \nextpage creator-project-managing.html
+
+ \title Creating an Android Application
+
+ This tutorial describes developing Qt Quick applications for Android devices
+ using Qt Quick Controls.
+
+ This tutorial describes how to use \QC to implement a Qt Quick application
+ that accelerates an SVG (Scalable Vector Graphics) image based on the
+ changing accelerometer values.
+
+ \image creator_android_tutorial_ex_app.png
+
+ \section1 Creating the Project
+
+ Let us start with creating an empty Qt project.
+
+ \list 1
+
+ \li Select \gui{File > New File or Project > Other Project >
+ Empty Qt Project > Choose}.
+
+ \li In the \gui{Name} field, type \b{accelbubble}.
+
+ \li In the \gui {Create in} field, enter the path for the project files.
+ For example, \c {C:\Qt\examples}, and then click \gui{Next} (on
+ Mac OS X, it is \gui Continue).
+
+ \li Select an Android \l{glossary-buildandrun-kit}{kit} for arm,
+ and click \gui{Next}.
+
+ \note Kits are listed if they have been specified in \gui Tools >
+ \gui Options > \gui{Build & Run} > \gui Kits.
+
+ \li Select \gui Next in the following dialogs to use the default
+ settings.
+
+ \li Review the project settings, and click \gui{Finish} (on Mac OS X,
+ it is \gui Done).
+ \endlist
+
+ \QC creates the project and displays its contents under the \gui Projects
+ view on the sidebar. You can only see a .pro file under the project as we
+ created an empty project, but the remaining bits will be added
+ during the course of this tutorial.
+
+ \section1 Creating the Main View
+
+ The main view of the application displays an SVG bubble image at the center
+ of the main window.
+
+ \list 1
+
+ \li In the \gui Edit mode, right-click on the \b{accelbubble} project
+ and select \gui{Add new} to open the \gui{New File} dialog.
+
+ \li Select \gui{Qt > QML File (Qt Quick 2)} and click \gui Choose to
+ give a name to the QML file.
+
+ \li In the \gui Name field, type "accelbubble" and select \gui Next.
+
+ \li Select \gui Finish to add accelbubble.qml to the project.
+ \endlist
+
+ \QC adds a default QML file containing a Rectangle. Here is how the QML
+ file looks:
+
+ \snippet qml/tutorial_initialqml.qml initialcode
+
+ Now let us edit accelbubble.qml to add the bits required for our
+ application.
+
+ \list 1
+
+ \li Replace the existing import statement with the following:
+
+ \snippet qml/tutorial_updatedmainview.qml imports
+
+ \li Replace the Rectangle type with ApplicationWindow, which
+ will be the top-level window for our application.
+
+ \li Set the \a id, \a title, \a visible, and the window dimension
+ properties (width and height) with the values given in the
+ following snippet:
+
+ \quotefromfile qml/tutorial_updatedmainview.qml
+ \skipto ApplicationWindow
+ \printuntil true
+ \skipto /^\}/
+ \printuntil }
+ \endlist
+
+ \section1 Adding an SVG Image
+
+ SVG is an XML-based image format that enables you to combine vector
+ graphics, raster graphics, and text into one image. It is based on
+ an open standard developed and maintained by \l{http://www.w3.org/}{W3C}.
+
+ Qt supports the \l{http://www.w3.org/TR/SVGTiny12/}{SVGT} v1.2, which is a
+ trimmed version of the \l{http://www.w3.org/TR/SVG12/}{SVG Full v1.2}
+ specification, for mobile devices.
+
+ You can copy the Bluebubble.svg used by the Qt Sensors example, Accel
+ Bubble, to your project directory or find an SVG image that uses SVGT v1.2.
+
+ \note If you choose to create a new SVG image, ensure that the \a svg root
+ element has the \a version attribute with the value 1.1 or 1.2, and baseProfile
+ with \c tiny.
+
+ \list 1
+ \li Open accelbubble.qml in \gui Edit mode and add an Image type
+ within the ApplicationWindow.
+ \li Set the image \a id, \a source, and \a smooth properties as shown
+ in the following code block:
+
+ \quotefromfile qml/tutorial_updatedmainview.qml
+ \skipto Image
+ \printuntil true
+
+ \li Add the following new properties to the image:
+
+ \dots
+ \printuntil bubbleCenter:
+
+ \note These properties are used to position the image
+ at the center of ApplicationWindow when the application starts.
+ \li Set the x and y position of the image based on the new
+ properties.
+
+ \dots
+ \printuntil }
+ \endlist
+
+ Here is how the accelbubble.qml file looks after making the changes
+ mentioned earlier in this section:
+
+ \quotefromfile qml/tutorial_updatedmainview.qml
+ \skipto import QtQuick
+ \printuntil 1.0
+ \codeline
+ \skipto ApplicationWindow
+ \printuntil true
+
+ \skipto Image
+ \printuntil /^\}\
+
+
+ \section1 Moving the Bubble
+
+ Now that the visual elements are in place, let us move the bubble based on
+ Accelerometer sensor values.
+
+ \list 1
+ \li Add the following import statement to accelbubble.qml:
+
+ \snippet qml/tutorial_finalmainqml.qml sensorimport
+
+ \li Add the Accelerometer type with the necessary properties as shown
+ in the following code block:
+
+ \quotefromfile qml/tutorial_finalmainqml.qml
+ \skipto Accelerometer
+ \printuntil true
+ \skipto }
+ \printuntil }
+
+ \li Add the following JavaScript functions that calculate the
+ x and y position of the bubble based on the current Accelerometer
+ values:
+
+ \snippet qml/tutorial_finalmainqml.qml jsfunctions
+
+ \li Add the following JavaScript code for \a onReadingChanged signal of
+ Accelerometer type to make the bubble move when the Accelerometer
+ values change:
+
+ \snippet qml/tutorial_finalmainqml.qml readingchanged
+
+ \li Add SmoothedAnimation behavior on the \a x and \a y properties of
+ the bubble to make its movement look smoother.
+
+ \snippet qml/tutorial_finalmainqml.qml smoothedanim
+ \endlist
+
+
+ \section1 Running the Application
+
+ The main view is complete but the application is not ready yet. This
+ section provides instructions to add a few lines of C++ code that loads the
+ QML file when you try to run the application on an Android device.
+
+ \list 1
+ \li Right-click on the project in \gui Edit mode and select
+ \gui{Add New > Qt > Qt Resource File}.
+
+ \li Name the resource file as \a accelbubble.qrc and click \gui Next.
+
+ \li Select \gui Finish in the following dialog to add the resource file
+ to the project and open it in \gui Edit mode.
+
+ \li Select \gui {Add > Add Prefix} and add \c / as the prefix.
+
+ \note The prefix is used every time you refer to the .qrc file
+ contents from the C++ code.
+
+ \li Select \gui {Add > Add Files} and add accelbubble.qml and Bluebubble.svg
+ to the resource file.
+
+ \li Right-click on the project in \gui Edit mode and select
+ \gui {Add New} to open the \gui {New File} dialog.
+
+ \li Select \gui {C++ > C++ Source File > Choose}
+
+ \li Name the file as \a main.cpp and click \gui Next.
+
+ \li Select \gui Finish to add main.cpp to the project and open it in
+ edit mode.
+
+ \li Add the following lines of C++ code to main.cpp to load the
+ accelbubble.qml file from accelbubble.qrc:
+
+ \quotefromfile tutorial_main.cpp
+ \skipto #include
+ \printuntil }
+
+ \li Update the accelbubble.pro file with the following library
+ dependency information:
+
+ \code
+ QT += quick sensors svg xml
+ \endcode
+ \endlist
+
+ The application is complete and ready to be deployed to the device.
+ Enable "USB Debugging" on your Android device and connect it to your PC.
+ If you are using a device running Android v4.2.2, it should prompt you to
+ verify the connection to allow USB debugging from the PC it is connected
+ to. To avoid such prompts every time you connect the device, check
+ "Always allow from the computer" and select \gui OK.
+
+ To run the application on the device, press CTRL + R keys in \QC
+ \gui Edit mode.
+
+ \section1 Example Code
+
+ When you have completed the steps mentioned in the earlier sections, the
+ accelbubble.qml, main.cpp, and accelbubble.pro files look as follows:
+
+ \section2 accelbubble.qml
+
+ \quotefile qml/tutorial_finalmainqml.qml
+
+ \section2 main.cpp
+
+ \quotefile tutorial_main.cpp
+
+ \section2 accelbubble.pro
+
+ \quotefile tutorial_accelbubble.pro
+*/
diff --git a/doc/src/overview/creator-tutorials.qdoc b/doc/src/overview/creator-tutorials.qdoc
index b3513c2943e..7dad18d9f98 100644
--- a/doc/src/overview/creator-tutorials.qdoc
+++ b/doc/src/overview/creator-tutorials.qdoc
@@ -46,6 +46,11 @@
Learn how to create a Qt widget based application for the desktop.
+ \li \l{Creating an Android Application}
+
+ Learn how to create a Qt Quick application using Qt Quick Controls
+ for Android devices.
+
\endlist
*/
diff --git a/doc/src/projects/creator-projects-overview.qdoc b/doc/src/projects/creator-projects-overview.qdoc
index 072368a03e7..a72d16a9df5 100644
--- a/doc/src/projects/creator-projects-overview.qdoc
+++ b/doc/src/projects/creator-projects-overview.qdoc
@@ -24,7 +24,7 @@
/*!
\contentspage index.html
- \previouspage creator-writing-program.html
+ \previouspage creator-android-app-tutorial.html
\page creator-project-managing.html
\nextpage creator-project-creating.html
diff --git a/doc/src/qtcreator.qdoc b/doc/src/qtcreator.qdoc
index f5662893675..b8d8ddc9d62 100644
--- a/doc/src/qtcreator.qdoc
+++ b/doc/src/qtcreator.qdoc
@@ -154,6 +154,7 @@
\list
\li \l{Creating a Qt Quick Application}
\li \l{Creating a Qt Widget Based Application}
+ \li \l{Creating an Android Application}
\endlist
\endlist
\li \l{Managing Projects}
diff --git a/doc/src/widgets/qtdesigner-app-tutorial.qdoc b/doc/src/widgets/qtdesigner-app-tutorial.qdoc
index 65a58b88a43..1cdfcf35060 100644
--- a/doc/src/widgets/qtdesigner-app-tutorial.qdoc
+++ b/doc/src/widgets/qtdesigner-app-tutorial.qdoc
@@ -26,7 +26,7 @@
\contentspage index.html
\previouspage creator-qml-application.html
\page creator-writing-program.html
- \nextpage creator-project-managing.html
+ \nextpage creator-android-app-tutorial.html
\title Creating a Qt Widget Based Application
--
GitLab