Revision control
Copy as Markdown
// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qharmonyappjscontext.h"
#include <QtCore/private/qcore_ohos_p.h>
QT_BEGIN_NAMESPACE
namespace {
QOhosJsState &jsState()
{
return QOhosJsThreadOps::instance().jsState();
}
}
/*!
\class QHarmonyAppJsContext
\inmodule QtCore
\brief The QHarmonyAppJsContext class gives code on the JS thread of a
HarmonyOS application access to the application's state.
QHarmonyJsContext describes the JS runtime. QHarmonyAppJsContext holds
the state of the application in that runtime, such as its default
\c UIAbility instance. Keeping the two apart makes function signatures
meaningful. A function that takes a QHarmonyAppJsContext depends on the
application's state. A function that takes a QHarmonyJsContext needs
only the runtime. A task gets the application context once, with
fromJsContext(), and passes it on.
The class derives from QHarmonyJsContext, and there is only one object.
QHarmonyJsContext::fromEnv() returns it as the base class. All member
functions must be called on the JS thread. References to it and its
\c napi_value results follow the lifetime rules of QHarmonyJsContext.
\sa {Qt for HarmonyOS Platform API}
*/
QHarmonyAppJsContext::QHarmonyAppJsContext() = default;
QHarmonyAppJsContext::~QHarmonyAppJsContext() = default;
/*!
Returns the application context of \a env. \a env must be the
environment of the JS thread. The returned context is valid as long as
\a env.
Use this function in a JS callback created with
\c napi_create_function(), which receives only the \c napi_env.
*/
QHarmonyAppJsContext &QHarmonyAppJsContext::fromEnv(napi_env env)
{
Q_ASSERT(env == jsState().env());
static QHarmonyAppJsContext appJsContext;
return appJsContext;
}
/*!
Returns the application context of \a jsContext. The returned context is
valid as long as \a jsContext.
*/
QHarmonyAppJsContext &QHarmonyAppJsContext::fromJsContext(QHarmonyJsContext &jsContext)
{
return fromEnv(jsContext.env());
}
/*!
Returns the default ArkTS \c UIAbility instance of the application. This
is the first instance created for the application or, once that instance
is destroyed, another live instance. The result can therefore change
over the lifetime of the process. Returns \nullptr when no ability is
left, which happens at some stages of application shutdown. Also returns
\nullptr in a child process started without a UI, where no ability
exists.
The ability is the entry point to the ability-bound platform APIs. Its
\c context property is the \c UIAbilityContext. APIs such as
\c {notificationManager.requestEnableNotification()},
\c {systemShare.ShareController.show()}, and \c {iap.createPurchase()}
take this context. \c context.getApplicationContext() returns the
\c ApplicationContext, which provides \c restartApp() and the
application directories.
*/
napi_value QHarmonyAppJsContext::defaultAbility()
{
return jsState().defaultQAbility().value_or(QNapi::Object());
}
QT_END_NAMESPACE