/* * 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_RUNTIME_H #define OHOS_ABILITY_RUNTIME_RUNTIME_H #include #include #include class ModuleCheckerDelegate; namespace OHOS { namespace AppExecFwk { class EventRunner; } // namespace AppExecFwk namespace AbilityRuntime { class Runtime { public: enum class Language { JS = 0, CJ }; struct Options { Language lang = Language::JS; std::string bundleName; std::string moduleName; std::string codePath; std::string bundleCodeDir; std::string hapPath; std::string arkNativeFilePath; std::string packagePathStr; std::vector assetBasePathStr; std::shared_ptr eventRunner = nullptr; std::map hapModulePath; bool loadAce = true; bool preload = false; bool isBundle = true; bool isDebugVersion = false; bool isJsFramework = false; bool isStageModel = true; bool isTestFramework = false; bool jitEnabled = false; bool isMultiThread = false; bool isErrorInfoEnhance = false; int32_t uid = -1; // ArkTsCard start bool isUnique = false; // ArkTsCard end std::shared_ptr moduleCheckerDelegate = nullptr; int32_t apiTargetVersion = 0; std::map pkgContextInfoJsonStringMap; std::map packageNameList; std::map aotCompileStatusMap; }; struct DebugOption { std::string bundleName = ""; std::string perfCmd; std::string processName = ""; bool isDebugApp = true; bool isStartWithDebug = false; bool isStartWithNative = false; }; static std::unique_ptr Create(const Options& options); static void SavePreloaded(std::unique_ptr&& instance); static std::unique_ptr GetPreloaded(); Runtime() = default; virtual ~Runtime() = default; virtual Language GetLanguage() const = 0; virtual void StartDebugMode(const DebugOption debugOption) = 0; virtual void DumpHeapSnapshot(bool isPrivate) = 0; virtual void DumpCpuProfile() = 0; virtual void DestroyHeapProfiler() = 0; virtual void ForceFullGC() = 0; virtual void ForceFullGC(uint32_t tid) = 0; virtual void DumpHeapSnapshot(uint32_t tid, bool isFullGC) = 0; virtual void AllowCrossThreadExecution() = 0; virtual void GetHeapPrepare() = 0; virtual void NotifyApplicationState(bool isBackground) = 0; virtual bool SuspendVM(uint32_t tid) = 0; virtual void ResumeVM(uint32_t tid) = 0; virtual void PreloadSystemModule(const std::string& moduleName) = 0; virtual void PreloadMainAbility(const std::string& moduleName, const std::string& srcPath, const std::string& hapPath, bool isEsMode, const std::string& srcEntrance) = 0; virtual void PreloadModule(const std::string& moduleName, const std::string& srcPath, const std::string& hapPath, bool isEsMode, bool useCommonTrunk) = 0; virtual void FinishPreload() = 0; virtual bool LoadRepairPatch(const std::string& patchFile, const std::string& baseFile) = 0; virtual bool NotifyHotReloadPage() = 0; virtual bool UnLoadRepairPatch(const std::string& patchFile) = 0; virtual void RegisterQuickFixQueryFunc(const std::map& moduleAndPath) = 0; virtual void StartProfiler(const DebugOption debugOption) = 0; virtual void DoCleanWorkAfterStageCleaned() {} virtual void SetModuleLoadChecker(const std::shared_ptr moduleCheckerDelegate) const {} virtual void SetDeviceDisconnectCallback(const std::function &cb) = 0; virtual void UpdatePkgContextInfoJson(std::string moduleName, std::string hapPath, std::string packageName) = 0; Runtime(const Runtime&) = delete; Runtime(Runtime&&) = delete; Runtime& operator=(const Runtime&) = delete; Runtime& operator=(Runtime&&) = delete; }; } // namespace AbilityRuntime } // namespace OHOS #endif // OHOS_ABILITY_RUNTIME_RUNTIME_H