1 /* 2 * Copyright (c) 2023 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 UPDATE_SERVICE_KITS_H 17 #define UPDATE_SERVICE_KITS_H 18 19 #include <iostream> 20 21 #include "business_error.h" 22 #include "check_result.h" 23 #include "clear_options.h" 24 #include "current_version_info.h" 25 #include "description_options.h" 26 #include "download_options.h" 27 #include "iupdate_callback.h" 28 #include "pause_download_options.h" 29 #include "resume_download_options.h" 30 #include "new_version_info.h" 31 #include "update_callback_info.h" 32 #include "upgrade_info.h" 33 #include "upgrade_options.h" 34 #include "upgrade_policy.h" 35 #include "task_info.h" 36 #include "version_description_info.h" 37 #include "version_digest_info.h" 38 39 namespace OHOS::UpdateService { 40 class UpdateServiceKits { 41 public: 42 UpdateServiceKits() = default; 43 virtual ~UpdateServiceKits() = default; 44 DISALLOW_COPY_AND_MOVE(UpdateServiceKits); 45 46 /** 47 * Get instance of ohos account manager. 48 * 49 * @return Instance of ohos account manager. 50 */ 51 static UpdateServiceKits& GetInstance(); 52 53 virtual int32_t RegisterUpdateCallback(const UpgradeInfo &info, const UpdateCallbackInfo &cb, 54 int32_t &funcResult) = 0; 55 56 virtual int32_t UnregisterUpdateCallback(const UpgradeInfo &info, int32_t &funcResult) = 0; 57 58 virtual int32_t CheckNewVersion(const UpgradeInfo &info, BusinessError &businessError, 59 CheckResult &checkResult, int32_t &funcResult) = 0; 60 61 virtual int32_t Download(const UpgradeInfo &info, const VersionDigestInfo &versionDigestInfo, 62 const DownloadOptions &downloadOptions, BusinessError &businessError, int32_t &funcResult) = 0; 63 64 virtual int32_t PauseDownload(const UpgradeInfo &info, const VersionDigestInfo &versionDigestInfo, 65 const PauseDownloadOptions &pauseDownloadOptions, BusinessError &businessError, int32_t &funcResult) = 0; 66 67 virtual int32_t ResumeDownload(const UpgradeInfo &info, const VersionDigestInfo &versionDigestInfo, 68 const ResumeDownloadOptions &resumeDownloadOptions, BusinessError &businessError, int32_t &funcResult) = 0; 69 70 virtual int32_t Upgrade(const UpgradeInfo &info, const VersionDigestInfo &versionDigest, 71 const UpgradeOptions &upgradeOptions, BusinessError &businessError, int32_t &funcResult) = 0; 72 73 virtual int32_t ClearError(const UpgradeInfo &info, const VersionDigestInfo &versionDigest, 74 const ClearOptions &clearOptions, BusinessError &businessError, int32_t &funcResult) = 0; 75 76 virtual int32_t TerminateUpgrade(const UpgradeInfo &info, BusinessError &businessError, int32_t &funcResult) = 0; 77 78 virtual int32_t GetNewVersionInfo(const UpgradeInfo &info, NewVersionInfo &newVersionInfo, 79 BusinessError &businessError, int32_t &funcResult) = 0; 80 81 virtual int32_t GetNewVersionDescription(const UpgradeInfo &info, const VersionDigestInfo &versionDigestInfo, 82 const DescriptionOptions &descriptionOptions, VersionDescriptionInfo &newVersionDescriptionInfo, 83 BusinessError &businessError, int32_t &funcResult) = 0; 84 85 virtual int32_t GetCurrentVersionInfo(const UpgradeInfo &info, CurrentVersionInfo ¤tVersionInfo, 86 BusinessError &businessError, int32_t &funcResult) = 0; 87 88 virtual int32_t GetCurrentVersionDescription(const UpgradeInfo &info, const DescriptionOptions &descriptionOptions, 89 VersionDescriptionInfo ¤tVersionDescriptionInfo, BusinessError &businessError, int32_t &funcResult) = 0; 90 91 virtual int32_t GetTaskInfo(const UpgradeInfo &info, TaskInfo &taskInfo, BusinessError &businessError, 92 int32_t &funcResult) = 0; 93 94 virtual int32_t SetUpgradePolicy(const UpgradeInfo &info, const UpgradePolicy &policy, 95 BusinessError &businessError, int32_t &funcResult) = 0; 96 97 virtual int32_t GetUpgradePolicy(const UpgradeInfo &info, UpgradePolicy &policy, BusinessError &businessError, 98 int32_t &funcResult) = 0; 99 100 virtual int32_t Cancel(const UpgradeInfo &info, int32_t service, BusinessError &businessError, 101 int32_t &funcResult) = 0; 102 103 virtual int32_t FactoryReset(BusinessError &businessError) = 0; 104 105 virtual int32_t ApplyNewVersion(const UpgradeInfo &info, const std::string &miscFile, 106 const std::vector<std::string> &packageNames, BusinessError &businessError, int32_t &funcResult) = 0; 107 108 virtual int32_t VerifyUpgradePackage(const std::string &packagePath, const std::string &keyPath, 109 BusinessError &businessError, int32_t &funcResult) = 0; 110 }; 111 } // namespace OHOS::UpdateService 112 #endif // UPDATE_SERVICE_KITS_H 113