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 f84f6d8d4b15915137ab461b0d52375a1a1c9987..b8096dac7cdbf928cf24c873697236f5db2190e1 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 52b4c68f09783d16a6a50d4012323851d438e60b..e2f871ad70f3f56277e039d1842bea8e5b50bfc3 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 ac65681362e4048c95dcaf18787ec2fc5aeecab7..94266318ad99c50e05c6a0fe2d1baa313591a33e 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 b5752134f3d6ccbf68e850a1ea8e308a3d54c598..0fa9351e7e29a65639326e88a7353661ed4e3868 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 3490b9873c8ea6e20d2597ce7bf571a3ba214901..0cedd7a755f60c7a97cfc7807a482322137f2266 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 0024464792d0faa4bfc0b41ae02fd867148ba3c6..6edc26e09f73a3e5f11d971c7b3a6d7721a09da8 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 14ee27c8c47b7486062efdfcb97d83b2e770208a..7c6f42e28ba5bd4de156a7e5d5bfb4b4d1d7cd6b 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 918397f75eca178fed0f0069bf85e1a4eed58473..9b8c1e615b16d6b7140b67067592ea28061a0668 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 8438667c9d53fea034188eac7d1eb916b659f420..abfc6324e73ec4fd350f2483d8cb72e86242b62f 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 d2bc19d8414cc439d4be6361982d1b81c336f19d..419a342e8be31e6883c98b67a4f52f0e897e4f5c 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 7913824d6a72001d59ce71a43406c4720215755b..0e5b5ef59a1db0ca549c1a66082b0a8cc4803d97 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 d1b9f447d3e3ee4f5209bf400a5a259b91f8f6a9..e68d5a23081ee0f3e6b9cf7e04b15cefcf52b3fa 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 4c905c9a2cdaa05bd44ceff127c604dfbec88dc0..68561d8fc04532ec85a57d1cf2f25232cea81405 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 113271047fbf868f2c2187fd9f2f4e37e3c2a4dc..4d773835384dc14f8232bf5f0bdc88ecc7603151 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 a0a8eb21e4325923f4dac14779ade8012fa72230..504689900a5f7c648ba78b47b9fdcd5376a46a73 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 99cd10fcf7a4044c49a7bc38d5dd5a65b3f99dd4..e3cf3c6502ca08893594b7e08f9d417c586ed62e 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 cc3705ce0eba89efa108c19bcbdefa7a8856fc2e..c7ad3abe1a6afa87bb6b7c8a4cd1bf74be5b7d74 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 92c6f6fb4751fcfec7b8a7ef2dd2b08ea0dae0d3..56931b062edeccd91edc4300b406527d0591d0fe 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 f60975130d3f231de72d34f1adc2c13e9bba3e62..27a3321561b831946729c0e8a049732867f203e1 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 631ad9df5212eb4ff0758ab9e28a7c5ce45b5f9a..8ca8dd4461f198a8e272bd4a3b766d1121484ab6 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 63fe026abd42dc17598caecd607bfe2ef23d4215..efebc90c4be9f2856f765d710969eb6268acb711 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 f5f9a78ac13c43357387c1635bff21c10d9b4db8..c411ee08099a64ac83ae3f8c3516dd719fdaf793 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 fe9dc40a6c3e45db13f822835c088c8643ab033a..b157bfc429bfb4d3c9d7856c44eab201c80516e0 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