diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md index f9e360f9cfabb0753382ca2d1245e013ff24968f..c21b064d4de03bb7d81e31547ca3a05e3680028b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -10,6 +10,7 @@ ```ts import bundleManager from '@ohos.bundle.bundleManager' ``` + ## 权限列表 | 权限 | 权限等级 | 描述 | @@ -27,7 +28,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 包信息标志，指示需要获取的包信息的内容。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | | ----------------------------------------- | ---------- | ------------------------------------------------------------ | @@ -45,7 +46,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 应用信息标志，指示需要获取的应用信息的内容。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 **系统接口：** 系统接口，不支持三方应用调用。 @@ -58,9 +59,9 @@ import bundleManager from '@ohos.bundle.bundleManager' ### AbilityFlag -功能组件信息标志，指示需要获取的功能组件信息的内容。 +Ability组件信息标志，指示需要获取的Ability组件信息的内容。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 **系统接口：** 系统接口，不支持三方应用调用。 @@ -77,7 +78,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 扩展组件信息标志，指示需要获取的扩展组件信息的内容。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 **系统接口：** 系统接口，不支持三方应用调用。 @@ -92,7 +93,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 指示扩展组件的类型。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | |:----------------:|:---:|-----| @@ -115,9 +116,9 @@ import bundleManager from '@ohos.bundle.bundleManager' ### PermissionGrantState -指示权限授予信息。 +指示权限授予状态。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | |:----------------:|:---:|:---:| @@ -128,7 +129,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 标识该组件所支持的窗口模式。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | |:----------------:|:---:|:---:| @@ -140,21 +141,21 @@ import bundleManager from '@ohos.bundle.bundleManager' 指示组件的启动方式。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | |:----------------:|:---:|:---:| -| SINGLETON | 0 | ability的启动模式,表示单实例。 | -| STANDARD | 1 | ability的启动模式,表示普通多实例。 | -| SPECIFIED | 2 | ability的启动模式,表示该ability内部根据业务自己置顶多实例。 | +| SINGLETON | 0 | ability的启动模式，表示单实例。 | +| STANDARD | 1 | ability的启动模式，表示普通多实例。 | +| SPECIFIED | 2 | ability的启动模式，表示该ability内部根据业务自己置顶多实例。 | ### AbilityType 指示Ability组件的类型。 - **模型约束:** 仅可在FA模型下使用 + **模型约束：** 仅可在FA模型下使用 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 | 值 | 说明 | | :-----: | ---- | :--------------------------------------------------------: | @@ -166,7 +167,7 @@ import bundleManager from '@ohos.bundle.bundleManager' 标识该Ability的显示模式。该标签仅适用于page类型的Ability。 - **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 + **系统能力：** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。 | 名称 |值 |说明 | |:----------------------------------|---|---| @@ -184,7 +185,7 @@ import bundleManager from '@ohos.bundle.bundleManager' | AUTO_ROTATION_PORTRAIT_RESTRICTED |11|表示受开关控制的自动竖向旋转模式。| | LOCKED |12|表示锁定模式。| -## 方法 +## 接口 ### bundleManager.getBundleInfoForSelf @@ -614,7 +615,7 @@ try { getAllBundleInfo(bundleFlags: [number](#bundleflag), userId: number, callback: AsyncCallback>): void; -以异步方法根据给定的bundleFlags和userId获取多个BundleInfo，使用callback形式返回结果。 +以异步方法根据给定的bundleFlags和userId获取系统中所有的BundleInfo，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -662,7 +663,7 @@ try { getAllBundleInfo(bundleFlags: [number](#bundleflag), callback: AsyncCallback>): void; -以异步方法根据给定的bundleFlags获取多个BundleInfo，使用callback形式返回结果。 +以异步方法根据给定的bundleFlags获取系统中所有的BundleInfo，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -708,7 +709,7 @@ try { getAllBundleInfo(bundleFlags: [number](#bundleflag), userId?: number): Promise>; -以异步方法根据给定的bundleFlags和userId获取多个BundleInfo，使用Promise形式返回结果。 +以异步方法根据给定的bundleFlags和userId获取系统中所有的BundleInfo，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -758,7 +759,7 @@ try { getAllApplicationInfo(appFlags: [number](#applicationflag), userId: number, callback: AsyncCallback>): void; -以异步方法根据给定的appFlags和userId获取多个ApplicationInfo，使用callback形式返回结果。 +以异步方法根据给定的appFlags和userId获取系统中所有的ApplicationInfo，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -806,7 +807,7 @@ try { getAllApplicationInfo(appFlags: [number](#applicationflag), callback: AsyncCallback>): void; -以异步方法根据给定的appFlags获取多个ApplicationInfo，使用callback形式返回结果。 +以异步方法根据给定的appFlags获取系统中所有的ApplicationInfo，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -852,7 +853,7 @@ try { getAllApplicationInfo(appFlags: [number](#applicationflag), userId?: number): Promise>; -以异步方法根据给定的appFlags和userId获取多个ApplicationInfo，使用Promise形式返回结果。 +以异步方法根据给定的appFlags和userId获取系统中所有的ApplicationInfo，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1290,7 +1291,7 @@ try { getBundleNameByUid(uid: number, callback: AsyncCallback\): void; -以异步方法根据给定的uid获取bundleName，使用callback形式返回结果。 +以异步方法根据给定的uid获取对应的bundleName，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1335,7 +1336,7 @@ try { getBundleNameByUid(uid: number): Promise\; -以异步方法根据给定的uid获取bundleName，使用Promise形式返回结果。 +以异步方法根据给定的uid获取对应的bundleName，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1482,7 +1483,7 @@ try { cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback\): void; -以异步方法根据给定的bundleName清理BundleCache，并获取清理结果，使用callback形式返回结果。 +以异步方法根据给定的bundleName清理BundleCache，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1529,7 +1530,7 @@ try { cleanBundleCacheFiles(bundleName: string): Promise\; -以异步方法根据给定的bundleName清理BundleCache，并获取清理结果，使用Promise形式返回结果。 +以异步方法根据给定的bundleName清理BundleCache，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1547,7 +1548,7 @@ cleanBundleCacheFiles(bundleName: string): Promise\; | 类型 | 说明 | | -------------- | ------------------------------------------------------------ | -| Promise\ | Promise对象，返回true表示清理应用缓存目录数据成功，返回false表示清理应用缓存目录数据失败。 | +| Promise\ | 无返回结果的Promise对象。当清理应用缓存目录数据失败会抛出错误对象。 | **错误码：** @@ -1565,9 +1566,9 @@ import bundleManager from '@ohos.bundle.bundleManager' let bundleName = "com.ohos.myapplication"; try { - bundleManager.cleanBundleCacheFiles(bundleName).then(()=> { + bundleManager.cleanBundleCacheFiles(bundleName).then(() => { console.info('cleanBundleCacheFiles successfully.'); - }).catch(err=> { + }).catch(err => { console.error('cleanBundleCacheFiles failed:' + err.message); }); } catch (err) { @@ -1579,7 +1580,7 @@ try { setApplicationEnabled(bundleName: string, isEnabled: boolean, callback: AsyncCallback\): void; -设置指定应用的禁用使能状态，使用callback形式返回结果。 +设置指定应用的禁用或使能状态，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1593,7 +1594,7 @@ setApplicationEnabled(bundleName: string, isEnabled: boolean, callback: AsyncCal | ---------- | ------- | ---- | ------------------------------------- | | bundleName | string | 是 | 指定应用的bundleName。 | | isEnabled | boolean | 是 | 值为true表示使能，值为false表示禁用。 | -| callback | AsyncCallback\ | 是 | 回调函数，当设置应用禁用使能状态成功时，err为null，否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数，当设置应用禁用或使能状态成功时，err为null，否则为错误对象。 | **错误码：** @@ -1626,7 +1627,7 @@ try { setApplicationEnabled(bundleName: string, isEnabled: boolean): Promise\; -设置指定应用的禁用使能状态，使用Promise形式返回结果。 +设置指定应用的禁用或使能状态，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1662,9 +1663,9 @@ import bundleManager from '@ohos.bundle.bundleManager' let bundleName = "com.ohos.myapplication"; try { - bundleManager.setApplicationEnabled(bundleName, false).then(()=> { + bundleManager.setApplicationEnabled(bundleName, false).then(() => { console.info('setApplicationEnabled successfully.'); - }).catch(err=> { + }).catch(err => { console.error('setApplicationEnabled failed:' + err.message); }); } catch (err) { @@ -1676,7 +1677,7 @@ try { setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isEnabled: boolean, callback: AsyncCallback\): void; -设置指定组件的禁用使能状态，使用callback形式返回结果。 +设置指定组件的禁用或使能状态，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1690,7 +1691,7 @@ setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isE | -------- | ----------- | ---- | ------------------------------------- | | info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 需要被设置的组件。 | | isEnabled| boolean | 是 | 值为true表示使能，值为false表示禁用。 | -| callback | AsyncCallback\ | 是 | 回调函数，当设置组件禁用使能状态成功时，err为null，否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数，当设置组件禁用或使能状态成功时，err为null，否则为错误对象。 | **错误码：** @@ -1737,7 +1738,7 @@ try { setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isEnabled: boolean): Promise\; -设置指定组件的禁用使能状态，使用Promise形式返回结果。 +设置指定组件的禁用或使能状态，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1784,9 +1785,9 @@ try { console.info('queryAbilityInfo successfully. Data: ' + JSON.stringify(abilitiesInfo)); info = abilitiesInfo[0]; - bundleManager.setAbilityEnabled(info, false).then(()=> { + bundleManager.setAbilityEnabled(info, false).then(() => { console.info('setAbilityEnabled successfully.'); - }).catch(err=> { + }).catch(err => { console.error('setAbilityEnabled failed:' + err.message); }); }).catch(error => { @@ -1801,7 +1802,7 @@ try { isApplicationEnabled(bundleName: string, callback: AsyncCallback\): void; -以异步的方法获取指定应用的禁用使能状态，使用callback形式返回结果。 +以异步的方法获取指定应用的禁用或使能状态，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1845,7 +1846,7 @@ try { isApplicationEnabled(bundleName: string): Promise\; -以异步的方法获取指定应用的禁用使能状态，使用Promise形式返回结果。 +以异步的方法获取指定应用的禁用或使能状态，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1892,7 +1893,7 @@ try { isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), callback: AsyncCallback\): void; -以异步的方法获取指定组件的禁用使能状态，使用callback形式返回结果。 +以异步的方法获取指定组件的禁用或使能状态，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -1950,7 +1951,7 @@ try { isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md)): Promise\; -以异步的方法获取指定组件的禁用使能状态，使用Promise形式返回结果。 +以异步的方法获取指定组件的禁用或使能状态，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2011,7 +2012,7 @@ try { getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallback\): void; -以异步方法根据给定的bundleName和userId获取用于启动应用程序主要功能，使用callback形式返回结果。 +以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2061,7 +2062,7 @@ try { getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\): void; -以异步方法根据给定的bundleName获取用于启动应用程序主要功能，使用callback形式返回结果。 +以异步方法根据给定的bundleName获取用于启动应用程序的Want参数，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2109,7 +2110,7 @@ try { getLaunchWantForBundle(bundleName: string, userId?: number): Promise\; -以异步方法根据给定的bundleName和userId获取用于启动应用程序主要功能，使用Promise形式返回结果。 +以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2391,7 +2392,7 @@ try { getPermissionDef(permissionName: string, callback: AsyncCallback\<[PermissionDef](js-apis-bundleManager-permissionDef.md)>): void; -以异步方法根据给定的permissionName获取PermissionDef，使用callback形式返回结果。 +以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息，使用callback形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2436,7 +2437,7 @@ try { getPermissionDef(permissionName: string): Promise\<[PermissionDef](js-apis-bundleManager-permissionDef.md)>; -以异步方法根据给定的permissionName获取PermissionDef，使用Promise形式返回结果。 +以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息，使用Promise形式返回结果。 **系统接口：** 此接口为系统接口。 @@ -2706,13 +2707,13 @@ try { getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: number) : [ApplicationInfo](js-apis-bundleManager-applicationInfo.md); -以同步方法根据给定的bundleName、applicationFlags和userId获取ApplicationInfo +以同步方法根据给定的bundleName、applicationFlags和userId获取ApplicationInfo。 **系统接口：** 此接口为系统接口。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO -**系统能力：** SystemCapability.BundleManager.BundleFramework.Core +**系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 **参数：** @@ -2758,7 +2759,7 @@ try { getApplicationInfoSync(bundleName: string, applicationFlags: number) : [ApplicationInfo](js-apis-bundleManager-applicationInfo.md); -以同步方法根据给定的bundleName和applicationFlags获取ApplicationInfo +以同步方法根据给定的bundleName和applicationFlags获取ApplicationInfo。 **系统接口：** 此接口为系统接口。