aboutsummaryrefslogtreecommitdiffstats
path: root/src/androidextras/android/qandroidbinder.cpp
diff options
context:
space:
mode:
authorAssam Boudjelthia <[email protected]>2021-05-11 12:49:40 +0300
committerAssam Boudjelthia <[email protected]>2021-06-29 14:08:24 +0300
commitae24e41ad4da78b029fd42ea317e4d2be73b015e (patch)
tree3f2d8c44dbf5a3eb666a7782bb5c1dfd62481c8e /src/androidextras/android/qandroidbinder.cpp
parentede82024b08842e9599b9bdbd00b7498601a921f (diff)
Remove QtAndroidExtras module and add note about its state in Qt 6HEADdev
The JNI utilities (i.e. QJniObject, QJniEnvironment) are already under qtbase as public APIs. Permission handling is now under QCoreApplication::{check,request}Permission and QPermission namespace. Some of the QtAndroid namespace functions are now under QNativeInterface's QAndroidApplication, this includes: * sdkVersion() * hideSplashScreen() * context() and isActivityContext() * runOnAndroidMainThread() The remaining APIs are now moved as private APIs under qtbase ee05af296f65e240f64db6470cdddafbddbf2fa3. That is until we add new cross-platform APIs to replace their functionalities like Intents handling, starting activites and working with Services. Task-number: QTBUG-83251 Task-number: QTBUG-84382 Pick-to: 6.2 Change-Id: Id077f8cbbe223a987916f737fad6088fb58e470d Reviewed-by: Ville Voutilainen <[email protected]>
Diffstat (limited to 'src/androidextras/android/qandroidbinder.cpp')
-rw-r--r--src/androidextras/android/qandroidbinder.cpp168
1 files changed, 0 insertions, 168 deletions
diff --git a/src/androidextras/android/qandroidbinder.cpp b/src/androidextras/android/qandroidbinder.cpp
deleted file mode 100644
index e6df77c..0000000
--- a/src/androidextras/android/qandroidbinder.cpp
+++ /dev/null
@@ -1,168 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2017 BogDan Vatra <[email protected]>
-** Contact: https://www.qt.io/licensing/
-**
-** This file is part of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:LGPL$
-** 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 Lesser General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU Lesser
-** General Public License version 3 as published by the Free Software
-** Foundation and appearing in the file LICENSE.LGPL3 included in the
-** packaging of this file. Please review the following information to
-** ensure the GNU Lesser General Public License version 3 requirements
-** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
-**
-** GNU General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU
-** General Public License version 2.0 or (at your option) the GNU General
-** Public license version 3 or any later version approved by the KDE Free
-** Qt Foundation. The licenses are as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
-** included in the packaging of this file. Please review the following
-** information to ensure the GNU General Public License requirements will
-** be met: https://www.gnu.org/licenses/gpl-2.0.html and
-** https://www.gnu.org/licenses/gpl-3.0.html.
-**
-** $QT_END_LICENSE$
-**
-****************************************************************************/
-
-#include "qandroidbinder.h"
-
-#include "qandroidbinder_p.h"
-#include "qandroidparcel.h"
-#include "qandroidparcel_p.h"
-
-#include <jni/qandroidjnienvironment.h>
-
-QT_BEGIN_NAMESPACE
-QAndroidBinderPrivate::QAndroidBinderPrivate(QAndroidBinder *binder)
- : handle("org/qtproject/qt/android/extras/QtAndroidBinder", "(J)V", jlong(binder))
- , m_isQtAndroidBinder(true)
-{
- QAndroidJniExceptionCleaner cleaner;
-}
-
-QAndroidBinderPrivate::QAndroidBinderPrivate(const QAndroidJniObject &binder)
- : handle(binder)
- , m_isQtAndroidBinder(false)
-{
-}
-
-QAndroidBinderPrivate::~QAndroidBinderPrivate()
-{
- if (m_isQtAndroidBinder) {
- QAndroidJniExceptionCleaner cleaner;
- handle.callMethod<void>("setId", "(J)V", jlong(0));
- if (m_deleteListener)
- m_deleteListener();
- }
-}
-
-/*!
- \class QAndroidBinder
- \inmodule QtAndroidExtras
- \brief Wraps the most important methods of Android Binder class.
-
- The QAndroidBinder is a convenience class that wraps the most important
- \l {https://developer.android.com/reference/android/os/Binder.html}{Android Binder}
- methods.
-
- \since 5.10
-*/
-
-
-/*!
- \enum QAndroidBinder::CallType
-
- This enum is used with \l QAndroidBinder::transact() to describe the mode in which the
- IPC call is performed.
-
- \value Normal normal IPC, meaning that the caller waits the result from the callee
- \value OneWay one-way IPC, meaning that the caller returns immediately, without waiting for a result from the callee
-*/
-
-/*!
- Creates a new object which can be used to perform IPC.
-
- \sa onTransact, transact
- */
-QAndroidBinder::QAndroidBinder()
- : d(new QAndroidBinderPrivate(this))
-{
-}
-
-/*!
- Creates a new object from the \a binder Java object.
-
- \sa transact
- */
-QAndroidBinder::QAndroidBinder(const QAndroidJniObject &binder)
- : d(new QAndroidBinderPrivate(binder))
-{
-}
-
-QAndroidBinder::~QAndroidBinder()
-{
-}
-
-/*!
- Default implementation is a stub that returns false.
- The user should override this method to get the transact data from the caller.
-
- The \a code is the action to perform.
- The \a data is the marshaled data sent by the caller.\br
- The \a reply is the marshaled data to be sent to the caller.\br
- The \a flags are the additional operation flags.\br
-
- \warning This method is called from Binder's thread which is different
- from the thread that this object was created.
-
- \sa transact
- */
-bool QAndroidBinder::onTransact(int /*code*/, const QAndroidParcel &/*data*/, const QAndroidParcel &/*reply*/, CallType /*flags*/)
-{
- return false;
-}
-
-/*!
- Performs an IPC call
-
- The \a code is the action to perform. Should be between
- \l {https://developer.android.com/reference/android/os/IBinder.html#FIRST_CALL_TRANSACTION}
- {FIRST_CALL_TRANSACTION} and
- \l {https://developer.android.com/reference/android/os/IBinder.html#LAST_CALL_TRANSACTION}
- {LAST_CALL_TRANSACTION}.\br
- The \a data is the marshaled data to send to the target.\br
- The \a reply (if specified) is the marshaled data to be received from the target.
- May be \b nullptr if you are not interested in the return value.\br
- The \a flags are the additional operation flags.\br
-
- \return true on success
- */
-bool QAndroidBinder::transact(int code, const QAndroidParcel &data, QAndroidParcel *reply, CallType flags) const
-{
- QAndroidJniExceptionCleaner cleaner;
- return d->handle.callMethod<jboolean>("transact", "(ILandroid/os/Parcel;Landroid/os/Parcel;I)Z",
- jint(code), data.d->handle.object(), reply ? reply->d->handle.object() : nullptr, jint(flags));
-}
-
-/*!
- The return value is useful to call other Java API which are not covered by this wrapper
- */
-QAndroidJniObject QAndroidBinder::handle() const
-{
- return d->handle;
-}
-
-QT_END_NAMESPACE