summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLeena Miettinen <riitta-leena.miettinen@digia.com>2013-10-28 11:10:55 +0100
committerLeena Miettinen <riitta-leena.miettinen@digia.com>2013-10-29 15:22:17 +0100
commit48fb32e0fe48226f59b6bf4008346281e12b82ef (patch)
tree22d2249507875dcc7c6d70f82314c5bf49b7a8dd /doc
parentbad74c6b558e817daf384df8eeb2d091d75d6fbd (diff)
downloadqt-creator-48fb32e0fe48226f59b6bf4008346281e12b82ef.tar.gz
Doc: update the Android tutorial
Use the Qt Quick Controls application wizard to streamline the process. Remove snippet files and store compilable example code in doc/examples. Do not store generated files. Change-Id: I920484e84b2ef23bce9e77a7b0eddf963fe94552 Reviewed-by: Venugopal Shivashankar <venugopal.shivashankar@digia.com> Reviewed-by: Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@digia.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/accelbubble/main.qml103
-rw-r--r--doc/snippets/qml/tutorial_finalmainqml.qml118
-rw-r--r--doc/snippets/qml/tutorial_initialqml.qml47
-rw-r--r--doc/snippets/qml/tutorial_updatedmainview.qml62
-rw-r--r--doc/snippets/tutorial_accelbubble.pro7
-rw-r--r--doc/snippets/tutorial_main.cpp50
-rw-r--r--doc/src/android/creator-android-app-tutorial.qdoc222
7 files changed, 182 insertions, 427 deletions
diff --git a/doc/examples/accelbubble/main.qml b/doc/examples/accelbubble/main.qml
new file mode 100644
index 0000000000..313be9cd70
--- /dev/null
+++ b/doc/examples/accelbubble/main.qml
@@ -0,0 +1,103 @@
+/****************************************************************************
+**
+** 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.
+// **********************************************************************
+
+import QtQuick 2.1
+import QtQuick.Controls 1.0
+
+import QtSensors 5.0
+
+ApplicationWindow {
+ title: qsTr("Accelerate Bubble")
+ id: mainWindow
+ width: 640
+ height: 480
+ visible: true
+
+ Accelerometer {
+ id: accel
+ dataRate: 100
+ active:true
+
+ 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
+ }
+ }
+
+ 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);
+ }
+
+ 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
+
+ Behavior on y {
+ SmoothedAnimation {
+ easing.type: Easing.Linear
+ duration: 100
+ }
+ }
+ Behavior on x {
+ SmoothedAnimation {
+ easing.type: Easing.Linear
+ duration: 100
+ }
+ }
+
+ MenuBar {
+ Menu {
+ title: qsTr("File")
+ MenuItem {
+ text: qsTr("Exit")
+ onTriggered: Qt.quit();
+ }
+ }
+ }
+ }
+}
diff --git a/doc/snippets/qml/tutorial_finalmainqml.qml b/doc/snippets/qml/tutorial_finalmainqml.qml
deleted file mode 100644
index 1332a86c63..0000000000
--- a/doc/snippets/qml/tutorial_finalmainqml.qml
+++ /dev/null
@@ -1,118 +0,0 @@
-/****************************************************************************
-**
-** 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
deleted file mode 100644
index 56f55c678b..0000000000
--- a/doc/snippets/qml/tutorial_initialqml.qml
+++ /dev/null
@@ -1,47 +0,0 @@
-/****************************************************************************
-**
-** 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
deleted file mode 100644
index bb4dfba047..0000000000
--- a/doc/snippets/qml/tutorial_updatedmainview.qml
+++ /dev/null
@@ -1,62 +0,0 @@
-/****************************************************************************
-**
-** 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
deleted file mode 100644
index 430e671df3..0000000000
--- a/doc/snippets/tutorial_accelbubble.pro
+++ /dev/null
@@ -1,7 +0,0 @@
-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
deleted file mode 100644
index e5ba8ab34a..0000000000
--- a/doc/snippets/tutorial_main.cpp
+++ /dev/null
@@ -1,50 +0,0 @@
-/****************************************************************************
-**
-** 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
index ecf946ab84..c0bdba9d24 100644
--- a/doc/src/android/creator-android-app-tutorial.qdoc
+++ b/doc/src/android/creator-android-app-tutorial.qdoc
@@ -41,20 +41,18 @@
\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 Select \gui File > \gui {New File or Project} > \gui Applications >
+ \gui {Qt Quick 2 Application (Qt Quick Controls)} > \gui 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).
+ For example, \c {C:\Qt\examples}, and then click \gui{Next} (or
+ \gui Continue on Mac OS X).
- \li Select an Android \l{glossary-buildandrun-kit}{kit} for arm,
+ \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 >
@@ -63,106 +61,73 @@
\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).
+ \li Review the project settings, and click \gui{Finish} (or \gui Done on
+ Mac OS X).
+
\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.
+ \QC generates a default QML file that you can modify to create the main view
+ of the application.
\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.
+ To use the Bluebubble.svg used by the Qt Sensors example, Accel Bubble, in
+ your project, you must copy it to the project directory (same subdirectory
+ as the QML file) from the examples directory in the Qt installation
+ directory. For example:
+ \c {C:\Qt\Qt5.2.0\5.2.0\msvc2010\examples\sensors\accelbubble\content}.
+ The image appears in the \gui Resources pane. You can also use any other
+ image or a QML type, instead.
\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 In the \gui Projects view, double-click the main.qml file
+ to open it in the code editor.
- \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:
+ \li Modify the properties of the ApplicationWindow type to specify the
+ application name, give the ApplicationWindow an id, and to set it
+ visible, as illustrated by the following code snippet:
- \quotefromfile qml/tutorial_updatedmainview.qml
+ \quotefromfile accelbubble/main.qml
\skipto ApplicationWindow
- \printuntil true
+ \printuntil visible
\skipto /^\}/
\printuntil }
- \endlist
- \section1 Adding an SVG Image
+ \li Click \gui Design to open the file in \QMLD.
- 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}.
+ \li In the \gui Navigator pane, select \gui Button and press \key Delete
+ to delete it.
- 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.
+ \li In the \gui Library view, \gui Resources tab, select Bluebubble.svg
+ and drag and drop it to the canvas.
- 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.
+ \li In the \gui Properties pane, \gui Id field, enter \e bubble to be
+ able to reference the image from other places.
- \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:
+ \li In the code editor, add the following new properties to the image to
+ position the image at the center of ApplicationWindow when the
+ application starts:
- \quotefromfile qml/tutorial_updatedmainview.qml
+ \quotefromfile accelbubble/main.qml
\skipto Image
- \printuntil true
+ \printuntil bubble.width
- \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.
+ \li Set the x and y position of the image based on the new
+ properties:
\dots
+ \printuntil centerY
+ \skipto /^\}/
\printuntil }
\endlist
- Here is how the accelbubble.qml file looks after making the changes
- mentioned earlier in this section:
+ Here is how the accelbubble.qml file looks after you made the changes:
- \quotefromfile qml/tutorial_updatedmainview.qml
+ \quotefromfile accelbubble/main.qml
\skipto import QtQuick
\printuntil 1.0
\codeline
@@ -170,7 +135,9 @@
\printuntil true
\skipto Image
- \printuntil /^\}\
+ \printuntil y:
+ \skipto /^\}/
+ \printuntil }
\section1 Moving the Bubble
@@ -179,14 +146,15 @@
Accelerometer sensor values.
\list 1
- \li Add the following import statement to accelbubble.qml:
+ \li Add the following import statement to main.qml:
- \snippet qml/tutorial_finalmainqml.qml sensorimport
+ \code
+ import QtSensors 5.0
+ \endcode
- \li Add the Accelerometer type with the necessary properties as shown
- in the following code block:
+ \li Add the Accelerometer type with the necessary properties:
- \quotefromfile qml/tutorial_finalmainqml.qml
+ \quotefromfile accelbubble/main.qml
\skipto Accelerometer
\printuntil true
\skipto }
@@ -196,93 +164,61 @@
x and y position of the bubble based on the current Accelerometer
values:
- \snippet qml/tutorial_finalmainqml.qml jsfunctions
+ \quotefromfile accelbubble/main.qml
+ \skipto function
+ \printuntil Math.atan(x
+ \printuntil }
\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
+ \quotefromfile accelbubble/main.qml
+ \skipto onReadingChanged
+ \printuntil }
\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
+ \quotefromfile accelbubble/main.qml
+ \skipto Behavior
+ \printuntil x
+ \printuntil }
+ \printuntil }
\endlist
+ \section1 Adding Dependencies
- \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}
+ Update the accelbubble.pro file with the following library dependency
+ information:
- \li Name the file as \a main.cpp and click \gui Next.
+ \code
+ QT += quick sensors svg xml
+ \endcode
- \li Select \gui Finish to add main.cpp to the project and open it in
- edit mode.
+ \section1 Running the Application
- \li Add the following lines of C++ code to main.cpp to load the
- accelbubble.qml file from accelbubble.qrc:
+ The application is complete and ready to be deployed to an Android device:
- \quotefromfile tutorial_main.cpp
- \skipto #include
- \printuntil }
+ \list 1
- \li Update the accelbubble.pro file with the following library
- dependency information:
+ \li Enable \e{USB Debugging} on the device.
- \code
- QT += quick sensors svg xml
- \endcode
- \endlist
+ \li Connect the device to the development PC.
- 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.
+ \li To run the application on the device, press \key {Ctrl+R}.
- \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
+ \endlist
- \section2 main.cpp
+ \section1 Example Code
- \quotefile tutorial_main.cpp
+ When you have completed the steps, the main.qml file should look as follows:
- \section2 accelbubble.pro
+ \quotefile accelbubble/main.qml
- \quotefile tutorial_accelbubble.pro
*/