From 9db9439b2084169060338342a6aa06946cdd11dc Mon Sep 17 00:00:00 2001 From: lanhaoyu Date: Tue, 1 Jul 2025 10:54:41 +0800 Subject: [PATCH] bms docs arkts1.2 Signed-off-by: lanhaoyu --- .../js-apis-appControl-sys.md | 56 +- ...apis-bundleManager-AppProvisionInfo-sys.md | 6 +- ...-apis-bundleManager-ApplicationInfo-sys.md | 6 +- ...s-apis-bundleManager-BundlePackInfo-sys.md | 10 +- ...is-bundleManager-BundleResourceInfo-sys.md | 2 +- ...Manager-LauncherAbilityResourceInfo-sys.md | 2 +- .../js-apis-bundleManager-abilityInfo.md | 22 +- .../js-apis-bundleManager-applicationInfo.md | 14 +- .../js-apis-bundleManager-bundleInfo.md | 18 +- ...apis-bundleManager-extensionAbilityInfo.md | 8 +- .../js-apis-bundleManager-hapModuleInfo.md | 8 +- ...-apis-bundleManager-launcherAbilityInfo.md | 8 +- .../js-apis-bundleManager-metadata.md | 2 +- ...js-apis-bundleManager-overlayModuleInfo.md | 4 +- ...js-apis-bundleManager-permissionDef-sys.md | 6 +- ...eManager-recoverableApplicationInfo-sys.md | 4 +- ...apis-bundleManager-sharedBundleInfo-sys.md | 4 +- .../js-apis-bundleManager-shortcutInfo-sys.md | 8 +- .../js-apis-bundleManager-skill.md | 4 +- .../js-apis-bundleManager-sys.md | 1254 +++++++++++++++-- .../apis-ability-kit/js-apis-bundleManager.md | 292 +++- .../js-apis-bundleMonitor-sys.md | 2 +- .../js-apis-bundleResourceManager-sys.md | 128 +- .../js-apis-defaultAppManager-sys.md | 273 +++- .../apis-ability-kit/js-apis-installer-sys.md | 148 +- .../js-apis-launcherBundleManager-sys.md | 101 +- .../js-apis-launcherBundleManager.md | 5 +- .../js-apis-shortcutManager-sys.md | 98 +- .../apis-basic-services-kit/js-apis-zlib.md | 167 ++- 29 files changed, 2332 insertions(+), 328 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-appControl-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-appControl-sys.md index f84f6d8d4b1..b8096dac7cd 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-appControl-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-appControl-sys.md @@ -460,7 +460,8 @@ try { ## appControl.deleteDisposedStatusSync10+ -deleteDisposedStatusSync(appId: string, appIndex:? number) : void +ArkTs1.1: deleteDisposedStatusSync(appId: string, appIndex:? number) : void
+ArkTs1.2: deleteDisposedStatusSync(appId: string, appIndex:? int) : void 以同步方法删除指定应用或分身应用的处置状态。成功返回null,失败抛出对应异常。 @@ -475,7 +476,7 @@ deleteDisposedStatusSync(appId: string, appIndex:? number) : void | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | appId | string | 是 | 要查询的应用的appId。
appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid)。 | -| appIndex12+ | number | 否 | 表示分身应用的索引。
appIndex为0时,表示删除指定应用的处置状态。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,表示删除指定应用的处置状态。 | **错误码:** @@ -512,6 +513,7 @@ appId是应用的唯一标识,由应用Bundle名称和签名信息决定,可 **示例:** +ArkTs1.1: ```ts import bundleManager from '@ohos.bundle.bundleManager'; import { BusinessError } from '@ohos.base'; @@ -532,10 +534,32 @@ try { console.error("getBundleInfo failed " + message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; + +let bundleName = 'com.example.myapplication'; +let appId: string; +try { + bundleManager.getBundleInfo(bundleName, bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO) + .then((data: bundleManager.BundleInfo) => { + appId = data.signatureInfo.appId; + console.info("appId is " + appId); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error("getBundleInfo failed " + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error("getBundleInfo failed " + message); +} +``` ## appControl.getDisposedRule11+ -getDisposedRule(appId: string, appIndex:? number): DisposedRule +ArkTs1.1: getDisposedRule(appId: string, appIndex:? number): DisposedRule
+ArkTs1.2: getDisposedRule(appId: string, appIndex:? int): DisposedRule 获取指定应用或分身应用已设置的拦截规则。 @@ -550,7 +574,7 @@ getDisposedRule(appId: string, appIndex:? number): DisposedRule | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | appId | string | 是 | 要获取拦截规则的应用的appId。
appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid)。 | -| appIndex12+ | number | 否 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用的拦截规则。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用的拦截规则。 | **返回值:** @@ -591,7 +615,8 @@ try { ## appControl.setDisposedRule11+ -setDisposedRule(appId: string, rule: DisposedRule, appIndex:? number): void +ArkTs1.1: setDisposedRule(appId: string, rule: DisposedRule, appIndex:? number): void
+ArkTs1.2: setDisposedRule(appId: string, rule: DisposedRule, appIndex:? int): void 设置指定应用或分身应用的拦截规则。 @@ -607,7 +632,7 @@ setDisposedRule(appId: string, rule: DisposedRule, appIndex:? number): void | ----------- | ------ | ---- | --------------------------------------- | | appId | string | 是 | 要设置拦截规则的应用的appId。
appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid)。 | | rule | [DisposedRule](#disposedrule11) | 是 | 指示对应用的拦截规则。 | -| appIndex12+ | number | 否 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用的拦截规则。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用的拦截规则。 | **错误码:** @@ -662,7 +687,8 @@ try { ## appControl.setUninstallDisposedRule15+ -setUninstallDisposedRule(appIdentifier: string, rule: UninstallDisposedRule, appIndex:? number): void +ArkTs1.1: setUninstallDisposedRule(appIdentifier: string, rule: UninstallDisposedRule, appIndex:? number): void
+ArkTs1.2: setUninstallDisposedRule(appIdentifier: string, rule: UninstallDisposedRule, appIndex:? int): void 设置指定应用或分身应用的卸载处置规则。 @@ -678,7 +704,7 @@ setUninstallDisposedRule(appIdentifier: string, rule: UninstallDisposedRule, app | ----------- | ------ | ---- | --------------------------------------- | | appIdentifier | string | 是 | 要设置卸载处置规则的应用的appIdentifier。
如果应用没有appIdentifier可使用appId代替。appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid)。 | | rule | [UninstallDisposedRule](#uninstalldisposedrule15) | 是 | 表示要设置的卸载处置规则。 | -| appIndex | number | 否 | 表示分身应用的索引。
appIndex为0时,为主应用设置卸载处置规则。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,为主应用设置卸载处置规则。 | **错误码:** @@ -723,7 +749,8 @@ try { ## appControl.getUninstallDisposedRule15+ -getUninstallDisposedRule(appIdentifier: string, appIndex:? number): UninstallDisposedRule +ArkTs1.1: getUninstallDisposedRule(appIdentifier: string, appIndex:? number): UninstallDisposedRule
+ArkTs1.2: getUninstallDisposedRule(appIdentifier: string, appIndex:? int): UninstallDisposedRule 获取指定应用或分身应用已设置的卸载处置规则。 @@ -738,7 +765,7 @@ getUninstallDisposedRule(appIdentifier: string, appIndex:? number): UninstallDis | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | appIdentifier | string | 是 | 要获取卸载处置规则的应用的appIdentifier。
如果应用没有appIdentifier可使用appId代替。appId是应用的唯一标识,由应用Bundle名称和签名信息决定,设置方法参见[获取应用的appId](#获取应用的appid)。 | -| appIndex | number | 否 | 表示分身应用的索引。
appIndex为0时,表示获取主应用的卸载处置规则。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,表示获取主应用的卸载处置规则。 | **返回值:** @@ -778,7 +805,8 @@ try { ## appControl.deleteUninstallDisposedRule15+ -deleteUninstallDisposedRule(appIdentifier: string, appIndex:? number): void +ArkTs1.1: deleteUninstallDisposedRule(appIdentifier: string, appIndex:? number): void
+ArkTs1.2: deleteUninstallDisposedRule(appIdentifier: string, appIndex:? int): void 删除指定应用或分身应用的卸载处置规则。 @@ -793,7 +821,7 @@ deleteUninstallDisposedRule(appIdentifier: string, appIndex:? number): void | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | appIdentifier | string | 是 | 要删除卸载处置规则的应用的appIdentifier。
如果应用没有appIdentifier可使用appId代替。appId是应用的唯一标识,由应用Bundle名称和签名信息决定,删除方法参见[获取应用的appId](#获取应用的appid)。 | -| appIndex | number | 否 | 表示分身应用的索引。
appIndex为0时,表示删除主应用的卸载处置规则。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示分身应用的索引。
appIndex为0时,表示删除主应用的卸载处置规则。 | **错误码:** @@ -839,7 +867,7 @@ try { | disposedType | [DisposedType](#disposedrule11) | 是 | 是 | 对应用的拦截规则。 | | controlType | [ControlType](#controltype11) | 是 | 是 | 拦截指定应用程序的不同策略。 | | elementList | Array\<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | 是 | 拦截指定应用程序能力的列表。 | -| priority | number | 是 | 是 | 拦截规则的优先级。 | +| priority | ArkTs1.1: number
ArkTs1.2: int | 是 | 是 | 拦截规则的优先级。 | ### ComponentType11+ @@ -893,7 +921,7 @@ try { | --------- | -------------- | ---- | ---- | --------------------------- | | want | [Want](js-apis-app-ability-want.md) | 是 | 是 | 指定应用被拦截时,跳转到的页面。 | | UninstallComponentType | [UninstallComponentType](#uninstallcomponenttype15) | 是 | 是 | 拦截时将拉起能力的类型。 | -| priority | number | 是 | 是 | 拦截规则的优先级。 | +| priority | ArkTs1.1: number
ArkTs1.2: int | 是 | 是 | 拦截规则的优先级。 | ### UninstallComponentType15+ diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-AppProvisionInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-AppProvisionInfo-sys.md index 52b4c68f097..e2f871ad70f 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-AppProvisionInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-AppProvisionInfo-sys.md @@ -16,7 +16,7 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | ------------------------- | ------ | ---- | ---- | -------------------- | -| versionCode | number | 是 | 否 | 配置文件的版本号。 | +| versionCode | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 配置文件的版本号。 | | versionName | string | 是 | 否 | 配置文件的版本名称。 | | uuid | string | 是 | 否 | 配置文件中的uuid。 | | type | string | 是 | 否 | 配置文件的类型,为debug或者release。 | @@ -37,5 +37,5 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | ------------------------- | ------ | ---- | ---- | -------------------- | -| notBefore | number | 是 | 否 | 配置文件的最早有效日期。 | -| notAfter | number | 是 | 否 | 配置文件的最晚有效日期。 | \ No newline at end of file +| notBefore | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 配置文件的最早有效日期。 | +| notAfter | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 配置文件的最晚有效日期。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-ApplicationInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-ApplicationInfo-sys.md index ac65681362e..94266318ad9 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-ApplicationInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-ApplicationInfo-sys.md @@ -16,7 +16,7 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | --------- | -------------- | ---- | ---- | --------------------------- | -| flags12+ | number | 是 | 是 | 标识当前应用和当前用户之间的状态集合,每一位表示一个特定的布尔状态。
**系统API:** 从API version 12开始,该接口支持在系统API中使用。 | +| flags12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 是 | 标识当前应用和当前用户之间的状态集合,每一位表示一个特定的布尔状态。
**系统API:** 从API version 12开始,该接口支持在系统API中使用。 | ## PreinstalledApplicationInfo12+ @@ -29,5 +29,5 @@ | --------- | -------------- | ---- | ---- | --------------------------- | | bundleName | string | 是 | 否 | 应用包的名称。 | | moduleName | string | 是 | 否 | 应用包的模块名,返回entry模块的moduleName。若不存在entry模块则返回feature模块的moduleName。 | -| iconId | number | 是 | 否 | 应用图标Id。 | -| labelId | number | 是 | 否 | 应用标签Id。 | \ No newline at end of file +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用图标Id。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用标签Id。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundlePackInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundlePackInfo-sys.md index b5752134f3d..0fa9351e7e2 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundlePackInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundlePackInfo-sys.md @@ -118,7 +118,7 @@ | type | string | 是 | 否 | 表示forms的类型。 | | updateEnabled | boolean | 是 | 否 | 表示该卡片是否支持定时刷新,true表示卡片支持定时刷新,false表示不支持。 | | scheduledUpdateTime | string | 是 | 否 | 表示卡片定点刷新的时间,采用24小时计数,精确到分钟。 | -| updateDuration | number | 是 | 否 | 表示卡片定时刷新的更新频率,单位为30分钟,取值为30的倍数值。卡片的最高频率为每30分钟刷新一次,和定点刷新二选一,二者都配置的情况下,定时优先。 | +| updateDuration | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 表示卡片定时刷新的更新频率,单位为30分钟,取值为30的倍数值。卡片的最高频率为每30分钟刷新一次,和定点刷新二选一,二者都配置的情况下,定时优先。 | | supportDimensions | Array\ | 是 | 否 | 表示卡片外观规格,取值为“1\*2”,“2\*2”,“2\*4”,“4\*4”,定义卡片时至少要指定一个卡片规格。 | | defaultDimension | string | 是 | 否 | 表示卡片默认外观规格,取值必须在supportDimensions配置的列表中。 | @@ -131,8 +131,8 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | ----------- | ------ | ---- | ---- | -------------------- | | releaseType | string | 是 | 否 | 版本的名称。 | -| compatible | number | 是 | 否 | 版本的最小兼容代码。 | -| target | number | 是 | 否 | 目标版本号。 | +| compatible | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 版本的最小兼容代码。 | +| target | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 目标版本号。 | ## Version @@ -142,6 +142,6 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | ------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | -| minCompatibleVersionCode | number | 是 | 否 | 能够兼容的最低历史版本号,用于跨设备兼容性判断。该值为32位整型数值,非负整数。 | +| minCompatibleVersionCode | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 能够兼容的最低历史版本号,用于跨设备兼容性判断。该值为32位整型数值,非负整数。 | | name | string | 是 | 否 | 标识版本号的文字描述,用于向用户展示。 | -| code | number | 是 | 否 | 标识应用的版本号,值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。 | +| code | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 标识应用的版本号,值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundleResourceInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundleResourceInfo-sys.md index 3490b9873c8..0cedd7a755f 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundleResourceInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-BundleResourceInfo-sys.md @@ -20,4 +20,4 @@ | icon | string | 是 | 否 | 应用图标,为Base64编码格式。 | | label | string | 是 | 否 | 应用名称。 | | drawableDescriptor12+ | [DrawableDescriptor](../apis-arkui/js-apis-arkui-drawableDescriptor-sys.md) | 是 | 否 | 应用图标的drawableDescriptor对象。 | -| appIndex12+ | number | 是 | 否 | 应用分身Id。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用分身Id。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md index 0024464792d..6edc26e09f7 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md @@ -22,4 +22,4 @@ | icon | string | 是 | 否 | 应用图标,为Base64编码格式。 | | label | string | 是 | 否 | 应用名称。 | | drawableDescriptor12+ | [DrawableDescriptor](../apis-arkui/js-apis-arkui-drawableDescriptor-sys.md) | 是 | 否 | 应用图标的drawableDescriptor对象。 | -| appIndex12+ | number | 是 | 否 | 应用分身Id。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用分身Id。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-abilityInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-abilityInfo.md index 14ee27c8c47..7c6f42e28ba 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-abilityInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-abilityInfo.md @@ -15,11 +15,11 @@ Ability信息,三方应用可以通过[bundleManager.getBundleInfoForSelf](js- | moduleName | string | 是 | 否 | Ability所属的HAP的名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | name | string | 是 | 否 | Ability名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | label | string | 是 | 否 | Ability对用户显示的名称的资源描述符,如:"label": "$string: mainability_description"。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| labelId | number | 是 | 否 | Ability的标签资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | Ability的标签资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | description | string | 是 | 否 | Ability的描述。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| descriptionId | number | 是 | 否 | Ability的描述资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | Ability的描述资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | icon | string | 是 | 否 | Ability的图标资源描述符,如"icon": "$media:icon"。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| iconId | number | 是 | 否 | Ability的图标资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | Ability的图标资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | process | string | 是 | 否 | Ability的进程名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | exported | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用,取值为true表示Ability可以被其他应用调用,取值为false表示Ability不可以被其他应用调用。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | type | [bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype) | 是 | 否 | Ability类型。
**模型约束:** 此接口仅可在FA模型下使用。 | @@ -37,8 +37,8 @@ Ability信息,三方应用可以通过[bundleManager.getBundleInfoForSelf](js- | windowSize|[WindowSize](#windowsize) | 是 | 否 | Ability窗口尺寸。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | excludeFromDock12+ | boolean | 是 | 否 | 判断Ability是否可以在dock区域隐藏图标,取值为true表示可以隐藏,取值为false不可以隐藏。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | | skills12+ | Array\<[Skill](js-apis-bundleManager-skill.md)> | 是 | 否 | Ability的Skills信息。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| appIndex12+ | number | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | -| orientationId14+ | number | 是 | 否 | Ability的显示模式资源id。当orientationId不为0时表示当前显示模式为自定义配置,需要使用orientationId去资源管理获取对应的资源。
**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | +| orientationId14+ | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | Ability的显示模式资源id。当orientationId不为0时表示当前显示模式为自定义配置,需要使用orientationId去资源管理获取对应的资源。
**原子化服务API:** 从API version 14开始,该接口支持在原子化服务中使用。 | ## WindowSize @@ -50,9 +50,9 @@ Ability信息,三方应用可以通过[bundleManager.getBundleInfoForSelf](js- | 名称 | 类型 | 只读 | 可选 | 说明 | | -------------------| ------- | ---- | ---- | ---------------------------------- | -| maxWindowRatio | number | 是 | 否 | 表示自由窗口状态下窗口的最大宽高比;取值范围0-1。 | -| minWindowRatio | number | 是 | 否 | 表示自由窗口状态下窗口的最小宽高比;取值范围0-1。 | -| maxWindowWidth | number | 是 | 否 | 表示自由窗口状态下窗口的最大宽度,宽度单位为vp。 | -| minWindowWidth | number | 是 | 否 | 表示自由窗口状态下窗口的最小宽度,宽度单位为vp。 | -| maxWindowHeight | number | 是 | 否 | 表示自由窗口状态下窗口的最大高度,宽度单位为vp。 | -| minWindowHeight | number | 是 | 否 | 表示自由窗口状态下窗口的最小高度,宽度单位为vp。 | \ No newline at end of file +| maxWindowRatio | ArkTs1.1: number
ArkTs1.2: double | 是 | 否 | 表示自由窗口状态下窗口的最大宽高比;取值范围0-1。 | +| minWindowRatio | ArkTs1.1: number
ArkTs1.2: double | 是 | 否 | 表示自由窗口状态下窗口的最小宽高比;取值范围0-1。 | +| maxWindowWidth | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 表示自由窗口状态下窗口的最大宽度,宽度单位为vp。 | +| minWindowWidth | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 表示自由窗口状态下窗口的最小宽度,宽度单位为vp。 | +| maxWindowHeight | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 表示自由窗口状态下窗口的最大高度,宽度单位为vp。 | +| minWindowHeight | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 表示自由窗口状态下窗口的最小高度,宽度单位为vp。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md index 918397f75ec..9b8c1e615b1 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md @@ -13,20 +13,20 @@ | -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | | name | string | 是 | 否 | 应用程序的名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | description | string | 是 | 否 | 标识应用的描述信息,使用示例:"description": $string: mainability_description"。关于description的详细信息可参见descriptionResource字段说明。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| descriptionId | number | 是 | 否 | 标识应用的描述信息的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 标识应用的描述信息的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | enabled | boolean | 是 | 否 | 判断应用程序是否可以使用,取值为true表示可以使用,取值为false表示不可使用。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | label | string | 是 | 否 | 标识应用的名称,使用示例:"label": "$string: mainability_description"。关于label的详细信息可参见labelResource字段说明。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| labelId | number | 是 | 否 | 标识应用名称的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 标识应用名称的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | icon | string | 是 | 否 | 应用程序的图标,使用示例:"icon": "$media:icon"。关于icon的详细信息可参见iconResource字段说明。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| iconId | number | 是 | 否 | 应用程序图标的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用程序图标的资源id。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | process | string | 是 | 否 | 应用程序的进程名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | permissions | Array\ | 是 | 否 | 访问应用程序所需的权限,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION和GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | codePath | string | 是 | 否 | 应用程序的安装目录。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | metadata(deprecated) | Map\> | 是 | 否 | 应用程序的元信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION和GET_BUNDLE_INFO_WITH_METADATA获取。注: 从API version 10开始不再维护,建议使用metadataArray替代。 | | metadataArray10+ | Array\<[ModuleMetadata](#modulemetadata10)> | 是 | 否 | 应用程序的元信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION和GET_BUNDLE_INFO_WITH_METADATA获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | removable | boolean | 是 | 否 | 应用程序是否可以被移除,取值为true表示可以被移除,取值为false表示不可以被移除。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| accessTokenId | number | 是 | 否 | 应用程序的accessTokenId。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| uid | number | 是 | 否 | 应用程序的uid。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| accessTokenId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用程序的accessTokenId。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| uid | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用程序的uid。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | iconResource | [Resource](../apis-localization-kit/js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的图标资源信息,通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id,可以调用全球化的接口[getMediaContent](../apis-localization-kit/js-apis-resource-manager.md#getmediacontent9)来获取详细的资源数据信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | labelResource | [Resource](../apis-localization-kit/js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的标签资源信息,通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id,可以调用全球化的接口[getMediaContent](../apis-localization-kit/js-apis-resource-manager.md#getmediacontent9)来获取详细的资源数据信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | descriptionResource | [Resource](../apis-localization-kit/js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的描述资源信息,通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id,可以调用全球化的接口[getMediaContent](../apis-localization-kit/js-apis-resource-manager.md#getmediacontent9)来获取详细的资源数据信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | @@ -38,7 +38,7 @@ | dataUnclearable11+ | boolean | 是 | 否 | 标识应用数据是否可被删除。true表示不可删除,false表示可以删除。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | nativeLibraryPath12+ | string | 是 | 否 | 应用程序的本地库文件路径。 | | multiAppMode12+ | [MultiAppMode](#multiappmode12) | 是 | 否 | 应用多开模式。| -| appIndex12+ | number | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | | installSource12+ | string | 是 | 否 | 应用程序的安装来源,支持的取值如下:
- pre-installed表示应用为第一次开机时安装的预置应用。
- ota表示应用为系统升级时新增的预置应用。
- recovery表示卸载后再恢复的预置应用。
- 安装来源的格式为包名表示应用由此包名对应的应用安装。
- unknown表示应用安装来源未知。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | | releaseType12+ | string | 是 | 否 | 标识应用打包时使用的SDK的发布类型。当前SDK的发布类型可能为Canary、Beta、Release,其中Canary和Beta可能通过序号进一步细分,例如Canary1、Canary2、Beta1、Beta2等。开发者可通过对比应用打包依赖的SDK发布类型和OS的发布类型([deviceInfo.distributionOSReleaseType](../apis-basic-services-kit/js-apis-device-info.md))来判断兼容性。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | | cloudFileSyncEnabled12+ | boolean | 是 | 否 | 标识当前应用是否启用端云文件同步能力。true表示当前应用启用端云文件同步能力,false表示当前应用不启用端云文件同步能力。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | @@ -53,7 +53,7 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | --------- | -------------- | ---- | ---- | --------------------------- | | multiAppModeType12+ | bundleManager.MultiAppModeType | 是 | 否 | 应用多开模式的类型。 | -| maxCount12+ | number | 是 | 否 | 应用多开的最大个数。 | +| maxCount12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用多开的最大个数。 | ## ModuleMetadata10+ diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-bundleInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-bundleInfo.md index 8438667c9d5..abfc6324e73 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-bundleInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-bundleInfo.md @@ -14,20 +14,20 @@ | --------------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | | name | string | 是 | 否 | 应用包的名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | vendor | string | 是 | 否 | 应用包的供应商。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| versionCode | number | 是 | 否 | 应用包的版本号。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| versionCode | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用包的版本号。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | versionName | string | 是 | 否 | 应用包的版本文本描述信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| targetVersion | number | 是 | 否 | 该标签标识应用运行目标版本。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| minCompatibleVersionCode | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 分布式场景下的应用包兼容的最低版本。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| targetVersion | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 该标签标识应用运行目标版本。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | appInfo | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 是 | 否 | 应用程序的配置信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | hapModulesInfo | Array\<[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)> | 是 | 否 | 模块的配置信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | reqPermissionDetails | Array\<[ReqPermissionDetail](#reqpermissiondetail)> | 是 | 否 | 应用运行时需向系统申请的权限集合的详细信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | permissionGrantStates | Array\<[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)> | 是 | 否 | 申请权限的授予状态,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | signatureInfo | [SignatureInfo](#signatureinfo) | 是 | 否 | 应用包的签名信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_SIGNATURE_INFO获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| installTime | number | 是 | 否 | 应用包安装时间。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| updateTime | number | 是 | 否 | 应用包更新时间。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| installTime | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用包安装时间。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| updateTime | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 应用包更新时间。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | routerMap12+ | Array\<[RouterItem](js-apis-bundleManager-hapModuleInfo.md#routeritem12)> | 是 | 否 | 应用的路由表配置,由hapModulesInfo下的routerMap信息,根据RouterItem中的name字段进行去重后合并得到。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_ROUTER_MAP获取。
**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 | -| appIndex12+ | number | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | -| firstInstallTime18+ | number | 是 | 是 | 应用在当前设备的首次安装时间。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | +| firstInstallTime18+ | ArkTs1.1: number
ArkTs1.2: long | 是 | 是 | 应用在当前设备的首次安装时间。
**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。 | ## ReqPermissionDetail @@ -45,7 +45,7 @@ | name | string | 否 | 否 | 需要使用的权限名称。 | | moduleName10+ | string | 否 | 否 | 申请该权限的module名称。 | | reason | string | 否 | 否 | 描述申请权限的原因。 | -| reasonId | number | 否 | 否 | 描述申请权限的原因ID。 | +| reasonId | ArkTs1.1: number
ArkTs1.2: long | 否 | 否 | 描述申请权限的原因ID。 | | usedScene | [UsedScene](#usedscene) | 否 | 否 | 权限使用的场景和时机。 | @@ -85,4 +85,4 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | --------- | -------------- | ---- | ---- | --------------------------- | | bundleName | string | 是 | 否 | 应用的bundleName。 | -| appIndex | number | 是 | 否 | 应用包的分身索引信息。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用包的分身索引信息。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-extensionAbilityInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-extensionAbilityInfo.md index d2bc19d8414..419a342e8be 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-extensionAbilityInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-extensionAbilityInfo.md @@ -16,9 +16,9 @@ ExtensionAbility信息,三方应用可以通过[bundleManager.getBundleInfoFor | bundleName | string | 是 | 否 | 应用Bundle名称。 | | moduleName | string | 是 | 否 | ExtensionAbility所属的HAP的名称。 | | name | string | 是 | 否 | ExtensionAbility名称。 | -| labelId | number | 是 | 否 | ExtensionAbility的标签资源ID。 | -| descriptionId | number | 是 | 否 | ExtensionAbility的描述资源ID。 | -| iconId | number | 是 | 否 | ExtensionAbility的图标资源ID。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | ExtensionAbility的标签资源ID。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | ExtensionAbility的描述资源ID。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | ExtensionAbility的图标资源ID。 | | exported | boolean | 是 | 否 | 判断ExtensionAbility是否可以被其他应用调用,取值为true表示ExtensionAbility可以被其他应用调用,取值为false表示ExtensionAbility不可以被其他应用调用。 | | extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是 | 否 | ExtensionAbility类型。 | | permissions | Array\ | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合。 | @@ -29,4 +29,4 @@ ExtensionAbility信息,三方应用可以通过[bundleManager.getBundleInfoFor | writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限。 | | extensionAbilityTypeName11+ | string | 是 | 否 | ExtensionAbility的类型名称。 | | skills12+ | Array\<[Skill](js-apis-bundleManager-skill.md)> | 是 | 否 | ExtensionAbility的Skills信息。 | -| appIndex12+ | number | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | \ No newline at end of file +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-hapModuleInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-hapModuleInfo.md index 7913824d6a7..0e5b5ef59a1 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-hapModuleInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-hapModuleInfo.md @@ -13,11 +13,11 @@ HAP信息,三方应用可以通过[getBundleInfoForSelf](js-apis-bundleManager | --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- | | name | string | 是 | 否 | 模块名称。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | icon | string | 是 | 否 | 模块图标。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| iconId | number | 是 | 否 | 模块图标的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 模块图标的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | label | string | 是 | 否 | 模块标签。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| labelId | number | 是 | 否 | 模块标签的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 模块标签的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | description | string | 是 | 否 | 模块描述信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | -| descriptionId | number | 是 | 否 | 描述信息的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 描述信息的资源id值。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | mainElementName | string | 是 | 否 | 入口ability信息。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | abilitiesInfo | Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)> | 是 | 否 | Ability信息。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_ABILITY获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | | extensionAbilitiesInfo | Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)> | 是 | 否 | ExtensionAbility信息。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY获取。
**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 | @@ -57,7 +57,7 @@ HAP信息,三方应用可以通过[getBundleInfoForSelf](js-apis-bundleManager | ----------- | ------ | ---- | ---- | ---------------------- | | bundleName10+ | string | 是 | 否 | 标识当前模块依赖的共享包包名。 | | moduleName | string | 是 | 否 | 标识当前模块依赖的共享包模块名。 | -| versionCode10+ | number | 是 | 否 | 标识当前共享包的版本号。 | +| versionCode10+ | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 标识当前共享包的版本号。 | ## RouterItem12+ diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-launcherAbilityInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-launcherAbilityInfo.md index d1b9f447d3e..e68d5a23081 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-launcherAbilityInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-launcherAbilityInfo.md @@ -15,7 +15,7 @@ | --------------- | ----------------------------------------------------------- | ---- | ---- | ------------------------------------ | | applicationInfo | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 是 | 否 | launcher ability的应用程序的配置信息。 | | elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | launcher ability的ElementName信息。 | -| labelId | number | 是 | 否 | launcher ability的标签ID。 | -| iconId | number | 是 | 否 | launcher ability的图标ID。 | -| userId | number | 是 | 否 | launcher ability的用户ID。 | -| installTime | number | 是 | 否 | launcher ability的安装时间。 | \ No newline at end of file +| labelId | number
ArkTs1.2: long | 是 | 否 | launcher ability的标签ID。 | +| iconId | number
ArkTs1.2: long | 是 | 否 | launcher ability的图标ID。 | +| userId | number
ArkTs1.2: int | 是 | 否 | launcher ability的用户ID。 | +| installTime | number
ArkTs1.2: long | 是 | 否 | launcher ability的安装时间。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-metadata.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-metadata.md index 4c905c9a2cd..68561d8fc04 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-metadata.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-metadata.md @@ -16,4 +16,4 @@ | name | string | 否 | 否 | 元数据名称。 | | value | string | 否 | 否 | 元数据值。 | | resource | string | 否 | 否 | 元数据资源。 | -| valueId18+ | number | 是 | 是 | 元数据值id。当valueId不为0时,表示当前元数据值为自定义配置,需要使用valueId去资源管理获取对应的值。 当valueId为0时,表示当前元数据值为固定字符串。 | \ No newline at end of file +| valueId18+ | number
ArkTs1.2: long | 是 | 是 | 元数据值id。当valueId不为0时,表示当前元数据值为自定义配置,需要使用valueId去资源管理获取对应的值。 当valueId为0时,表示当前元数据值为固定字符串。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-overlayModuleInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-overlayModuleInfo.md index 113271047fb..4d773835384 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-overlayModuleInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-overlayModuleInfo.md @@ -14,5 +14,5 @@ OverlayModuleInfo信息,三方应用可以通过[overlay.getOverlayModuleInfo] | bundleName | string | 是 | 否 | overlay特征module所属的应用的bundle名称。 | | moduleName | string | 是 | 否 | overlay特征module的名称。 | | targetModuleName | string | 是 | 否 | overlay特征module指定的目标module的名称。 | -| priority | number | 是 | 否 | overlay特征module的优先级。 | -| state | number | 是 | 否 | overlay特征module的禁用使能状态。0代表禁用状态; 1代表使能状态。 | \ No newline at end of file +| priority | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | overlay特征module的优先级。 | +| state | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | overlay特征module的禁用使能状态。0代表禁用状态; 1代表使能状态。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-permissionDef-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-permissionDef-sys.md index a0a8eb21e43..504689900a5 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-permissionDef-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-permissionDef-sys.md @@ -17,6 +17,6 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | -------------- | ------ | ---- | ---- | -------------- | | permissionName | string | 是 | 否 | 用户权限名称。 | -| grantMode | number | 是 | 否 | 权限的授予模式。 | -| labelId | number | 是 | 否 | 权限的标签ID。 | -| descriptionId | number | 是 | 否 | 描述权限的ID。 | \ No newline at end of file +| grantMode | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 权限的授予模式。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 权限的标签ID。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 描述权限的ID。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-recoverableApplicationInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-recoverableApplicationInfo-sys.md index 99cd10fcf7a..e3cf3c6502c 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-recoverableApplicationInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-recoverableApplicationInfo-sys.md @@ -20,8 +20,8 @@ | ---------------- | ------------------------------ | ---- | ---- | ---------------------- | | bundleName | string | 是 | 否 | 应用包的名称。 | | moduleName | string | 是 | 否 | 模块名称。 | -| labelId | number | 是 | 否 | 模块标签的资源ID值。 | -| iconId | number | 是 | 否 | 模块图标的资源ID值。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 模块标签的资源ID值。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 模块图标的资源ID值。 | | systemApp12+ | boolean | 是 | 否 | 标识应用是否为系统应用,取值为true表示系统应用,取值为false表示非系统应用。 | | bundleType12+ |[BundleType](js-apis-bundleManager.md#bundletype) | 是 | 否 | 标识包的类型,取值为APP(应用)或者ATOMIC_SERVICE(原子化服务)。 | | codePaths12+ | Array\ | 是 | 否 | 应用程序的安装目录。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sharedBundleInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sharedBundleInfo-sys.md index cc3705ce0eb..c7ad3abe1a6 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sharedBundleInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sharedBundleInfo-sys.md @@ -33,7 +33,7 @@ | 名称 | 类型 | 只读 | 可选 | 说明 | | ------------- | ------ | ---- | ---- | -------------------------- | | name | string | 是 | 否 | 共享包模块名称。 | -| versionCode | number | 是 | 否 | 共享包的版本号。 | +| versionCode | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 共享包的版本号。 | | versionName | string | 是 | 否 | 共享包的版本文本描述信息。 | | description | string | 是 | 否 | 共享包的模块描述信息。 | -| descriptionId | number | 是 | 否 | 共享包描述的资源id值。 | +| descriptionId | ArkTs1.1: number
ArkTs1.2: long | 是 | 否 | 共享包描述的资源id值。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-shortcutInfo-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-shortcutInfo-sys.md index 92c6f6fb475..56931b062ed 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-shortcutInfo-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-shortcutInfo-sys.md @@ -36,12 +36,12 @@ | moduleName | string | 是 | 是 | 快捷方式的模块名。 | | hostAbility | string | 是 | 是 | 快捷方式的本地Ability名称。 | | icon | string | 是 | 是 | 快捷方式的图标。 | -| iconId | number | 是 | 是 | 快捷方式的图标ID。 | +| iconId | ArkTs1.1: number
ArkTs1.2: long | 是 | 是 | 快捷方式的图标ID。 | | label | string | 是 | 是 | 快捷方式的标签。 | -| labelId | number | 是 | 是 | 快捷方式的标签ID。 | +| labelId | ArkTs1.1: number
ArkTs1.2: long | 是 | 是 | 快捷方式的标签ID。 | | wants | Array\<[ShortcutWant](#shortcutwant)> | 是 | 是 | 快捷方式所需要的信息。 | -| appIndex12+ | number | 否 | 否 | 应用程序分身的索引。 | -| sourceType12+ | number | 否 | 否 | 快捷方式来源类型,0:自定义快捷方式;1:静态快捷方式。 | +| appIndex12+ | ArkTs1.1: number
ArkTs1.2: int | 否 | 否 | 应用程序分身的索引。 | +| sourceType12+| ArkTs1.1: number
ArkTs1.2: int | 否 | 否 | 快捷方式来源类型,0:自定义快捷方式;1:静态快捷方式。 | ## ParameterItem12+ diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-skill.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-skill.md index f60975130d3..27a3321561b 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-skill.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-skill.md @@ -32,11 +32,11 @@ import { bundleManager } from '@kit.AbilityKit'; | --------------- | ------ | ---- | ---- | ----------------------------------------------------------- | | scheme | string | 是 | 否 | 标识 URI 协议名,常见的有http、https、file、ftp等。 | | host | string | 是 | 否 | 标识 URI 主机地址部分,仅当 scheme 存在时有意义。 | -| port | number | 是 | 否 | 标识 URI 端口部分,仅当 scheme 和 host 同时存在时有意义。 | +| port | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 标识 URI 端口部分,仅当 scheme 和 host 同时存在时有意义。 | | path | string | 是 | 否 | 标识 URI 路径部分,仅当 scheme 和 host 同时存在时有意义。 | | pathStartWith | string | 是 | 否 | 标识 URI 路径部分,用于前缀匹配,仅当 scheme 和 host 同时存在时有意义。 | | pathRegex | string | 是 | 否 | 标识 URI 路径部分,用于正则匹配,仅当 scheme 和 host 同时存在时有意义。 | | type | string | 是 | 否 | 标识与Want相匹配的数据类型,使用MIME(Multipurpose Internet Mail Extensions)类型规范。 | | utd | string | 是 | 否 | 标识与 Want 相匹配的 URI 的标准化数据类型,适用于分享等场景。 | -| maxFileSupported | number | 是 | 否 | 对于指定类型的文件,标识一次能接收或打开的最大数量。 | +| maxFileSupported| ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 对于指定类型的文件,标识一次能接收或打开的最大数量。 | | linkFeature | string | 是 | 否 | 标识 URI 提供的功能类型,用于实现应用间跳转, 仅在AbilityInfo中存在。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md index 631ad9df521..8ca8dd4461f 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md @@ -146,7 +146,8 @@ Ability组件信息标志,指示需要获取的Ability组件信息的内容。 ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, userId: int, callback: AsyncCallback\): void 根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用callback异步回调。 @@ -161,8 +162,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。| -| userId | number | 是 | 表示用户ID。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。| +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象。 | **错误码:** @@ -179,6 +180,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: **示例:** +ArkTs1.1: ```ts // 额外获取AbilityInfo import { bundleManager } from '@kit.AbilityKit'; @@ -224,10 +226,58 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取AbilityInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` + +```ts +// 额外获取ApplicationInfo中的metadata +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, callback: AsyncCallback\): void 根据给定的bundleName和bundleFlags获取BundleInfo,使用callback异步回调。 @@ -242,7 +292,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\< | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。| +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。| | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 | **错误码:** @@ -258,6 +308,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\< **示例:** +ArkTs1.1: ```ts // 额外获取extensionAbility import { bundleManager } from '@kit.AbilityKit'; @@ -279,10 +330,34 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取extensionAbility +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\ +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, userId?: int): Promise\ 根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用Promise异步回调。 @@ -297,8 +372,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -320,6 +395,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise **示例:** +ArkTs1.1: ```ts // 额外获取ApplicationInfo和SignatureInfo import { bundleManager } from '@kit.AbilityKit'; @@ -359,11 +435,54 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message); } +``` +ArkTs1.2: +```ts +// 额外获取ApplicationInfo和SignatureInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` + +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} ``` ## bundleManager.getApplicationInfo -getApplicationInfo(bundleName: string, appFlags: number, userId: number, callback: AsyncCallback\): void +ArkTs1.1: getApplicationInfo(bundleName: string, appFlags: number, userId: number, callback: AsyncCallback\): void
+ArkTs1.2: getApplicationInfo(bundleName: string, appFlags: int, userId: int, callback: AsyncCallback\): void 根据给定的bundleName、appFlags和userId获取ApplicationInfo,使用callback异步回调。 @@ -380,8 +499,8 @@ getApplicationInfo(bundleName: string, appFlags: number, userId: number, callbac | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | -| userId | number | 是 | 表示用户ID。 | +| appFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 | **错误码:** @@ -399,6 +518,7 @@ getApplicationInfo(bundleName: string, appFlags: number, userId: number, callbac **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -420,10 +540,34 @@ try { hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT; +let userId = 100; +try { + bundleManager.getApplicationInfo(bundleName, appFlags, userId, + (err: BusinessError | null, data: bundleManager.ApplicationInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); +} +``` ## bundleManager.getApplicationInfo -getApplicationInfo(bundleName: string, appFlags: number, callback: AsyncCallback\): void +ArkTs1.1: getApplicationInfo(bundleName: string, appFlags: number, callback: AsyncCallback\): void
+ArkTs1.2: getApplicationInfo(bundleName: string, appFlags: int, callback: AsyncCallback\): void 根据给定的bundleName和appFlags获取ApplicationInfo,使用callback异步回调。 @@ -440,7 +584,7 @@ getApplicationInfo(bundleName: string, appFlags: number, callback: AsyncCallback | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | +| appFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 | **错误码:** @@ -457,6 +601,7 @@ getApplicationInfo(bundleName: string, appFlags: number, callback: AsyncCallback **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -477,10 +622,33 @@ try { hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT; +try { + bundleManager.getApplicationInfo(bundleName, appFlags, + (err: BusinessError | null, data: bundleManager.ApplicationInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); +} +``` ## bundleManager.getApplicationInfo -getApplicationInfo(bundleName: string, appFlags: number, userId?: number): Promise\ +ArkTs1.1: getApplicationInfo(bundleName: string, appFlags: number, userId?: number): Promise\
+ArkTs1.2: getApplicationInfo(bundleName: string, appFlags: int, userId?: int): Promise\ 根据给定的bundleName、appFlags和userId获取ApplicationInfo,使用Promise异步回调。 @@ -497,8 +665,8 @@ getApplicationInfo(bundleName: string, appFlags: number, userId?: number): Promi | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| appFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -521,6 +689,7 @@ getApplicationInfo(bundleName: string, appFlags: number, userId?: number): Promi **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -540,10 +709,32 @@ try { hilog.error(0x0000, 'testTag', 'getApplicationInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_WITH_PERMISSION; +let userId = 100; +try { + bundleManager.getApplicationInfo(bundleName, appFlags, userId).then((data: bundleManager.ApplicationInfo) => { + hilog.info(0x0000, 'testTag', 'getApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllBundleInfo -getAllBundleInfo(bundleFlags: number, userId: number, callback: AsyncCallback>): void +ArkTs1.1: getAllBundleInfo(bundleFlags: number, userId: number, callback: AsyncCallback>): void
+ArkTs1.2: getAllBundleInfo(bundleFlags: int, userId: int, callback: AsyncCallback>): void 根据给定的bundleFlags和userId获取系统中所有的BundleInfo,使用callback异步回调。 @@ -557,8 +748,8 @@ getAllBundleInfo(bundleFlags: number, userId: number, callback: AsyncCallbackArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -574,6 +765,7 @@ getAllBundleInfo(bundleFlags: number, userId: number, callback: AsyncCallback | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllBundleInfo -getAllBundleInfo(bundleFlags: number, callback: AsyncCallback>): void +ArkTs1.1: getAllBundleInfo(bundleFlags: number, callback: AsyncCallback>): void
+ArkTs1.2: getAllBundleInfo(bundleFlags: int, callback: AsyncCallback>): void 根据给定的bundleFlags获取系统中所有的BundleInfo,使用callback异步回调。 @@ -611,7 +826,7 @@ getAllBundleInfo(bundleFlags: number, callback: AsyncCallback | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | -------------------------------------------------- | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -626,6 +841,7 @@ getAllBundleInfo(bundleFlags: number, callback: AsyncCallback **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -645,10 +861,33 @@ try { hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; +let userId = 100; +try { + bundleManager.getAllBundleInfo(bundleFlags, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllBundleInfo -getAllBundleInfo(bundleFlags: number, userId?: number): Promise> +ArkTs1.1: getAllBundleInfo(bundleFlags: number, userId?: number): Promise>
+ArkTs1.2: getAllBundleInfo(bundleFlags: int, userId?: int): Promise> 根据给定的bundleFlags和userId获取系统中所有的BundleInfo,使用Promise异步回调。 @@ -662,8 +901,8 @@ getAllBundleInfo(bundleFlags: number, userId?: number): PromiseArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -684,6 +923,7 @@ getAllBundleInfo(bundleFlags: number, userId?: number): Promise) => { + hilog.info(0x0000, 'testTag', 'getAllBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllApplicationInfo -getAllApplicationInfo(appFlags: number, userId: number, callback: AsyncCallback>): void +ArkTs1.1: getAllApplicationInfo(appFlags: number, userId: number, callback: AsyncCallback>): void
+ArkTs1.2: getAllApplicationInfo(appFlags: int, userId: int, callback: AsyncCallback>): void 根据给定的appFlags和userId获取系统中所有的ApplicationInfo,使用callback异步回调。 @@ -718,8 +978,8 @@ getAllApplicationInfo(appFlags: number, userId: number, callback: AsyncCallback< | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ----------------------------------------------------------- | -| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | -| userId | number | 是 | 表示用户ID。 | +| appFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -735,6 +995,7 @@ getAllApplicationInfo(appFlags: number, userId: number, callback: AsyncCallback< **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -755,10 +1016,33 @@ try { hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT; +let userId = 100; +try { + bundleManager.getAllApplicationInfo(appFlags, userId, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllApplicationInfo -getAllApplicationInfo(appFlags: number, callback: AsyncCallback>): void +ArkTs1.1: getAllApplicationInfo(appFlags: number, callback: AsyncCallback>): void
+ArkTs1.2: getAllApplicationInfo(appFlags: int, callback: AsyncCallback>): void 根据给定的appFlags获取系统中所有的ApplicationInfo,使用callback异步回调。 @@ -772,7 +1056,7 @@ getAllApplicationInfo(appFlags: number, callback: AsyncCallbackArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -787,6 +1071,7 @@ getAllApplicationInfo(appFlags: number, callback: AsyncCallback | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllApplicationInfo -getAllApplicationInfo(appFlags: number, userId?: number): Promise> +ArkTs1.1: getAllApplicationInfo(appFlags: number, userId?: number): Promise>
+ArkTs1.2: getAllApplicationInfo(appFlags: int, userId?: int): Promise> 根据给定的appFlags和userId获取系统中所有的ApplicationInfo,使用Promise异步回调。 @@ -823,8 +1130,8 @@ getAllApplicationInfo(appFlags: number, userId?: number): PromiseArkTs1.2: [int](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -845,6 +1152,7 @@ getAllApplicationInfo(appFlags: number, userId?: number): Promise) => { + hilog.info(0x0000, 'testTag', 'getAllApplicationInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message); +} ``` ## bundleManager.queryAbilityInfo -queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback>): void +Arkts1.1: queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback>): void
+Arkts1.2: queryAbilityInfo(want: Want, abilityFlags: int, userId: int, callback: AsyncCallback>): void 根据给定的want、abilityFlags和userId获取多个AbilityInfo,使用callback异步回调。 @@ -881,8 +1209,8 @@ queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: Asy | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------ | ---- | ------------------------------------------------------- | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | -| abilityFlags | [number](#abilityflag) | 是 | 指定返回的AbilityInfo所包含的信息。 | -| userId | number | 是 | 表示用户ID。 | +| abilityFlags | ArkTs1.1: [number](#abilityflag)
ArkTs1.2: [int](#abilityflag) | 是 | 指定返回的AbilityInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -902,6 +1230,7 @@ queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: Asy **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -927,10 +1256,38 @@ try { hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryAbilityInfo(want, abilityFlags, userId, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryAbilityInfo -queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback>): void +Arkts1.1: queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback>): void
+Arkts1.2: queryAbilityInfo(want: Want, abilityFlags: int, callback: AsyncCallback>): void 根据给定的want和abilityFlags获取一个或多个AbilityInfo,使用callback异步回调。 @@ -945,7 +1302,7 @@ queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallbackArkTs1.2: [int](#abilityflag) | 是 | 指定返回的AbilityInfo所包含的信息。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\;否则为错误对象。 | **错误码:** @@ -964,6 +1321,7 @@ queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryAbilityInfo -queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise> +ArkTs1.1: queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise>
+ArkTs1.2: queryAbilityInfo(want: Want, abilityFlags: int, userId?: int): Promise> 根据给定的want、abilityFlags和userId获取一个或多个AbilityInfo,使用Promise异步回调。 @@ -1006,8 +1391,8 @@ queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): PromiseArkTs1.2: [int](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1032,6 +1417,7 @@ queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise) => { + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` + +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryAbilityInfo(want, abilityFlags).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryAbilityInfoSync10+ -queryAbilityInfoSync(want: Want, abilityFlags: number, userId?: number): Array\ +ArkTs1.1: queryAbilityInfoSync(want: Want, abilityFlags: number, userId?: number): Array\
+ArkTs1.2: queryAbilityInfoSync(want: Want, abilityFlags: int, userId?: int): Array\ 以同步方法根据给定的want、abilityFlags和userId获取一个或多个AbilityInfo。 @@ -1096,8 +1532,8 @@ queryAbilityInfoSync(want: Want, abilityFlags: number, userId?: number): Array\< | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------ | ---- | ------------------------------------------------------- | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | -| abilityFlags | [number](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| abilityFlags | ArkTs1.1: [number](#abilityflag)
ArkTs1.2: [int](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1166,7 +1602,8 @@ try { ## bundleManager.queryAbilityInfo12+ -queryAbilityInfo(wants: Array\, abilityFlags: number, userId?: number): Promise> +ArkTs1.1: queryAbilityInfo(wants: Array\, abilityFlags: number, userId?: number): Promise>
+ArkTs1.2: queryAbilityInfo(wants: Array\, abilityFlags: int, userId?: int): Promise> 根据给定的want列表、abilityFlags和userId获取一个或多个AbilityInfo,使用Promise异步回调。 @@ -1181,8 +1618,8 @@ queryAbilityInfo(wants: Array\, abilityFlags: number, userId?: number): Pr | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------ | ---- | ------------------------------------------------------- | | want | Array\ | 是 | 表示包含要查询的应用Bundle名称的Want集合。 | -| abilityFlags | [number](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| abilityFlags | ArkTs1.1: [number](#abilityflag)
ArkTs1.2: [int](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1207,6 +1644,7 @@ queryAbilityInfo(wants: Array\, abilityFlags: number, userId?: number): Pr **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1234,10 +1672,41 @@ let wants: Array = [ want, want1 ]; hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication1", + abilityName : "EntryAbility" +}; +let want1: Want = { + bundleName : "com.example.myapplication2", + abilityName : "EntryAbility" +}; +let wants: Array = [ want, want1 ]; +try { + bundleManager.queryAbilityInfo(wants, abilityFlags, userId).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryExtensionAbilityInfo -queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId: number, callback: AsyncCallback>): void +ArkTs1.1: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId: number, callback: AsyncCallback>): void
+ArkTs1.2: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: int, userId: int, callback: AsyncCallback>): void 根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取一个或多个ExtensionAbilityInfo,使用callback异步回调。 @@ -1253,8 +1722,8 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType | --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | | extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager-sys.md#extensionabilitytype) | 是 | 标识extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | -| userId | number | 是 | 表示用户ID。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array\;否则为错误对象。 | **错误码:** @@ -1273,6 +1742,7 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1299,10 +1769,39 @@ try { hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; +let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryExtensionAbilityInfo -queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, callback: AsyncCallback>): void +ArkTs1.1: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, callback: AsyncCallback>): void
+ArkTs1.2: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: int, callback: AsyncCallback>): void 根据给定的want、extensionAbilityType和extensionAbilityFlags获取一个或多个ExtensionAbilityInfo,使用callback异步回调。 @@ -1318,7 +1817,7 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType | --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | | extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager-sys.md#extensionabilitytype) | 是 | 标识extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | | callback | AsyncCallback> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array\;否则为错误对象。 | **错误码:** @@ -1336,6 +1835,7 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1361,10 +1861,38 @@ try { hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; +let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryExtensionAbilityInfo -queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId?: number): Promise> +ArkTs1.1: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId?: number): Promise>
+ArkTs1.2: queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: int, userId?: int): Promise> 根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取ExtensionAbilityInfo,使用Promise异步回调。 @@ -1380,8 +1908,8 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType | --------------------- | --------------------------------------------- | ---- | --------------------------------------------------------- | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | | extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager-sys.md#extensionabilitytype) | 是 | 标识extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1405,6 +1933,7 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: ExtensionAbilityType **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1454,10 +1983,62 @@ try { hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; +let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); +} +``` + +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; +let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.queryExtensionAbilityInfoSync10+ -queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId?: number): Array\ +ArkTs1.1: queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: number, userId?: number): Array\
+ArkTs1.2: queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: ExtensionAbilityType, extensionAbilityFlags: int, userId?: int): Array\ 以同步方法根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取ExtensionAbilityInfo。 @@ -1473,8 +2054,8 @@ queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: ExtensionAbility | --------------------- | --------------------------------------------- | ---- | --------------------------------------------------------- | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | | extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager-sys.md#extensionabilitytype) | 是 | 标识extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1544,7 +2125,8 @@ try { ## bundleManager.getBundleNameByUid14+ -getBundleNameByUid(uid: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleNameByUid(uid: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleNameByUid(uid: int, callback: AsyncCallback\): void 根据给定的uid获取对应的bundleName,使用callback异步回调。 @@ -1556,7 +2138,7 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | ------------------------------------------------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | | callback | AsyncCallback\ | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleName;否则为错误对象。 | **错误码:** @@ -1571,6 +2153,7 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\): void **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1589,10 +2172,31 @@ try { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getBundleNameByUid(uid, (err: BusinessError | null, data: string | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleNameByUid success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); +} +``` ## bundleManager.getBundleNameByUid14+ -getBundleNameByUid(uid: number): Promise\ +ArkTs1.1: getBundleNameByUid(uid: number): Promise\
+ArkTs1.2: getBundleNameByUid(uid: int): Promise\ 根据给定的uid获取对应的bundleName,使用Promise异步回调。 @@ -1604,7 +2208,7 @@ getBundleNameByUid(uid: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -1624,6 +2228,7 @@ getBundleNameByUid(uid: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1640,10 +2245,30 @@ try { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getBundleNameByUid(uid).then((data: string) => { + hilog.info(0x0000, 'testTag', 'getBundleNameByUid success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); +} +``` ## bundleManager.getBundleNameByUidSync14+ -getBundleNameByUidSync(uid: number): string +ArkTs1.1: getBundleNameByUidSync(uid: number): string
+ArkTs1.2: getBundleNameByUidSync(uid: int): string 以同步方法根据给定的uid获取对应的bundleName。 @@ -1655,7 +2280,7 @@ getBundleNameByUidSync(uid: number): string | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -1691,7 +2316,8 @@ try { ## bundleManager.getBundleArchiveInfo -getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleArchiveInfo(hapFilePath: string, bundleFlags: int, callback: AsyncCallback\): void 根据给定的hapFilePath和bundleFlags获取BundleInfo,使用callback异步回调。 @@ -1706,7 +2332,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCa | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ----------------------------------------------------------- | | hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 | **错误码:** @@ -1722,6 +2348,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCa **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1742,10 +2369,33 @@ try { hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let hapFilePath = "/data/xxx/test.hap"; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; +try { + bundleManager.getBundleArchiveInfo(hapFilePath, bundleFlags, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleArchiveInfo -getBundleArchiveInfo(hapFilePath: string, bundleFlags: number): Promise\ +ArkTs1.1: getBundleArchiveInfo(hapFilePath: string, bundleFlags: number): Promise\
+ArkTs1.2: getBundleArchiveInfo(hapFilePath: string, bundleFlags: int): Promise\ 根据给定的hapFilePath和bundleFlags获取BundleInfo,使用Promise异步回调。 @@ -1760,7 +2410,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: number): Promise\ArkTs1.2: int | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | **返回值:** @@ -1781,6 +2431,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: number): Promise\ { + hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleArchiveInfoSync10+ -getBundleArchiveInfoSync(hapFilePath: string, bundleFlags: number): BundleInfo +ArkTs1.1: getBundleArchiveInfoSync(hapFilePath: string, bundleFlags: number): BundleInfo
+ArkTs1.2: getBundleArchiveInfoSync(hapFilePath: string, bundleFlags: int): BundleInfo 以同步方法根据给定的hapFilePath和bundleFlags获取BundleInfo对象。 @@ -1817,7 +2489,7 @@ getBundleArchiveInfoSync(hapFilePath: string, bundleFlags: number): BundleInfo | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------------------------------ | | hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | **返回值:** @@ -1856,7 +2528,8 @@ try { ## bundleManager.getAllBundleCacheSize15+ -getAllBundleCacheSize(): Promise\ +ArkTs1.1: getAllBundleCacheSize(): Promise\
+ArkTs1.2: getAllBundleCacheSize(): Promise\ 获取全局缓存大小,使用Promise异步回调。 @@ -1870,7 +2543,7 @@ getAllBundleCacheSize(): Promise\ | 类型 | 说明 | | ---------------------------------------- | ------- | -| Promise\ | Promise对象。返回全局缓存大小,以字节为单位。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象。返回全局缓存大小,以字节为单位。 | **错误码:** @@ -1883,6 +2556,7 @@ getAllBundleCacheSize(): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1899,6 +2573,24 @@ try { hilog.error(0x0000, 'testTag', 'getAllBundleCacheSize failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +try { + bundleManager.getAllBundleCacheSize().then((data: long) => { + hilog.info(0x0000, 'testTag','getAllBundleCacheSize success. data: ' + JSON.stringify(data)); +}).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); +}); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.cleanAllBundleCache15+ @@ -2061,7 +2753,8 @@ try { ## bundleManager.cleanBundleCacheFiles15+ -cleanBundleCacheFiles(bundleName: string, appIndex: number): Promise\ +Arkts1.1: cleanBundleCacheFiles(bundleName: string, appIndex: number): Promise\
+Arkts1.2: cleanBundleCacheFiles(bundleName: string, appIndex: int): Promise\ 根据给定的bundleName和appIndex清理BundleCache,使用Promise异步回调。 @@ -2078,7 +2771,7 @@ cleanBundleCacheFiles(bundleName: string, appIndex: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------------------------ | | bundleName | string | 是 | 表示要清理其缓存数据的应用程序的bundleName。 | -| appIndex | number | 是 | 表示要清理其缓存数据的应用程序的分身应用索引。
appIndex为0时,清理主应用缓存数据。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示要清理其缓存数据的应用程序的分身应用索引。
appIndex为0时,清理主应用缓存数据。 | **返回值:** @@ -2101,6 +2794,7 @@ cleanBundleCacheFiles(bundleName: string, appIndex: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -2119,6 +2813,26 @@ try { hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = "com.ohos.myapplication"; +let appIndex = 1; +try { + bundleManager.cleanBundleCacheFiles(bundleName, appIndex).then(() => { + hilog.info(0x0000, 'testTag', 'cleanBundleCacheFiles success.'); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', message); +} +``` ## bundleManager.setApplicationEnabled @@ -2231,7 +2945,8 @@ try { ## bundleManager.setApplicationEnabled12+ -setApplicationEnabled(bundleName: string, appIndex: number, isEnabled: boolean): Promise\ +ArkTs1.1: setApplicationEnabled(bundleName: string, appIndex: number, isEnabled: boolean): Promise\
+ArkTs1.2: setApplicationEnabled(bundleName: string, appIndex: int, isEnabled: boolean): Promise\ 设置指定应用或分身应用的禁用或使能状态,使用Promise异步回调。 @@ -2246,7 +2961,7 @@ setApplicationEnabled(bundleName: string, appIndex: number, isEnabled: boolean): | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------- | ---- | ------------------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| appIndex | number | 是 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用的禁用或使能状态。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用的禁用或使能状态。 | | isEnabled | boolean | 是 | 值为true表示使能,值为false表示禁用。 | **返回值:** @@ -2269,6 +2984,7 @@ setApplicationEnabled(bundleName: string, appIndex: number, isEnabled: boolean): **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -2286,6 +3002,25 @@ try { hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = "com.ohos.myapplication"; +try { + bundleManager.setApplicationEnabled(bundleName, 1, false).then(() => { + hilog.info(0x0000, "testTag", "setApplicationEnabled success."); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', message); +} +``` ## bundleManager.setApplicationEnabledSync10+ @@ -2473,7 +3208,8 @@ try { ## bundleManager.setAbilityEnabled12+ -setAbilityEnabled(info: AbilityInfo, appIndex: number, isEnabled: boolean): Promise\ +ArkTs1.1: setAbilityEnabled(info: AbilityInfo, appIndex: number, isEnabled: boolean): Promise\
+ArkTs1.2: setAbilityEnabled(info: AbilityInfo, appIndex: int, isEnabled: boolean): Promise\ 设置指定应用或分身应用组件的禁用或使能状态,使用Promise异步回调。 @@ -2488,7 +3224,7 @@ setAbilityEnabled(info: AbilityInfo, appIndex: number, isEnabled: boolean): Prom | 参数名 | 类型 | 必填 | 说明 | | -------- | ----------- | ---- | ------------------------------------- | | info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 需要被设置的组件。 | -| appIndex | number | 是 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用组件的禁用或使能状态。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示分身应用的索引。
appIndex为0时,表示设置指定应用组件的禁用或使能状态。 | | isEnabled| boolean | 是 | 值为true表示使能,值为false表示禁用。 | **返回值:** @@ -2512,6 +3248,7 @@ setAbilityEnabled(info: AbilityInfo, appIndex: number, isEnabled: boolean): Prom **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -2542,6 +3279,39 @@ try { hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo: Array) => { + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(abilitiesInfo)); + let info = abilitiesInfo[0]; + + bundleManager.setAbilityEnabled(info, 1, false).then(() => { + hilog.info(0x0000, "testTag", "setAbilityEnabled success."); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'setAbilityEnabled failed: %{public}s', message); + }); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.setAbilityEnabledSync10+ @@ -2712,7 +3482,8 @@ try { ## bundleManager.isApplicationEnabled12+ -isApplicationEnabled(bundleName: string, appIndex: number): Promise\ +ArkTs1.1: isApplicationEnabled(bundleName: string, appIndex: number): Promise\
+ArkTs1.2: isApplicationEnabled(bundleName: string, appIndex: int): Promise\ 获取指定应用或分身应用的禁用或使能状态,使用Promise异步回调。 @@ -2725,7 +3496,7 @@ isApplicationEnabled(bundleName: string, appIndex: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| appIndex | number | 是 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用的禁用或使能状态。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用的禁用或使能状态。 | **返回值:** @@ -2746,6 +3517,7 @@ isApplicationEnabled(bundleName: string, appIndex: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -2763,6 +3535,25 @@ try { hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +try { + bundleManager.isApplicationEnabled(bundleName, 1).then((data: boolean) => { + hilog.info(0x0000, 'testTag', 'isApplicationEnabled success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', message); +} +``` ## bundleManager.isApplicationEnabledSync10+ @@ -2944,7 +3735,8 @@ try { ## bundleManager.isAbilityEnabled12+ -isAbilityEnabled(info: AbilityInfo, appIndex: number): Promise\ +Arkts1.1: isAbilityEnabled(info: AbilityInfo, appIndex: number): Promise\
+Arkts1.2: isAbilityEnabled(info: AbilityInfo, appIndex: int): Promise\ 获取应用或指定分身应用组件的禁用或使能状态,使用Promise异步回调。 @@ -2957,7 +3749,7 @@ isAbilityEnabled(info: AbilityInfo, appIndex: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---- | ----------- | ---- | --------------------------- | | info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 表示关于检查ability的信息。 | -| appIndex | number | 是 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用组件的禁用或使能状态。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示分身应用的索引。
appIndex为0时,表示获取指定应用组件的禁用或使能状态。 | **返回值:** @@ -2979,6 +3771,7 @@ isAbilityEnabled(info: AbilityInfo, appIndex: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -3009,6 +3802,39 @@ try { hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; +let userId = 100; +let want: Want = { + bundleName : "com.example.myapplication", + abilityName : "EntryAbility" +}; +try { + bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo: Array) => { + hilog.info(0x0000, 'testTag', 'queryAbilityInfo success. data: %{public}s', JSON.stringify(abilitiesInfo)); + let info = abilitiesInfo[0]; + + bundleManager.isAbilityEnabled(info, 1).then((data: boolean) => { + hilog.info(0x0000, "testTag", 'isAbilityEnabled success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'isAbilityEnabled failed: %{public}s', message); + }); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message); +} +``` ## bundleManager.isAbilityEnabledSync10+ @@ -3080,7 +3906,8 @@ try { ## bundleManager.getLaunchWantForBundle -getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallback\): void +Arkts1.1: getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallback\): void
+Arkts1.2: getLaunchWantForBundle(bundleName: string, userId: int, callback: AsyncCallback\): void 根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用callback异步回调。 @@ -3095,7 +3922,7 @@ getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallba | 参数名 | 类型 | 必填 | 说明 | | ---------- | -------------------- | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| userId | number | 是 | 表示用户ID。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback\ | 是 | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象。 | **错误码:** @@ -3113,6 +3940,7 @@ getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallba **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -3133,6 +3961,28 @@ try { hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let bundleName = 'com.example.myapplication'; +let userId = 100; +try { + bundleManager.getLaunchWantForBundle(bundleName, userId, (err: BusinessError | null, data: Want | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message); +} +``` ## bundleManager.getLaunchWantForBundle @@ -3189,7 +4039,8 @@ try { ## bundleManager.getLaunchWantForBundle -getLaunchWantForBundle(bundleName: string, userId?: number): Promise\ +ArkTs1.1: getLaunchWantForBundle(bundleName: string, userId?: number): Promise\
+ArkTs1.2: getLaunchWantForBundle(bundleName: string, userId?: int): Promise\ 根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用Promise异步回调。 @@ -3204,7 +4055,7 @@ getLaunchWantForBundle(bundleName: string, userId?: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -3227,6 +4078,7 @@ getLaunchWantForBundle(bundleName: string, userId?: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -3245,11 +4097,33 @@ try { hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; +import Want from '@ohos.app.ability.Want'; + +let bundleName = 'com.example.myapplication'; +let userId = 100; +try { + bundleManager.getLaunchWantForBundle(bundleName, userId).then((data: Want) => { + hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message); +} +``` ## bundleManager.getLaunchWantForBundleSync10+ -getLaunchWantForBundleSync(bundleName: string, userId?: number): Want +ArkTs1.1: getLaunchWantForBundleSync(bundleName: string, userId?: number): Want
+ArkTs1.2: getLaunchWantForBundleSync(bundleName: string, userId?: int): Want 以同步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数。 @@ -3264,7 +4138,7 @@ getLaunchWantForBundleSync(bundleName: string, userId?: number): Want | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -3665,7 +4539,8 @@ try { ## bundleManager.getApplicationInfoSync -getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: number) : ApplicationInfo +ArkTs1.1: getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: number) : ApplicationInfo
+ArkTs1.2: getApplicationInfoSync(bundleName: string, applicationFlags: int, userId: int) : ApplicationInfo 以同步方法根据给定的bundleName、applicationFlags和userId获取ApplicationInfo。 @@ -3680,8 +4555,8 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: num | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ----------------------------------------------------------| | bundleName | string | 是 | 表示应用程序的bundleName。 | -| applicationFlags | [number](#applicationflag) | 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息。 | -| userId | number | 是 | 表示用户ID。 | +| applicationFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | **返回值:** @@ -3723,7 +4598,8 @@ try { ## bundleManager.getApplicationInfoSync -getApplicationInfoSync(bundleName: string, applicationFlags: number) : ApplicationInfo +ArkTs1.1: getApplicationInfoSync(bundleName: string, applicationFlags: number) : ApplicationInfo
+ArkTs1.2: getApplicationInfoSync(bundleName: string, applicationFlags: int) : ApplicationInfo 以同步方法根据给定的bundleName、applicationFlags获取ApplicationInfo。 @@ -3738,7 +4614,7 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number) : Applicati | 参数名 | 类型 | 必填 | 说明 | | ---------------- | -------------------------- | ---- | ----------------------------------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| applicationFlags | [number](#applicationflag) | 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息。 | +| applicationFlags | ArkTs1.1: [number](#applicationflag)
ArkTs1.2: [int](#applicationflag) | 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息。 | **返回值:** @@ -3778,7 +4654,8 @@ try { ## bundleManager.getBundleInfoSync14+ -getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): BundleInfo +ArkTs1.1: getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): BundleInfo
+ArkTs1.2: getBundleInfoSync(bundleName: string, bundleFlags: int, userId: int): BundleInfo 以同步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo。 @@ -3793,8 +4670,8 @@ getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): Bund | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | -------------------------------------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | -| userId | number | 是 | 表示用户ID。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | **返回值:** @@ -3835,7 +4712,8 @@ try { ## bundleManager.getBundleInfoSync14+ -getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo +ArkTs1.1: getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo
+ArkTs1.2: getBundleInfoSync(bundleName: string, bundleFlags: int): BundleInfo 以同步方法根据给定的bundleName、bundleFlags获取BundleInfo。 @@ -3850,7 +4728,7 @@ getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo | 参数名 | 类型 | 必填 | 说明 | | ----------- | --------------------- | ---- | ------------------------------------------------------ | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | **返回值:** @@ -4147,7 +5025,8 @@ try { ## bundleManager.getAppProvisionInfo10+ -getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\): void +ArkTs1.1: getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\): void
+ArkTs1.2: getAppProvisionInfo(bundleName: string, userId: int, callback: AsyncCallback\): void 获取指定bundleName和userId的provision配置文件信息,使用callback异步回调。 @@ -4162,7 +5041,7 @@ getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\ | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 指定应用的bundleName。 | -| userId | number | 是 | 指定用户ID, 可以通过接口[getOsAccountLocalId](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定用户ID, 可以通过接口[getOsAccountLocalId](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 | | callback | AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo-sys.md)\> | 是 | 回调函数,当获取成功时,err为null,data为指定bundleName的provision配置文件信息。 | @@ -4180,6 +5059,7 @@ getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -4200,10 +5080,33 @@ try { hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = "com.ohos.myapplication"; +let userId = 100; +try { + bundleManager.getAppProvisionInfo(bundleName, userId, + (err: BusinessError | null, data: bundleManager.AppProvisionInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAppProvisionInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); +} +``` ## bundleManager.getAppProvisionInfo10+ -getAppProvisionInfo(bundleName: string, userId?: number): Promise\ +ArkTs1.1: getAppProvisionInfo(bundleName: string, userId?: number): Promise\
+ArkTs1.2: getAppProvisionInfo(bundleName: string, userId?: int): Promise\ 根据bundleName和userId获取应用的provision配置文件信息,使用Promise异步回调。 @@ -4218,7 +5121,7 @@ getAppProvisionInfo(bundleName: string, userId?: number): Promise\ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0,可以通过接口[getOsAccountLocalId](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 | **返回值:** @@ -4241,6 +5144,7 @@ getAppProvisionInfo(bundleName: string, userId?: number): Promise\ { + hilog.info(0x0000, 'testTag', 'getAppProvisionInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); +} +try { + bundleManager.getAppProvisionInfo(bundleName, userId).then((data: bundleManager.AppProvisionInfo) => { + hilog.info(0x0000, 'testTag', 'getAppProvisionInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message); +} +``` ## bundleManager.getAppProvisionInfoSync10+ -getAppProvisionInfoSync(bundleName: string, userId?: number): AppProvisionInfo +Arkts1.1: getAppProvisionInfoSync(bundleName: string, userId?: number): AppProvisionInfo
+Arkts1.2: getAppProvisionInfoSync(bundleName: string, userId?: int): AppProvisionInfo 以同步方法根据bundleName和userId获取应用的provision配置文件信息并返回结果。 @@ -4288,7 +5224,7 @@ getAppProvisionInfoSync(bundleName: string, userId?: number): AppProvisionInfo | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 指定的bundleName。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0,可以通过接口[getOsAccountLocalId](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0,可以通过接口[getOsAccountLocalId](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 | **返回值:** @@ -4438,7 +5374,8 @@ try { ## bundleManager.queryExtensionAbilityInfoSync11+ -queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: string, extensionAbilityFlags: number, userId?: number): Array\ +ArkTs1.1: queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: string, extensionAbilityFlags: number, userId?: number): Array\
+ArkTs1.2: queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: string, extensionAbilityFlags: int, userId?: int): Array\ 根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取ExtensionAbilityInfo,使用同步方式返回结果。 @@ -4454,8 +5391,8 @@ queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: string, extensio | --------------------- | ------------------------------- | ---- | --------------------------------------------------------- | | want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 | | extensionAbilityType | string | 是 | 表示自定义extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示返回的ExtensionInfo对象中需要包含的信息标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示返回的ExtensionInfo对象中需要包含的信息标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -4528,7 +5465,8 @@ try { ## bundleManager.getJsonProfile11+ -getJsonProfile(profileType: ProfileType, bundleName: string, moduleName?: string, userId?: number): string +ArkTs1.1: getJsonProfile(profileType: ProfileType, bundleName: string, moduleName?: string, userId?: number): string
+ArkTs1.2: getJsonProfile(profileType: ProfileType, bundleName: string, moduleName?: string, userId?: int): string 以同步的方法根据给定的profileType、bundleName和moduleName查询相应配置文件的JSON字符串。 @@ -4547,7 +5485,7 @@ getJsonProfile(profileType: ProfileType, bundleName: string, moduleName?: string | profileType | [ProfileType](#profiletype11) | 是 | 表示要查询的配置文件类型。 | | bundleName | string | 是 | 表示要查询应用程序的bundleName。 | | moduleName | string | 否 | 表示要查询应用程序的module的名称,缺省时在入口模块中查找。 | -| userId12+ | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| userId12+ | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -4779,7 +5717,8 @@ try { ## bundleManager.queryExtensionAbilityInfoSync11+ -queryExtensionAbilityInfoSync(extensionAbilityType: string, extensionAbilityFlags: number, userId?: number): Array\ +ArkTs1.1: queryExtensionAbilityInfoSync(extensionAbilityType: string, extensionAbilityFlags: number, userId?: number): Array\
+ArkTs1.2: queryExtensionAbilityInfoSync(extensionAbilityType: string, extensionAbilityFlags: int, userId?: int): Array\ 根据给定的extensionAbilityType、extensionAbilityFlags和userId获取ExtensionAbilityInfo。 @@ -4794,8 +5733,8 @@ queryExtensionAbilityInfoSync(extensionAbilityType: string, extensionAbilityFlag | 参数名 | 类型 | 必填 | 说明 | | --------------------- | ------------------------------- | ---- | --------------------------------------------------------- | | extensionAbilityType | string | 是 | 表示自定义extensionAbility的类型。 | -| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示返回的ExtensionInfo对象中需要包含的信息标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户ID。取值范围:大于等于0。 | +| extensionAbilityFlags | ArkTs1.1: [number](#extensionabilityflag)
ArkTs1.2: [int](#extensionabilityflag) | 是 | 表示返回的ExtensionInfo对象中需要包含的信息标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户ID。取值范围:大于等于0。 | **返回值:** @@ -4909,7 +5848,8 @@ try { ## bundleManager.getDeveloperIds12+ -getDeveloperIds(appDistributionType?: number): Array\ +Arkts1.1: getDeveloperIds(appDistributionType?: number): Array\
+Arkts1.2: getDeveloperIds(appDistributionType?: int): Array\ 根据给定的应用分发类型获取当前用户下的所有的开发者ID列表。 @@ -4923,7 +5863,7 @@ getDeveloperIds(appDistributionType?: number): Array\ | 参数名 | 类型 | 必填 | 说明 | | --------------------- | ---------| ---- | --------------------- | -| appDistributionType | [number](#appdistributiontype12) | 否 | 表示应用的分发类型,当该参数缺省时,会返回所有应用的开发者ID列表。 | +| appDistributionType | ArkTs1.1: [number](#appdistributiontype12)
ArkTs1.2: [int](#appdistributiontype12) | 否 | 表示应用的分发类型,当该参数缺省时,会返回所有应用的开发者ID列表。 | **返回值:** @@ -5236,7 +6176,8 @@ try { ## bundleManager.getAppCloneIdentity14+ -getAppCloneIdentity(uid: number): Promise\; +Arkts1.1: getAppCloneIdentity(uid: number): Promise\
+Arkts1.2: getAppCloneIdentity(uid: int): Promise\ 根据uid查询分身应用的bundleName和appIndex。使用Promise异步回调。 @@ -5248,7 +6189,7 @@ getAppCloneIdentity(uid: number): Promise\; | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------| -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -5268,6 +6209,7 @@ getAppCloneIdentity(uid: number): Promise\; **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -5285,10 +6227,30 @@ try { hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getAppCloneIdentity(uid).then((data: bundleManager.AppCloneIdentity) => { + hilog.info(0x0000, 'testTag', 'getAppCloneIdentity success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed: %{public}s', message); +} +``` ## bundleManager.getAppCloneBundleInfo12+ -getAppCloneBundleInfo(bundleName: string, appIndex: number, bundleFlags: number, userId?: number): Promise\; +Arkts1.1: getAppCloneBundleInfo(bundleName: string, appIndex: number, bundleFlags: number, userId?: number): Promise\
+Arkts1.1: getAppCloneBundleInfo(bundleName: string, appIndex: int, bundleFlags: int, userId?: int): Promise\ 根据bundleName、分身索引、[bundleFlags](js-apis-bundleManager.md#bundleflag)以及用户ID查询主应用或分身应用的BundleInfo。使用Promise异步回调。 @@ -5302,10 +6264,10 @@ getAppCloneBundleInfo(bundleName: string, appIndex: number, bundleFlags: number, | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------| -| bundleName | number | 是 | 表示要查询的应用Bundle名称。 | -| appIndex | number | 是 | 表示要查询的分身应用索引。
appIndex为0时,可以查询主应用信息。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| bundleName | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示要查询的应用Bundle名称。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示要查询的分身应用索引。
appIndex为0时,可以查询主应用信息。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -5329,6 +6291,7 @@ getAppCloneBundleInfo(bundleName: string, appIndex: number, bundleFlags: number, **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -5348,10 +6311,32 @@ try { hilog.error(0x0000, 'testTag', 'getAppCloneBundleInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let appIndex = 1; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY; +try { + bundleManager.getAppCloneBundleInfo(bundleName, appIndex, bundleFlags).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getAppCloneBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getAllAppCloneBundleInfo12+ -getAllAppCloneBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\>; +Arkts1.1: getAllAppCloneBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\>
+Arkts1.1: getAllAppCloneBundleInfo(bundleName: string, bundleFlags: int, userId?: int): Promise\> 根据bundleName、[bundleFlags](js-apis-bundleManager.md#bundleflag)以及用户ID查询主应用和分身应用的BundleInfo列表。使用Promise异步回调。 @@ -5365,9 +6350,9 @@ getAllAppCloneBundleInfo(bundleName: string, bundleFlags: number, userId?: numbe | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------| -| bundleName | number | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| bundleName | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示要查询的应用Bundle名称。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -5390,6 +6375,7 @@ getAllAppCloneBundleInfo(bundleName: string, bundleFlags: number, userId?: numbe **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -5411,6 +6397,26 @@ try { hilog.error(0x0000, 'testTag', 'getAllAppCloneBundleInfo failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY; +try { + bundleManager.getAllAppCloneBundleInfo(bundleName, bundleFlags).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'getAllAppCloneBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllAppCloneBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllAppCloneBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.verifyAbc11+ verifyAbc(abcPaths: Array\, deleteOriginalFiles: boolean, callback: AsyncCallback\): void diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager.md index 63fe026abd4..efebc90c4be 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager.md @@ -206,7 +206,8 @@ import { bundleManager } from '@kit.AbilityKit'; ## bundleManager.getBundleInfoForSelf -getBundleInfoForSelf(bundleFlags: number): Promise\ +ArkTs1.1: getBundleInfoForSelf(bundleFlags: number): Promise\
+ArkTs1.2: getBundleInfoForSelf(bundleFlags: int): Promise\ 根据给定的bundleFlags获取当前应用的BundleInfo,使用Promise异步回调。 @@ -218,7 +219,7 @@ getBundleInfoForSelf(bundleFlags: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | **返回值:** @@ -236,6 +237,7 @@ getBundleInfoForSelf(bundleFlags: number): Promise\ **示例:** +ArkTs1.1: ```ts // 额外获取带有metadataArray信息的appInfo import { bundleManager } from '@kit.AbilityKit'; @@ -255,10 +257,31 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取带有metadataArray信息的appInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA; +try { + bundleManager.getBundleInfoForSelf(bundleFlags).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); +} +``` ## bundleManager.getBundleInfoForSelf -getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleInfoForSelf(bundleFlags: int, callback: AsyncCallback\): void 根据给定的bundleFlags获取当前应用的BundleInfo,使用callback异步回调。 @@ -270,7 +293,7 @@ getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback\): | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的当前应用的BundleInfo;否则为错误对象。 | **错误码:** @@ -283,6 +306,7 @@ getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback\): **示例:** +ArkTs1.1: ```ts // 额外获取带有permissions信息的abilitiesInfo import { bundleManager } from '@kit.AbilityKit'; @@ -304,6 +328,28 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取带有permissions信息的abilitiesInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; +try { + bundleManager.getBundleInfoForSelf(bundleFlags, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); +} +``` ## bundleManager.getProfileByAbility @@ -724,7 +770,8 @@ try { ## bundleManager.getBundleInfoForSelfSync10+ -getBundleInfoForSelfSync(bundleFlags: number): BundleInfo +ArkTs1.1: getBundleInfoForSelfSync(bundleFlags: number): BundleInfo
+ArkTs1.2: getBundleInfoForSelfSync(bundleFlags: int): BundleInfo 以同步方法根据给定的bundleFlags获取当前应用的BundleInfo。 @@ -736,7 +783,7 @@ getBundleInfoForSelfSync(bundleFlags: number): BundleInfo | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | **返回值:** @@ -862,7 +909,8 @@ try { ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, userId: int, callback: AsyncCallback\): void 根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用callback异步回调。 @@ -877,8 +925,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。| -| userId | number | 是 | 表示用户ID。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。| +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象。 | **错误码:** @@ -895,6 +943,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: **示例:** +ArkTs1.1: ```ts // 额外获取AbilityInfo import { bundleManager } from '@kit.AbilityKit'; @@ -940,10 +989,59 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取AbilityInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` + +```ts +// 额外获取ApplicationInfo中的metadata +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, callback: AsyncCallback\): void 根据给定的bundleName和bundleFlags获取BundleInfo,使用callback异步回调。 @@ -958,7 +1056,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\< | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。| +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。| | callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 | **错误码:** @@ -974,6 +1072,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\< **示例:** +ArkTs1.1: ```ts // 额外获取extensionAbility import { bundleManager } from '@kit.AbilityKit'; @@ -995,10 +1094,34 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +// 额外获取extensionAbility +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, + (err: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` ## bundleManager.getBundleInfo14+ -getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\ +ArkTs1.1: getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\
+ArkTs1.2: getBundleInfo(bundleName: string, bundleFlags: int, userId?: int): Promise\ 根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用Promise异步回调。 @@ -1013,8 +1136,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------- | | bundleName | string | 是 | 表示要查询的应用Bundle名称。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | -| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 指定返回的BundleInfo所包含的信息。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 | **返回值:** @@ -1036,6 +1159,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise **示例:** +ArkTs1.1: ```ts // 额外获取ApplicationInfo和SignatureInfo import { bundleManager } from '@kit.AbilityKit'; @@ -1075,11 +1199,54 @@ try { hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message); } +``` +ArkTs1.2: +```ts +// 额外获取ApplicationInfo和SignatureInfo +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO; +let userId = 100; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags, userId).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} +``` + +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleName = 'com.example.myapplication'; +let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; +try { + bundleManager.getBundleInfo(bundleName, bundleFlags).then((data: bundleManager.BundleInfo) => { + hilog.info(0x0000, 'testTag', 'getBundleInfo success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); +} ``` ## bundleManager.getBundleInfoSync14+ -getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): BundleInfo +ArkTs1.1: getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): BundleInfo
+ArkTs1.2: getBundleInfoSync(bundleName: string, bundleFlags: int, userId: int): BundleInfo 以同步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo。 @@ -1094,8 +1261,8 @@ getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): Bund | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | -------------------------------------------------------- | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | -| userId | number | 是 | 表示用户ID。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | **返回值:** @@ -1136,7 +1303,8 @@ try { ## bundleManager.getBundleInfoSync14+ -getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo +ArkTs1.1: getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo
+ArkTs1.2: getBundleInfoSync(bundleName: string, bundleFlags: int): BundleInfo 以同步方法根据给定的bundleName、bundleFlags获取BundleInfo。 @@ -1151,7 +1319,7 @@ getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo | 参数名 | 类型 | 必填 | 说明 | | ----------- | --------------------- | ---- | ------------------------------------------------------ | | bundleName | string | 是 | 表示应用程序的bundleName。 | -| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | +| [bundleFlags](js-apis-bundleManager.md#bundleflag) | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 | **返回值:** @@ -1189,7 +1357,8 @@ try { ## bundleManager.getBundleNameByUid14+ -getBundleNameByUid(uid: number, callback: AsyncCallback\): void +ArkTs1.1: getBundleNameByUid(uid: number, callback: AsyncCallback\): void
+ArkTs1.2: getBundleNameByUid(uid: int, callback: AsyncCallback\): void 根据给定的uid获取对应的bundleName,使用callback异步回调。 @@ -1201,7 +1370,7 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | ------------------------------------------------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | | callback | AsyncCallback\ | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleName;否则为错误对象。 | **错误码:** @@ -1216,6 +1385,7 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\): void **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1234,10 +1404,31 @@ try { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getBundleNameByUid(uid, (err: BusinessError | null, data: string | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getBundleNameByUid success. data: %{public}s', JSON.stringify(data)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); +} +``` ## bundleManager.getBundleNameByUid14+ -getBundleNameByUid(uid: number): Promise\ +ArkTs1.1: getBundleNameByUid(uid: number): Promise\
+ArkTs1.2: getBundleNameByUid(uid: int): Promise\ 根据给定的uid获取对应的bundleName,使用Promise异步回调。 @@ -1249,7 +1440,7 @@ getBundleNameByUid(uid: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -1269,6 +1460,7 @@ getBundleNameByUid(uid: number): Promise\ **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1285,10 +1477,30 @@ try { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getBundleNameByUid(uid).then((data: string) => { + hilog.info(0x0000, 'testTag', 'getBundleNameByUid success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); +} +``` ## bundleManager.getBundleNameByUidSync14+ -getBundleNameByUidSync(uid: number): string +ArkTs1.1: getBundleNameByUidSync(uid: number): string
+ArkTs1.2: getBundleNameByUidSync(uid: int): string 以同步方法根据给定的uid获取对应的bundleName。 @@ -1300,7 +1512,7 @@ getBundleNameByUidSync(uid: number): string | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -1336,7 +1548,8 @@ try { ## bundleManager.getAppCloneIdentity14+ -getAppCloneIdentity(uid: number): Promise\; +ArkTs1.1: getAppCloneIdentity(uid: number): Promise\
+ArkTs1.2: getAppCloneIdentity(uid: int): Promise\ 根据uid查询分身应用的bundleName和appIndex。使用Promise异步回调。 @@ -1348,7 +1561,7 @@ getAppCloneIdentity(uid: number): Promise\; | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------------------| -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** @@ -1368,6 +1581,7 @@ getAppCloneIdentity(uid: number): Promise\; **示例:** +ArkTs1.1: ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -1385,10 +1599,30 @@ try { hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed. Cause: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleManager from '@ohos.bundle.bundleManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let uid = 20010005; +try { + bundleManager.getAppCloneIdentity(uid).then((data: bundleManager.AppCloneIdentity) => { + hilog.info(0x0000, 'testTag', 'getAppCloneIdentity success. data: %{public}s', JSON.stringify(data)); + }).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed: %{public}s', message); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed: %{public}s', message); +} +``` ## bundleManager.getSignatureInfo18+ -getSignatureInfo(uid: number): SignatureInfo +ArkTs1.1: getSignatureInfo(uid: number): SignatureInfo
+ArkTs1.2: getSignatureInfo(uid: int): SignatureInfo 根据给定的uid获取对应的[SignatureInfo](./js-apis-bundleManager-bundleInfo.md#signatureinfo)。 @@ -1400,7 +1634,7 @@ getSignatureInfo(uid: number): SignatureInfo | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------------------ | -| uid | number | 是 | 表示应用程序的UID。 | +| uid | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示应用程序的UID。 | **返回值:** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleMonitor-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleMonitor-sys.md index f5f9a78ac13..c411ee08099 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleMonitor-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleMonitor-sys.md @@ -31,7 +31,7 @@ import bundleMonitor from '@ohos.bundle.bundleMonitor'; | 名称 | 类型 | 只读 | 可选 | 说明 | | ---------- | ------ | ---- | ---- | -------------------------- | | bundleName | string | 是 | 否 | 应用状态发生变化的应用Bundle名称。 | -| userId | number | 是 | 否 | 应用状态发生变化的用户id。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 否 | 应用状态发生变化的用户id。 | ## BundleChangedEvent diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleResourceManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleResourceManager-sys.md index fe9dc40a6c3..b157bfc429b 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleResourceManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleResourceManager-sys.md @@ -48,7 +48,8 @@ import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; ### bundleResourceManager.getBundleResourceInfo -getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag)): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md) +ArkTs1.1: getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag)): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md)
+ArkTs1.2: getBundleResourceInfo(bundleName: string, resourceFlags?: [int](#resourceflag)): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md) 以同步方法根据给定的bundleName和resourceFlags获取当前应用的BundleResourceInfo。 @@ -63,7 +64,7 @@ getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | | bundleName | string | 是 | 指定查询应用的包名。 | -| resourceFlags | [number](#resourceflag) | 否 | 指定返回的BundleResourceInfo所包含的信息。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 否 | 指定返回的BundleResourceInfo所包含的信息。 | **返回值:** @@ -103,7 +104,8 @@ try { ### bundleResourceManager.getLauncherAbilityResourceInfo -getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag)): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)> +ArkTs1.1: getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag)): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)>
+ArkTs1.2: getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [int](#resourceflag)): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)> 以同步方法根据给定的bundleName和resourceFlags获取当前应用的LauncherAbilityResourceInfo。 @@ -118,7 +120,7 @@ getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#res | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | | bundleName | string | 是 | 指定查询应用的包名。 | -| resourceFlags | [number](#resourceflag) | 否 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 否 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | **返回值:** @@ -157,7 +159,8 @@ try { ### bundleResourceManager.getAllBundleResourceInfo -getAllBundleResourceInfo(resourceFlags: [number](#resourceflag), callback: AsyncCallback>): void +ArkTs1.1: getAllBundleResourceInfo(resourceFlags: [number](#resourceflag), callback: AsyncCallback>): void
+ArkTs1.2: getAllBundleResourceInfo(resourceFlags: [int](#resourceflag), callback: AsyncCallback>): void 根据给定的resourceFlags获取所有应用的BundleResourceInfo。使用callback异步回调。 @@ -171,7 +174,7 @@ getAllBundleResourceInfo(resourceFlags: [number](#resourceflag), callback: Async | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| resourceFlags | [number](#resourceflag) | 是 | 指定返回的BundleResourceInfo所包含的信息。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 是 | 指定返回的BundleResourceInfo所包含的信息。 | | callback | AsyncCallback\> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleResourceInfo数值;否则为错误对象。 | **错误码:** @@ -186,6 +189,7 @@ getAllBundleResourceInfo(resourceFlags: [number](#resourceflag), callback: Async **示例:** +ArkTs1.1: ```ts import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; import { BusinessError } from '@ohos.base'; @@ -204,10 +208,32 @@ try { hilog.error(0x0000, 'testTag', 'getAllBundleResourceInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleResourceManager.ResourceFlag.GET_RESOURCE_INFO_ALL; +try { + bundleResourceManager.getAllBundleResourceInfo(bundleFlags, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllBundleResourceInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllBundleResourceInfo success. data length: %{public}s', JSON.stringify(data?.length)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleResourceInfo failed: %{public}s', message); +} +``` ### bundleResourceManager.getAllBundleResourceInfo -getAllBundleResourceInfo(resourceFlags: [number](#resourceflag)): Promise>; +ArkTs1.1: getAllBundleResourceInfo(resourceFlags: [number](#resourceflag)): Promise>
+ArkTs1.2: getAllBundleResourceInfo(resourceFlags: [int](#resourceflag)): Promise>; 根据给定的resourceFlags获取所有应用的BundleResourceInfo。使用Promise异步回调。 @@ -221,7 +247,7 @@ getAllBundleResourceInfo(resourceFlags: [number](#resourceflag)): PromiseArkTs1.2: [int](#resourceflag) | 是 | 指定返回的BundleResourceInfo所包含的信息。 | **返回值:** @@ -241,6 +267,7 @@ getAllBundleResourceInfo(resourceFlags: [number](#resourceflag)): Promise) => { + hilog.info(0x0000, 'testTag', 'getAllBundleResourceInfo success. data length: %{public}s', JSON.stringify(data?.length)); +}).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllBundleResourceInfo failed: %{public}s', message); +}) +} catch (err) { +let message = (err as BusinessError).message; +hilog.error(0x0000, 'testTag', 'getAllBundleResourceInfo failed: %{public}s', message); +} +``` ### bundleResourceManager.getAllLauncherAbilityResourceInfo -getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag), callback: AsyncCallback>): void +ArkYs1.1: getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag), callback: AsyncCallback>): void
+ArkYs1.2: getAllLauncherAbilityResourceInfo(resourceFlags: [int](#resourceflag), callback: AsyncCallback>): void 根据给定的resourceFlags获取当前所有应用的LauncherAbilityResourceInfo。使用callback异步回调。 @@ -274,7 +321,7 @@ getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag), callba | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| resourceFlags | [number](#resourceflag) | 是 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 是 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | | callback | AsyncCallback\> | 是 | 回调函数,当获取成功时,err为null,data为获取到的LauncherAbilityResourceInfo数值;否则为错误对象。 | **错误码:** @@ -289,6 +336,7 @@ getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag), callba **示例:** +ArkTs1.1: ```ts import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; import { BusinessError } from '@ohos.base'; @@ -307,10 +355,32 @@ try { hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleResourceManager.ResourceFlag.GET_RESOURCE_INFO_ALL; +try { + bundleResourceManager.getAllLauncherAbilityResourceInfo(bundleFlags, + (err: BusinessError | null, data: Array | undefined) => { + if (err) { + hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', err.message); + return; + } + hilog.info(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo success. data length: %{public}s', JSON.stringify(data?.length)); + }); +} catch (err) { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', message); +} +``` ### bundleResourceManager.getAllLauncherAbilityResourceInfo -getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag)) : Promise> +ArkTs1.1: getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag)) : Promise>
+ArkTs1.2: getAllLauncherAbilityResourceInfo(resourceFlags: [int](#resourceflag)) : Promise> 根据给定的resourceFlags获取当前所有应用的LauncherAbilityResourceInfo。使用Promise异步回调。 @@ -324,7 +394,7 @@ getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag)) : Prom | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | -| resourceFlags | [number](#resourceflag) | 是 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 是 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | **返回值:** @@ -343,6 +413,7 @@ getAllLauncherAbilityResourceInfo(resourceFlags: [number](#resourceflag)) : Prom | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| **示例:** +ArkTs1.1: ```ts import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; import { BusinessError } from '@ohos.base'; @@ -359,10 +430,30 @@ try { hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', message); } ``` +ArkTs1.2: +```ts +import bundleResourceManager from '@ohos.bundle.bundleResourceManager'; +import { BusinessError } from '@ohos.base'; +import hilog from '@ohos.hilog'; + +let bundleFlags = bundleResourceManager.ResourceFlag.GET_RESOURCE_INFO_ALL; +try { + bundleResourceManager.getAllLauncherAbilityResourceInfo(bundleFlags).then((data: Array) => { + hilog.info(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo success. data length: %{public}s', JSON.stringify(data?.length)); +}).catch((err: Error) => { + let message = (err as BusinessError).message; + hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', message); +}) +} catch (err) { +let message = (err as BusinessError).message; +hilog.error(0x0000, 'testTag', 'getAllLauncherAbilityResourceInfo failed: %{public}s', message); +} +``` ### bundleResourceManager.getBundleResourceInfo12+ -getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag), appIndex?: number): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md) +ArkTs1.1: getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag), appIndex?: number): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md)
+ArkTs1.2: getBundleResourceInfo(bundleName: string, resourceFlags?: [int](#resourceflag), appIndex?: int): [BundleResourceInfo](js-apis-bundleManager-BundleResourceInfo-sys.md) 以同步方法根据给定的bundleName、resourceFlags和appIndex获取当前应用的BundleResourceInfo。 @@ -377,8 +468,8 @@ getBundleResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | | bundleName | string | 是 | 指定查询应用的包名。 | -| resourceFlags | [number](#resourceflag) | 否 | 指定返回的BundleResourceInfo所包含的信息。 | -| appIndex | number | 否 | 指定查询应用分身的ID。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 否 | 指定返回的BundleResourceInfo所包含的信息。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 指定查询应用分身的ID。 | **返回值:** @@ -420,7 +511,8 @@ try { ### bundleResourceManager.getLauncherAbilityResourceInfo12+ -getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag), appIndex?: number): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)> +ArkTs1.1: getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#resourceflag), appIndex?: number): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)>
+ArkTs1.2: getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [int](#resourceflag), appIndex?: int): Array<[LauncherAbilityResourceInfo](js-apis-bundleManager-LauncherAbilityResourceInfo-sys.md)> 以同步方法根据给定的bundleName、resourceFlags和appIndex获取当前应用的LauncherAbilityResourceInfo。 @@ -435,8 +527,8 @@ getLauncherAbilityResourceInfo(bundleName: string, resourceFlags?: [number](#res | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------- | | bundleName | string | 是 | 指定查询应用的包名。 | -| resourceFlags | [number](#resourceflag) | 否 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | -| appIndex | number | 否 | 指定查询应用分身的ID。 | +| resourceFlags | ArkTs1.1: [number](#resourceflag)
ArkTs1.2: [int](#resourceflag) | 否 | 指定返回的LauncherAbilityResourceInfo所包含的信息。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 指定查询应用分身的ID。 | **返回值:** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-defaultAppManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-defaultAppManager-sys.md index 4180ba0a190..5939b2f51b1 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-defaultAppManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-defaultAppManager-sys.md @@ -24,7 +24,8 @@ import { defaultAppManager } from '@kit.AbilityKit'; ## defaultAppManager.getDefaultApplication -getDefaultApplication(type: string, userId?: number): Promise\ +ArkTs1.1: getDefaultApplication(type: string, userId?: number): Promise\
+ArkTs1.2: getDefaultApplication(type: string, userId?: int): Promise\ 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型获取默认应用信息,使用Promise异步回调。 @@ -39,7 +40,7 @@ getDefaultApplication(type: string, userId?: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | type | string | 是 | 要查询的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。 | -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId| ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **返回值:** @@ -63,6 +64,7 @@ getDefaultApplication(type: string, userId?: number): Promise\ **示例:** +ArkTs1.1: ```ts import { defaultAppManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -92,10 +94,42 @@ defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AV console.error('Operation failed. Cause: ' + JSON.stringify(error)); }); ``` +ArkTs1.2: +```ts +import defaultAppManager from '@ohos.bundle.defaultAppManager' +import { BusinessError } from '@ohos.base'; +import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor'; +import bundleManager from '@ohos.bundle.bundleManager'; + +defaultAppManager.getDefaultApplication(defaultAppManager.ApplicationType.BROWSER) + .then((data: bundleManager.BundleInfo) => { + console.info('getDefaultApplication success. bundleInfo: ' + JSON.stringify(data)); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getDefaultApplication failed ' + message); + }); + +defaultAppManager.getDefaultApplication("image/png") + .then((data: bundleManager.BundleInfo) => { + console.info('getDefaultApplication success. bundleInfo: ' + JSON.stringify(data)); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getDefaultApplication failed ' + message); + }); + +defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI) + .then((data: bundleManager.BundleInfo) => { + console.info('getDefaultApplication success. bundleInfo: ' + JSON.stringify(data)); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getDefaultApplication failed ' + message); + }); +``` ## defaultAppManager.getDefaultApplication -getDefaultApplication(type: string, userId: number, callback: AsyncCallback\) : void +ArkTs1.1: getDefaultApplication(type: string, userId: number, callback: AsyncCallback\) : void
+ArkTs1.2: getDefaultApplication(type: string, userId: int, callback: AsyncCallback\) : void 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型获取默认应用信息,使用callback异步回调。 @@ -110,7 +144,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\ArkTs1.2: int | 是 | 用户ID。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数,返回包信息。 | **错误码:** @@ -129,6 +163,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\ { + if (error) { + console.error('getDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('getDefaultApplication success. bundleInfo:' + JSON.stringify(data)); +}); + +defaultAppManager.getDefaultApplication("image/png", userId, + (error: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (error) { + console.error('getDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('getDefaultApplication success. bundleInfo:' + JSON.stringify(data)); +}); + +defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId, + (error: BusinessError | null, data: bundleManager.BundleInfo | undefined) => { + if (error) { + console.error('getDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('getDefaultApplication success. bundleInfo:' + JSON.stringify(data)); +}); +``` ## defaultAppManager.getDefaultApplication @@ -226,7 +296,8 @@ defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AV ## defaultAppManager.getDefaultApplicationSync10+ -getDefaultApplicationSync(type: string, userId?: number): BundleInfo +ArkTs1.1: getDefaultApplicationSync(type: string, userId?: number): BundleInfo
+ArkTs1.2: getDefaultApplicationSync(type: string, userId?: int): BundleInfo 以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型获取默认应用信息,使用BundleInfo返回结果。 @@ -241,7 +312,7 @@ getDefaultApplicationSync(type: string, userId?: number): BundleInfo | 参数名 | 类型 | 必填 | 说明 | | -------| ------ | ---- | --------------------------------------- | | type | string | 是 | 要查询的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。| -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **返回值:** @@ -293,7 +364,8 @@ try { ## defaultAppManager.setDefaultApplication -setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise\ +ArkTs1.1: setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise\
+ArkTs1.2: setDefaultApplication(type: string, elementName: ElementName, userId?: int): Promise\ 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型设置默认应用,使用Promise异步回调。 @@ -309,7 +381,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number): | ----------- | ------ | ---- | --------------------------------------- | | type | string | 是 | 要设置的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。 | | elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 要设置为默认应用的组件信息。 | -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **返回值:** @@ -333,6 +405,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number): **示例:** +ArkTs1.1: ```ts import { defaultAppManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -379,10 +452,62 @@ defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AV console.error('Operation failed. Cause: ' + JSON.stringify(error)); }); ``` +ArkTs1.2: +```ts +import defaultAppManager from '@ohos.bundle.defaultAppManager' +import { BusinessError } from '@ohos.base'; +import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor'; + +defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}).then(() => { + console.info('setDefaultApplication success.'); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('setDefaultApplication failed ' + message); +}); + +let userId = 100; +defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId).then(() => { + console.info('setDefaultApplication success.'); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('setDefaultApplication failed ' + message); +}); + +defaultAppManager.setDefaultApplication("image/png", { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId).then(() => { + console.info('setDefaultApplication success.'); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('setDefaultApplication failed ' + message); +}); + +defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId).then(() => { + console.info('setDefaultApplication success.'); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('setDefaultApplication failed ' + message); +}); +``` ## defaultAppManager.setDefaultApplication -setDefaultApplication(type: string, elementName: ElementName, userId: number, callback: AsyncCallback\) : void +ArkTs1.1: setDefaultApplication(type: string, elementName: ElementName, userId: number, callback: AsyncCallback\) : void
+ArkTs1.2: setDefaultApplication(type: string, elementName: ElementName, userId: int, callback: AsyncCallback\) : void 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型设置默认应用,使用callback异步回调。 @@ -398,7 +523,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca | ----------- | ------ | ---- | --------------------------------------- | | type | string | 是 | 要设置的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。 | | elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 要设置为默认应用的组件信息。 | -| userId | number | 是 | 用户ID。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 用户ID。 | | callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数。 | **错误码:** @@ -417,6 +542,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca **示例:** +ArkTs1.1: ```ts import { defaultAppManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -459,6 +585,49 @@ defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AV console.info('Operation successful.'); }); ``` +ArkTs1.2: +```ts +import defaultAppManager from '@ohos.bundle.defaultAppManager' +import { BusinessError } from '@ohos.base'; +import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor'; + +let userId = 100; +defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId, (error: BusinessError | null) => { + if (error) { + console.error('setDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('setDefaultApplication success.'); +}); + +defaultAppManager.setDefaultApplication("image/png", { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId, (error: BusinessError | null) => { + if (error) { + console.error('setDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('setDefaultApplication success.'); +}); + +defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, { + bundleName: "com.example.myapplication", + moduleName: "module01", + abilityName: "EntryAbility" +}, userId, (error: BusinessError | null) => { + if (error) { + console.error('setDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('setDefaultApplication success.'); +}); +``` ## defaultAppManager.setDefaultApplication @@ -539,7 +708,8 @@ defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AV ## defaultAppManager.setDefaultApplicationSync10+ -setDefaultApplicationSync(type: string, elementName: ElementName, userId?: number): void +ArkTs1.1: setDefaultApplicationSync(type: string, elementName: ElementName, userId?: number): void
+ArkTs1.2: setDefaultApplicationSync(type: string, elementName: ElementName, userId?: int): void 以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型设置默认应用。 @@ -555,7 +725,7 @@ setDefaultApplicationSync(type: string, elementName: ElementName, userId?: numbe | ----------- | ------ | ---- | --------------------------------------- | | type | string | 是 | 要设置的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。| | elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 要设置为默认应用的组件信息。 | -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **错误码:** @@ -625,7 +795,8 @@ try { ## defaultAppManager.resetDefaultApplication -resetDefaultApplication(type: string, userId?: number): Promise\ +ArkTs1.1: resetDefaultApplication(type: string, userId?: number): Promise\
+ArkTs1.2: resetDefaultApplication(type: string, userId?: int): Promise\ 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型重置默认应用,使用Promise异步回调。 @@ -640,7 +811,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | | type | string | 是 | 要重置的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。 | -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId| ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **错误码:** @@ -657,6 +828,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\ **示例:** +ArkTs1.1: ```ts import { defaultAppManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -687,10 +859,39 @@ defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType. console.error('Operation failed. Cause: ' + JSON.stringify(error)); }); ``` +ArkTs1.2: +```ts +import defaultAppManager from '@ohos.bundle.defaultAppManager' +import { BusinessError } from '@ohos.base'; +import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor'; + +let userId = 100; +defaultAppManager.resetDefaultApplication(defaultAppManager.ApplicationType.BROWSER, userId).then(() => { + console.info('resetDefaultApplication success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('resetDefaultApplication failed ' + message); +}); + +defaultAppManager.resetDefaultApplication("image/png", userId).then(() => { + console.info('resetDefaultApplication success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('resetDefaultApplication failed ' + message); +}); + +defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId).then(() => { + console.info('resetDefaultApplication success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('resetDefaultApplication failed ' + message); +}); +``` ## defaultAppManager.resetDefaultApplication -resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\) : void +ArkTs1.1: resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\) : void
+ArkTs1.2: resetDefaultApplication(type: string, userId: int, callback: AsyncCallback\) : void 根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型重置默认应用,使用callback异步回调。 @@ -705,7 +906,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\ArkTs1.2: int | 是 | 用户ID。 | | callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数。 | **错误码:** @@ -723,6 +924,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\ { + if (error) { + console.error('resetDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('resetDefaultApplication success.'); +}); + +defaultAppManager.resetDefaultApplication("image/png", userId, + (error: BusinessError | null) => { + if (error) { + console.error('resetDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('resetDefaultApplication success.'); +}); + +defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId, + (error: BusinessError | null) => { + if (error) { + console.error('resetDefaultApplication failed ' + JSON.stringify(error.message)); + return; + } + console.info('resetDefaultApplication success.'); +}); +``` ## defaultAppManager.resetDefaultApplication @@ -819,7 +1055,8 @@ defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType. ## defaultAppManager.resetDefaultApplicationSync10+ -resetDefaultApplicationSync(type: string, userId?: number): void +ArkTs1.1: resetDefaultApplicationSync(type: string, userId?: number): void
+ArkTs1.2: resetDefaultApplicationSync(type: string, userId?: int): void 以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型重置默认应用。 @@ -834,7 +1071,7 @@ resetDefaultApplicationSync(type: string, userId?: number): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | --------------------------------------- | | type | string | 是 | 要重置的应用类型,取[ApplicationType](js-apis-defaultAppManager.md#defaultappmanagerapplicationtype)中的值,或者符合媒体类型格式的文件类型,或者[UniformDataType](../apis-arkdata/js-apis-data-uniformTypeDescriptor.md)类型。| -| userId | number | 否 | 用户ID。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 用户ID。默认值:调用方所在用户。 | **错误码:** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-installer-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-installer-sys.md index 9a43b1f65a2..fc150b4ccf4 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-installer-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-installer-sys.md @@ -1384,7 +1384,8 @@ try { ## BundleInstaller.createAppClone12+ -createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): Promise\; +ArkTs1.1: createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): Promise\
+ArkTs1.2: createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): Promise\ 创建应用分身,使用Promise异步回调。 @@ -1405,7 +1406,7 @@ createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): P | 类型 | 说明 | | --------------- | -------------------------------------- | -| Promise\ | Promise对象。返回创建的分身应用索引值。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象。返回创建的分身应用索引值。 | **错误码:** @@ -1422,6 +1423,7 @@ createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): P | 17700069 | The app does not support the creation of an appClone instance. | **示例:** +ArkTs1.1: ```ts import installer from '@ohos.bundle.installer'; import { BusinessError } from '@ohos.base'; @@ -1448,10 +1450,38 @@ try { console.error('getBundleInstaller failed. Cause: ' + message); } ``` +ArkTs1.2: +```ts +import installer from '@ohos.bundle.installer'; +import { BusinessError } from '@ohos.base'; + +let bundleName = 'com.ohos.camera'; +let createAppCloneParam: installer.CreateAppCloneParam = { + userId: 100, + appIndex: 1, +}; +try { + installer.getBundleInstaller().then((data: installer.BundleInstaller) => { + data.createAppClone(bundleName, createAppCloneParam).then(() => { + console.info('createAppClone success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('createAppClone failed ' + message); + }); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed ' + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed ' + message); +} +``` ## BundleInstaller.destroyAppClone12+ -destroyAppClone(bundleName: string, appIndex: number, userId?: number): Promise\; +ArkTs1.1: destroyAppClone(bundleName: string, appIndex: number, userId?: number): Promise\
+ArkTs1.2: destroyAppClone(bundleName: string, appIndex: int, options?: int | DestroyAppCloneParam): Promise\ 删除应用分身,使用Promise异步回调。 @@ -1466,8 +1496,8 @@ destroyAppClone(bundleName: string, appIndex: number, userId?: number): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ------------ | ----------------------------- | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 待删除应用分身的包名。 | -| appIndex | number | 是 | 待删除应用分身的索引。 | -| userId | number | 否 | 待删除应用分身所属用户id。默认值:调用方所在用户。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 待删除应用分身的索引。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 待删除应用分身所属用户id。默认值:调用方所在用户。 | **返回值:** @@ -1489,6 +1519,7 @@ destroyAppClone(bundleName: string, appIndex: number, userId?: number): Promise\ | 17700061 | The appIndex is invalid. | **示例:** +Arkts1.1: ```ts import installer from '@ohos.bundle.installer'; import { BusinessError } from '@ohos.base'; @@ -1513,10 +1544,36 @@ try { console.error('getBundleInstaller failed. Cause: ' + message); } ``` +Arkts1.2: +```ts +import installer from '@ohos.bundle.installer'; +import { BusinessError } from '@ohos.base'; + +let bundleName = 'com.ohos.camera'; +let index = 1; +let userId = 100; +try { + installer.getBundleInstaller().then((data: installer.BundleInstaller) => { + data.destroyAppClone(bundleName, index, userId).then(() => { + console.info('destroyAppClone successfully.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('destroyAppClone failed ' + message); + }); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed ' + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed. Cause: ' + message); +} +``` ## BundleInstaller.destroyAppClone15+ -destroyAppClone(bundleName: string, appIndex: number, destroyAppCloneParam?: DestroyAppCloneParam): Promise\; +ArkTs1.1: destroyAppClone(bundleName: string, appIndex: number, destroyAppCloneParam?: DestroyAppCloneParam): Promise\
+ArkTs1.2: destroyAppClone(bundleName: string, appIndex: int, options?: int | DestroyAppCloneParam): Promise\ 删除应用分身,使用Promise异步回调。 @@ -1531,7 +1588,7 @@ destroyAppClone(bundleName: string, appIndex: number, destroyAppCloneParam?: Des | 参数名 | 类型 | 必填 | 说明 | | ------------ | ----------------------------- | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 待删除应用分身的包名。 | -| appIndex | number | 是 | 待删除应用分身的索引。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 是 | 待删除应用分身的索引。 | | destroyAppCloneParam | [DestroyAppCloneParam](#destroyappcloneparam15) | 否 | 指定删除应用分身所需的其他参数,默认值:参照[DestroyAppCloneParam](#destroyappcloneparam15)的默认值。 | **返回值:** @@ -1555,6 +1612,7 @@ destroyAppClone(bundleName: string, appIndex: number, destroyAppCloneParam?: Des | 17700062 | Failed to uninstall the app because the app is locked. | **示例:** +ArkTs1.1: ```ts import installer from '@ohos.bundle.installer'; import { BusinessError } from '@ohos.base'; @@ -1587,10 +1645,43 @@ try { console.error('getBundleInstaller failed. Cause: ' + message); } ``` +ArkTs1.2: +```ts +import installer from '@ohos.bundle.installer'; +import { BusinessError } from '@ohos.base'; + +let bundleName = 'com.ohos.camera'; +let index = 1; +let userId = 100; +let key = 'ohos.bms.param.verifyUninstallRule'; +let value = 'false'; +let item: installer.Parameters = {key, value}; +let destroyAppCloneOpt: installer.DestroyAppCloneParam = { + userId: userId, + parameters: [item] +}; +try { + installer.getBundleInstaller().then((data: installer.BundleInstaller) => { + data.destroyAppClone(bundleName, index, destroyAppCloneOpt).then(() => { + console.info('destroyAppClone success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('destroyAppClone failed ' + message); + }); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed ' + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed. Cause: ' + message); +} +``` ## BundleInstaller.installPreexistingApp12+ -installPreexistingApp(bundleName: string, userId?: number): Promise\; +ArkTs1.1: installPreexistingApp(bundleName: string, userId?: number): Promise\
+ArkTs1.2: installPreexistingApp(bundleName: string, userId?: int): Promise\ 安装应用,使用Promise异步回调。 @@ -1605,7 +1696,7 @@ installPreexistingApp(bundleName: string, userId?: number): Promise\; | 参数名 | 类型 | 必填 | 说明 | | ------------ | ----------------------------- | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 需要安装应用的包名。 | -| userId | number | 否 | 需要安装应用的用户id,userId需要大于0。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 需要安装应用的用户id,userId需要大于0。默认值:调用方所在用户。 | **返回值:** @@ -1628,6 +1719,7 @@ installPreexistingApp(bundleName: string, userId?: number): Promise\; | 17700058 | Failed to install the HAP because this application is prohibited from being installed on this device or by specified users. | **示例:** +ArkTs1.1: ```ts import installer from '@ohos.bundle.installer'; import { BusinessError } from '@ohos.base'; @@ -1651,6 +1743,30 @@ try { console.error('getBundleInstaller failed. Cause: ' + message); } ``` +ArkTs1.2: +```ts +import installer from '@ohos.bundle.installer'; +import { BusinessError } from '@ohos.base'; + +let bundleName = 'com.ohos.camera'; +let userId = 100; +try { + installer.getBundleInstaller().then((data: installer.BundleInstaller) => { + data.installPreexistingApp(bundleName, userId).then(() => { + console.info('installPreexistingApp success.'); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('installPreexistingApp failed ' + message); + }); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed ' + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getBundleInstaller failed. Cause: ' + message); +} +``` ## HashParam @@ -1675,11 +1791,11 @@ try { | 名称 | 类型 | 必填 | 说明 | | ------------------------------ | ------------------------------ | ------------------ | ------------------ | -| userId | number | 否 | 指示用户id,默认值:调用方所在用户,取值范围:大于等于0,可使用[queryOsAccountLocalIdFromProcess](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前进程所在用户。当安装、卸载或恢复一个驱动应用时,该参数会被忽略,会在所有用户下执行。 | -| installFlag | number | 否 | 指示安装标志,枚举值:0x00:应用初次安装,0x01:应用覆盖安装,0x10:应用免安装,默认值为应用初次安装。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 指示用户id,默认值:调用方所在用户,取值范围:大于等于0,可使用[queryOsAccountLocalIdFromProcess](../apis-basic-services-kit/js-apis-osAccount.md#getosaccountlocalid9)获取当前进程所在用户。当安装、卸载或恢复一个驱动应用时,该参数会被忽略,会在所有用户下执行。 | +| installFlag | ArkTs1.1: number
ArkTs1.2: int | 否 | 指示安装标志,枚举值:0x00:应用初次安装,0x01:应用覆盖安装,0x10:应用免安装,默认值为应用初次安装。 | | isKeepData | boolean | 否 | 卸载时是否保留数据目录,默认值为false。 | | hashParams | Array<[HashParam](#hashparam)> | 否 | 哈希值参数,默认值为空。 | -| crowdtestDeadline| number | 否 | 众测活动的截止日期,默认值为-1,表示无截止日期约束。 | +| crowdtestDeadline | ArkTs1.1: number
ArkTs1.2: long | 否 | 众测活动的截止日期,默认值为-1,表示无截止日期约束。 | | sharedBundleDirPaths10+ | Array\ | 否 |共享包文件所在路径,默认值为空。 | | specifiedDistributionType10+ | string | 否 |应用安装时指定的分发类型,默认值为空,最大长度为128字节。该字段通常由操作系统运营方的应用市场指定。 | | additionalInfo10+ | string | 否 |应用安装时的额外信息,默认值为空,最大长度为3000字节。该字段通常由操作系统运营方的应用市场在安装企业应用时指定,用于保存应用的额外信息。 | @@ -1697,7 +1813,7 @@ try { | 名称 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------------------------------ | | bundleName | string | 是 | 共享包包名。 | -| versionCode | number | 否 | 指示共享包的版本号。默认值:如果不填写versionCode,则卸载该包名的所有共享包。 | +| versionCode | ArkTs1.1: number
ArkTs1.2: int | 否 | 指示共享包的版本号。默认值:如果不填写versionCode,则卸载该包名的所有共享包。 | ## VerifyCodeParamdeprecated @@ -1750,8 +1866,8 @@ PGO(Profile-guided Optimization)配置文件参数信息。 | 名称 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------------------------------ | -| userId | number | 否 | 指定创建分身应用所在的用户id。默认值:调用方所在用户。 | -| appIndex | number | 否 | 指定创建分身应用的索引值。默认值:当前可用的最小索引值。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 指定创建分身应用所在的用户id。默认值:调用方所在用户。 | +| appIndex | ArkTs1.1: number
ArkTs1.2: int | 否 | 指定创建分身应用的索引值。默认值:当前可用的最小索引值。 | ## DestroyAppCloneParam15+ @@ -1763,5 +1879,5 @@ PGO(Profile-guided Optimization)配置文件参数信息。 | 名称 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------------------------------ | -| userId | number | 否 | 指定删除分身应用所在的用户id。默认值:调用方所在用户。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 否 | 指定删除分身应用所在的用户id。默认值:调用方所在用户。 | | parameters | Array<[Parameters](#parameters15)> | 否 | 指定删除分身应用扩展参数,默认值为空。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md index 4be67848640..a3718bfb04e 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md @@ -17,7 +17,8 @@ import launcherBundleManager from '@ohos.bundle.launcherBundleManager'; ## launcherBundleManager.getLauncherAbilityInfo9+ -getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallback\\>) : void +ArkTs1.1: getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallback\\>) : void
+ArkTs1.2: getLauncherAbilityInfo(bundleName: string, userId: int, callback: AsyncCallback\\>) : void 查询指定bundleName及用户的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 @@ -32,7 +33,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallba | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------- | | bundleName | string | 是 | 应用Bundle名称。 | -| userId | number | 是 | 被查询的用户id。| +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 被查询的用户id。| | callback | AsyncCallback\\> | 是 | callback形式返回bundle包含的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)信息。 | **错误码:** @@ -50,6 +51,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallba **示例:** +ArkTs1.1: ```ts import launcherBundleManager from '@ohos.bundle.launcherBundleManager'; import { BusinessError } from '@ohos.base'; @@ -69,10 +71,30 @@ try { console.error(`errData is errCode:${code} message:${message}`); } ``` +ArkTs1.2: +```ts +import launcherBundleManager from '@ohos.bundle.launcherBundleManager'; +import { BusinessError } from '@ohos.base'; + +try { + launcherBundleManager.getLauncherAbilityInfo('com.example.demo', 100, + (error: BusinessError | null, data: Array | undefined) => { + if (error) { + console.error('getLauncherAbilityInfo failed ' + error.message); + return; + } + console.info('getLauncherAbilityInfo success. data: ' + JSON.stringify(data)); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getLauncherAbilityInfo failed ' + message); +} +``` ## launcherBundleManager.getLauncherAbilityInfo9+ -getLauncherAbilityInfo(bundleName: string, userId: number) : Promise\\> +ArkTs1.1: getLauncherAbilityInfo(bundleName: string, userId: number) : Promise\\>
+ArkTs1.2: getLauncherAbilityInfo(bundleName: string, userId: int) : Promise\\> 查询指定bundleName及用户的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 @@ -87,7 +109,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number) : Promise\ArkTs1.2: int | 是 | 被查询的用户id。 | **返回值:** @@ -110,6 +132,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number) : Promise\) => { + console.info('getLauncherAbilityInfo success. data: ' + JSON.stringify(data)); + }).catch ((error: Error) => { + let message = (error as BusinessError).message; + console.error('getLauncherAbilityInfo failed ' + message); + }) +} catch (error) { + let message = (error as BusinessError).message; + console.error('getLauncherAbilityInfo failed ' + message); +} +``` ## launcherBundleManager.getAllLauncherAbilityInfo9+ -getAllLauncherAbilityInfo(userId: number, callback: AsyncCallback\\>) : void +ArkTs1.1: getAllLauncherAbilityInfo(userId: number, callback: AsyncCallback\\>) : void
+ArkTs1.2: getAllLauncherAbilityInfo(userId: int, callback: AsyncCallback\\>) : void 查询指定用户下所有应用的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 @@ -144,7 +185,7 @@ getAllLauncherAbilityInfo(userId: number, callback: AsyncCallback\ArkTs1.2: int | 是 | 被查询的用户id。 | | callback | AsyncCallback\\> | 是 | callback形式返回指定用户下所有应用的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 | **错误码:** @@ -161,6 +202,7 @@ getAllLauncherAbilityInfo(userId: number, callback: AsyncCallback\ | undefined) => { + if (error) { + console.error('getAllLauncherAbilityInfo failed ' + error.message); + return; + } + console.info('getAllLauncherAbilityInfo success. data: ' + JSON.stringify(data)); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getAllLauncherAbilityInfo failed ' + message); +} +``` ## launcherBundleManager.getAllLauncherAbilityInfo9+ -getAllLauncherAbilityInfo(userId: number) : Promise\\> +ArkTs1.1: getAllLauncherAbilityInfo(userId: number) : Promise\\>
+ArkTs1.2: getAllLauncherAbilityInfo(userId: int) : Promise\\> 查询指定用户下所有应用的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 @@ -196,7 +258,7 @@ getAllLauncherAbilityInfo(userId: number) : Promise\ArkTs1.2: int | 是 | 被查询的用户id。 | **返回值:** @@ -218,6 +280,7 @@ getAllLauncherAbilityInfo(userId: number) : Promise\) => { + console.info('getAllLauncherAbilityInfo success. data: ' + JSON.stringify(data)); + }).catch ((error: Error) => { + let message = (error as BusinessError).message; + console.error('getAllLauncherAbilityInfo failed ' + message); + }) +} catch (error) { + let message = (error as BusinessError).message; + console.error('getAllLauncherAbilityInfo failed ' + message); +} +``` ## launcherBundleManager.getShortcutInfo9+ @@ -399,7 +479,8 @@ try { ## launcherBundleManager.getShortcutInfoSync13+ -getShortcutInfoSync(bundleName: string, userId: number) : Array\<[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)\> +ArkTs1.1: getShortcutInfoSync(bundleName: string, userId: number) : Array\<[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)\>
+ArkTs1.2: getShortcutInfoSync(bundleName: string, userId: int) : Array\<[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)\> 查询指定用户下指定应用的[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)。 @@ -414,7 +495,7 @@ getShortcutInfoSync(bundleName: string, userId: number) : Array\<[ShortcutInfo]( | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------- | | bundleName | string | 是 | 应用Bundle名称。 | -| userId | number | 是 | 表示用户ID。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 表示用户ID。 | **返回值:** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager.md index 915392d8a79..c26506ddce4 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-launcherBundleManager.md @@ -14,7 +14,8 @@ import { launcherBundleManager } from '@kit.AbilityKit'; ## launcherBundleManager.getLauncherAbilityInfoSync18+ -getLauncherAbilityInfoSync(bundleName: string, userId: number) : Array\<[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)\> +ArkTs1.1: getLauncherAbilityInfoSync(bundleName: string, userId: number) : Array\<[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)\>
+ArkTs1.2: getLauncherAbilityInfoSync(bundleName: string, userId: int) : Array\<[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)\> 查询指定bundleName及用户的[LauncherAbilityInfo](js-apis-bundleManager-launcherAbilityInfo.md)。 @@ -27,7 +28,7 @@ getLauncherAbilityInfoSync(bundleName: string, userId: number) : Array\<[Launche | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------- | | bundleName | string | 是 | 应用Bundle名称。 | -| userId | number | 是 | 被查询的用户id。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 被查询的用户id。 | **返回值:** diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-shortcutManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-shortcutManager-sys.md index 42751720062..98929479dd7 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-shortcutManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-shortcutManager-sys.md @@ -17,7 +17,8 @@ import { shortcutManager } from '@kit.AbilityKit'; ## shortcutManager.addDesktopShortcutInfo12+ -addDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: number) : Promise\ +ArkTs1.1: addDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: number) : Promise\
+ArkTs1.2: addDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: int) : Promise\ 增加指定用户的[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)。 @@ -32,7 +33,7 @@ addDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortc | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------- | | shortcutInfo | [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md) | 是 | 快捷方式信息。 | -| userId | number | 是 | 用户id。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 用户id。 | **错误码:** @@ -51,6 +52,7 @@ addDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortc **示例:** +ArkTs1.1: ```ts import { shortcutManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -93,10 +95,41 @@ struct ShortcutExample { } } ``` +ArkTs1.2: +```ts +import shortcutManager from '@ohos.bundle.shortcutManager'; +import { BusinessError } from '@ohos.base'; + +let data: shortcutManager.ShortcutInfo = { + id: "test1", + bundleName: "com.example.myapplication", + moduleName: "hello", + hostAbility: "hello", + icon: "hello", + iconId: 1, + label: "hello", + labelId: 1, + wants: [], + appIndex: 0, + sourceType: 0, +} +try { + shortcutManager.addDesktopShortcutInfo(data, 100).then(() => { + console.log("addDesktopShortcutInfo success"); + }).catch ((error: Error) => { + let message = (error as BusinessError).message; + console.error('addDesktopShortcutInfo failed ' + message); + }) +} catch (error) { + let message = (error as BusinessError).message; + console.error('addDesktopShortcutInfo failed ' + message); +} +``` ## shortcutManager.deleteDesktopShortcutInfo12+ -deleteDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: number) : Promise\ +ArkTs1.1: deleteDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: number) : Promise\
+ArkTs1.2: deleteDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md), userId: int) : Promise\ 删除指定用户的[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)。 @@ -111,7 +144,7 @@ deleteDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-sho | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | -------------- | | shortcutInfo | [ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md) | 是 | 快捷方式信息。 | -| userId | number | 是 | 用户id。 | +| userId | ArkTs1.1: number
ArkTs1.2: int | 是 | 用户id。 | **错误码:** @@ -126,6 +159,7 @@ deleteDesktopShortcutInfo(shortcutInfo: [ShortcutInfo](js-apis-bundleManager-sho **示例:** +ArkTs1.1: ```ts import { shortcutManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; @@ -168,10 +202,41 @@ struct ShortcutExample { } } ``` +ArkTs1.2: +```ts +import shortcutManager from '@ohos.bundle.shortcutManager'; +import { BusinessError } from '@ohos.base'; + +let data: shortcutManager.ShortcutInfo = { + id: "test1", + bundleName: "com.example.myapplication", + moduleName: "", + hostAbility: "", + icon: "", + iconId: 1, + label: "hello", + labelId: 1, + wants: [], + appIndex: 0, + sourceType: 0, +} +try { + shortcutManager.deleteDesktopShortcutInfo(data, 100).then(() => { + console.log("deleteDesktopShortcutInfo success"); + }).catch ((error: Error) => { + let message = (error as BusinessError).message; + console.error('deleteDesktopShortcutInfo failed ' + message); + }) +} catch (error) { + let message = (error as BusinessError).message; + console.error('deleteDesktopShortcutInfo failed ' + message); +} +``` ## shortcutManager.getAllDesktopShortcutInfo12+ -getAllDesktopShortcutInfo(userId: number) : Promise> +ArkTs1.1: getAllDesktopShortcutInfo(userId: number) : Promise>
+ArkTs1.2: getAllDesktopShortcutInfo(userId: int) : Promise> 查询指定用户的所有[ShortcutInfo](js-apis-bundleManager-shortcutInfo-sys.md)。 @@ -185,7 +250,7 @@ getAllDesktopShortcutInfo(userId: number) : PromiseArkTs1.2: int | 是 | 被查询的用户id。 | **返回值:** @@ -206,6 +271,7 @@ getAllDesktopShortcutInfo(userId: number) : Promise) => { + console.log("getAllDesktopShortcutInfo success. data: " + JSON.stringify(data)); + }).catch ((error: Error) => { + let message = (error as BusinessError).message; + console.error('getAllDesktopShortcutInfo failed ' + message); + }) +} catch (error) { + let message = (error as BusinessError).message; + console.error('getAllDesktopShortcutInfo failed ' + message); +} +``` diff --git a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-zlib.md b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-zlib.md index 884457d0f70..c440021b775 100644 --- a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-zlib.md +++ b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-zlib.md @@ -411,7 +411,8 @@ try { ## zlib.getOriginalSize12+ -getOriginalSize(compressedFile: string): Promise\ +ArkTs1.1: getOriginalSize(compressedFile: string): Promise\
+ArkTs1.2: getOriginalSize(compressedFile: string): Promise\ 获取压缩文件的原始大小,使用Promise异步返回。成功时返回压缩文件的原始大小,失败时返回错误码。 @@ -429,7 +430,7 @@ getOriginalSize(compressedFile: string): Promise\ | 类型 | 说明 | | -------------- | ----------------------- | -| Promise\ | Promise对象,返回压缩文件的原始大小,单位字节。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象,返回压缩文件的原始大小,单位字节。 | **错误码:** @@ -443,6 +444,7 @@ getOriginalSize(compressedFile: string): Promise\ **示例:** +ArkTs1.1: ```ts // 代码中使用的路径需为应用的沙箱路径,如/data/storage/el2/base/temp,也可以通过context获取。 import { zlib, BusinessError } from '@kit.BasicServicesKit'; @@ -461,6 +463,26 @@ try { console.error(`errData is errCode:${code} message:${message}`); } ``` +ArkTs1.2: +```ts +// 代码中使用的路径需为应用的沙箱路径,如/data/storage/el2/base/temp,也可以通过context获取。 +import zlib from '@ohos.zlib'; +import { BusinessError } from '@ohos.base'; + +let compressedFile = '/data/storage/el2/base/temp/test.zip'; + +try { + zlib.getOriginalSize(compressedFile).then((data: long) => { + console.info('getOriginalSize success. getOriginalSize: ' + JSON.stringify(data)); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getOriginalSize failed ' + message); + }); +} catch (error) { + let message = (error as BusinessError).message; + console.error('getOriginalSize failed ' + message); +} +``` ## zlib.compressFiles12+ @@ -580,7 +602,8 @@ let checksum = zlib.createChecksumSync() ### adler3212+ -adler32(adler: number, buf: ArrayBuffer): Promise<number> +ArkTs1.1: adler32(adler: number, buf: ArrayBuffer): Promise<number>
+ArkTs1.2: adler32(adler: long, buf: ArrayBuffer): Promise\ 计算Adler-32校验和,使用Promise异步返回。成功时返回计算后的Adler-32校验和,失败时返回错误码。 @@ -592,14 +615,14 @@ adler32(adler: number, buf: ArrayBuffer): Promise<number> | 参数名 | 类型 | 必填 | 说明 | | ------ | ----------- | ---- | ------------------------ | -| adler | number | 是 | Adler-32校验和的初始值。 | +| adler | ArkTs1.1: number
ArkTs1.2: long | 是 | Adler-32校验和的初始值。 | | buf | ArrayBuffer | 是 | 计算校验和数据缓冲区。 | **返回值:** | 类型 | 说明 | | --------------------- | ----------------------------------------- | -| Promise<number> | Promise对象。返回计算后的Adler-32校验和。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象。返回计算后的Adler-32校验和。 | **错误码:** @@ -631,7 +654,8 @@ checksum.adler32(0, arrayBufferIn).then(data => { ### adler32Combine12+ -adler32Combine(adler1: number, adler2: number, len2: number): Promise<number> +ArkTs1.1: adler32Combine(adler1: number, adler2: number, len2: number): Promise<number>
+ArkTs1.2: adler32Combine(adler1: long, adler2: long, len2: long): Promise\ 将两个Adler-32校验和合并,使用Promise异步返回。成功时返回合并后的Adler-32校验和,失败时返回错误码。 @@ -643,15 +667,15 @@ adler32Combine(adler1: number, adler2: number, len2: number): Promise<number& | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------ | -| adler1 | number | 是 | 第一个要合并的Adler-32校验和。 | -| adler2 | number | 是 | 第二个要合并的Adler-32校验和。 | -| len2 | number | 是 | 第二个Adler-32校验和的数据块的长度。 | +| adler1 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第一个要合并的Adler-32校验和。 | +| adler2 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第二个要合并的Adler-32校验和。 | +| len2 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第二个Adler-32校验和的数据块的长度。 | **返回值:** | 类型 | 说明 | | --------------------- | ----------------------------------------- | -| Promise<number> | Promise对象。返回合并后的Adler-32校验和。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象。返回合并后的Adler-32校验和。 | **错误码:** @@ -663,6 +687,7 @@ adler32Combine(adler1: number, adler2: number, len2: number): Promise<number& **示例:** +ArkTs1.1: ```ts import { zlib, BusinessError } from '@kit.BasicServicesKit'; @@ -691,10 +716,42 @@ async function demo() { }) } ``` +ArkTs1.2: +```ts +import zlib from '@ohos.zlib'; +import { BusinessError } from '@ohos.base'; + +async function demo() { + let str = 'hello world!'; + let arrayBufferIn = new ArrayBuffer(12); + let data = new Uint8Array(arrayBufferIn); + for (let i = 0, j = str.length; i < j; i++) { + data[i] = str.charCodeAt(i); + } + let checksum = zlib.createChecksumSync() + let adler1 = 0; + let adler2 = 1; + await checksum.adler32(0, arrayBufferIn).then(data => { + console.info('adler32 success', data); + adler1 = data; + }) + await checksum.adler32(1, arrayBufferIn).then(data => { + console.info('adler32 success', data); + adler2 = data; + }) + await checksum.adler32Combine(adler1, adler2, 12).then((data) => { + console.info('adler32Combine success', data); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('adler32Combine failed ' + message); + }) +} +``` ### crc3212+ -crc32(crc: number, buf: ArrayBuffer): Promise<number> +ArkTs1.1: crc32(crc: number, buf: ArrayBuffer): Promise<number>
+ArkTs1.2: crc32(crc: long, buf: ArrayBuffer): Promise\ 更新CRC-32校验,使用Promise异步返回。成功时返回更新后的CRC-32校验,失败时返回错误码。 @@ -706,14 +763,14 @@ crc32(crc: number, buf: ArrayBuffer): Promise<number> | 参数名 | 类型 | 必填 | 说明 | | ------ | ----------- | ---- | -------------------- | -| crc | number | 是 | CRC-32校验的初始值。 | +| crc | ArkTs1.1: number
ArkTs1.2: long | 是 | CRC-32校验的初始值。 | | buf | ArrayBuffer | 是 | 计算校验数据缓冲区。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------------------- | -| Promise<number> | Promise对象。返回更新后的CRC-32校验。 | +| ArkTs1.1: Promise\
ArkTs1.2: Promise\ | Promise对象。返回更新后的CRC-32校验。 | **错误码:** @@ -725,6 +782,7 @@ crc32(crc: number, buf: ArrayBuffer): Promise<number> **示例:** +ArkTs1.1: ```ts import { zlib, BusinessError } from '@kit.BasicServicesKit'; @@ -744,10 +802,33 @@ checksum.crc32(0, arrayBufferIn).then((data) => { console.error(`errData is errCode:${errData.code} message:${errData.message}`); }) ``` +ArkTs1.2: +```ts +import zlib from '@ohos.zlib'; +import { BusinessError } from '@ohos.base'; + +let str = 'hello world!'; +let arrayBufferIn = new ArrayBuffer(12); +let data = new Uint8Array(arrayBufferIn); + +for (let i = 0, j = str.length; i < j; i++) { + data[i] = str.charCodeAt(i); +} + +let checksum = zlib.createChecksumSync() + +checksum.crc32(0, arrayBufferIn).then((data) => { + console.info('crc32 success', data); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('crc32 failed ' + message); +}) +``` ### crc32Combine12+ -crc32Combine(crc1: number, crc2: number, len2: number): Promise<number> +ArkTs1.1: crc32Combine(crc1: number, crc2: number, len2: number): Promise<number>
+ArkTs1.2: crc32Combine(crc1: long, crc2: long, len2: long): Promise\ 将两个CRC-32校验合并,使用Promise异步返回。成功时返回合并后的CRC-32校验,失败时返回错误码。 @@ -759,9 +840,9 @@ crc32Combine(crc1: number, crc2: number, len2: number): Promise<number> | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | -------------------------------- | -| crc1 | number | 是 | 第一个要合并的CRC-32校验。 | -| crc2 | number | 是 | 第二个要合并的CRC-32校验。 | -| len2 | number | 是 | 第二个CRC-32校验的数据块的长度。 | +| crc1 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第一个要合并的CRC-32校验。 | +| crc2 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第二个要合并的CRC-32校验。 | +| len2 | ArkTs1.1: number
ArkTs1.2: long | 是 | 第二个CRC-32校验的数据块的长度。 | **返回值:** @@ -779,6 +860,7 @@ crc32Combine(crc1: number, crc2: number, len2: number): Promise<number> **示例:** +ArkTs1.1: ```ts import { zlib, BusinessError } from '@kit.BasicServicesKit'; @@ -807,6 +889,37 @@ async function demo() { }) } ``` +ArkTs1.2: +```ts +import zlib from '@ohos.zlib'; +import { BusinessError } from '@ohos.base'; + +async function demo() { + let str = 'hello world!'; + let arrayBufferIn = new ArrayBuffer(12); + let data = new Uint8Array(arrayBufferIn); + for (let i = 0, j = str.length; i < j; i++) { + data[i] = str.charCodeAt(i); + } + let checksum = zlib.createChecksumSync() + let crc1 = 0; + let crc2 = 1; + await checksum.crc32(0, arrayBufferIn).then(data => { + console.info('crc32 success', data); + crc1 = data; + }) + await checksum.crc32(1, arrayBufferIn).then(data => { + console.info('crc32 success', data); + crc2 = data; + }) + await checksum.crc32Combine(crc1, crc2, 12).then((data) => { + console.info('crc32Combine success', data); + }).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('crc32Combine failed ' + message); + }) +} +``` ### crc6412+ @@ -863,7 +976,8 @@ checksum.crc64(0, arrayBufferIn).then((data) => { ### getCrcTable12+ -getCrcTable(): Promise<Array<number>> +ArkTs1.1: getCrcTable(): Promise<Array<number>>
+ArkTs1.2: getCrcTable(): Promise> 输出CRC-32校验表,使用Promise异步返回。成功时返回CRC-32校验表。 @@ -875,10 +989,11 @@ getCrcTable(): Promise<Array<number>> | 类型 | 说明 | | ---------------------------------- | ------------------------------- | -| Promise<Array<number>> | Promise对象。返回CRC-32校验表。 | +| ArkTs1.1: Promise
ArkTs1.2: Promise> | Promise对象。返回CRC-32校验表。 | **示例:** +ArkTs1.1: ```ts import { zlib, BusinessError } from '@kit.BasicServicesKit'; @@ -890,6 +1005,20 @@ checksum.getCrcTable().then((data) => { console.error(`errData is errCode:${errData.code} message:${errData.message}`); }) ``` +ArkTs1.2: +```ts +import zlib from '@ohos.zlib'; +import { BusinessError } from '@ohos.base'; + +let checksum = zlib.createChecksumSync() + +checksum.getCrcTable().then((data) => { + console.info('getCrcTable success'); +}).catch((error: Error) => { + let message = (error as BusinessError).message; + console.error('getCrcTable failed ' + message); +}) +``` ### getCrc64Table12+ -- Gitee