9#include <napi/native_api.h>
13#include <QtCore/qbytearray.h>
14#include <QtCore/qdebug.h>
15#include <QtCore/qglobal.h>
16#include <QtCore/qjsonarray.h>
17#include <QtCore/qjsondocument.h>
18#include <QtCore/qjsonobject.h>
19#include <QtCore/qmap.h>
20#include <QtCore/qwaitcondition.h>
21#include <QtCore/qdir.h>
22#include <QtCore/private/qcore_unix_p.h>
23#include <QtCore/qvariant.h>
24#include <QtCore/private/qnapi_p.h>
25#include <QtCore/private/qohosappcontext_p.h>
26#include <QtCore/private/qohoscommon_p.h>
27#include <QtCore/private/qohospermissionshelper_p.h>
28#include <QtCore/private/qcoreapplication_p.h>
37#include <qohossinglethreadexecutor.h>
38#include <qpa/qwindowsysteminterface.h>
40#include <qohosapppermissions_p.h>
41#include <qohosdeviceinfo_p.h>
42#include <qohospermissionshelperimpl.h>
43#include <qohosplugincore.h>
44#include <qohosqpaenums.h>
47#include <sys/resource.h>
51#include <unordered_map>
53#include "qarkui/qxcomponentregistry.h"
64#include "render/qxcomponent.h"
68using namespace std::chrono_literals;
78extern "C" typedef int (*
Main)(
int,
char **);
85static std::vector<QNapi::Reference<QNapi::Object>> foregroundAbilities;
95constexpr const char *enableHotStartEnvVariableName =
"IO__QT__OHOS__ENABLE_HOT_START";
97constexpr const char *qtMainThreadStackSizeEnvVariableName =
"IO__QT__OHOS__QT_MAIN_THREAD_STACK_SIZE";
99constexpr std::size_t defaultQtThreadStackSize = 8 * 1024 * 1024;
101constexpr auto minSupportedOhosSdkApiVersion = 23;
104std::atomic<
bool> experimentalEnableGlBackinStore{
false};
105std::atomic<
bool> debugUseBasicStyleAndTheme{
false};
106std::atomic<
bool> debugDrawQtRasterBackingStoreFlushedRegion{
false};
107std::atomic<
bool> vsyncOnSoftwareBackingStoreEnabled{
true};
108std::atomic<
bool> enableNativeNodeApiKeyEvents{
true};
109std::atomic<
bool> enableNativeNodeApiMouseEvents{
true};
112const auto callerPidWantArgName =
"ohos.aafwk.param.callerPid";
113const auto qtAppProcessIdWantArgName =
"io.qt.private.appProcessId";
115const char *mapQtRunModeToString(
QtRunMode qtRunMode)
121 return "NoUiChildProcess";
124 qOhosReportFatalErrorAndAbort(
125 "%s: got unknown QtRunMode value: %d",
126 Q_FUNC_INFO,
static_cast<
int>(qtRunMode));
129struct QtAppStartConfig
131 std::string appLibraryPath;
132 bool watchdogEnabled =
true;
138 static AppContextDirs mapFromNapiObject(QNapi::Object appContextObj);
139 static AppContextDirs mapFromQOhosAppContextProperties(
const QMap<QOhosAppContext::Type, QString> &props);
141 QMap<QOhosAppContext::Type, QString> mapToQOhosAppContextProperties()
const;
142 QJsonObject mapToQJsonObject()
const;
144 std::string bundleCodeDir;
145 std::string cacheDir;
146 std::string filesDir;
147 std::string preferencesDir;
149 std::string databaseDir;
150 std::string distributedFilesDir;
151 std::string resourceDir;
154 static const std::pair<
const char *,
std::string AppContextDirs::*> propsNames[];
155 static const std::pair<QOhosAppContext::Type, std::string AppContextDirs::*> qOhosAppContextPropsMap[];
158const std::pair<
const char *,
std::string AppContextDirs::*> AppContextDirs::propsNames[] = {
159 {
"bundleCodeDir", &AppContextDirs::bundleCodeDir},
160 {
"cacheDir", &AppContextDirs::cacheDir},
161 {
"filesDir", &AppContextDirs::filesDir},
162 {
"preferencesDir", &AppContextDirs::preferencesDir},
163 {
"tempDir", &AppContextDirs::tempDir},
164 {
"databaseDir", &AppContextDirs::databaseDir},
165 {
"distributedFilesDir", &AppContextDirs::distributedFilesDir},
166 {
"resourceDir", &AppContextDirs::resourceDir},
169const std::pair<QOhosAppContext::Type, std::string AppContextDirs::*> AppContextDirs::qOhosAppContextPropsMap[] = {
170 {QOhosAppContext::Type::bundleCodeDir, &AppContextDirs::bundleCodeDir},
171 {QOhosAppContext::Type::cacheDir, &AppContextDirs::cacheDir},
172 {QOhosAppContext::Type::filesDir, &AppContextDirs::filesDir},
173 {QOhosAppContext::Type::preferencesDir, &AppContextDirs::preferencesDir},
174 {QOhosAppContext::Type::tempDir, &AppContextDirs::tempDir},
175 {QOhosAppContext::Type::databaseDir, &AppContextDirs::databaseDir},
176 {QOhosAppContext::Type::distributedFilesDir, &AppContextDirs::distributedFilesDir},
177 {QOhosAppContext::Type::resourceDir, &AppContextDirs::resourceDir},
180AppContextDirs AppContextDirs::mapFromNapiObject(QNapi::Object appContextObj)
182 AppContextDirs appContextDirs;
183 for (
const auto &propEntry : propsNames)
184 appContextDirs.*propEntry.second = appContextObj.get<QNapi::String>(propEntry.first);
186 return appContextDirs;
189AppContextDirs AppContextDirs::mapFromQOhosAppContextProperties(
190 const QMap<QOhosAppContext::Type, QString> &props)
192 AppContextDirs appContextDirs;
193 for (
const auto &propEntry : qOhosAppContextPropsMap)
194 appContextDirs.*propEntry.second = props[propEntry.first].toStdString();
195 return appContextDirs;
198QMap<QOhosAppContext::Type, QString> AppContextDirs::mapToQOhosAppContextProperties()
const
200 QMap<QOhosAppContext::Type, QString> qOhosAppContextProps;
201 for (
const auto &propEntry : qOhosAppContextPropsMap)
202 qOhosAppContextProps[propEntry.first] = QString::fromStdString(
this->*propEntry.second);
203 return qOhosAppContextProps;
206QJsonObject AppContextDirs::mapToQJsonObject()
const
209 for (
const auto &propEntry : propsNames)
210 json[QString::fromUtf8(propEntry.first)] = QString::fromStdString(
this->*propEntry.second);
214std::vector<std::string> splitString(
const std::string &inputStr,
char separator)
216 constexpr auto separatorSize = 1;
218 std::vector<std::string> result;
219 std::size_t currentPos = 0;
220 while (currentPos < inputStr.size()) {
221 auto separatorPos = inputStr.find(separator, currentPos);
222 result.push_back(inputStr.substr(currentPos, separatorPos));
223 currentPos = separatorPos != std::string::npos
224 ? separatorPos + separatorSize
231std::pair<QOhosConsumer<
bool>, std::function<
void()>> makeConditionFlagMTAccessors(
232 std::string conditionName)
236 std::string conditionName;
237 std::mutex conditionMutex;
238 std::condition_variable conditionCv;
239 bool condition =
false;
242 auto context = std::make_shared<Context>();
243 context->conditionName = std::move(conditionName);
246 [context](
bool condition) {
248 "%s: setting condition '%s' to %s",
249 Q_FUNC_INFO, context->conditionName.c_str(), mapBoolToTrueFalseStr(condition));
251 std::lock_guard<std::mutex> conditionLock(context->conditionMutex);
252 if (condition != context->condition) {
253 context->condition = condition;
254 context->conditionCv.notify_all();
259 qOhosPrintfDebug(
"%s: waiting for condition '%s'", Q_FUNC_INFO, context->conditionName.c_str());
261 std::unique_lock<std::mutex> conditionLock(context->conditionMutex);
262 context->conditionCv.wait(
265 return context->condition;
268 qOhosPrintfDebug(
"%s: condition '%s' met", Q_FUNC_INFO, context->conditionName.c_str());
273template<
typename FuncResult,
typename ...FuncArgs,
typename FuncFactory>
274auto makeLazyInitFunc(FuncFactory funcFactory) ->
std::function<FuncResult(FuncArgs...)>
276 using Func =
std::function<FuncResult(FuncArgs...)>;
277 return [func = Func(), factory = QOhosSupplier<Func>(
std::move(funcFactory))](FuncArgs ...args)
mutable {
279 func = std::exchange(factory,
nullptr)();
280 return func(
std::forward<FuncArgs>(args)...);
284std::function<
int(std::vector<std::string>)> openLibraryWithMainFunctionOrFail(
const std::string &libraryPath)
286 void *mainLibraryHnd = dlopen(libraryPath.c_str(), RTLD_LAZY);
287 if (Q_UNLIKELY(!mainLibraryHnd)) {
288 qOhosReportFatalErrorAndAbort(
289 "%s: dlopen() failed to open library '%s': %s",
290 Q_FUNC_INFO, libraryPath.c_str(), dlerror());
293 auto *mainFunc =
reinterpret_cast<
Main>(dlsym(mainLibraryHnd,
"main"));
294 if (Q_UNLIKELY(!mainFunc)) {
295 qOhosReportFatalErrorAndAbort(
296 "%s: dlsym() failed to find 'main' symbol in library '%s': %s",
297 Q_FUNC_INFO, libraryPath.c_str(), dlerror());
300 qOhosPrintfDebug(
"%s: opened library '%s' with main function", Q_FUNC_INFO, libraryPath.c_str());
302 return [libraryPath, mainFunc](std::vector<std::string> mainArgs) {
303 auto mainArgsPointers = std::vector<
char *>();
304 for (
auto &arg : mainArgs)
305 mainArgsPointers.push_back(&arg[0]);
306 mainArgsPointers.push_back(
nullptr);
308 int argc = mainArgs.size();
309 char **argv = &mainArgsPointers[0];
312 "%s: calling 'main' function in library '%s' (argc=%d)",
313 Q_FUNC_INFO, libraryPath.c_str(), argc);
315 for (
int i = 0; i < argc; ++i)
316 qOhosPrintfDebug(
"%s: 'main' function argv[%d]='%s'", Q_FUNC_INFO, i, argv[i]);
318 int mainResult = mainFunc(argc, argv);
321 "%s: 'main' function in library '%s' returned %d",
322 Q_FUNC_INFO, libraryPath.c_str(), mainResult);
328void redirectStandardDescriptorsToFile(
const std::string &redirectedStdoutPath)
330 int openResult = qt_safe_open(redirectedStdoutPath.c_str(), O_WRONLY | O_CREAT | O_TRUNC, 0666);
331 auto openErrno = errno;
332 if (openResult < 0) {
334 qOhosPrintfWarning(
"%s: error opening file '%s' for redirected stdout: %s",
335 Q_FUNC_INFO, redirectedStdoutPath.c_str(),
std::strerror(openErrno));
341 if (qt_safe_dup2(openResult, STDOUT_FILENO) < 0) {
342 auto dup2Errno = errno;
343 qOhosPrintfWarning(
"%s: dup2() failed on redirecting stdout to '%s': %s",
344 Q_FUNC_INFO, redirectedStdoutPath.c_str(),
std::strerror(dup2Errno));
347 qt_safe_close(openResult);
350QOhosConsumer<std::vector<std::string>> makeAppMainFuncLauncher(
351 const QtAppStartConfig &appStartConfig, QOhosConsumer<
int> funcExitHandler)
353 auto appLibraryMainFunc = makeLazyInitFunc<
int, std::vector<std::string>>(
354 [appLibraryPath = appStartConfig.appLibraryPath]() {
355 return openLibraryWithMainFunctionOrFail(appLibraryPath);
358 return [appLibraryMainFunc = std::move(appLibraryMainFunc), funcExitHandler = std::move(funcExitHandler), appStartConfig](std::vector<std::string> appArgs) {
359 auto __dbg = make_QCScopedDebugJS(
"startApplicationMainFunction");
360 std::vector<std::string> mainArgs;
361 mainArgs.push_back(appStartConfig.appLibraryPath);
362 mainArgs.insert(mainArgs.end(), appArgs.begin(), appArgs.end());
365 appStartConfig.watchdogEnabled
367 : std::shared_ptr<
void>();
369 int exitCode = appLibraryMainFunc(
std::move(mainArgs));
371 funcExitHandler(exitCode);
375std::optional<std::vector<std::string>> tryMapJsonArrayToStrings(
const std::string &inputJson)
377 auto doc = QJsonDocument::fromJson(QByteArray::fromStdString(inputJson));
379 qOhosPrintfWarning(
"%s: input is not valid JSON string", Q_FUNC_INFO);
382 if (!doc.isArray()) {
383 qOhosPrintfWarning(
"%s: input JSON does not contain an array", Q_FUNC_INFO);
387 const auto inputArray = doc.array();
389 std::vector<std::string> result;
390 for (
const auto &elem : inputArray) {
391 if (!elem.isString()) {
392 qOhosPrintfWarning(
"%s: input array's element is not a string", Q_FUNC_INFO);
395 result.push_back(elem.toString().toStdString());
401std::optional<std::vector<std::pair<std::string, std::string>>>
402tryMapJsonObjectToStringPairs(
const std::string &inputJson)
404 auto doc = QJsonDocument::fromJson(QByteArray::fromStdString(inputJson));
406 qOhosPrintfWarning(
"%s: input is not valid JSON string", Q_FUNC_INFO);
409 if (!doc.isObject()) {
410 qOhosPrintfWarning(
"%s: input JSON does not contain an object", Q_FUNC_INFO);
414 const auto inputObject = doc.object();
416 std::vector<std::pair<std::string, std::string>> result;
417 for (
auto it = inputObject.constBegin(); it != inputObject.constEnd(); ++it) {
418 if (!it->isString()) {
419 qOhosPrintfWarning(
"%s: input object's value is not a string", Q_FUNC_INFO);
422 result.emplace_back(it.key().toStdString(), it->toString().toStdString());
429std::enable_if_t<std::is_base_of<QNapi::Value, T>::value, T>
430getWantParamOrEmptyIfNotPresent(QNapi::Object want,
const std::string ¶mName)
432 return QNapi::getOptionalPropOrEmpty<T>(
433 QNapi::getOptionalPropOrEmpty<QNapi::Object>(want,
"parameters"),
434 paramName,
"parameters of Want");
437std::vector<std::string> getQtAppArgsFromWant(QNapi::Object want)
439 using namespace std::string_literals;
441 const auto *qtObsoleteUseUriAsArgPropName =
"io.qt.useUriAsArg";
442 const auto *qtAppArgsPropName =
"io.qt.appArgs";
443 const auto *qtAppArgsJsonPropName =
"io.qt.appArgsJson";
445 Napi::HandleScope getArgsScope(want.Env());
447 std::vector<std::string> result;
449 auto optWantParams = QNapi::getOptionalPropOrEmpty<QNapi::Object>(want,
"parameters");
450 if (!optWantParams.IsEmpty() && optWantParams.Has(qtObsoleteUseUriAsArgPropName)) {
452 "Qt: Want parameter '%s' is obsolete and is ignored. The ability launch URI is no "
453 "longer passed as an application argument.",
454 qtObsoleteUseUriAsArgPropName);
457 auto optQtAppArgs = getWantParamOrEmptyIfNotPresent<QNapi::Array>(want, qtAppArgsPropName);
458 auto optQtAppArgsJson = getWantParamOrEmptyIfNotPresent<QNapi::String>(want, qtAppArgsJsonPropName);
460 if (!optQtAppArgs.IsEmpty()) {
461 if (!QNapi::arrayElementTypesMatch<QNapi::String>(optQtAppArgs)) {
462 throw QNapi::makeLoggedException(
463 want.Env(),
"Want parameter '"s + qtAppArgsPropName +
"' is not an array of strings"s);
466 auto qtAppArgsStrings = QNapi::getArrayElements<std::vector<std::string>, QNapi::String>(optQtAppArgs);
467 result.insert(result.end(), qtAppArgsStrings.begin(), qtAppArgsStrings.end());
468 }
else if (!optQtAppArgsJson.IsEmpty()) {
469 auto optQtAppArgsJsonStrings = tryMapJsonArrayToStrings(optQtAppArgsJson);
470 if (!optQtAppArgsJsonStrings) {
471 throw QNapi::makeLoggedException(
472 want.Env(),
"Want parameter '"s + qtAppArgsJsonPropName +
"' is invalid"s);
474 result.insert(result.end(), optQtAppArgsJsonStrings->begin(), optQtAppArgsJsonStrings->end());
480void requestAppPermissionsInBackground(
JsState &jsState,
const std::vector<std::string> &permissionsNames)
482 for (
const auto &permissionName : permissionsNames) {
484 "Qt: automatically requesting application permission: '%s'",
485 permissionName.c_str());
487 QOhosAppPermissions::requestAppPermissionFromUser(
488 jsState, permissionName,
489 [permissionName](QOhosJsState &,
bool permissionGranted) {
490 if (permissionGranted) {
492 "Qt: automatically requested application permission granted: '%s'",
493 permissionName.c_str());
496 "Qt: automatically requested application permission rejected: '%s'",
497 permissionName.c_str());
503struct AppProcessLaunchOptions
505 QNapi::Boolean useDefaultUiAbilityInstanceInQt;
506 QNapi::String appSharedLibNameOverride;
507 QNapi::Boolean experimentalGlBackingStore;
508 QNapi::Boolean debugDrawQtRasterBackingStoreFlushedRegion;
509 QNapi::Boolean debugUseBasicStyleAndTheme;
510 QNapi::Boolean enableVsyncOnSoftwareBackingStore;
511 QNapi::Boolean watchdogEnabled;
512 QNapi::String redirectStdoutToFile;
513 QNapi::String exitCodeFile;
514 QNapi::String autoRequestPermissions;
515 QNapi::Boolean enableNativeNodeApiKeyEvents;
516 QNapi::Boolean enableNativeNodeApiMouseEvents;
517 QNapi::String envVarsJson;
520AppProcessLaunchOptions getProcessLaunchOptionsFromWant(QNapi::Object launchWant)
522 auto assignWantParamIfPresent = [&](
auto &outputValue,
const char *paramName) {
523 using Param = std::remove_reference_t<
decltype(outputValue)>;
524 outputValue = getWantParamOrEmptyIfNotPresent<Param>(launchWant, paramName);
527 AppProcessLaunchOptions launchOpts;
529 assignWantParamIfPresent(
530 launchOpts.useDefaultUiAbilityInstanceInQt,
531 "io.qt.useDefaultUiAbilityInstanceInQt");
532 assignWantParamIfPresent(
533 launchOpts.appSharedLibNameOverride,
534 "io.qt.appSharedLibNameOverride");
535 assignWantParamIfPresent(
536 launchOpts.experimentalGlBackingStore,
537 "io.qt.experimental.enableGlBackingStore");
538 assignWantParamIfPresent(
539 launchOpts.debugDrawQtRasterBackingStoreFlushedRegion,
540 "io.qt.debug.drawQtRasterBackingStoreFlushedRegion");
541 assignWantParamIfPresent(
542 launchOpts.debugUseBasicStyleAndTheme,
543 "io.qt.debug.useBasicStyleAndTheme");
544 assignWantParamIfPresent(
545 launchOpts.enableVsyncOnSoftwareBackingStore,
546 "io.qt.experimental.enableVsyncOnSoftwareBackingStore");
547 assignWantParamIfPresent(
548 launchOpts.watchdogEnabled,
549 "io.qt.watchdogEnabled");
550 assignWantParamIfPresent(
551 launchOpts.redirectStdoutToFile,
552 "io.qt.debug.redirectedStdoutPath");
553 assignWantParamIfPresent(
554 launchOpts.exitCodeFile,
555 "io.qt.debug.exitCodePath");
556 assignWantParamIfPresent(
557 launchOpts.autoRequestPermissions,
558 "io.qt.debug.autoRequestPermissions");
559 assignWantParamIfPresent(
560 launchOpts.enableNativeNodeApiKeyEvents,
561 "io.qt.experimental.enableNativeNodeApiKeyEvents");
562 assignWantParamIfPresent(
563 launchOpts.enableNativeNodeApiMouseEvents,
564 "io.qt.experimental.enableNativeNodeApiMouseEvents");
565 assignWantParamIfPresent(
566 launchOpts.envVarsJson,
567 "io.qt.envVarsJson");
572void setGlobalFlagsFromAppProcessLaunchOptions(
const AppProcessLaunchOptions &launchOpts)
574 if (!launchOpts.useDefaultUiAbilityInstanceInQt.IsEmpty())
577 if (!launchOpts.experimentalGlBackingStore.IsEmpty())
578 experimentalEnableGlBackinStore = launchOpts.experimentalGlBackingStore.Value();
580 if (!launchOpts.debugUseBasicStyleAndTheme.IsEmpty())
581 debugUseBasicStyleAndTheme = launchOpts.debugUseBasicStyleAndTheme.Value();
583 if (!launchOpts.enableVsyncOnSoftwareBackingStore.IsEmpty())
584 vsyncOnSoftwareBackingStoreEnabled = launchOpts.enableVsyncOnSoftwareBackingStore.Value();
586 debugDrawQtRasterBackingStoreFlushedRegion =
587 launchOpts.debugDrawQtRasterBackingStoreFlushedRegion.IsEmpty()
589 : launchOpts.debugDrawQtRasterBackingStoreFlushedRegion.Value();
591 if (!launchOpts.enableNativeNodeApiKeyEvents.IsEmpty())
592 enableNativeNodeApiKeyEvents = launchOpts.enableNativeNodeApiKeyEvents.Value();
594 if (!launchOpts.enableNativeNodeApiMouseEvents.IsEmpty())
595 enableNativeNodeApiMouseEvents = launchOpts.enableNativeNodeApiMouseEvents.Value();
597 if (!launchOpts.envVarsJson.IsEmpty()) {
598 auto optEnvVars = tryMapJsonObjectToStringPairs(launchOpts.envVarsJson.Utf8Value());
600 for (
const auto &[name, value] : *optEnvVars)
601 qputenv(name.c_str(), QByteArray::fromStdString(value));
606void terminateAllAbilityInstances(
JsState &jsState,
const char *logContext)
609 [&](
auto qAbilityPeer) {
611 "Qt: terminating QAbility with instanceId='%s'",
612 qAbilityPeer->instanceId().c_str());
614 if (optQUiAbilityPeer)
615 JsWindowsTracker::tagWindowAsClosing(optQUiAbilityPeer->window(), logContext);
616 qAbilityPeer->qAbility().eval(
"context.terminateSelf()");
620std::optional<
std::size_t> tryGetMaxStackSizeHardLimit()
622 struct ::rlimit limit;
623 if (::getrlimit(RLIMIT_STACK, &limit) != 0) {
624 auto getrlimitErrno = errno;
626 "%s: error reading stack size hard limit (assuming no limit): %s",
627 Q_FUNC_INFO,
std::strerror(getrlimitErrno));
631 return limit.rlim_max != RLIM_INFINITY
632 ? std::optional<std::size_t>(limit.rlim_max)
636std::optional<
std::size_t> tryGetQtThreadStackSizeFromEnv()
638 int stackSizeFromEnv = qEnvironmentVariableIntValue(qtMainThreadStackSizeEnvVariableName);
639 return stackSizeFromEnv > 0
640 ? std::optional(
static_cast<
std::size_t>(stackSizeFromEnv))
644std::size_t getPreferredStackSizeForQtThread()
646 constexpr std::size_t qtRequiredMinStackSize = 40960;
647 std::size_t pthreadStackMin = PTHREAD_STACK_MIN;
648 auto minStackSize =
std::max({qtRequiredMinStackSize, pthreadStackMin});
649 auto maxStackSize = tryGetMaxStackSizeHardLimit().value_or(std::numeric_limits<std::size_t>::max());
651 auto optRequestedStackSize = tryGetQtThreadStackSizeFromEnv();
653 if (optRequestedStackSize.has_value()) {
654 auto requestedStackSize = optRequestedStackSize.value();
655 if (requestedStackSize < minStackSize) {
657 "%s: requested stack size (%zu) is below minimum (pthread min: %zu, Qt min: %zu), increasing",
658 Q_FUNC_INFO, requestedStackSize, pthreadStackMin, qtRequiredMinStackSize);
660 if (requestedStackSize > maxStackSize) {
662 "%s: requested stack size (%zu) is above maximum (hard limit: %zu), decreasing",
663 Q_FUNC_INFO, requestedStackSize, maxStackSize);
667 auto preferredStackSize = qBound(
668 minStackSize, optRequestedStackSize.value_or(defaultQtThreadStackSize), maxStackSize);
670 qOhosPrintfInfo(
"%s: preferred stack size for Qt Thread: %zu", Q_FUNC_INFO, preferredStackSize);
672 return preferredStackSize;
675QOhosConsumer<std::vector<std::string>> makeQtThreadWithMainFuncLauncher(
676 QOhosConsumer<std::vector<std::string>> baseMainFuncLauncher)
679 .threadPreferredStackSize = getPreferredStackSizeForQtThread(),
681 auto qtThreadExecutor = makeSingleThreadExecutor(qtThreadExecutorConfig);
685 std::mutex initializedMutex;
686 std::condition_variable initializedCv;
687 bool initialized =
false;
690 auto initContext =
std::make_shared<InitContext>();
694 pthread_setname_np(pthread_self(),
"QtMainThread");
700 auto *currentThread = QThread::currentThread();
701 QThread *mainThread = QCoreApplicationPrivate::theMainThread;
702 if (mainThread != currentThread) {
703 qOhosReportFatalErrorAndAbort(
704 "%s: mainThread (%p) != currentThread (%p). Qt API was likely used before Qt initialization. Aborting.",
705 Q_FUNC_INFO, mainThread, currentThread);
708 qt_setQOhosPermissionsHelper(getQOhosPermissionsHelperImpl());
710 QtOhos::initQtThreadState();
713 std::lock_guard<
std::mutex> initializedLock(initContext->initializedMutex);
714 initContext->initialized =
true;
715 initContext->initializedCv.notify_one();
720 std::unique_lock<
std::mutex> initializedLock(initContext->initializedMutex);
721 initContext->initializedCv.wait(
724 return initContext->initialized;
728 auto sharedBaseMainFuncLauncher = moveToSharedPtr(
std::move(baseMainFuncLauncher));
730 return [qtThreadExecutor = std::move(qtThreadExecutor), sharedBaseMainFuncLauncher](std::vector<std::string> appArgs) {
732 [sharedBaseMainFuncLauncher, appArgs = std::move(appArgs)]()
mutable {
733 (*sharedBaseMainFuncLauncher)(
std::move(appArgs));
746 return *getQAbilityInstancesManagerPtr();
751 QNapi::Object launchWant = qAbilityPeer->launchWant();
753 if (!s_qtAppThreadMainFuncLauncher) {
754 auto qtAppThreadIdleSetFunc = std::make_shared<QOhosConsumer<
bool>>();
755 std::function<
void()> qtAppThreadIdleStateWaitFunc;
756 std::tie(*qtAppThreadIdleSetFunc, qtAppThreadIdleStateWaitFunc) = makeConditionFlagMTAccessors(
"Qt thread idle");
758 auto launchOpts = getProcessLaunchOptionsFromWant(launchWant);
760 setGlobalFlagsFromAppProcessLaunchOptions(launchOpts);
762 if (!launchOpts.redirectStdoutToFile.IsEmpty())
763 redirectStandardDescriptorsToFile(launchOpts.redirectStdoutToFile.Utf8Value());
765 if (!launchOpts.exitCodeFile.IsEmpty())
768 if (!launchOpts.autoRequestPermissions.IsEmpty())
769 requestAppPermissionsInBackground(jsState, splitString(launchOpts.autoRequestPermissions,
','));
771 std::string appSharedLibName =
772 !launchOpts.appSharedLibNameOverride.IsEmpty()
773 ? launchOpts.appSharedLibNameOverride
776 auto appMainFuncLauncher = makeAppMainFuncLauncher(
778 .appLibraryPath = s_appSharedLibsDirPath +
"/" + appSharedLibName,
779 .watchdogEnabled = !launchOpts.watchdogEnabled.IsEmpty()
780 ? launchOpts.watchdogEnabled.Value()
783 [qtAppThreadIdleSetFunc](
int exitCode) {
784 if (s_hotStartEnabled)
785 s_autoStartedAbilityInstanceWaitingForQtWindow =
true;
787 s_appExitCode = exitCode;
789 qOhosPrintfInfo(
"Qt: asynchronously terminating remaining QAbility instances, if any");
790 QOhosJsThreadGateway::invoke(
791 [](QOhosJsState &jsState) {
792 auto &pluginJsState = JsState::castFrom(jsState);
793 if (s_hotStartEnabled)
794 getQAbilityInstancesManager().registerPendingAutoStartedInstance();
797 "Qt: force-resolving pending QWindow destroy Promises before termination if needed");
798 pluginJsState.visitEachQAbilityPeer(
799 [&](std::shared_ptr<QtOhos::QAbilityPeer> peer) {
800 peer->forceResolveQWindowDestroyPromiseIfPresent(
801 Napi::Env(jsState.env()));
804 terminateAllAbilityInstances(pluginJsState,
"Qt main() exit");
807 (*qtAppThreadIdleSetFunc)(
true);
810 auto mainFuncLauncher = moveToSharedPtr(
811 makeQtThreadWithMainFuncLauncher(std::move(appMainFuncLauncher)));
813 (*qtAppThreadIdleSetFunc)(
false);
814 s_hotStartIteration.activeInQtThread = s_hotStartIteration.activeInQtThread.value_or(0) + 1;
815 (*mainFuncLauncher)(
std::move(appArgs));
820 s_hotStartIteration.lastRequestedInJsThread = s_hotStartIteration.lastRequestedInJsThread.value_or(0) + 1;
824 : getQtAppArgsFromWant(launchWant));
827std::map<std::string, QNapi::Reference<QNapi::Function>> makeJsModulesFactoriesMap(
828 const QNapi::Object &jsModulesFactoriesObj)
830 std::map<std::string, QNapi::Reference<QNapi::Function>> jsModulesFactoriesMap;
831 for (
const auto &prop : jsModulesFactoriesObj) {
832 if (prop.first.IsString()) {
833 auto propName = QNapi::checkedCast<QNapi::String>(prop.first);
834 QNapi::Value propValue = prop.second;
835 if (propValue.IsFunction()) {
836 jsModulesFactoriesMap.emplace(
837 propName.Utf8Value(),
838 QNapi::Reference<QNapi::Function>::makePersistentFrom(
839 QNapi::checkedCast<QNapi::Function>(propValue)));
844 return jsModulesFactoriesMap;
850 void startQAbilityInstance(
851 QNapi::Object baseQAbility, QObjectThreadSafeRef qwindow,
852 QNapi::Object optStartOptions,
855 void startAppProcess(
856 QNapi::Object baseQAbility,
const std::string &processId, QNapi::Object requestWant,
857 QNapi::Object optStartOptions,
std::function<
void(
JsState &)> continueFunc)
override;
859 void startNoUiChildProcess(
JsState &jsState,
const std::string &libraryName,
const std::vector<std::string> &args)
override;
862void AppFunctionsImpl::startQAbilityInstance(
863 QNapi::Object baseQAbility, QObjectThreadSafeRef qwindow,
864 QNapi::Object optStartOptions,
867 getQAbilityInstancesManager().startNewInstance(
868 baseQAbility, qwindow, optStartOptions,
std::move(startupNotifyFunc));
871void AppFunctionsImpl::startAppProcess(
872 QNapi::Object baseQAbility,
const std::string &processId, QNapi::Object requestWant,
873 QNapi::Object optStartOptions,
std::function<
void(
JsState &)> continueFunc)
875 auto __dbg = make_QCScopedDebugJS(
"AppFunctionsImpl::startAppProcess");
877 static const char *
const clonedWantPropsNames[] = {
885 auto env = baseQAbility.Env();
887 auto qAbilityInfo = QAbilityInstancesManager::readAbilityInfo(baseQAbility);
889 auto startWantParams = QNapi::Object::New(env);
890 auto requestWantParams = QNapi::getOptionalPropOrEmpty<QNapi::Object>(requestWant,
"parameters");
891 if (!requestWantParams.IsEmpty()) {
892 for (
const auto &requestWantParamEntry : requestWantParams) {
894 requestWantParamEntry.first,
static_cast<QNapi::Value>(requestWantParamEntry.second));
897 startWantParams.Set(qtAppProcessIdWantArgName, processId);
899 auto startWant = QNapi::makeObject(
902 {
"bundleName", qAbilityInfo.bundleName},
903 {
"moduleName", qAbilityInfo.moduleName},
904 {
"abilityName", qAbilityInfo.name},
905 {
"parameters", startWantParams},
908 for (
const auto &propName : clonedWantPropsNames) {
909 auto optProp = QNapi::getOptionalPropOrEmpty<QNapi::Value>(requestWant, propName);
910 if (!optProp.IsEmpty())
911 startWant.Set(propName, optProp);
914 std::vector<QNapi::ValueWrapper> startAbilityArgs = {startWant};
915 if (!optStartOptions.IsEmpty())
916 startAbilityArgs.push_back(optStartOptions);
918 baseQAbility.evalToPromiseOrRejectOnThrow(
"context.startAbility(*)", startAbilityArgs)
919 .onCatch(QtOhos::makeErrorLoggingJsCallback(
"startAbility()"))
921 [continueFunc = std::move(continueFunc)](
const CallbackInfo &cbInfo) {
926void AppFunctionsImpl::startNoUiChildProcess(
927 JsState &jsState,
const std::string &libraryName,
const std::vector<std::string> &args)
929 const auto *childProcessSrcEntry =
"./ets/process/QChildProcess.ets";
937 constexpr int startModeAppSpawnFork = 1;
939 auto appContextDirs = AppContextDirs::mapFromQOhosAppContextProperties(QOhosAppContext::getAllProperties());
941 QJsonArray argsArray;
942 std::transform(args.begin(), args.end(),
std::back_inserter(argsArray), QString::fromStdString);
944 QJsonObject childSetupJson = {
945 {QString::fromUtf8(
"appContext"), appContextDirs.mapToQJsonObject()},
946 {QString::fromUtf8(
"appName"), QString::fromStdString(libraryName)},
947 {QString::fromUtf8(
"appArgs"), argsArray},
951 "@ohos.app.ability.childProcessManager.startChildProcess(*)",
953 childProcessSrcEntry,
954 startModeAppSpawnFork,
958 cbInfo.getLeadingArgs(Q_FUNC_INFO, error, data);
960 int childPid = data.IsNumber()
961 ? QNapi::checkedCast<QNapi::Number>(data)
965 qOhosPrintfDebug(
"%s: child started: %d", Q_FUNC_INFO, childPid);
966 sendChildProcessSetupData(childPid, childSetupJson);
968 qOhosPrintfError(
"%s: child NOT started", Q_FUNC_INFO);
974void handleAbilityOnForeground(
const CallbackInfo &cbInfo)
976 const auto qAbility = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
978 if (foregroundAbilities.empty()) {
979 QtOhos::invokeInQtThread([]() {
980 const auto setQosRes = OH_QoS_SetThreadQoS(QoS_Level::QOS_USER_INTERACTIVE);
981 if (setQosRes != 0) {
982 qOhosWarning(QtForOhos)
983 <<
"Setting QoS level of Qt thread to USER_INTERACTIVE failed, error code:"
986 updateApplicationState(Qt::ApplicationActive);
990 foregroundAbilities.push_back(Napi::Persistent(qAbility));
993void handleAbilityOnBackground(
const CallbackInfo &cbInfo)
995 const auto qAbility = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
997 const auto qAbilityRef = Napi::Persistent(qAbility);
998 foregroundAbilities.erase(
999 std::remove(foregroundAbilities.begin(), foregroundAbilities.end(), qAbilityRef),
1000 foregroundAbilities.end());
1002 if (foregroundAbilities.empty()) {
1003 QtOhos::invokeInQtThread([]() {
1004 const auto resetQosRes = OH_QoS_ResetThreadQoS();
1005 if (resetQosRes != 0) {
1006 qOhosWarning(QtForOhos)
1007 <<
"Resetting QoS level of Qt thread failed, error code:"
1010 updateApplicationState(Qt::ApplicationHidden);
1011 updateApplicationState(Qt::ApplicationInactive);
1016QNapi::Value handleAbilityOnContinue(
const CallbackInfo &cbInfo)
1018 QNapi::Object qAbility;
1019 QNapi::Object wantParamsObj;
1020 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbility, wantParamsObj);
1023 cbInfo
.jsState().tryGetQAbilityPeerByInstance(qAbility)
);
1024 if (!uiAbilityPeer) {
1025 qOhosPrintfWarning(
"%s: got unknown Ability, rejecting", Q_FUNC_INFO);
1026 return makeResolvedPromise(
1027 cbInfo.jsState().mapOhosEnumToJs(
1028 QOhosAbilityOnContinueResult::REJECT));
1033 [](QOhosJsState &jsState,
auto result) {
1034 return jsState.mapOhosEnumToJs(result);
1036 [&](QOhosJsState &jsState,
auto resultConsumer) {
1038 JsState::castFrom(jsState), wantParamsObj,
std::move(resultConsumer));
1042std::string targetLibraryDirectory() {
1043 #if defined(Q_PROCESSOR_ARM_64)
1044 return "/libs/arm64";
1045 #elif defined(Q_PROCESSOR_ARM_32)
1047 #elif defined(Q_PROCESSOR_X86_64)
1048 return "/libs/x86_64";
1050 #error "Unknown system architecture, aborting!"
1054void tryDetectBrokenWant(
JsState &jsState, QNapi::Object want)
1056 Napi::HandleScope checkScope(want.Env());
1058 auto optDefaultQAbility = jsState.defaultQAbility();
1060 if (optDefaultQAbility) {
1061 bool fromThisApp = getQAbilityInstancesManager().isWantFromThisApp(optDefaultQAbility.value(), want);
1062 auto optCallerPid = getWantParamOrEmptyIfNotPresent<QNapi::Number>(want, callerPidWantArgName);
1063 if (fromThisApp && !optCallerPid.IsEmpty() && ::kill(optCallerPid.Int64Value(), 0) != 0) {
1065 "%s: got Want from non-existing app process (pid: %lld), which most likely means that we received"
1066 " broken Want (platform bug). That's fatal error for us!",
1067 Q_FUNC_INFO,
static_cast<
long long>(optCallerPid.Int64Value()));
1073std::string readInitialBytesOfFile(
const std::string &filePath,
std::size_t maxReadSize)
1075 FILE *inputFile =
std::fopen(filePath.c_str(),
"rb");
1076 if (inputFile ==
nullptr) {
1077 auto fopenErrno = errno;
1078 qOhosReportFatalErrorAndAbort(
1079 "%s: can't open file '%s': %s",
1080 Q_FUNC_INFO, filePath.c_str(),
std::strerror(fopenErrno));
1083 std::unique_ptr<FILE,
decltype(&
std::fclose)> inputFileCloseGuard(inputFile, &std::fclose);
1085 auto readBuffer = std::string(maxReadSize,
'\0');
1087 auto bytesRead = std::fread(&readBuffer[0], 1, maxReadSize, inputFile);
1088 if (
std::ferror(inputFile)) {
1089 qOhosReportFatalErrorAndAbort(
1090 "%s: error reading '%s': (%zu bytes read)",
1091 Q_FUNC_INFO, filePath.c_str(), bytesRead);
1094 readBuffer.resize(bytesRead);
1095 readBuffer.shrink_to_fit();
1100std::string readCurrentProcessNameFromProcFs()
1102 const auto *procCmdlinePath =
"/proc/self/cmdline";
1103 auto procCmdlineData = readInitialBytesOfFile(procCmdlinePath, 64 * 1024);
1105 auto processNameTerminatorPos = procCmdlineData.find(
'\0');
1106 if (processNameTerminatorPos == std::string::npos)
1107 qOhosReportFatalErrorAndAbort(
"%s: found unexpected content in '%s'", Q_FUNC_INFO, procCmdlinePath);
1109 procCmdlineData.resize(processNameTerminatorPos);
1110 procCmdlineData.shrink_to_fit();
1112 return procCmdlineData;
1115bool isThisEmbeddedUIExtensionProcess(
const QNapi::Object &appContext)
1117 std::string appName = appContext.eval<QNapi::String>(
"applicationInfo.name");
1118 return readCurrentProcessNameFromProcFs() == appName +
":embeddedUI";
1121void handleAbilityStageOnCreate(
const CallbackInfo &cbInfo)
1123 auto abilityStage = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1125 if (qEnvironmentVariableIntValue(enableHotStartEnvVariableName) != 0) {
1126 auto appContext = abilityStage.eval<QNapi::Object>(
"context.getApplicationContext()");
1127 if (!isThisEmbeddedUIExtensionProcess(appContext)) {
1129 appContext.eval<QNapi::Value>(
"setSupportedProcessCache(*)", {
true});
1131 }
catch (
const Napi::Error &error) {
1132 qOhosPrintfError(
"setSupportedProcessCache() failed with error: %s", error.what());
1138 "AbilityStage::onCreate: hot start enabled: %s",
1142QNapi::Value handleAbilityStageOnNewProcessRequest(
const CallbackInfo &cbInfo)
1144 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1146 QNapi::Object qAbilityStage;
1148 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbilityStage, want);
1150 qOhosPrintfInfo(
"AbilityStage::onNewProcessRequest: input Want: %s", QNapi::toJsonString(want).c_str());
1154 auto optProcessIdParam = getWantParamOrEmptyIfNotPresent<QNapi::String>(want, qtAppProcessIdWantArgName);
1156 std::string processId = !optProcessIdParam.IsEmpty() ? optProcessIdParam :
std::string();
1158 qOhosPrintfInfo(
"AbilityStage::onNewProcessRequest: returning processId='%s'", processId.c_str());
1160 return QNapi::String::New(cbInfo.Env(), processId);
1163QNapi::Value handleAbilityStageOnAcceptWant(
const CallbackInfo &cbInfo)
1165 using namespace std::string_literals;
1167 QNapi::Object qAbilityStage;
1169 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbilityStage, want);
1171 qOhosPrintfInfo(
"AbilityStage::onAcceptWant: input Want: %s", QNapi::toJsonString(want).c_str());
1175 auto optProcessIdParam = getWantParamOrEmptyIfNotPresent<QNapi::String>(want, qtAppProcessIdWantArgName);
1176 if (!optProcessIdParam.IsEmpty()) {
1177 std::string processIdParamStr = QNapi::checkedCast<QNapi::String>(optProcessIdParam);
1178 auto instanceId =
"//"s + processIdParamStr;
1179 qOhosPrintfInfo(
"AbilityStage::onAcceptWant: returning instanceId='%s'", instanceId.c_str());
1180 return QNapi::String::New(cbInfo.Env(), instanceId);
1183 std::shared_ptr<
QAbilityPeer> defaultQAbilityPeer = cbInfo.jsState().defaultQAbilityPeer();
1185 auto defaultQAbility = defaultQAbilityPeer->qAbility();
1186 auto receivedQAbilityInstanceId =
1187 !defaultQAbility.IsEmpty()
1188 ? getQAbilityInstancesManager().tryGetQAbilityInstanceIdFromWant(defaultQAbility, want)
1191 auto qAbilityInstanceId =
1192 receivedQAbilityInstanceId.has_value()
1193 ? receivedQAbilityInstanceId.value()
1195 defaultQAbilityPeer->instanceId());
1197 qOhosPrintfInfo(
"AbilityStage::onAcceptWant: returning instanceId='%s'", qAbilityInstanceId.c_str());
1199 return QNapi::String::New(cbInfo.Env(), qAbilityInstanceId);
1202void asyncRunTaskInTemporaryThread(
std::function<
void()> task, std::function<
void(QOhosJsState &)> continueFunc)
1204 auto taskRunnerThread = std::thread(
1205 [task = std::move(task), continueFunc = std::move(continueFunc)]()
mutable {
1207 QOhosJsThreadGateway::invoke(std::move(continueFunc));
1209 taskRunnerThread.detach();
1212void asyncRunTaskInTemporaryThreadWithTimeout(
1213 QOhosJsState &jsState,
std::function<
void()> task,
std::chrono::milliseconds waitTimeout,
1214 QOhosConsumer<QOhosJsState &,
bool> successConsumer)
1216 auto successNotifyFunc = moveToSharedPtr(
1217 makeCallOnceConsumerWrapper<QOhosJsState &,
bool>(
1218 std::move(successConsumer)));
1222 [successNotifyFunc](
const QOhosCallbackInfo &cbInfo) {
1223 (*successNotifyFunc)(cbInfo.jsState(),
false);
1227 asyncRunTaskInTemporaryThread(
1229 [successNotifyFunc](QOhosJsState &jsState) {
1230 (*successNotifyFunc)(jsState,
true);
1234QNapi::Value handleAbilityStageOnPrepareTerminationAsync(
const CallbackInfo &cbInfo)
1236 qOhosPrintfInfo(
"%s", Q_FUNC_INFO);
1238 return makeResolvedPromise(
1239 cbInfo.jsState().eval<QNapi::Number>(
1240 "@ohos.app.ability.AbilityConstant.PrepareTermination.TERMINATE_IMMEDIATELY"));
1245 qOhosPrintfInfo(
"AbilityStage::onDestroy: start");
1247 qOhosPrintfInfo(
"AbilityStage::onDestroy: destroying the Qt thread object");
1257 qOhosPrintfInfo(
"AbilityStage::onDestroy: calling _Exit(%d)",
s_appExitCode);
1263 QNapi::Object qAbility;
1265 QNapi::Object launchParam;
1266 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbility, want, launchParam);
1269 "%s: input Want: %s, launchParam: %s",
1270 Q_FUNC_INFO, QNapi::toJsonString(want).c_str(), QNapi::toJsonString(launchParam).c_str());
1274 if (!QAbilityInstancesManager::isQtInternalWantFromThisProcess(want))
1275 dispatchNewWant(qAbility, want, launchParam);
1277 qOhosPrintfDebug(
"%s: received qt-internal Want from current process, nothing to do", Q_FUNC_INFO);
1280void loadWindowStageContentPage(
JsState &jsState, QNapi::Object &qAbility,
const QNapi::Object &windowStage)
1282 auto *jsEnv = jsState.env();
1284 auto qAbilityInstanceId = getQAbilityInstancesManager().getQAbilityInstanceIdOrPendingAutoStartedId(qAbility);
1287 auto qAbilityRef = moveToSharedPtr(QNapi::Reference<>::makePersistentFrom(qAbility));
1288 auto windowStageRef = moveToSharedPtr(QNapi::Reference<>::makePersistentFrom(windowStage));
1290 auto localStorage = jsState.eval<QNapi::Object>(
"LocalStorage.makeNewLocalStorage()");
1298 {
"xComponentId", xComponentId.toNapiValue(jsEnv)},
1299 {
"onDisAppear", []() {}},
1302 [qAbilityRef, windowStageRef](
const QtOhos::CallbackInfo &cbInfo) {
1303 getQAbilityInstancesManager().handleStartedUiInstance(
1304 cbInfo.jsState(), qAbilityRef->Value(), windowStageRef->Value());
1309 qOhosPrintfDebug(
"XComponentId: %s onAppear", xComponentId.stringId().c_str());
1314 qAbility.set(
"localStorage", localStorage);
1316 const std::string mainWindowNativeNodePagePath =
"pages/MainWindowNativeNode";
1317 windowStage.evalToPromiseOrRejectOnThrow(
"loadContent(*)", {mainWindowNativeNodePagePath, localStorage})
1319 auto launchWant = qAbilityRef->eval<QNapi::Object>(
"launchWant");
1320 qOhosPrintfDebug(
"%s: launchWant: %s", Q_FUNC_INFO, QNapi::toJsonString(launchWant).c_str());
1322 .onCatch([qAbilityInstanceId](
const CallbackInfo &cbInfo) {
1323 QtOhos::logJsCallbackError(cbInfo,
"windowStage.loadContent failed");
1324 qOhosReportFatalErrorAndAbort(
1325 "%s: Failed to loadContent for QAbility instance(qAbilityInstanceId: %s)", Q_FUNC_INFO, qAbilityInstanceId.c_str());
1329QNapi::Symbol getAbilityWindowStageCreatedOrRestoredPropSymbol(
JsState &jsState)
1334 return jsState.getJsSymbolForType<Symbol>();
1337void handleAbilityOnWindowStageCreate(
const CallbackInfo &cbInfo)
1339 QNapi::Object qAbility;
1340 QNapi::Object windowStage;
1341 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbility, windowStage);
1343 qAbility.set(getAbilityWindowStageCreatedOrRestoredPropSymbol(cbInfo.jsState()),
true);
1344 loadWindowStageContentPage(cbInfo
.jsState(), qAbility, windowStage);
1347void handleAbilityOnWindowStageRestore(
const CallbackInfo &cbInfo)
1349 QNapi::Object qAbility;
1350 QNapi::Object windowStage;
1351 cbInfo.getLeadingArgs(Q_FUNC_INFO, qAbility, windowStage);
1353 auto optCreatedOrRestoredProp = QNapi::getOptionalPropOrEmpty<QNapi::Boolean>(
1354 qAbility, getAbilityWindowStageCreatedOrRestoredPropSymbol(cbInfo.jsState()));
1355 bool createdOrRestoredProp = !optCreatedOrRestoredProp.IsEmpty()
1356 ? optCreatedOrRestoredProp.Value()
1359 if (!createdOrRestoredProp) {
1360 qAbility.set(getAbilityWindowStageCreatedOrRestoredPropSymbol(cbInfo.jsState()),
true);
1361 loadWindowStageContentPage(cbInfo
.jsState(), qAbility, windowStage);
1364 "%s: window page already created or restored. Skip page reloading", Q_FUNC_INFO);
1368void handleAbilityOnWindowStageDestroy(
const CallbackInfo &)
1372QNapi::Value handleAbilityOnPrepareToTerminate(
const CallbackInfo &cbInfo)
1374 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1375 auto ability = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1377 auto abilityPeer = cbInfo
.jsState().tryGetQAbilityPeerByInstance(ability);
1379 qOhosPrintfWarning(
"%s: unrecognized ability, returning immediately", Q_FUNC_INFO);
1380 return QNapi::Boolean::New(cbInfo.Env(),
false);
1383 bool destroyAllowed = abilityPeer->destroyAllowedFlag()->load();
1385 "%s: ability id: '%s', destroyAllowed=%s",
1388 if (!destroyAllowed) {
1389 QtOhos::invokeInQtThread(
1390 [qwindowRef = abilityPeer->qWindowRef()]() {
1391 auto *qwindow = qobject_cast<QWindow *>(qwindowRef.data());
1392 if (qwindow !=
nullptr) {
1393 qOhosPrintfInfo(
"handleAbilityOnPrepareToTerminate: calling QWindow::close()");
1394 QOhosCloseEventContext::runWithCloseRootCauseSet(
1395 QOhosCloseEventContext::CloseRootCause::OnPrepareToTerminate,
1400 qOhosPrintfDebug(
"%s: QWindow is null", Q_FUNC_INFO);
1405 return QNapi::Boolean::New(cbInfo.Env(), !destroyAllowed);
1408QNapi::Value handleAbilityOnPrepareToTerminateAsync(
const CallbackInfo &cbInfo)
1410 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1412 auto qAbility = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1417 jsState.tryGetQAbilityPeerByInstance(qAbility)
);
1419 if (optQUiAbilityPeer) {
1421 jsState,
"UIAbility::onPrepareToTerminateAsync",
1424 return QNapi::Boolean::New(
1426 ohosRequestResolution == QUiAbilityPeerBackend::CloseAbilityRequestResolution::DontClose);
1429 qOhosPrintfWarning(
"%s: no matching QAbilityPeer, resolving immediately with 'false'", Q_FUNC_INFO);
1430 return makeResolvedPromise(QNapi::Boolean::New(cbInfo.Env(),
false));
1436 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1438 QNapi::Object ability;
1440 QNapi::Object launchParam;
1441 cbInfo.getLeadingArgs(Q_FUNC_INFO, ability, want, launchParam);
1443 QAbilityInstancesManager::setLaunchParamOnAbilityObject(cbInfo
.jsState(), ability, launchParam);
1446QNapi::Value handleAbilityOnDestroy(
const CallbackInfo &cbInfo)
1448 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1450 auto qAbility = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1452 auto qAbilityPeer = cbInfo
.jsState().tryGetQAbilityPeerByInstance(qAbility);
1453 if (!qAbilityPeer) {
1454 qOhosPrintfDebug(
"%s: no matching QAbilityPeer, returning resolved Promise", Q_FUNC_INFO);
1455 return makeResolvedPromise(cbInfo.Env());
1458 auto optQWindowDestroyPromise = qAbilityPeer->qWindowDestroyPromise();
1460 auto initialPromise = optQWindowDestroyPromise.has_value()
1461 ? optQWindowDestroyPromise.value()
1462 : makeResolvedPromise(cbInfo.Env());
1464 auto resultPromiseDeferred = std::make_shared<QNapi::Promise::Deferred>(cbInfo.Env());
1466 initialPromise.onFinally(
1467 [qAbilityPeer, resultPromiseDeferred](
const CallbackInfo &cbInfo) {
1468 qOhosPrintfDebug(
"%s: initial Promise resolved for id='%s'", Q_FUNC_INFO, qAbilityPeer->instanceId().c_str());
1475 qOhosPrintfInfo(
"Qt: requested Qt app quit, waiting for the main() function to return");
1477 constexpr auto resultPromiseAutoresolveTimeout = 5s;
1479 asyncRunTaskInTemporaryThreadWithTimeout(
1484 resultPromiseAutoresolveTimeout,
1485 [instanceId = qAbilityPeer->instanceId(), resultPromiseDeferred](QOhosJsState &jsState,
bool threadExited) {
1487 "Qt: end waiting for Qt app's main() function, returned: %s",
1489 qOhosPrintfDebug(
"%s: resolving result Promise for id='%s'", Q_FUNC_INFO, instanceId.c_str());
1490 resultPromiseDeferred->Resolve(Napi::Env(jsState.env()).Undefined());
1493 resultPromiseDeferred->Resolve(cbInfo.Env().Undefined());
1497 qOhosPrintfDebug(
"%s: returning Promise for id='%s'", Q_FUNC_INFO, qAbilityPeer->instanceId().c_str());
1499 return resultPromiseDeferred->Promise();
1502void initDeviceInfo(
JsState &jsState)
1506 static const std::pair<Type,
const char *> strPropertiesMap[] = {
1507 {Type::deviceType,
"deviceType"},
1508 {Type::manufacture,
"manufacture"},
1509 {Type::brand,
"brand"},
1510 {Type::marketName,
"marketName"},
1511 {Type::productSeries,
"productSeries"},
1512 {Type::productModel,
"productModel"},
1513 {Type::softwareModel,
"softwareModel"},
1514 {Type::hardwareModel,
"hardwareModel"},
1515 {Type::hardwareProfile,
"hardwareProfile"},
1516 {Type::serial,
"serial"},
1517 {Type::bootloaderVersion,
"bootloaderVersion"},
1518 {Type::abiList,
"abiList"},
1519 {Type::securityPatchTag,
"securityPatchTag"},
1520 {Type::displayVersion,
"displayVersion"},
1521 {Type::incrementalVersion,
"incrementalVersion"},
1522 {Type::osReleaseType,
"osReleaseType"},
1523 {Type::osFullName,
"osFullName"},
1524 {Type::versionId,
"versionId"},
1525 {Type::buildType,
"buildType"},
1526 {Type::buildUser,
"buildUser"},
1527 {Type::buildHost,
"buildHost"},
1528 {Type::buildTime,
"buildTime"},
1529 {Type::buildRootHash,
"buildRootHash"},
1530 {Type::udid,
"udid"},
1531 {Type::distributionOSName,
"distributionOSName"},
1532 {Type::distributionOSVersion,
"distributionOSVersion"},
1533 {Type::distributionOSReleaseType,
"distributionOSReleaseType"},
1536 static const std::pair<Type,
const char *> intPropertiesMap[] = {
1537 {Type::majorVersion,
"majorVersion"},
1538 {Type::seniorVersion,
"seniorVersion"},
1539 {Type::featureVersion,
"featureVersion"},
1540 {Type::buildVersion,
"buildVersion"},
1541 {Type::sdkApiVersion,
"sdkApiVersion"},
1542 {Type::firstApiVersion,
"firstApiVersion"},
1543 {Type::distributionOSApiVersion,
"distributionOSApiVersion"},
1546 auto deviceInfoObj = jsState.eval<QNapi::Object>(
"@ohos.deviceInfo");
1548 QMap<Type, QVariant> deviceInfo;
1549 for (
const auto &propEntry : strPropertiesMap)
1550 deviceInfo[propEntry.first] = QString::fromStdString(deviceInfoObj.get<QNapi::String>(propEntry.second));
1551 for (
const auto &propEntry : intPropertiesMap)
1552 deviceInfo[propEntry.first] =
static_cast<
int>(deviceInfoObj.get<QNapi::Number>(propEntry.second));
1557void initAppData(
JsState &jsState, QNapi::Object appContext)
1559 initDeviceInfo(jsState);
1561 auto systemLocaleId = QString::fromStdString(
1562 jsState.eval<QNapi::String>(
"@ohos.intl.Locale<new>().toString()"));
1563 auto systemPreferredLanguages = QNapi::getArrayElements<QStringList, QNapi::String>(
1564 jsState.eval<QNapi::Array>(
"@ohos.i18n.System.getPreferredLanguageList()"),
1565 &QString::fromStdString);
1566 QtOhos::invokeInQtThread(
1567 [systemLocaleId, systemPreferredLanguages]() {
1568 QOhosPlatformIntegration::setSystemLocale(
new QOhosSystemLocale(systemLocaleId, systemPreferredLanguages));
1572 appContext.eval(
"setColorMode(*)", {jsState.mapOhosEnumToJs(defaultColorMode)});
1575std::string buildFcLangEnvVariableValue(
JsState &jsState)
1577 std::string language = jsState.eval<QNapi::String>(
"@ohos.intl.Locale<new>().language");
1578 std::string region = jsState.eval<QNapi::String>(
"@ohos.intl.Locale<new>().region");
1580 return language +
"_" + region +
".UTF-8";
1583void setupQtApplicationImpl(
JsState &jsState, QNapi::Object appStartupObj,
QtRunMode qtRunMode)
1585 auto appContext = appStartupObj.get<QNapi::Object>(
"appContext");
1586 auto appContextDirs = AppContextDirs::mapFromNapiObject(appContext);
1587 if (appContextDirs.resourceDir.empty()) {
1588 auto optResourceDirProp = QNapi::getOptionalPropOrEmpty<QNapi::String>(appStartupObj,
"resourceDir");
1589 std::string resourceDir = !optResourceDirProp.IsEmpty() ? optResourceDirProp :
std::string();
1590 appContextDirs.resourceDir = !resourceDir.empty()
1592 : appContextDirs.bundleCodeDir +
"/entry/resources/resfile";
1595 auto jsModulesFactories = appStartupObj.get<QNapi::Object>(
"modulesFactories");
1597 qOhosPrintfDebug(
"%s: setting up Qt in %s mode", Q_FUNC_INFO, mapQtRunModeToString(qtRunMode));
1599 getQAbilityInstancesManagerPtr() =
1600 makeQAbilityInstancesManager(&handleDefaultQAbilityInstanceStartup);
1602 currentQtRunMode = qtRunMode;
1604 jsModulesFactories.Env(), makeJsModulesFactoriesMap(jsModulesFactories),
1605 std::make_shared<AppFunctionsImpl>(), qtRunMode);
1607 QOhosAppContext::init(appContextDirs.mapToQOhosAppContextProperties());
1608 initAppData(jsState, appContext);
1611 if (ohosSdkApiVersion < minSupportedOhosSdkApiVersion) {
1612 qOhosReportFatalErrorAndAbort(
1613 "%s: unsupported OHOS version! Current API version: %d, minimum supported version: %d. Aborting.",
1614 Q_FUNC_INFO, ohosSdkApiVersion, minSupportedOhosSdkApiVersion);
1618 if (!recognizedDeviceType.has_value()) {
1619 qOhosReportFatalErrorAndAbort(
1620 "%s: Unrecognized device type: %s. Qt does not support unrecognized devices. Aborting.",
1624 bool allowUnsupportedDevices =
1625 qEnvironmentVariable(
"QT_IO_EXPERIMENTAL_ALLOW_UNSUPPORTED_DEVICES", {})
1626 == QLatin1String(
"true");
1628 qOhosReportFatalErrorAndAbort(
1629 "%s: Unsupported device type: %s. Aborting.",
1633 s_appSharedLibName = appStartupObj.get<QNapi::String>(
"appName");
1635 qOhosPrintfDebug(
"setupQtApplication() - sharedLibraryName: %s",
s_appSharedLibName.c_str());
1636 qOhosPrintfDebug(
"setupQtApplication() - bundleCodeDir: %s", appContextDirs.bundleCodeDir.c_str());
1639 qOhosPrintfDebug(
"setupQtApplication() - Shared libraries directory: %s",
s_appSharedLibsDirPath.c_str());
1641 auto jsAppArgs = QNapi::getPropOrUndefined(appStartupObj,
"appArgs");
1642 if (jsAppArgs.IsArray()) {
1643 s_appArgs = std::make_unique<std::vector<std::string>>(
1644 QNapi::getArrayElements<std::vector<std::string>, QNapi::String>(
1645 QNapi::checkedCast<QNapi::Array>(jsAppArgs)));
1649 const char *variable;
1651 } env_variables[] = {
1652 {
"QT_QPA_PLATFORM_PLUGIN_PATH", s_appSharedLibsDirPath },
1653 {
"QML2_IMPORT_PATH", appContextDirs.resourceDir +
"/qml" },
1654 {
"QT_PRINTER_MODULE",
"ohosprintersupport"},
1655 {
"TMPDIR", QOhosAppContext::getProperty(QOhosAppContext::Type::tempDir).toStdString()},
1656 {
"HOME", QOhosAppContext::getProperty(QOhosAppContext::Type::filesDir).toStdString()},
1657 {
"FC_LANG", buildFcLangEnvVariableValue(jsState)},
1660 for (
const auto &e : env_variables) {
1661 if (::setenv(e.variable, e.value.c_str(), 1) != 0)
1662 qOhosReportFatalErrorAndAbort(
"%s: Cannot set '%s' environment variable", Q_FUNC_INFO, e.variable);
1665 if (::chdir(appContextDirs.filesDir.c_str()) != 0) {
1666 auto chdirErrno = errno;
1668 "%s: failed to change current directory to '%s': %s",
1669 Q_FUNC_INFO, appContextDirs.filesDir.c_str(),
std::strerror(chdirErrno));
1673QtRunMode getQtRunModeFromAppStartupObj(QNapi::Object appStartupObj)
1675 std::unordered_map<std::string, QtRunMode> abilityClassNameToQtRunModeMap = {
1679 const auto optAbilityClassName = QNapi::getOptionalPropOrEmpty<QNapi::String>(appStartupObj,
"abilityClassName");
1680 if (!optAbilityClassName.IsEmpty()) {
1681 const std::string abilityClassName = optAbilityClassName;
1682 if (abilityClassNameToQtRunModeMap.find(abilityClassName) != abilityClassNameToQtRunModeMap.end())
1683 return abilityClassNameToQtRunModeMap[abilityClassName];
1685 qOhosReportFatalErrorAndAbort(
1686 "%s: got unsupported name of the Ability class: '%s'", Q_FUNC_INFO, abilityClassName.c_str());
1694 auto appStartupObj = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1695 auto qtRunMode = getQtRunModeFromAppStartupObj(appStartupObj);
1696 setupQtApplicationImpl(cbInfo
.jsState(), appStartupObj, qtRunMode);
1701 auto __dbg = make_QCScopedDebugJS(Q_FUNC_INFO);
1703 auto paramsObj = cbInfo.getFirstArg<QNapi::Object>(Q_FUNC_INFO);
1707 auto childSetupObj = readChildProcessSetupData(cbInfo.Env());
1708 childSetupObj[
"modulesFactories"] = paramsObj.get<QNapi::Object>(
"modulesFactories");
1712 auto appArgs = s_appArgs ? *s_appArgs : std::vector<std::string>();
1714 QThread::currentThread();
1715 QtOhos::initQtThreadState();
1716 auto appMainFuncLauncher = makeAppMainFuncLauncher(
1718 .appLibraryPath = s_appSharedLibsDirPath +
"/" + s_appSharedLibName,
1722 appMainFuncLauncher(appArgs);
1725QNapi::Value makeXComponentIdForMainWindowWithQAbilityInstanceId(
const CallbackInfo &cbInfo)
1727 std::string qAbilityInstanceId = cbInfo.getFirstArg<QNapi::String>(Q_FUNC_INFO);
1731QNapi::Value checkIsAdapterCApiSupported(
const CallbackInfo &cbInfo)
1733 constexpr bool adapterCApiSupported =
true;
1734 return QNapi::Boolean::New(cbInfo.Env(), adapterCApiSupported);
1746 return vsyncOnSoftwareBackingStoreEnabled;
1751 auto __dbg = make_QCScopedDebugJS(
"quitApplicationFromJsThread");
1752 auto hotStartIterationToQuit = s_hotStartIteration.lastRequestedInJsThread;
1753 QtOhos::invokeInQtThread(
1754 [hotStartIterationToQuit]() {
1755 if (s_hotStartIteration.activeInQtThread == hotStartIterationToQuit)
1756 QCoreApplication::quit();
1762 qOhosDebug(QtForOhos) <<
"QOhos updateApplicationState" << state;
1767 if (state <= Qt::ApplicationInactive) {
1777 QWindowSystemInterface::handleApplicationStateChanged(Qt::ApplicationState(state));
1780 QWindowSystemInterface::handleApplicationStateChanged(Qt::ApplicationState(state));
1787 static bool block = qEnvironmentVariableIntValue(
"QT_BLOCK_EVENT_LOOPS_WHEN_SUSPENDED") != 0;
1793 return experimentalEnableGlBackinStore;
1798 return debugDrawQtRasterBackingStoreFlushedRegion;
1803 return debugUseBasicStyleAndTheme;
1808 return enableNativeNodeApiKeyEvents;
1813 return enableNativeNodeApiMouseEvents;
1818 return std::exchange(s_autoStartedAbilityInstanceWaitingForQtWindow,
false);
1829 auto __dbg = make_QCScopedDebugJS(
"qohosjsmain Init");
1831 QNapi::Object(env, exports).DefineProperties(
1833 Napi::PropertyDescriptor::Function(
"handleAbilityStageOnCreate", QtOhos::handleAbilityStageOnCreate),
1834 Napi::PropertyDescriptor::Function(
"handleAbilityStageOnNewProcessRequest", QtOhos::handleAbilityStageOnNewProcessRequest),
1835 Napi::PropertyDescriptor::Function(
"handleAbilityStageOnAcceptWant", QtOhos::handleAbilityStageOnAcceptWant),
1836 Napi::PropertyDescriptor::Function(
"handleAbilityStageOnPrepareTerminationAsync", QtOhos::handleAbilityStageOnPrepareTerminationAsync),
1837 Napi::PropertyDescriptor::Function(
"handleAbilityStageOnDestroy", QtOhos::handleAbilityStageOnDestroy),
1838 Napi::PropertyDescriptor::Function(
"handleAbilityOnNewWant", QtOhos::handleAbilityOnNewWant),
1839 Napi::PropertyDescriptor::Function(
"handleAbilityOnWindowStageCreate", QtOhos::handleAbilityOnWindowStageCreate),
1840 Napi::PropertyDescriptor::Function(
"handleAbilityOnWindowStageRestore", QtOhos::handleAbilityOnWindowStageRestore),
1841 Napi::PropertyDescriptor::Function(
"handleAbilityOnWindowStageDestroy", QtOhos::handleAbilityOnWindowStageDestroy),
1842 Napi::PropertyDescriptor::Function(
"onStageDestroy", QtOhos::handleAbilityOnWindowStageDestroy),
1843 Napi::PropertyDescriptor::Function(
"handleAbilityOnPrepareToTerminate", QtOhos::handleAbilityOnPrepareToTerminate),
1844 Napi::PropertyDescriptor::Function(
"handleAbilityOnPrepareToTerminateAsync", QtOhos::handleAbilityOnPrepareToTerminateAsync),
1845 Napi::PropertyDescriptor::Function(
"handleAbilityOnCreate", QtOhos::handleAbilityOnCreate),
1846 Napi::PropertyDescriptor::Function(
"handleAbilityOnDestroy", QtOhos::handleAbilityOnDestroy),
1847 Napi::PropertyDescriptor::Function(
"handleAbilityOnBackground", QtOhos::handleAbilityOnBackground),
1848 Napi::PropertyDescriptor::Function(
"handleAbilityOnContinue", QtOhos::handleAbilityOnContinue),
1849 Napi::PropertyDescriptor::Function(
"onBackground", QtOhos::handleAbilityOnBackground),
1850 Napi::PropertyDescriptor::Function(
"handleAbilityOnForeground", QtOhos::handleAbilityOnForeground),
1851 Napi::PropertyDescriptor::Function(
"onForeground", QtOhos::handleAbilityOnForeground),
1852 Napi::PropertyDescriptor::Function(
"setupQtApplication", QtOhos::setupQtApplication),
1853 Napi::PropertyDescriptor::Function(
"runQtChildProcess", QtOhos::runQtChildProcess),
1854 Napi::PropertyDescriptor::Function(
1855 "makeXComponentIdForMainWindowWithQAbilityInstanceId",
1856 QtOhos::makeXComponentIdForMainWindowWithQAbilityInstanceId),
1857 Napi::PropertyDescriptor::Function(
"checkIsAdapterCApiSupported", QtOhos::checkIsAdapterCApiSupported),
1861 QArkUi::QXComponentRegistry::Init(env, exports);
1868extern "C" __attribute__((constructor))
void RegisterEntryModule(
void)
1870 static napi_module qtMainModule = {
1873 .nm_filename =
nullptr,
1874 .nm_register_func = Init,
1875 .nm_modname =
"qohos",
1877 .reserved = {
nullptr},
1880 napi_module_register(&qtMainModule);
static QOhosEventDispatcherStopper * instance()
void goingToStop(bool stop)
static QXComponentId createForNativeNodeMainWindow(const std::string &qAbilityInstanceId)
JsState & jsState() const
virtual void visitEachQAbilityPeer(const std::function< void(std::shared_ptr< QAbilityPeer >)> &visitor)=0
CloseAbilityRequestSource
CloseAbilityRequestResolution
static std::shared_ptr< QUiAbilityPeer > tryCastFromQAbilityPeerOrNull(std::shared_ptr< QAbilityPeer > qAbilityPeer)
bool isCurrentDeviceSupported()
void init(QMap< Type, QVariant > devinfo)
std::optional< RecognizedDeviceType > tryGetRecognizedDeviceType()
Combined button and popup list for selecting options.
std::shared_ptr< void > makeWatchdog()
bool acquireAndCleanPendingAutoStartedInstanceWindowFlag()
std::string const char * mapBoolToTrueFalseStr(bool value)
bool blockEventLoopsWhenSuspended()
void removeMatchingJsQAbilityPeer(QNapi::Object qAbility)
void updateApplicationState(int state)
bool isOhosNoUiChildMode()
void initJsThreadState(napi_env env, std::map< std::string, QNapi::Reference< QNapi::Function > > &&jsModulesFactories, std::shared_ptr< AppFunctions > appFunctions, QtRunMode qtRunMode)
bool isGlBackingStoreDefaultEnabled()
void quitApplicationFromJsThread()
bool isVsyncOnSoftwareBackingStoreEnabled()
bool isNativeNodeApiMouseEventsEnabled()
QtOhosQpa::enums::ohos::app::ability::AbilityConstant::OnContinueResult QOhosAbilityOnContinueResult
bool isNativeNodeApiKeyEventsEnabled()
bool isDebugUseBasicStyleAndThemeEnabled()
bool isDebugDrawQtRasterBackingStoreFlushedRegionEnabled()
static bool s_hotStartEnabled
static bool s_autoStartedAbilityInstanceWaitingForQtWindow
QT_END_NAMESPACE static EXTERN_C_START napi_value Init(napi_env env, napi_value exports)
std::function< void()> s_qtAppThreadIdleStateWaitFunc
std::optional< std::uint64_t > lastRequestedInJsThread
static std::string s_appSharedLibName
static QList< QByteArray > s_applicationParams
static std::unique_ptr< std::vector< std::string > > s_appArgs
int(* Main)(int, char **)
static std::string s_appSharedLibsDirPath
std::optional< std::uint64_t > activeInQtThread
static std::string s_exitCodeFilePath
QOhosConsumer< std::vector< std::string > > s_qtAppThreadMainFuncLauncher
virtual std::optional< std::string > pendingAutoStartedInstanceId() const =0
virtual std::shared_ptr< QUiAbilityPeerBackend > getAbilityPeerBackend(std::shared_ptr< QUiAbilityPeer > uiAbilityPeer)=0