/* * Copyright (c) 2021-2023 Huawei Device Co., Ltd. * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef OHOS_ABILITY_RUNTIME_JS_RUNTIME_H #define OHOS_ABILITY_RUNTIME_JS_RUNTIME_H #include #include #include #include #include #include #include "native_engine/native_engine.h" #include "runtime.h" namespace panda::ecmascript { class EcmaVM; } // namespace panda::ecmascript namespace OHOS { namespace AppExecFwk { class EventHandler; } // namespace AppExecFwk namespace AbilityBase { class Extractor; } // namespace AbilityBase namespace JsEnv { class JsEnvironment; class SourceMapOperator; struct UncaughtExceptionInfo; } // namespace JsEnv using AppLibPathMap = std::map>; namespace AbilityRuntime { class TimerTask; inline void *DetachCallbackFunc(NativeEngine *engine, void *value, void *) { return value; } class JsRuntime : public Runtime { public: static std::unique_ptr Create(const Options& options); static std::unique_ptr LoadSystemModuleByEngine(NativeEngine* engine, const std::string& moduleName, NativeValue* const* argv, size_t argc); static void SetAppLibPath(const AppLibPathMap& appLibPaths, const bool& isSystemApp = false); static bool ReadSourceMapData(const std::string& hapPath, const std::string& sourceMapPath, std::string& content); JsRuntime(); ~JsRuntime() override; NativeEngine& GetNativeEngine() const; Language GetLanguage() const override { return Language::JS; } std::unique_ptr LoadModule(const std::string& moduleName, const std::string& modulePath, const std::string& hapPath, bool esmodule = false, bool useCommonChunk = false); std::unique_ptr LoadSystemModule( const std::string& moduleName, NativeValue* const* argv = nullptr, size_t argc = 0); void PostTask(const std::function& task, const std::string& name, int64_t delayTime); void PostSyncTask(const std::function& task, const std::string& name); void RemoveTask(const std::string& name); void DumpHeapSnapshot(bool isPrivate) override; bool BuildJsStackInfoList(uint32_t tid, std::vector& jsFrames) override; void NotifyApplicationState(bool isBackground) override; bool SuspendVM(uint32_t tid) override; void ResumeVM(uint32_t tid) override; bool RunSandboxScript(const std::string& path, const std::string& hapPath); bool RunScript(const std::string& path, const std::string& hapPath, bool useCommonChunk = false); void PreloadSystemModule(const std::string& moduleName) override; void StartDebugMode(bool needBreakPoint) override; void StopDebugMode(); bool LoadRepairPatch(const std::string& hqfFile, const std::string& hapPath) override; bool UnLoadRepairPatch(const std::string& hqfFile) override; bool NotifyHotReloadPage() override; void RegisterUncaughtExceptionHandler(JsEnv::UncaughtExceptionInfo uncaughtExceptionInfo); bool LoadScript(const std::string& path, std::vector* buffer = nullptr, bool isBundle = false); bool StartDebugger(bool needBreakPoint, uint32_t instanceId); void StopDebugger(); bool LoadScript(const std::string& path, uint8_t *buffer, size_t len, bool isBundle); NativeEngine* GetNativeEnginePointer() const; panda::ecmascript::EcmaVM* GetEcmaVm() const; void UpdateModuleNameAndAssetPath(const std::string& moduleName); void RegisterQuickFixQueryFunc(const std::map& moduleAndPath) override; static bool GetFileBuffer(const std::string& filePath, std::string& fileFullName, std::vector& buffer); void InitSourceMap(const std::shared_ptr operatorImpl); void FreeNativeReference(std::unique_ptr reference); void FreeNativeReference(std::shared_ptr&& reference); void StartProfiler(const std::string &perfCmd) override; void ReloadFormComponent(); // Reload ArkTS-Card component void DoCleanWorkAfterStageCleaned() override; void SetModuleLoadChecker(const std::shared_ptr& moduleCheckerDelegate) const override; private: void FinishPreload() override; bool Initialize(const Options& options); void Deinitialize(); NativeValue* LoadJsBundle(const std::string& path, const std::string& hapPath, bool useCommonChunk = false); NativeValue* LoadJsModule(const std::string& path, const std::string& hapPath); int32_t JsperfProfilerCommandParse(const std::string &command, int32_t defaultValue); bool debugMode_ = false; bool preloaded_ = false; bool isBundle_ = true; std::string codePath_; std::string moduleName_; std::unique_ptr methodRequireNapiRef_; std::unordered_map modules_; std::shared_ptr jsEnv_ = nullptr; uint32_t instanceId_ = 0; std::string bundleName_; int32_t apiTargetVersion_ = 0; static std::atomic hasInstance; private: bool CreateJsEnv(const Options& options); void PreloadAce(const Options& options); bool InitLoop(); inline bool IsUseAbilityRuntime(const Options& options) const; void FreeNativeReference(std::unique_ptr uniqueNativeRef, std::shared_ptr&& sharedNativeRef); void InitConsoleModule(); void InitTimerModule(); void InitWorkerModule(const Options& options); void ReInitJsEnvImpl(const Options& options); }; } // namespace AbilityRuntime } // namespace OHOS #endif // OHOS_ABILITY_RUNTIME_JS_RUNTIME_H