1 /* 2 * Copyright (c) 2022-2024 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef FOUNDATION_BUNDLEMGR_SERVICES_KITS_INCLUDE_INSTALLER_H 17 #define FOUNDATION_BUNDLEMGR_SERVICES_KITS_INCLUDE_INSTALLER_H 18 19 #include "base_cb_info.h" 20 #include "clone_param.h" 21 #include "install_param.h" 22 #include "plugin/install_plugin_param.h" 23 #include "napi/native_api.h" 24 #include "napi/native_common.h" 25 #include "napi/native_node_api.h" 26 27 namespace OHOS { 28 namespace AppExecFwk { 29 extern thread_local napi_ref g_classBundleInstaller; 30 31 struct InstallResult { 32 int32_t resultCode = 0; 33 std::string resultMsg; 34 }; 35 36 enum class InstallOption { 37 INSTALL = 0, 38 RECOVER = 1, 39 UNINSTALL = 2, 40 UPDATE_BUNDLE_FOR_SELF = 3, 41 UNKNOWN = 4, 42 UNINSTALL_AND_RECOVER = 5, 43 }; 44 45 struct AsyncInstallCallbackInfo { AsyncInstallCallbackInfoAsyncInstallCallbackInfo46 explicit AsyncInstallCallbackInfo(napi_env napiEnv) : env(napiEnv) {} 47 ~AsyncInstallCallbackInfo(); 48 49 int32_t err = 0; 50 InstallOption option = InstallOption::UNKNOWN; 51 std::string bundleName; 52 std::string param; 53 napi_env env; 54 napi_async_work asyncWork = nullptr; 55 napi_deferred deferred = nullptr; 56 napi_ref callback = nullptr; 57 std::vector<std::string> hapFiles; 58 OHOS::AppExecFwk::InstallParam installParam; 59 OHOS::AppExecFwk::UninstallParam uninstallParam; 60 InstallResult installResult; 61 }; 62 63 struct AsyncGetBundleInstallerCallbackInfo { AsyncGetBundleInstallerCallbackInfoAsyncGetBundleInstallerCallbackInfo64 explicit AsyncGetBundleInstallerCallbackInfo(napi_env napiEnv) : env(napiEnv) {} 65 ~AsyncGetBundleInstallerCallbackInfo(); 66 67 napi_env env; 68 napi_async_work asyncWork = nullptr; 69 napi_deferred deferred = nullptr; 70 napi_ref callback = nullptr; 71 }; 72 73 struct ExtResourceCallbackInfo : public BaseCallbackInfo { ExtResourceCallbackInfoExtResourceCallbackInfo74 explicit ExtResourceCallbackInfo(napi_env env) : BaseCallbackInfo(env) {} 75 std::string bundleName; 76 std::vector<std::string> moduleNames; 77 std::vector<std::string> filePaths; 78 }; 79 80 struct CreateAppCloneCallbackInfo : public BaseCallbackInfo { CreateAppCloneCallbackInfoCreateAppCloneCallbackInfo81 explicit CreateAppCloneCallbackInfo(napi_env napiEnv) : BaseCallbackInfo(napiEnv) {} 82 int32_t userId = Constants::UNSPECIFIED_USERID; 83 int32_t appIndex = Constants::INITIAL_APP_INDEX; 84 std::string bundleName; 85 OHOS::AppExecFwk::DestroyAppCloneParam destroyAppCloneParam; 86 }; 87 88 struct InstallPreexistingAppCallbackInfo : public BaseCallbackInfo { InstallPreexistingAppCallbackInfoInstallPreexistingAppCallbackInfo89 explicit InstallPreexistingAppCallbackInfo(napi_env napiEnv) : BaseCallbackInfo(napiEnv) {} 90 int32_t userId = Constants::UNSPECIFIED_USERID; 91 std::string bundleName; 92 }; 93 94 struct PluginCallbackInfo : public BaseCallbackInfo { PluginCallbackInfoPluginCallbackInfo95 explicit PluginCallbackInfo(napi_env napiEnv) : BaseCallbackInfo(napiEnv) {} 96 std::string hostBundleName; 97 std::vector<std::string> pluginFilePaths; 98 std::string pluginBundleName; 99 OHOS::AppExecFwk::InstallPluginParam installPluginParam; 100 }; 101 102 napi_value GetBundleInstaller(napi_env env, napi_callback_info info); 103 napi_value GetBundleInstallerSync(napi_env env, napi_callback_info info); 104 napi_value Install(napi_env env, napi_callback_info info); 105 napi_value Recover(napi_env env, napi_callback_info info); 106 napi_value Uninstall(napi_env env, napi_callback_info info); 107 napi_value BundleInstallerConstructor(napi_env env, napi_callback_info info); 108 napi_value UpdateBundleForSelf(napi_env env, napi_callback_info info); 109 napi_value UninstallAndRecover(napi_env env, napi_callback_info info); 110 napi_value AddExtResource(napi_env env, napi_callback_info info); 111 napi_value RemoveExtResource(napi_env env, napi_callback_info info); 112 napi_value CreateAppClone(napi_env env, napi_callback_info info); 113 napi_value DestroyAppClone(napi_env env, napi_callback_info info); 114 napi_value InstallPreexistingApp(napi_env env, napi_callback_info info); 115 napi_value InstallPlugin(napi_env env, napi_callback_info info); 116 napi_value UninstallPlugin(napi_env env, napi_callback_info info); 117 } // AppExecFwk 118 } // OHOS 119 #endif // FOUNDATION_BUNDLEMGR_SERVICES_KITS_INCLUDE_INSTALLER_H