interface_sdk-js/api/@ohos.bundle.overlay.d.ts
sunjiakun f056bb55b1 API Lint
Signed-off-by: sunjiakun <sunjiakun5@huawei.com>
2024-07-19 15:40:13 +08:00

289 lines
17 KiB
TypeScript
Executable File

/*
* Copyright (c) 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.
*/
/**
* @file
* @kit AbilityKit
*/
import { AsyncCallback } from './@ohos.base';
import * as _OverlayModuleInfo from './bundleManager/OverlayModuleInfo';
/**
* Used for application interception overlay
*
* @namespace overlay
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
declare namespace overlay {
/**
* Set enabled state of overlay module based on specified moduleName.
*
* @param { string } moduleName - Indicates the module name of the overlay module to be set.
* @param { boolean } isEnabled - The value true means to enable overlay feature, and the value false means to disable overlay feature.
* @param { AsyncCallback<void> } callback - The callback of setting specified overlay module enabled state result.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function setOverlayEnabled(moduleName: string, isEnabled: boolean, callback: AsyncCallback<void>): void;
/**
* Set enabled state of overlay module based on specified moduleName.
*
* @param { string } moduleName - Indicates the module name of the overlay module to be set.
* @param { boolean } isEnabled - The value true means to enable overlay feature, and the value false means to disable overlay feature.
* @returns { Promise<void> }
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function setOverlayEnabled(moduleName: string, isEnabled: boolean): Promise<void>;
/**
* Set enabled state of overlay module based on specified bundleName and moduleName.
*
* @permission ohos.permission.CHANGE_OVERLAY_ENABLED_STATE
* @param { string } bundleName - Indicates the application bundle name of the overlay bundle to be set.
* @param { string } moduleName - Indicates the module name of the overlay module to be set.
* @param { boolean } isEnabled - The value true means to enable overlay feature, and the value false means to disable overlay feature.
* @param { AsyncCallback<void> } callback - The callback of setting specified overlay module enabled state result.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function setOverlayEnabledByBundleName(bundleName: string,
moduleName: string, isEnabled: boolean, callback: AsyncCallback<void>): void;
/**
* Set enabled state of overlay module based on specified bundleName and moduleName.
*
* @permission ohos.permission.CHANGE_OVERLAY_ENABLED_STATE
* @param { string } bundleName - Indicates the application bundle name of the overlay bundle to be set.
* @param { string } moduleName - Indicates the module name of the overlay module to be set.
* @param { boolean } isEnabled - The value true means to enable overlay feature, and the value false means to disable overlay feature.
* @returns { Promise<void> }
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function setOverlayEnabledByBundleName(bundleName: string, moduleName: string, isEnabled: boolean): Promise<void>;
/**
* Obtain the OverlayModuleInfo of current application based on moduleName.
*
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @param { AsyncCallback<OverlayModuleInfo> } callback - The callback of getting OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function getOverlayModuleInfo(moduleName: string, callback: AsyncCallback<OverlayModuleInfo>): void;
/**
* Obtain the OverlayModuleInfo of current application based on moduleName.
*
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @returns { Promise<OverlayModuleInfo> }
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function getOverlayModuleInfo(moduleName: string): Promise<OverlayModuleInfo>;
/**
* Obtain the OverlayModuleInfo of current application based on moduleName.
*
* @param { string } targetModuleName - Indicates the target module name of the target module to be queried.
* @param { AsyncCallback<Array<OverlayModuleInfo>> } callback - The callback of getting a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700034 - The specified module is an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function getTargetOverlayModuleInfos(targetModuleName: string,
callback: AsyncCallback<Array<OverlayModuleInfo>>): void;
/**
* Obtain the OverlayModuleInfo of current application based on moduleName.
*
* @param { string } targetModuleName - Indicates the target module name of the target module to be queried.
* @returns { Promise<Array<OverlayModuleInfo>> }
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700034 - The specified module is an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
function getTargetOverlayModuleInfos(targetModuleName: string): Promise<Array<OverlayModuleInfo>>;
/**
* Obtain the OverlayModuleInfo of the specified application based on bundleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } bundleName - Indicates the application bundle name of the overlay bundle to be quired.
* @param { AsyncCallback<Array<OverlayModuleInfo>> } callback - The callback of getting a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getOverlayModuleInfoByBundleName(bundleName: string,
callback: AsyncCallback<Array<OverlayModuleInfo>>): void;
/**
* Obtain the OverlayModuleInfo of the specified application based on bundleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } bundleName - Indicates the application bundle name of the overlay bundle to be quired.
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @param { AsyncCallback<Array<OverlayModuleInfo>> } callback - The callback of getting a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getOverlayModuleInfoByBundleName(bundleName: string,
moduleName: string, callback: AsyncCallback<Array<OverlayModuleInfo>>): void;
/**
* Obtain the OverlayModuleInfo of the specified application based on bundleName and moduleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } bundleName - Indicates the application bundle name of the overlay bundle to be quired.
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @returns { Promise<Array<OverlayModuleInfo>> } Returns a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700032 - The specified bundle does not contain any overlay module.
* @throws { BusinessError } 17700033 - The specified module is not an overlay module.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getOverlayModuleInfoByBundleName(bundleName: string,
moduleName?: string): Promise<Array<OverlayModuleInfo>>;
/**
* Obtain the OverlayModuleInfo of the specified target application based on bundleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } targetBundleName - Indicates the application target bundle name of the overlay bundle to be quired.
* @param { AsyncCallback<Array<OverlayModuleInfo>> } callback - The callback of getting a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700035 - The specified bundle is an overlay bundle.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getTargetOverlayModuleInfosByBundleName(targetBundleName: string,
callback: AsyncCallback<Array<OverlayModuleInfo>>): void;
/**
* Obtain the OverlayModuleInfo of the specified target application based on bundleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } targetBundleName - Indicates the application target bundle name of the overlay bundle to be quired.
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @param { AsyncCallback<Array<OverlayModuleInfo>> } callback - The callback of getting a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700034 - The specified module is an overlay module.
* @throws { BusinessError } 17700035 - The specified bundle is an overlay bundle.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getTargetOverlayModuleInfosByBundleName(targetBundleName: string,
moduleName: string, callback: AsyncCallback<Array<OverlayModuleInfo>>): void;
/**
* Obtain the OverlayModuleInfo of the specified target application based on bundleName and moduleName.
*
* @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
* @param { string } targetBundleName - Indicates the application target bundle name of the overlay bundle to be quired.
* @param { string } moduleName - Indicates the module name of the overlay module to be queried.
* @returns { Promise<Array<OverlayModuleInfo>> } Returns a list of OverlayModuleInfo object.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission denied, non-system app called system api.
* @throws { BusinessError } 17700001 - The specified bundleName is not found.
* @throws { BusinessError } 17700002 - The specified module name is not found.
* @throws { BusinessError } 17700034 - The specified module is an overlay module.
* @throws { BusinessError } 17700035 - The specified bundle is an overlay bundle.
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @systemapi
* @since 10
*/
function getTargetOverlayModuleInfosByBundleName(targetBundleName: string,
moduleName?: string): Promise<Array<OverlayModuleInfo>>;
/**
* Obtains configuration information about a overlay hap module.
*
* @typedef { _OverlayModuleInfo.OverlayModuleInfo }
* @syscap SystemCapability.BundleManager.BundleFramework.Overlay
* @since 10
*/
export type OverlayModuleInfo = _OverlayModuleInfo.OverlayModuleInfo;
}
export default overlay;