diff options
Diffstat (limited to 'src/positioning/doc/src/qtpositioning-android.qdoc')
-rw-r--r-- | src/positioning/doc/src/qtpositioning-android.qdoc | 82 |
1 files changed, 0 insertions, 82 deletions
diff --git a/src/positioning/doc/src/qtpositioning-android.qdoc b/src/positioning/doc/src/qtpositioning-android.qdoc deleted file mode 100644 index 1857574e..00000000 --- a/src/positioning/doc/src/qtpositioning-android.qdoc +++ /dev/null @@ -1,82 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2021 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** 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. -** -** GNU Free Documentation License Usage -** 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. Please review the following information to ensure -** the GNU Free Documentation License version 1.3 requirements -** will be met: https://www.gnu.org/licenses/fdl-1.3.html. -** $QT_END_LICENSE$ -** -****************************************************************************/ - -/*! -\page qtpositioning-android.html -\inmodule QtPositioning -\title Qt Positioning on Android -\brief Notes on using Qt Positioning on Android - -\section1 Using Qt Positioning from Android Services - -Using Qt Positioning from a service requires several extra actions to be taken, -depending on the Android version. The sections below give more details on -these actions. - -\note Since Android 8 (API level 26), the OS limits how frequently an -application can retrieve the user's current location while running in the -background. The application will normally be able to receive location updates -only a few times each hour. For more information, see -\l {Background Location Limits}. - -\section2 Using Foreground Service - -Since Android 8 (API level 26), the background service can be killed by the -Android OS when the application goes to the background. This normally happens -after around a minute of running in the background. To keep the location service -running, the service should be implemented as a \l {Foreground Service}. Such -service shows a status bar notification, which cannot be dismissed until the -service is stopped or removed from the foreground. This allows the user to be -always aware of the important background activities. - -\note Since Android 9 (API level 28), foreground services require a special -\c FOREGROUND_SERVICE permission. See the Android documentation for more -details on implementing foreground services. - -\section2 Use Background Location Permission - -Since Android 10 (API level 29), the service \e must request the -\l {ACCESS_BACKGROUND_LOCATION} permission. It should be added to the -\c AndroidManifest.xml file as follows: - -\badcode -<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> -\endcode - -\note Once the permission is added to \c {AndroidManifest.xml}, it is still -required to explicitly allow the constant access to the location services -for the application. To do it, one should navigate to \uicontrol Settings -> -\uicontrol {Apps}, select a proper application, open its permissions, and -specify the \uicontrol {Allow all the time} permission for Location -(see the screenshot below). - -\image permissions.png - -Check \l {Access Location in the Background} Android documentation for more -details. - -*/ |