/* * 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 panda { struct HmsMap; } namespace OHOS { namespace AppExecFwk { class EventHandler; } // namespace AppExecFwk namespace AbilityBase { class Extractor; class FileMapper; } // namespace AbilityBase namespace JsEnv { class JsEnvironment; class SourceMapOperator; struct UncaughtExceptionInfo; } // namespace JsEnv using AppLibPathMap = std::map>; namespace AbilityRuntime { class TimerTask; inline void *DetachCallbackFunc(napi_env env, void *value, void *) { return value; } class JsRuntime : public Runtime { public: static std::unique_ptr Create(const Options& options); 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; napi_env GetNapiEnv() const; Language GetLanguage() const override { return Language::JS; } 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; void DumpCpuProfile() override; void DestroyHeapProfiler() override; void ForceFullGC() override; void ForceFullGC(uint32_t tid) override; void DumpHeapSnapshot(uint32_t tid, bool isFullGC) override; void AllowCrossThreadExecution() override; void GetHeapPrepare() 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, const std::string& srcEntrance = ""); void PreloadSystemModule(const std::string& moduleName) override; void PreloadMainAbility(const std::string& moduleName, const std::string& srcPath, const std::string& hapPath, bool isEsMode, const std::string& srcEntrance) override; void PreloadModule(const std::string& moduleName, const std::string& srcPath, const std::string& hapPath, bool isEsMode, bool useCommonTrunk) override; bool PopPreloadObj(const std::string& key, std::unique_ptr& obj); void StartDebugMode(const DebugOption debugOption) override; void DebuggerConnectionHandler(bool isDebugApp, bool isStartWithDebug); 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(const JsEnv::UncaughtExceptionInfo& uncaughtExceptionInfo); bool LoadScript(const std::string& path, std::vector* buffer = nullptr, bool isBundle = false); bool LoadScript(const std::string& path, uint8_t* buffer, size_t len, bool isBundle, const std::string& srcEntrance = ""); bool StartDebugger(bool needBreakPoint, uint32_t instanceId); void StopDebugger(); 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, bool isABC = true); static std::shared_ptr GetSafeData(const std::string& path, std::string& fileFullName); void InitSourceMap(const std::shared_ptr operatorImpl); void InitSourceMap(const std::string hqfFilePath); void FreeNativeReference(std::unique_ptr reference); void FreeNativeReference(std::shared_ptr&& reference); void StartProfiler(const DebugOption debugOption) override; void DebuggerConnectionManager(bool isDebugApp, bool isStartWithDebug, const DebugOption dOption); void ReloadFormComponent(); // Reload ArkTS-Card component void SetModuleLoadChecker(const std::shared_ptr moduleCheckerDelegate) const override; static std::unique_ptr LoadSystemModuleByEngine(napi_env env, const std::string& moduleName, const napi_value* argv, size_t argc); std::unique_ptr LoadModule(const std::string& moduleName, const std::string& modulePath, const std::string& hapPath, bool esmodule = false, bool useCommonChunk = false, const std::string& srcEntrance = ""); std::unique_ptr LoadSystemModule( const std::string& moduleName, const napi_value* argv = nullptr, size_t argc = 0); void SetDeviceDisconnectCallback(const std::function &cb) override; void UpdatePkgContextInfoJson(std::string moduleName, std::string hapPath, std::string packageName) override; private: void FinishPreload() override; bool Initialize(const Options& options); void Deinitialize(); int32_t JsperfProfilerCommandParse(const std::string &command, int32_t defaultValue); napi_value LoadJsBundle(const std::string& path, const std::string& hapPath, bool useCommonChunk = false); napi_value LoadJsModule(const std::string& path, const std::string& hapPath, const std::string& srcEntrance = ""); bool preloaded_ = false; bool isBundle_ = true; bool isOhmUrl_ = false; 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; std::map pkgContextInfoJsonStringMap_; std::map packageNameList_; std::map> preloadList_; static std::atomic hasInstance; private: bool CreateJsEnv(const Options& options); void PreloadAce(const Options& options); bool InitLoop(bool isStage = true); 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); void PostPreload(const Options& options); void LoadAotFile(const Options& options); void SetRequestAotCallback(); std::string GetSystemKitPath(); std::vector GetSystemKitsMap(uint32_t version); }; } // namespace AbilityRuntime } // namespace OHOS #endif // OHOS_ABILITY_RUNTIME_JS_RUNTIME_H