aboutsummaryrefslogtreecommitdiffstats
path: root/examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc')
-rw-r--r--examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc116
1 files changed, 0 insertions, 116 deletions
diff --git a/examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc b/examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc
deleted file mode 100644
index 7aeef0a..0000000
--- a/examples/androidextras/services/servicesameprocess/doc/src/qtandroidextras-example-service-same-process.qdoc
+++ /dev/null
@@ -1,116 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2020 The Qt Company Ltd.
-** Contact: https://www.qt.io/licensing/
-**
-** This file is part of the QtAndroidExtras module of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:BSD$
-** Commercial License Usage
-** Licensees holding valid commercial Qt licenses may use this file in
-** accordance with the commercial license agreement provided with the
-** Software or, alternatively, in accordance with the terms contained in
-** a written agreement between you and The Qt Company. For licensing terms
-** and conditions see https://www.qt.io/terms-conditions. For further
-** information use the contact form at https://www.qt.io/contact-us.
-**
-** BSD License Usage
-** Alternatively, 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 The Qt Company Ltd 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$
-**
-****************************************************************************/
-
-/*!
- \title Native Android Service in Same Process
- \ingroup examples-qtandroidextras
- \example services/servicesameprocess
- \brief Demonstrates how to run an Android service in the main process,
- and how to communicate between QML/C++ and a Java service.
-
- \image androidservices.png
-
- This example demonstrates how to create and run a simple Android service in
- the same process as the main activity \c QtActivity, and then exchange data
- between QML/C++ and the Java service. This service is a pure Java
- implementation.
-
- When clicking the \uicontrol {Send to Service} button, the name entered in
- the QML view, Qt, in this case, is sent to the Android service. Then, the service
- replies back with a message \c {Hello Qt} which is printed in the QML view.
-
- \include examples-run.qdocinc
-
- \section1 Create the Service
-
- When running the app's process, you can extend either \c QtService or \c Service.
- Extending \c QtService allows Qt to load all the necessary libraries to load
- Qt components correctly and call native methods on Android. However, here
- the service is running in the same process, so extending either class works.
-
- Start by creating the Java service class. This is a normal Android \c Service
- that receives a name from QML and replies back with \c {Hello <name>}:
-
- \quotefromfile services/servicesameprocess/android/src/org/qtproject/example/qtandroidservice/QtAndroidService.java
- \skipto package
- \printuntil /^\}/
-
- In the overwritten method
- \l{Android: Service onStartCommand}{onStartCommand()}, the service receives a
- name from the calling intent, then calls the native method
- \c {sendToQt(String message)}. For more information on managing native
- calls in Qt, see \l{Calling QML/C++ Functions from Java Code}.
-
- \section1 Manage the AndroidManifest.xml File
-
- To use the service, it must be declared in the \c AndroidManifest.xml
- file. When using pure Android Service in the main app process, use the following:
-
- \quotefromfile services/servicesameprocess/android/AndroidManifest.xml
- \skipto <service
- \printuntil </service>
-
- \section1 Start the Service
-
- Before starting the service, register the native methods, then call the
- \l{Android: Service startService}{startService()} method, as follows:
-
- \quotefromfile services/servicesameprocess/qtandroidservice.cpp
- \skipto sendToService
- \printuntil /^\}/
-
- This function is used to start the Service. If the service is already running,
- it will only send the names without starting a new service instance.
-
- Then, you have to add the necessary \l Connections, as described in
- \l{Qt JNI Messenger}{Qt JNI Messenger Example}.
-
- \sa {Android Services}, {Qt for Android}, {Qt Android Extras}
-*/