Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
64241d6c
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
64241d6c
编写于
11月 26, 2022
作者:
O
openharmony_ci
提交者:
Gitee
11月 26, 2022
浏览文件
操作
浏览文件
下载
差异文件
!11804 包管理API整改资料修改
Merge pull request !11804 from 赵淦/master
上级
c33d96d4
86996ca1
变更
8
隐藏空白更改
内联
并排
Showing
8 changed file
with
649 addition
and
603 deletion
+649
-603
zh-cn/application-dev/reference/apis/js-apis-bundleManager.md
...n/application-dev/reference/apis/js-apis-bundleManager.md
+361
-334
zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md
...n/application-dev/reference/apis/js-apis-bundleMonitor.md
+14
-20
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
...plication-dev/reference/apis/js-apis-defaultAppManager.md
+40
-3
zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md
...plication-dev/reference/apis/js-apis-distributedBundle.md
+46
-70
zh-cn/application-dev/reference/apis/js-apis-freeInstall.md
zh-cn/application-dev/reference/apis/js-apis-freeInstall.md
+32
-60
zh-cn/application-dev/reference/apis/js-apis-installer.md
zh-cn/application-dev/reference/apis/js-apis-installer.md
+34
-34
zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md
...ation-dev/reference/apis/js-apis-launcherBundleManager.md
+69
-32
zh-cn/application-dev/reference/apis/js-apis-zlib.md
zh-cn/application-dev/reference/apis/js-apis-zlib.md
+53
-50
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-bundleManager.md
浏览文件 @
64241d6c
...
...
@@ -14,10 +14,10 @@ import bundleManager from '@ohos.bundle.bundleManager'
| 权限 | 权限等级 | 描述 |
| ------------------------------------------ | ------------ | ------------------|
| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息 |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
| ohos.permission.REMOVE_CACHE_FILES | system_basic | 清理应用缓存 |
|ohos.permission.CHANGE_ABILITY_ENABLED_STATE| system_basic | 设置禁用使能所需的权限 |
| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息
。
|
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息
。
|
| ohos.permission.REMOVE_CACHE_FILES | system_basic | 清理应用缓存
。
|
|ohos.permission.CHANGE_ABILITY_ENABLED_STATE| system_basic | 设置禁用使能所需的权限
。
|
权限等级参考
[
权限等级说明
](
../../security/accesstoken-overview.md#权限等级说明
)
。
...
...
@@ -25,63 +25,73 @@ import bundleManager from '@ohos.bundle.bundleManager'
### BundleFlag
包信息标志,指示需要获取的包信息的内容。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 | 值 | 说明 |
| ----------------------------------------- | ---------- | ------------------------------------------------------------ |
| GET_BUNDLE_INFO_DEFAULT | 0x00000000 | 用于获取默认bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息 |
| GET_BUNDLE_INFO_WITH_APPLICATION | 0x00000001 | 用于获取包含applicationInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息 |
| GET_BUNDLE_INFO_WITH_HAP_MODULE | 0x00000002 | 用于获取包含hapModuleInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息 |
| GET_BUNDLE_INFO_WITH_ABILITY | 0x00000004 | 用于获取包含ability的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用 |
| GET_BUNDLE_INFO_DEFAULT | 0x00000000 | 用于获取默认bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息
。
|
| GET_BUNDLE_INFO_WITH_APPLICATION | 0x00000001 | 用于获取包含applicationInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息
。
|
| GET_BUNDLE_INFO_WITH_HAP_MODULE | 0x00000002 | 用于获取包含hapModuleInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息
。
|
| GET_BUNDLE_INFO_WITH_ABILITY | 0x00000004 | 用于获取包含ability的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用
。
|
| GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY | 0x00000008 | 用于获取包含extensionAbility的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability 和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 |
| GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION | 0x00000010 | 用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息 |
| GET_BUNDLE_INFO_WITH_METADATA | 0x00000020 | 用于获取applicationInfo、moduleInfo和abilityInfo中包含的metadata。它不能单独使用,它需要与GET_BUNDLE_INFO_WITH_APPLICATION、GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用 |
| GET_BUNDLE_INFO_WITH_DISABLE | 0x00000040 | 用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息 |
| GET_BUNDLE_INFO_WITH_SIGNATURE_INFO | 0x00000080 | 用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息 |
| GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION | 0x00000010 | 用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息
。
|
| GET_BUNDLE_INFO_WITH_METADATA | 0x00000020 | 用于获取applicationInfo、moduleInfo和abilityInfo中包含的metadata。它不能单独使用,它需要与GET_BUNDLE_INFO_WITH_APPLICATION、GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用
。
|
| GET_BUNDLE_INFO_WITH_DISABLE | 0x00000040 | 用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息
。
|
| GET_BUNDLE_INFO_WITH_SIGNATURE_INFO | 0x00000080 | 用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息
。
|
### ApplicationFlag
应用信息标志,指示需要获取的应用信息的内容。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
**系统接口:**
系统接口,不支持三方应用调用。
| 名称 | 值 | 说明 |
| ------------------------------------ | ---------- | ------------------------------------------------------------ |
| GET_APPLICATION_INFO_DEFAULT | 0x00000000 | 用于获取默认的applicationInfo,获取的applicationInfo不包含permission和metadata信息 |
| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的applicationInfo |
| GET_APPLICATION_INFO_WITH_METADATA | 0x00000002 | 用于获取包含metadata的applicationInfo |
| GET_APPLICATION_INFO_WITH_DISABLE | 0x00000004 | 用于获取包含禁用应用程序的applicationInfo |
| GET_APPLICATION_INFO_DEFAULT | 0x00000000 | 用于获取默认的applicationInfo,获取的applicationInfo不包含permission和metadata信息
。
|
| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的applicationInfo
。
|
| GET_APPLICATION_INFO_WITH_METADATA | 0x00000002 | 用于获取包含metadata的applicationInfo
。
|
| GET_APPLICATION_INFO_WITH_DISABLE | 0x00000004 | 用于获取包含禁用应用程序的applicationInfo
。
|
### AbilityFlag
功能组件信息标志,指示需要获取的功能组件信息的内容。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
**系统接口:**
系统接口,不支持三方应用调用。
| 名称 | 值 | 说明 |
| --------------------------------- | ---------- | ------------------------------------------------------------ |
| GET_ABILITY_INFO_DEFAULT | 0x00000000 | 用于获取默认abilityInfo,获取的abilityInfo不包含permission、metadata和禁用的abilityInfo |
| GET_ABILITY_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的abilityInfo |
| GET_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的abilityInfo |
| GET_ABILITY_INFO_WITH_METADATA | 0x00000004 | 用于获取包含metadata的abilityInfo |
| GET_ABILITY_INFO_WITH_DISABLE | 0x00000008 | 用于获取包含禁用的abilityInfo的abilityInfo |
| GET_ABILITY_INFO_ONLY_SYSTEM_APP | 0x00000010 | 用于仅为系统应用程序获取abilityInfo
|
| GET_ABILITY_INFO_DEFAULT | 0x00000000 | 用于获取默认abilityInfo,获取的abilityInfo不包含permission、metadata和禁用的abilityInfo
。
|
| GET_ABILITY_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的abilityInfo
。
|
| GET_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的abilityInfo
。
|
| GET_ABILITY_INFO_WITH_METADATA | 0x00000004 | 用于获取包含metadata的abilityInfo
。
|
| GET_ABILITY_INFO_WITH_DISABLE | 0x00000008 | 用于获取包含禁用的abilityInfo的abilityInfo
。
|
| GET_ABILITY_INFO_ONLY_SYSTEM_APP | 0x00000010 | 用于仅为系统应用程序获取abilityInfo
。
|
### ExtensionAbilityFlag
扩展组件信息标志,指示需要获取的扩展组件信息的内容。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
**系统接口:**
系统接口,不支持三方应用调用。
| 名称 | 值 | 说明 |
| ------------------------------------------- | ---------- | ------------------------------------------------------------ |
| GET_EXTENSION_ABILITY_INFO_DEFAULT | 0x00000000 | 用于获取默认extensionAbilityInfo。获取的extensionAbilityInfo不包含permission、metadata 和禁用的abilityInfo |
| GET_EXTENSION_ABILITY_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的extensionAbilityInfo |
| GET_EXTENSION_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的extensionAbilityInfo |
| GET_EXTENSION_ABILITY_INFO_WITH_METADATA | 0x00000004 | 用于获取包含metadata的extensionAbilityInfo |
| GET_EXTENSION_ABILITY_INFO_DEFAULT | 0x00000000 | 用于获取默认extensionAbilityInfo。获取的extensionAbilityInfo不包含permission、metadata 和禁用的abilityInfo
。
|
| GET_EXTENSION_ABILITY_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的extensionAbilityInfo
。
|
| GET_EXTENSION_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的extensionAbilityInfo
。
|
| GET_EXTENSION_ABILITY_INFO_WITH_METADATA | 0x00000004 | 用于获取包含metadata的extensionAbilityInfo
。
|
### ExtensionAbilityType
指示扩展组件的类型。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 | 值 | 说明 |
...
...
@@ -105,64 +115,74 @@ import bundleManager from '@ohos.bundle.bundleManager'
### PermissionGrantState
指示权限授予信息。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 | 值 | 说明 |
|:----------------:|:---:|:---:|
| PERMISSION_DENIED| -1 | 拒绝授予权限 |
| PERMISSION_GRANTED | 0 | 授予权限 |
| PERMISSION_DENIED| -1 | 拒绝授予权限
。
|
| PERMISSION_GRANTED | 0 | 授予权限
。
|
### SupportWindowMode
标识该组件所支持的窗口模式。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 | 值 | 说明 |
|:----------------:|:---:|:---:|
| FULL_SCREEN | 0 | 窗口支持全屏显示 |
| SPLIT | 1 | 窗口支持分屏显示 |
| FLOATING | 2 | 支持窗口化显示 |
| FULL_SCREEN | 0 | 窗口支持全屏显示
。
|
| SPLIT | 1 | 窗口支持分屏显示
。
|
| FLOATING | 2 | 支持窗口化显示
。
|
### LaunchType
指示组件的启动方式。
**系统能力:**
以下各项对应的系统能力均为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模型下使用
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 | 值 | 说明 |
| :-----: | ---- | :--------------------------------------------------------: |
| PAGE | 1 | 表示基于Page模板开发的FA,用于提供与用户交互的能力 |
| SERVICE | 2 | 表示基于Service模板开发的PA,用于提供后台运行任务的能力 |
| DATA | 3 | 表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象 |
| PAGE | 1 | 表示基于Page模板开发的FA,用于提供与用户交互的能力
。
|
| SERVICE | 2 | 表示基于Service模板开发的PA,用于提供后台运行任务的能力
。
|
| DATA | 3 | 表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象
。
|
### DisplayOrientation
标识该Ability的显示模式。该标签仅适用于page类型的Ability。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
| 名称 |值 |说明 |
|:----------------------------------|---|---|
| UNSPECIFIED |0 |表示未定义方向模式,由系统判定 |
| LANDSCAPE |1 |表示横屏显示模式 |
| PORTRAIT |2 |表示竖屏显示模式 |
| FOLLOW_RECENT |3 |表示跟随上一个显示模式 |
| LANDSCAPE_INVERTED |4 |表示反向横屏显示模式 |
| PORTRAIT_INVERTED |5 |表示反向竖屏显示模式 |
| AUTO_ROTATION |6 |表示传感器自动旋转模式 |
| AUTO_ROTATION_LANDSCAPE |7 |表示传感器自动横向旋转模式 |
| AUTO_ROTATION_PORTRAIT |8 |表示传感器自动竖向旋转模式 |
| AUTO_ROTATION_RESTRICTED |9 |表示受开关控制的自动旋转模式 |
| AUTO_ROTATION_LANDSCAPE_RESTRICTED |10|表述受开关控制的自动横向旋转模式|
| AUTO_ROTATION_PORTRAIT_RESTRICTED |11|表示受开关控制的自动竖向旋转模式|
| LOCKED |12|表示锁定模式|
| UNSPECIFIED |0 |表示未定义方向模式,由系统判定
。
|
| LANDSCAPE |1 |表示横屏显示模式
。
|
| PORTRAIT |2 |表示竖屏显示模式
。
|
| FOLLOW_RECENT |3 |表示跟随上一个显示模式
。
|
| LANDSCAPE_INVERTED |4 |表示反向横屏显示模式
。
|
| PORTRAIT_INVERTED |5 |表示反向竖屏显示模式
。
|
| AUTO_ROTATION |6 |表示传感器自动旋转模式
。
|
| AUTO_ROTATION_LANDSCAPE |7 |表示传感器自动横向旋转模式
。
|
| AUTO_ROTATION_PORTRAIT |8 |表示传感器自动竖向旋转模式
。
|
| AUTO_ROTATION_RESTRICTED |9 |表示受开关控制的自动旋转模式
。
|
| AUTO_ROTATION_LANDSCAPE_RESTRICTED |10|表述受开关控制的自动横向旋转模式
。
|
| AUTO_ROTATION_PORTRAIT_RESTRICTED |11|表示受开关控制的自动竖向旋转模式
。
|
| LOCKED |12|表示锁定模式
。
|
## 方法
...
...
@@ -178,18 +198,20 @@ getBundleInfoForSelf(bundleFlags: [number](#bundleflag)): Promise\<[BundleInfo](
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------- |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------------------- | ------------------------------------- |
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回当前应用的BundleInfo
|
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回当前应用的BundleInfo
。
|
**错误码:**
错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
```
ts
import
bundleManager
from
'
@ohos.bundle.bundleManager
'
let
bundleFlags
=
bundleManager
.
BundleFlag
.
GET_BUNDLE_INFO_DEFAULT
;
...
...
@@ -216,8 +238,8 @@ getBundleInfoForSelf(bundleFlags: [number](#bundleflag), callback: AsyncCallback
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------- |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的当前应用的BundleInfo;否则为错误对象 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的当前应用的BundleInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -258,10 +280,10 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback:
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息|
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象 |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -269,9 +291,9 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback:
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -295,7 +317,7 @@ try {
}
```
```
```
ts
// 额外获取ApplicationInfo中的metadata
import
bundleManager
from
'
@ohos.bundle.bundleManager
'
let
bundleName
=
'
com.example.myapplication
'
;
...
...
@@ -331,9 +353,9 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息|
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象 |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -341,8 +363,8 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -381,24 +403,24 @@ getBundleInfo(bundleName: string, bundleFlags: [number](#bundleflag), userId?: n
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| userId | number | 否 | 表示用户ID |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------------------- | --------------------------- |
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回BundleInfo |
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回BundleInfo
。
|
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -453,10 +475,10 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象 |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -464,9 +486,9 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -505,9 +527,9 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), cal
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象 |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -515,8 +537,8 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), cal
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -554,15 +576,15 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称 |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| userId | number | 否 | 表示用户ID |
| bundleName | string | 是 | 表示要查询的应用程序包名称
。
|
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | -------------------------------- |
| Promise
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | Promise对象,返回ApplicationInfo |
| Promise
\<
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
> | Promise对象,返回ApplicationInfo
。
|
**错误码:**
...
...
@@ -570,9 +592,9 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -609,9 +631,9 @@ getAllBundleInfo(bundleFlags: [number](#bundleflag), userId: number, callback: A
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------------------------------------------------- |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
BundleInfo>;否则为错误对象 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
BundleInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -619,7 +641,7 @@ getAllBundleInfo(bundleFlags: [number](#bundleflag), userId: number, callback: A
| 错误码ID | 错误信息 |
| -------- | --------------------------------- |
| 17700004 | The specified userId is not found |
| 17700004 | The specified userId is not found
.
|
**示例:**
...
...
@@ -657,8 +679,8 @@ getAllBundleInfo(bundleFlags: [number](#bundleflag), callback: AsyncCallback<Arr
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------------------------------------------------- |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| callback | AsyncCallback
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
BundleInfo>;否则为错误对象 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| callback | AsyncCallback
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
BundleInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -699,14 +721,14 @@ getAllBundleInfo(bundleFlags: [number](#bundleflag), userId?: number): Promise<A
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------------------------------------------------- |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息 |
| userId | number | 否 | 表示用户ID
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 指定返回的BundleInfo所包含的信息
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ----------------------------------- |
| Promise
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | Promise对象,返回Array
\<
BundleInfo> |
| Promise
<Array
\<[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
>
> | Promise对象,返回Array
\<
BundleInfo>
。
|
**错误码:**
...
...
@@ -714,7 +736,7 @@ getAllBundleInfo(bundleFlags: [number](#bundleflag), userId?: number): Promise<A
| 错误码ID | 错误信息 |
| -------- | ---------------------------------- |
| 17700004 | The specified userId is not found |
| 17700004 | The specified userId is not found
.
|
**示例:**
...
...
@@ -749,9 +771,9 @@ getAllApplicationInfo(appFlags: [number](#applicationflag), userId: number, call
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------------------------------- |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
ApplicationInfo>;否则为错误对象 |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
ApplicationInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -759,7 +781,7 @@ getAllApplicationInfo(appFlags: [number](#applicationflag), userId: number, call
| 错误码ID | 错误信息 |
| -------- | ---------------------------------- |
| 17700004 | The specified userId is not found |
| 17700004 | The specified userId is not found
.
|
**示例:**
...
...
@@ -797,8 +819,8 @@ getAllApplicationInfo(appFlags: [number](#applicationflag), callback: AsyncCallb
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------------------------------- |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| callback | AsyncCallback
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
ApplicationInfo>;否则为错误对象 |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| callback | AsyncCallback
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
ApplicationInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -839,14 +861,14 @@ getAllApplicationInfo(appFlags: [number](#applicationflag), userId?: number): Pr
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------------------------------------------------------- |
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息 |
| userId | number | 否 | 表示用户ID
|
| appFlags |
[
number
](
#applicationflag
)
| 是 | 指定返回的ApplicationInfo所包含的信息
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ---------------------------------------- |
| Promise
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | Promise对象,返回Array
\<
ApplicationInfo> |
| Promise
<Array
\<[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
>
> | Promise对象,返回Array
\<
ApplicationInfo>
。
|
**错误码:**
...
...
@@ -854,7 +876,7 @@ getAllApplicationInfo(appFlags: [number](#applicationflag), userId?: number): Pr
| 错误码ID | 错误信息 |
| -------- | ---------------------------------- |
| 17700004 | The specified userId is not found |
| 17700004 | The specified userId is not found
.
|
**示例:**
...
...
@@ -890,10 +912,10 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId: numbe
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 指定返回的AbilityInfo所包含的信息 |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
AbilityInfo>;否则为错误对象 |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 指定返回的AbilityInfo所包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
AbilityInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -901,11 +923,11 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId: numbe
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified ability is not found |
| 17700004 | The specified userId is invalid |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified ability is not found
.
|
| 17700004 | The specified userId is invalid
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -947,9 +969,9 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), callback: Asy
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | -------------------------------------------------------|
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 指定返回的AbilityInfo所包含的信息 |
| callback | AsyncCallback
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
AbilityInfo>;否则为错误对象 |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 指定返回的AbilityInfo所包含的信息
。
|
| callback | AsyncCallback
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
AbilityInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -957,10 +979,10 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), callback: Asy
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified ability is not found |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified ability is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -1001,15 +1023,15 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId?: numb
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 表示指定返回的AbilityInfo所包含的信息 |
| userId | number | 否 | 表示用户ID |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| abilityFlags |
[
number
](
#abilityflag
)
| 是 | 表示指定返回的AbilityInfo所包含的信息
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------ |
| Promise
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | Promise对象,返回Array
\<
AbilityInfo> |
| Promise
<Array
\<[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
>
> | Promise对象,返回Array
\<
AbilityInfo>
。
|
**错误码:**
...
...
@@ -1017,11 +1039,11 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId?: numb
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified ability is not found |
| 17700004 | The specified userId is invalid |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified ability is not found
.
|
| 17700004 | The specified userId is invalid
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -1080,11 +1102,11 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型 |
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志 |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array
\<
ExtensionAbilityInfo>;否则为错误对象 |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型
。
|
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array
\<
ExtensionAbilityInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -1092,10 +1114,10 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified extensionAbility is not found |
| 17700004 | The specified userId is invalid |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified extensionAbility is not found
.
|
| 17700004 | The specified userId is invalid
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -1138,10 +1160,10 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型 |
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志 |
| callback | AsyncCallback
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array
\<
ExtensionAbilityInfo>;否则为错误对象 |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型
。
|
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志
。
|
| callback | AsyncCallback
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array
\<
ExtensionAbilityInfo>;否则为错误对象
。
|
**错误码:**
...
...
@@ -1149,9 +1171,9 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified extensionAbility is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified extensionAbility is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -1193,16 +1215,16 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | --------------------------------------------- | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want |
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型 |
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志 |
| userId | number | 否 | 表示用户ID |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want
。
|
| extensionAbilityType |
[
ExtensionAbilityType
](
#extensionabilitytype
)
| 是 | 标识extensionAbility的类型
。
|
| extensionAbilityFlags |
[
number
](
#extensionabilityflag
)
| 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | --------------------------------------------- |
| Promise
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | Promise对象,返回Array
\<
ExtensionAbilityInfo> |
| Promise
<Array
\<[
ExtensionAbilityInfo
](
js-apis-bundleManager-extensionAbilityInfo.md
)
>
> | Promise对象,返回Array
\<
ExtensionAbilityInfo>
。
|
**错误码:**
...
...
@@ -1210,10 +1232,10 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified extensionAbility is not found |
| 17700004 | The specified userId is invalid |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified extensionAbility is not found
.
|
| 17700004 | The specified userId is invalid
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -1275,8 +1297,8 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\<string>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
| uid | number | 是 | 表示应用程序的UID |
| callback | AsyncCallback
\<
string> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleName;否则为错误对象 |
| uid | number | 是 | 表示应用程序的UID
。
|
| callback | AsyncCallback
\<
string> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleName;否则为错误对象
。
|
**错误码:**
...
...
@@ -1284,7 +1306,7 @@ getBundleNameByUid(uid: number, callback: AsyncCallback\<string>): void;
| 错误码ID | 错误信息 |
| -------- | --------------------- |
| 17700021 | The uid is not found |
| 17700021 | The uid is not found
.
|
**示例:**
...
...
@@ -1320,13 +1342,13 @@ getBundleNameByUid(uid: number): Promise\<string>;
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------------ |
| uid | number | 是 | 表示应用程序的UID |
| uid | number | 是 | 表示应用程序的UID
。
|
**返回值:**
| 类型 | 说明 |
| ---------------- | --------------------------- |
| Promise
\<
string> | Promise对象,返回bundleName |
| Promise
\<
string> | Promise对象,返回bundleName
。
|
**错误码:**
...
...
@@ -1334,7 +1356,7 @@ getBundleNameByUid(uid: number): Promise\<string>;
| 错误码ID | 错误信息 |
| -------- | ---------------------|
| 17700021 | The uid is not found |
| 17700021 | The uid is not found
.
|
**示例:**
...
...
@@ -1368,9 +1390,9 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: [number](#bundleflag), ca
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ----------------------------------------------------------- |
| hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志 |
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象 |
| hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志
。
|
| callback | AsyncCallback
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象
。
|
**错误码:**
...
...
@@ -1378,7 +1400,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: [number](#bundleflag), ca
| 错误码ID | 错误信息 |
| -------- | --------------------------- |
| 17700022 | The hapFilePath is invalid |
| 17700022 | The hapFilePath is invalid
.
|
**示例:**
...
...
@@ -1416,14 +1438,14 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: [number](#bundleflag)):
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
| hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径 |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志 |
| hapFilePath | string | 是 | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定要返回的BundleInfo对象中包含的信息的标志
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------------------- | --------------------------- |
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回BundleInfo |
| Promise
\<
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
> | Promise对象,返回BundleInfo
。
|
**错误码:**
...
...
@@ -1431,7 +1453,7 @@ getBundleArchiveInfo(hapFilePath: string, bundleFlags: [number](#bundleflag)):
| 错误码ID | 错误信息 |
| -------- | -------------------------- |
| 17700022 | The hapFilePath is invalid |
| 17700022 | The hapFilePath is invalid
.
|
**示例:**
...
...
@@ -1467,8 +1489,8 @@ cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback\<void>): void;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 表示要清理其缓存数据的应用程序的bundleName |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当清理应用缓存目录数据成功,err为null,否则为错误对象 |
| bundleName | string | 是 | 表示要清理其缓存数据的应用程序的bundleName
。
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当清理应用缓存目录数据成功,err为null,否则为错误对象
。
|
**错误码:**
...
...
@@ -1476,8 +1498,8 @@ cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback\<void>): void;
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700001 | The specified bundleName is not found |
| 17700030 | The specified bundleName does not support cleaning cache files |
| 17700001 | The specified bundleName is not found
.
|
| 17700030 | The specified bundleName does not support cleaning cache files
.
|
**示例:**
...
...
@@ -1514,13 +1536,13 @@ cleanBundleCacheFiles(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------------------------ |
| bundleName | string | 是 | 表示要清理其缓存数据的应用程序的bundleName |
| bundleName | string | 是 | 表示要清理其缓存数据的应用程序的bundleName
。
|
**返回值:**
| 类型 | 说明 |
| -------------- | ------------------------------------------------------------ |
| Promise
\<
void> | Promise对象,返回true表示清理应用缓存目录数据成功,返回false表示清理应用缓存目录数据失败 |
| Promise
\<
void> | Promise对象,返回true表示清理应用缓存目录数据成功,返回false表示清理应用缓存目录数据失败
。
|
**错误码:**
...
...
@@ -1528,8 +1550,8 @@ cleanBundleCacheFiles(bundleName: string): Promise\<void>;
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700030 | The specified bundle does not support cleaning cache files |
| 17700001 | The specified bundleName is not found
.
|
| 17700030 | The specified bundle does not support cleaning cache files
.
|
**示例:**
...
...
@@ -1564,9 +1586,9 @@ setApplicationEnabled(bundleName: string, isEnabled: boolean, callback: AsyncCal
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------- | ---- | ------------------------------------- |
| bundleName | string | 是 | 指定应用的bundleName |
| isEnabled | boolean | 是 | 值为true表示使能,值为false表示禁用 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当设置应用禁用使能状态成功时,err为null,否则为错误对象 |
| bundleName | string | 是 | 指定应用的bundleName
。
|
| isEnabled | boolean | 是 | 值为true表示使能,值为false表示禁用
。
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当设置应用禁用使能状态成功时,err为null,否则为错误对象
。
|
**错误码:**
...
...
@@ -1574,7 +1596,7 @@ setApplicationEnabled(bundleName: string, isEnabled: boolean, callback: AsyncCal
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700001 | The specified bundleName is not found
.
|
**示例:**
...
...
@@ -1611,14 +1633,14 @@ setApplicationEnabled(bundleName: string, isEnabled: boolean): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------- | ---- | ------------------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| isEnabled | boolean | 是 | 值为true表示使能,值为false表示禁用 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| isEnabled | boolean | 是 | 值为true表示使能,值为false表示禁用
。
|
**返回值:**
| 类型 | 说明 |
| -------------- | ------------------------------------ |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象 |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象
。
|
**错误码:**
...
...
@@ -1626,7 +1648,7 @@ setApplicationEnabled(bundleName: string, isEnabled: boolean): Promise\<void>;
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700001 | The specified bundleName is not found
.
|
**示例:**
...
...
@@ -1661,9 +1683,9 @@ setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isE
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------- | ---- | ------------------------------------- |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 需要被设置的组件 |
| isEnabled| boolean | 是 | 值为true表示使能,值为false表示禁用 |
| callback | AsyncCallback
\<
void> |
| 回调函数,当设置组件禁用使能状态成功时,err为null,否则为错误对象
|
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 需要被设置的组件
。
|
| isEnabled| boolean | 是 | 值为true表示使能,值为false表示禁用
。
|
| callback | AsyncCallback
\<
void> |
是 | 回调函数,当设置组件禁用使能状态成功时,err为null,否则为错误对象。
|
**错误码:**
...
...
@@ -1671,8 +1693,8 @@ setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isE
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified abilityInfo is not found |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified abilityInfo is not found
.
|
**示例:**
...
...
@@ -1722,14 +1744,14 @@ setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isE
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------- | ---- | ------------------------------------- |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 需要被设置的组件 |
| isEnabled| boolean | 是 | 值为true表示使能,值为false表示禁用 |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 需要被设置的组件
。
|
| isEnabled| boolean | 是 | 值为true表示使能,值为false表示禁用
。
|
**返回值:**
| 类型 | 说明 |
| -------------- | --------------------------------- |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象 |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象
。
|
**错误码:**
...
...
@@ -1737,8 +1759,8 @@ setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isE
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified abilityInfo is not found |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified abilityInfo is not found
.
|
**示例:**
...
...
@@ -1784,8 +1806,8 @@ isApplicationEnabled(bundleName: string, callback: AsyncCallback\<boolean>): voi
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,返回true表示当前应用为使能状态,返回false表示应用为禁用状态 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,返回true表示当前应用为使能状态,返回false表示应用为禁用状态
。
|
**错误码:**
...
...
@@ -1793,7 +1815,7 @@ isApplicationEnabled(bundleName: string, callback: AsyncCallback\<boolean>): voi
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700001 | The specified bundleName is not found
.
|
**示例:**
...
...
@@ -1828,7 +1850,7 @@ isApplicationEnabled(bundleName: string): Promise\<boolean>;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
**返回值:**
...
...
@@ -1842,7 +1864,7 @@ isApplicationEnabled(bundleName: string): Promise\<boolean>;
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700001 | The specified bundleName is not found
.
|
**示例:**
...
...
@@ -1875,8 +1897,8 @@ isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), call
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ----------- | ---- | --------------------------- |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 表示关于检查ability的信息 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,返回true表示当前应用组件为使能状态,返回false表示应用组件为禁用状态 |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 表示关于检查ability的信息
。
|
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,返回true表示当前应用组件为使能状态,返回false表示应用组件为禁用状态
。
|
**错误码:**
...
...
@@ -1884,8 +1906,8 @@ isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), call
| 错误码ID | 错误信息 |
| -------- | --------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
**示例:**
...
...
@@ -1933,7 +1955,7 @@ isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md)): Pro
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ----------- | ---- | --------------------------- |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 表示关于检查ability的信息 |
| info |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 表示关于检查ability的信息
。
|
**返回值:**
...
...
@@ -1947,8 +1969,8 @@ isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md)): Pro
| 错误码ID | 错误信息 |
| -------- | --------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700001 | The specified bundleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
**示例:**
...
...
@@ -1996,9 +2018,9 @@ getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallba
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 表示应用程序的bundleName |
| userId | number | 是 | 表示用户ID |
| callback | AsyncCallback
\<
Want> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| userId | number | 是 | 表示用户ID
。
|
| callback | AsyncCallback
\<
Want> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象
。
|
**错误码:**
...
...
@@ -2006,9 +2028,9 @@ getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallba
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2046,8 +2068,8 @@ getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\<Want>): void
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 表示应用程序的bundleName |
| callback | AsyncCallback
\<
Want> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| callback | AsyncCallback
\<
Want> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象
。
|
**错误码:**
...
...
@@ -2055,8 +2077,8 @@ getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\<Want>): void
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2091,16 +2113,16 @@ getLaunchWantForBundle(bundleName: string, userId?: number): Promise\<Want>;
**参数:**
| 参数名
| 类型 | 必填 | 说明
|
| ---------- | ------ | ---- | ------------------------ |
| bundleName | string | 是 | 表示应用程序的bundleName |
| userId | number | 否 | 表示用户ID|
| 参数名
| 类型 | 必填 | 说明
|
| ---------- | ------ | ---- | ------------------------
-
|
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| userId | number | 否 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| -------------- | ------------------------- |
| Promise
\<
Want> | Promise对象,返回Want对象 |
| Promise
\<
Want> | Promise对象,返回Want对象
。
|
**错误码:**
...
...
@@ -2108,9 +2130,9 @@ getLaunchWantForBundle(bundleName: string, userId?: number): Promise\<Want>;
| 错误码ID | 错误信息 |
| -------- | --------------------------------------|
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2142,10 +2164,10 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName: strin
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ----------------------------- | ---- | ------------------------------------------------------------ |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| metadataName | string | 是 | 表示应用程序的metadataName
|
| callback | AsyncCallback
<Array
\<
string
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
string>;否则为错误对象 |
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
| metadataName | string | 是 | 表示应用程序的metadataName
。
|
| callback | AsyncCallback
<Array
\<
string
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
string>;否则为错误对象
。
|
**错误码:**
...
...
@@ -2153,11 +2175,11 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName: strin
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700002 | The specified moduleName is not existed |
| 17700003 | The specified abilityName is not existed |
| 17700024 | The specified metadataName is not existed or the profile is not json-format |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700002 | The specified moduleName is not existed
.
|
| 17700003 | The specified abilityName is not existed
.
|
| 17700024 | The specified metadataName is not existed or the profile is not json-format
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2192,15 +2214,15 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName?: stri
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | -------------------------- |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| metadataName | string | 否 | 表示应用程序的metadataName |
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
| metadataName | string | 否 | 表示应用程序的metadataName
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------- | ------------------------------- |
| Promise
<Array
\<
string
>
> | Promise对象,返回Array
\<
string> |
| Promise
<Array
\<
string
>
> | Promise对象,返回Array
\<
string>
。
|
**错误码:**
...
...
@@ -2208,11 +2230,11 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName?: stri
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700002 | The specified moduleName is not existed |
| 17700003 | The specified abilityName is not existed |
| 17700024 | The specified metadataName is not existed or the profile is not json-format |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700002 | The specified moduleName is not existed
.
|
| 17700003 | The specified abilityName is not existed
.
|
| 17700024 | The specified metadataName is not existed or the profile is not json-format
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2220,7 +2242,6 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName?: stri
import
bundleManager
from
'
@ohos.bundle.bundleManager
'
let
moduleName
=
'
entry
'
;
let
abilityName
=
'
MainAbility
'
;
let
metadataName
=
'
com.example.myapplication.metadata
'
;
try
{
bundleManager
.
getProfileByAbility
(
moduleName
,
abilityName
).
then
((
data
)
=>
{
...
...
@@ -2231,7 +2252,13 @@ try {
}
catch
(
error
)
{
console
.
error
(
'
getProfileByAbility failed. Cause:
'
+
error
.
message
);
}
```
```
ts
import
bundleManager
from
'
@ohos.bundle.bundleManager
'
let
moduleName
=
'
entry
'
;
let
abilityName
=
'
MainAbility
'
;
let
metadataName
=
'
com.example.myapplication.metadata
'
;
try
{
bundleManager
.
getProfileByAbility
(
moduleName
,
abilityName
,
metadataName
).
then
((
data
)
=>
{
console
.
info
(
'
getProfileByAbility successfully. Data:
'
+
JSON
.
stringify
(
data
));
...
...
@@ -2255,10 +2282,10 @@ getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, m
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | ----------------------------- | ---- | ------------------------------------------------------------ |
| moduleName | string | 是 | 表示应用程序的moduleName |
| extensionAbilityName | string | 是 | 表示应用程序的extensionAbilityName |
| metadataName | string | 是 | 表示应用程序的metadataName |
| callback | AsyncCallback
<Array
\<
string
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
string>;否则为错误对象 |
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| extensionAbilityName | string | 是 | 表示应用程序的extensionAbilityName
。
|
| metadataName | string | 是 | 表示应用程序的metadataName
。
|
| callback | AsyncCallback
<Array
\<
string
>
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
string>;否则为错误对象
。
|
**错误码:**
...
...
@@ -2266,10 +2293,10 @@ getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, m
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700002 | The specified moduleName is not existed |
| 17700003 | The specified extensionAbilityName is not existed |
| 17700024 | The specified metadataName is not existed or the profile is not json-format |
| 17700026 | The specified bundle is disabled |
| 17700002 | The specified moduleName is not existed
.
|
| 17700003 | The specified extensionAbilityName is not existed
.
|
| 17700024 | The specified metadataName is not existed or the profile is not json-format
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2304,15 +2331,15 @@ getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, m
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | ------ | ---- | ---------------------------------- |
| moduleName | string | 是 | 表示应用程序的moduleName |
| extensionAbilityName | string | 是 | 表示应用程序的extensionAbilityName |
| metadataName | string | 否 | 表示应用程序的metadataName |
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| extensionAbilityName | string | 是 | 表示应用程序的extensionAbilityName
。
|
| metadataName | string | 否 | 表示应用程序的metadataName
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------- | ----------------------------------- |
| Promise
<Array
\<
string
>
> | Promise对象,返回Array
\<
string>对象 |
| Promise
<Array
\<
string
>
> | Promise对象,返回Array
\<
string>对象
。
|
**错误码:**
...
...
@@ -2320,10 +2347,10 @@ getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, m
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700002 | The specified moduleName is not existed |
| 17700003 | The specified extensionAbilityName is not existed |
| 17700024 | The specified metadataName is not existed or the profile is not json-format |
| 17700026 | The specified bundle is disabled |
| 17700002 | The specified moduleName is not existed
.
|
| 17700003 | The specified extensionAbilityName is not existed
.
|
| 17700024 | The specified metadataName is not existed or the profile is not json-format
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2370,8 +2397,8 @@ getPermissionDef(permissionName: string, callback: AsyncCallback\<[PermissionDef
| 名称 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| permissionName | string | 是 | 表示权限名称 |
| callback | AsyncCallback
\<
[
PermissionDef
](
js-apis-bundleManager-permissionDef.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
PermissionDef>;否则为错误对象 |
| permissionName | string | 是 | 表示权限名称
。
|
| callback | AsyncCallback
\<
[
PermissionDef
](
js-apis-bundleManager-permissionDef.md
)
> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array
\<
PermissionDef>;否则为错误对象
。
|
**错误码:**
...
...
@@ -2379,7 +2406,7 @@ getPermissionDef(permissionName: string, callback: AsyncCallback\<[PermissionDef
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700006 | The specified permission is not found |
| 17700006 | The specified permission is not found
.
|
**示例:**
...
...
@@ -2415,13 +2442,13 @@ getPermissionDef(permissionName: string): Promise\<[PermissionDef](js-apis-bundl
| 名称 | 类型 | 必填 | 说明 |
| -------------- | ------ | ---- | -------------- |
| permissionName | string | 是 | 表示权限参数名 |
| permissionName | string | 是 | 表示权限参数名
。
|
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------ |
| Promise
\<
[
PermissionDef
](
js-apis-bundleManager-permissionDef.md
)
> | Promise对象,返回Array
\<
PermissionDef>对象 |
| Promise
\<
[
PermissionDef
](
js-apis-bundleManager-permissionDef.md
)
> | Promise对象,返回Array
\<
PermissionDef>对象
。
|
**错误码:**
...
...
@@ -2429,7 +2456,7 @@ getPermissionDef(permissionName: string): Promise\<[PermissionDef](js-apis-bundl
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700006 | The specified permission is not found |
| 17700006 | The specified permission is not found
.
|
**示例:**
...
...
@@ -2463,10 +2490,10 @@ getAbilityLabel(bundleName: string, moduleName: string, abilityName: string, cal
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 表示应用程序的bundleName |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| callback | AsyncCallback
\<
string> | 是 | 回调函数,当获取成功时,err为null,data为获指定组件的Label值;否则为错误对象 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
| callback | AsyncCallback
\<
string> | 是 | 回调函数,当获取成功时,err为null,data为获指定组件的Label值;否则为错误对象
。
|
**错误码:**
...
...
@@ -2474,11 +2501,11 @@ getAbilityLabel(bundleName: string, moduleName: string, abilityName: string, cal
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700002 | The specified moduleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700002 | The specified moduleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2517,15 +2544,15 @@ getAbilityLabel(bundleName: string, moduleName: string, abilityName: string): Pr
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
**返回值:**
| 类型 | 说明 |
| ---------------- | ----------------------------------- |
| Promise
\<
string> | Promise对象,返回指定组件的Lablel值 |
| Promise
\<
string> | Promise对象,返回指定组件的Lablel值
。
|
**错误码:**
...
...
@@ -2533,11 +2560,11 @@ getAbilityLabel(bundleName: string, moduleName: string, abilityName: string): Pr
| 错误码ID | 错误信息 |
| -------- | --------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700002 | The specified moduleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700002 | The specified moduleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2574,10 +2601,10 @@ getAbilityIcon(bundleName: string, moduleName: string, abilityName: string, call
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 表示应用程序的bundleName |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| callback | AsyncCallback
<
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
>
| 是 | 回调函数,当获取成功时,err为null,data为指定组件icon的PixelMap对象;否则为错误对象 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
| callback | AsyncCallback
<
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
>
| 是 | 回调函数,当获取成功时,err为null,data为指定组件icon的PixelMap对象;否则为错误对象
。
|
**错误码:**
...
...
@@ -2585,11 +2612,11 @@ getAbilityIcon(bundleName: string, moduleName: string, abilityName: string, call
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700002 | The specified moduleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700002 | The specified moduleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2628,15 +2655,15 @@ getAbilityIcon(bundleName: string, moduleName: string, abilityName: string): Pro
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| moduleName | string | 是 | 表示应用程序的moduleName |
| abilityName | string | 是 | 表示应用程序的abilityName |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| moduleName | string | 是 | 表示应用程序的moduleName
。
|
| abilityName | string | 是 | 表示应用程序的abilityName
。
|
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------------- | ------------------------------------------- |
| Promise
<
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
>
| Promise对象,返回指定组件icon的PixelMap对象 |
| Promise
<
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
>
| Promise对象,返回指定组件icon的PixelMap对象
。
|
**错误码:**
...
...
@@ -2644,11 +2671,11 @@ getAbilityIcon(bundleName: string, moduleName: string, abilityName: string): Pro
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700002 | The specified moduleName is not found |
| 17700003 | The specified abilityName is not found |
| 17700026 | The specified bundle is disabled |
| 17700029 | The specified ability is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700002 | The specified moduleName is not found
.
|
| 17700003 | The specified abilityName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
| 17700029 | The specified ability is disabled
.
|
**示例:**
...
...
@@ -2685,15 +2712,15 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: num
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ----------------------------------------------------------|
| bundleName | string | 是 | 表示应用程序的bundleName |
| applicationFlags |
[
number
](
#applicationflag
)
| 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息 |
| userId | number | 是 | 表示用户ID |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| applicationFlags |
[
number
](
#applicationflag
)
| 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息
。
|
| userId | number | 是 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| --------------- | ------------------------- |
|
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
| 返回ApplicationInfo对象 |
|
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
| 返回ApplicationInfo对象
。
|
**错误码:**
...
...
@@ -2701,9 +2728,9 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: num
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2737,14 +2764,14 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number) : [Applicat
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ----------------------------------------------------------|
| bundleName | string | 是 | 表示应用程序的bundleName |
| applicationFlags |
[
number
](
#applicationflag
)
| 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| applicationFlags |
[
number
](
#applicationflag
)
| 是 | 表示用于指定将返回的ApplicationInfo对象中包含的信息
。
|
**返回值:**
| 类型 | 说明 |
| --------------- | ------------------------- |
|
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
| 返回ApplicationInfo对象 |
|
[
ApplicationInfo
](
js-apis-bundleManager-applicationInfo.md
)
| 返回ApplicationInfo对象
。
|
**错误码:**
...
...
@@ -2752,8 +2779,8 @@ getApplicationInfoSync(bundleName: string, applicationFlags: number) : [Applicat
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2786,15 +2813,15 @@ getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag), userId
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------------------------------------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志 |
| userId | number | 是 | 表示用户ID |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志
。
|
| userId | number | 是 | 表示用户ID
。
|
**返回值:**
| 类型 | 说明 |
| ---------- | -------------------- |
|
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
| 返回BundleInfo对象 |
|
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
| 返回BundleInfo对象
。
|
**错误码:**
...
...
@@ -2802,9 +2829,9 @@ getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag), userId
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700004 | The specified userId is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700004 | The specified userId is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
@@ -2838,14 +2865,14 @@ getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag)): [Bund
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------------------------------------------------------- |
| bundleName | string | 是 | 表示应用程序的bundleName |
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志 |
| bundleName | string | 是 | 表示应用程序的bundleName
。
|
| bundleFlags |
[
number
](
#bundleflag
)
| 是 | 表示用于指定将返回的BundleInfo对象中包含的信息的标志
。
|
**返回值:**
| 类型 | 说明 |
| ---------- | -------------------- |
|
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
| 返回BundleInfo对象 |
|
[
BundleInfo
](
js-apis-bundleManager-bundleInfo.md
)
| 返回BundleInfo对象
。
|
**错误码:**
...
...
@@ -2853,8 +2880,8 @@ getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag)): [Bund
| 错误码ID | 错误信息 |
| -------- | ------------------------------------- |
| 17700001 | The specified bundleName is not found |
| 17700026 | The specified bundle is disabled |
| 17700001 | The specified bundleName is not found
.
|
| 17700026 | The specified bundle is disabled
.
|
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md
浏览文件 @
64241d6c
...
...
@@ -2,13 +2,13 @@
本模块提供监听应用安装,卸载,更新的能力。
> **说明:**
> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
javascript
```
ts
import
bundleMonitor
from
'
@ohos.bundle.bundleMonitor
'
;
```
...
...
@@ -28,8 +28,8 @@ import bundleMonitor from '@ohos.bundle.bundleMonitor';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------- | ------ | ---- | ---- | -------------------------- |
| bundleName | string | 是 | 否 | 应用状态发生变化的应用包名 |
| userId | number | 是 | 否 | 应用状态发生变化的用户id |
| bundleName | string | 是 | 否 | 应用状态发生变化的应用包名
。
|
| userId | number | 是 | 否 | 应用状态发生变化的用户id
。
|
## bundleMonitor.on
...
...
@@ -47,19 +47,16 @@ on(type: BundleChangedEvent, callback: Callback\<BundleChangedInfo>): void;
| 参数名 | 类型 | 必填 | 说明 |
| ---------------------------- | -------- | ---- | ------------------ |
| BundleChangedEvent | string | 是 | 注册监听的事件类型 |
| Callback
\<
BundleChangedInfo> | callback | 是 | 注册监听的回调函数 |
| BundleChangedEvent | string | 是 | 注册监听的事件类型
。
|
| Callback
\<
BundleChangedInfo> | callback | 是 | 注册监听的回调函数
。
|
**
相关错误码
**
**
错误码:
**
| 错误码ID | 错误信息 |
| -------- | --------------------------- |
| 201 | Permission denied. |
| 401 | The parameter check failed. |
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
```
j
s
```
t
s
import
bundleMonitor
from
'
@ohos.bundle.bundleMonitor
'
;
try
{
...
...
@@ -87,19 +84,16 @@ off(type: BundleChangedEvent, callback?: Callback\<BundleChangedInfo>): void;
| 参数名 | 类型 | 必填 | 说明 |
| ---------------------------- | -------- | ---- | ---------------------------------------------------------- |
| BundleChangedEvent | string | 是 | 注销监听的事件类型 |
| Callback
\<
BundleChangedInfo> | callback |
否 | 注销监听的回调函数,当为空时表示注销当前事件的所有callback
|
| BundleChangedEvent | string | 是 | 注销监听的事件类型
。
|
| Callback
\<
BundleChangedInfo> | callback |
是 | 注销监听的回调函数,当为空时表示注销当前事件的所有callback。
|
**
相关错误码
**
**
错误码:
**
| 错误码ID | 错误信息 |
| -------- | --------------------------- |
| 201 | Permission denied. |
| 401 | The parameter check failed. |
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
```
j
s
```
t
s
import
bundleMonitor
from
'
@ohos.bundle.bundleMonitor
'
;
try
{
...
...
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
浏览文件 @
64241d6c
...
...
@@ -11,6 +11,16 @@
```
import defaultAppMgr from '@ohos.bundle.defaultAppManager';
```
## 权限列表
| 权限 | 权限等级 | 描述 |
| --------------------------------------- | ----------- | ---------------- |
| ohos.permission.GET_DEFAULT_APPLICATION | system_core | 默认应用相关权限。 |
权限等级参考
[
权限等级说明
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-overview.md#%E6%9D%83%E9%99%90%E7%AD%89%E7%BA%A7%E8%AF%B4%E6%98%8E
)
## defaultAppMgr.ApplicationType
应用类型
...
...
@@ -48,9 +58,14 @@ isDefaultApplication(type: string): Promise\<boolean>
| ------------------------- | ------------------ |
| Promise
\<
boolean> | Promise形式返回当前应用是否是默认应用,true表示是默认应用,false表示不是默认应用。 |
**错误码:**
错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
isDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
)
.
then
((
data
)
=>
{
...
...
@@ -75,6 +90,10 @@ isDefaultApplication(type: string, callback: AsyncCallback\<boolean>): void
| type | string | 是 | 要查询的应用类型,取
[
ApplicationType
](
#defaultappmgrapplicationtype
)
中的值。 |
| callback | AsyncCallback
\<
boolean> | 是 | 程序启动作为入参的回调函数,返回当前应用是否是默认应用,true表示是默认应用,false表示不是默认应用。 |
**错误码:**
错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
```
js
...
...
@@ -115,6 +134,8 @@ getDefaultApplication(type: string, userId?: number): Promise\<BundleInfo>
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -164,6 +185,8 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\<Bun
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -213,6 +236,8 @@ getDefaultApplication(type: string, callback: AsyncCallback\<BundleInfo>) : void
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -273,6 +298,8 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number):
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -338,6 +365,8 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -396,6 +425,8 @@ setDefaultApplication(type: string, elementName: ElementName, callback: AsyncCal
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -404,7 +435,7 @@ setDefaultApplication(type: string, elementName: ElementName, callback: AsyncCal
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
setDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
{
bundleName
:
"
com.test.app
"
,
...
...
@@ -452,6 +483,8 @@ resetDefaultApplication(type: string, userId?: number): Promise\<void>
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -501,6 +534,8 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\<v
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -549,6 +584,8 @@ resetDefaultApplication(type: string, callback: AsyncCallback\<void>) : void;
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------- |
| 17700004 | The specified user id is not found. |
...
...
@@ -556,7 +593,7 @@ resetDefaultApplication(type: string, callback: AsyncCallback\<void>) : void;
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
resetDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
(
err
,
data
)
=>
{
if
(
err
)
{
...
...
zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md
浏览文件 @
64241d6c
...
...
@@ -22,7 +22,7 @@ SystemCapability.BundleManager.DistributedBundleFramework
| 权限 | 权限等级 | 说明 |
| ------------------------------------------ | ------------ | ------------------ |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息
。
|
权限等级参考
[
权限等级说明
](
../../security/accesstoken-overview.md#权限等级说明
)
。
...
...
@@ -49,19 +49,16 @@ getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback\<RemoteAb
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|--------------------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
{
...
...
@@ -108,19 +105,16 @@ getRemoteAbilityInfo(elementName: ElementName): Promise\<RemoteAbilityInfo>;
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
{
...
...
@@ -153,26 +147,23 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>, callback: AsyncCallback\
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息,最大数组长度为10 |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息,最大数组长度为10
。
|
| callback | AsyncCallback
\<
Array
\<
[
RemoteAbilityInfo
](
js-apis-bundleManager-remoteAbilityInfo.md
)
>> | 是 | 回调函数,调用成功返回err为null,data为RemoteAbilityInfo数组对象;否则返回错误对象。 |
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
[
...
...
@@ -214,7 +205,7 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>): Promise\<Array\<RemoteA
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | --------------------------------------------------- | ---- | ----------------------- |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息
,
最大数组长度为10。 |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息
,
最大数组长度为10。 |
**返回值:**
...
...
@@ -226,19 +217,16 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>): Promise\<Array\<RemoteA
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
[
...
...
@@ -279,26 +267,23 @@ getRemoteAbilityInfo(elementName: ElementName, locale: string, callback: AsyncCa
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementName |
[
ElementName
](
js-apis-bundleManager-elementName.md
)
| 是 | ElementName信息。 |
| locale | string |是 | 语言地区 |
| locale | string |是 | 语言地区
。
|
| callback | AsyncCallback
<
[
RemoteAbilityInfo
](
js-apis-bundleManager-remoteAbilityInfo.md
)
>
| 是 | 回调函数,操作成功返回err为null,data为RemoteAbilityInfo对象;否则为错误对象。 |
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
{
...
...
@@ -334,7 +319,7 @@ getRemoteAbilityInfo(elementName: ElementName, locale: string): Promise\<RemoteA
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | -------------------------------------------- | ---- | ----------------------- |
| elementName |
[
ElementName
](
js-apis-bundleManager-elementName.md
)
| 是 | ElementName信息。 |
| locale | string |是 | 语言地区 |
| locale | string |是 | 语言地区
。
|
**返回值:**
...
...
@@ -346,19 +331,16 @@ getRemoteAbilityInfo(elementName: ElementName, locale: string): Promise\<RemoteA
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
{
...
...
@@ -391,8 +373,8 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>, locale: string, callback
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息,最大数组长度为10 |
| locale | string |是 | 语言地区 |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息,最大数组长度为10
。
|
| locale | string |是 | 语言地区
。
|
| callback | AsyncCallback
\<
Array
\<
[
RemoteAbilityInfo
](
js-apis-bundleManager-remoteAbilityInfo.md
)
>> | 是 | 回调函数,调用成功返回err为null,data为RemoteAbilityInfo数组对象;否则返回错误对象。 |
**错误码:**
...
...
@@ -401,17 +383,14 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>, locale: string, callback
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
[
...
...
@@ -454,7 +433,7 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>, locale: string): Promise
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | --------------------------------------------------- | ---- | ----------------------- |
| elementNames | Array
<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>
| 是 | ElementName信息,最大数组长度为10。 |
| locale | string |是 | 语言地区 |
| locale | string |是 | 语言地区
。
|
**返回值:**
...
...
@@ -466,19 +445,16 @@ getRemoteAbilityInfo(elementNames: Array\<ElementName>, locale: string): Promise
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|-------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700003 | The specified ability name is not found. |
|
17700007 | The specified device id is not found. |
| 17700007 | The specified device id is not found. |
| 17700027 | The distributed service is not running. |
**示例:**
```
j
s
```
t
s
try
{
distributedBundle
.
getRemoteAbilityInfo
(
[
...
...
zh-cn/application-dev/reference/apis/js-apis-freeInstall.md
浏览文件 @
64241d6c
...
...
@@ -18,8 +18,8 @@ import freeInstall from '@ohos.bundle.freeInstall';
| 权限 | 权限等级 | 描述 |
| ------------------------------------------ | ------------ | ------------------ |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
| ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用 |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息
。
|
| ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用
。
|
权限等级参考
[
权限等级说明
](
../../security/accesstoken-overview.md#权限等级说明
)
。
## UpgradeFlag
...
...
@@ -28,11 +28,11 @@ import freeInstall from '@ohos.bundle.freeInstall';
**系统能力:**
SystemCapability.BundleManager.BundleFramework.FreeInstall
| 名称
| 值 | 说明 |
| ----------------
-------------
| ---- | ---------------- |
| NOT_UPGRADE | 0 | 模块无需升级 |
| SINGLE_UPGRADE | 1 | 单个模块需要升级 |
| RELATION_UPGRADE | 2 | 关系模块需要升级 |
| 名称 | 值 | 说明 |
| ---------------- | ---- | ---------------- |
| NOT_UPGRADE | 0 | 模块无需升级
。
|
| SINGLE_UPGRADE | 1 | 单个模块需要升级
。
|
| RELATION_UPGRADE | 2 | 关系模块需要升级
。
|
## BundlePackFlag
...
...
@@ -66,18 +66,15 @@ setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: Upg
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag |
[
UpgradeFlag
](
#upgradeflag
)
| 是 | 仅供内部系统使用标志位 |
| callback | AsyncCallback
\<
void>
| 是 | 回调函数。当函数调用成功,err为null,否则为错误对象
|
| callback | AsyncCallback
\<
void>
| 是 | 回调函数。当函数调用成功,err为null,否则为错误对象。
|
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|---------------------------------------- |
| 17700001 | The specified bundle name is not found. |
| 17700002 | The specified module name is not found. |
**示例:**
...
...
@@ -118,24 +115,21 @@ setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: Upg
| ----------- | --------------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag |
[
UpgradeFlag
](
#upgradeflag
)
| 是 | 仅供内部系统使用标志位
|
| upgradeFlag |
[
UpgradeFlag
](
#upgradeflag
)
| 是 | 仅供内部系统使用标志位
。
|
**返回值:**
| 类型 | 说明 |
| ------------- | ------------------------------------ |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象 |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象
。
|
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|----------------------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700002 | The specified module name is not found. |
**示例:**
...
...
@@ -180,12 +174,9 @@ isHapModuleRemovable(bundleName: string, moduleName: string, callback: AsyncCall
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|----------------------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700002 | The specified module name is not found. |
**示例:**
...
...
@@ -236,12 +227,9 @@ isHapModuleRemovable(bundleName: string, moduleName: string): Promise\<boolean>;
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|----------------------------------------|
| 17700001 | The specified bundle name is not found. |
| 17700002 | The specified module name is not found. |
**示例:**
...
...
@@ -278,19 +266,16 @@ getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag, callback:
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 应用程序包名称。 |
| bundlePackFlag |
[
BundlePackFlag
](
#bundlepackflag
)
| 是 | 指示要查询的应用包标志 |
| bundlePackFlag |
[
BundlePackFlag
](
#bundlepackflag
)
| 是 | 指示要查询的应用包标志
。
|
| callback | AsyncCallback
<
[
BundlePackInfo
](
js-apis-bundleManager-packInfo.md
)
>
| 是 | 回调函数。当函数调用成功,err为null,data为获取到的BundlePackInfo信息。否则为错误对象。 |
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|----------------------------------------|
| 17700001 | The specified bundle name is not found. |
**示例:**
...
...
@@ -327,7 +312,7 @@ getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag): Promise\
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | --------------------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundlePackFlag |
[
BundlePackFlag
](
#bundlepackflag
)
| 是 | 指示要查询的应用包标志
|
| bundlePackFlag |
[
BundlePackFlag
](
#bundlepackflag
)
| 是 | 指示要查询的应用包标志
。
|
**返回值:**
...
...
@@ -339,12 +324,9 @@ getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag): Promise\
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 401 | The parameter check failed. |
| 801 | Capability not supported. |
| 17700001 | The specified bundle name is not found |
| 错误码ID | 错误信息 |
|----------|----------------------------------------|
| 17700001 | The specified bundle name is not found. |
**示例:**
...
...
@@ -383,12 +365,7 @@ getDispatchInfo(callback: AsyncCallback\<DispatchInfo>): void;
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 801 | Capability not supported. |
错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
...
...
@@ -427,12 +404,7 @@ getDispatchInfo(): Promise\<DispatchInfo>;
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
|---------------|-------------------------|
| 201 | Permission denied.|
| 801 | Capability not supported. |
错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-installer.md
浏览文件 @
64241d6c
...
...
@@ -15,7 +15,7 @@ import installer from '@ohos.bundle.installer';
| 权限 | 权限等级 | 描述 |
| ------------------------------ | ----------- | ---------------- |
| ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用 |
| ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用
。
|
权限等级参考
[
权限等级说明
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-overview.md#%E6%9D%83%E9%99%90%E7%AD%89%E7%BA%A7%E8%AF%B4%E6%98%8E
)
...
...
@@ -33,7 +33,7 @@ getBundleInstaller(callback: AsyncCallback\<BundleInstaller>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback
\<
[
BundleInstaller
](
js-apis-installer.md#BundleInstaller
)
> | 是 | 回调函数,获取BundleInstaller对象,err为undefined,data为获取到的BundleInstaller对象;否则为错误对象 |
| callback | AsyncCallback
\<
[
BundleInstaller
](
js-apis-installer.md#BundleInstaller
)
> | 是 | 回调函数,获取BundleInstaller对象,err为undefined,data为获取到的BundleInstaller对象;否则为错误对象
。
|
**错误码:**
...
...
@@ -70,7 +70,7 @@ getBundleInstaller(): Promise\<BundleInstaller>;
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------ |
| Promise
\<
[
BundleInstaller
](
js-apis-installer.md#BundleInstaller
)
> | Promise对象,返回BundleInstaller对象 |
| Promise
\<
[
BundleInstaller
](
js-apis-installer.md#BundleInstaller
)
> | Promise对象,返回BundleInstaller对象
。
|
**错误码:**
...
...
@@ -107,9 +107,9 @@ install(hapFilePaths: Array<string>, installParam: InstallParam, callback:
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| hapFilePaths | Array
<
string
>
| 是 | 存储应用程序包的路径。路径应该是当前应用程序中存放HAP包的数据目录。当传入的路径是一个目录时, 该目录下只能放同一个应用的HAP包,且这些HAP包的签名需要保持一致 |
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,安装应用成功,err为undefined,否则为错误对象 |
| hapFilePaths | Array
<
string
>
| 是 | 存储应用程序包的路径。路径应该是当前应用程序中存放HAP包的数据目录。当传入的路径是一个目录时, 该目录下只能放同一个应用的HAP包,且这些HAP包的签名需要保持一致
。
|
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数
。
|
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,安装应用成功,err为undefined,否则为错误对象
。
|
**错误码:**
...
...
@@ -117,15 +117,15 @@ install(hapFilePaths: Array<string>, installParam: InstallParam, callback:
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------ |
| 17700004 | The specified userId is not existed |
| 17700010 | To parse file of config.json or module.json failed |
| 17700011 | To verify signature failed |
| 17700012 | Invalid hap file path or too large file size |
| 17700015 | Multiple haps have inconsistent configured information |
| 17700016 | No disk space left for installation |
| 17700017 | Downgrade installation is prohibited |
| 17700101 | The system service is excepted |
| 17700103 | I/O operation is failed |
| 17700004 | The specified userId is not existed
.
|
| 17700010 | To parse file of config.json or module.json failed
.
|
| 17700011 | To verify signature failed
.
|
| 17700012 | Invalid hap file path or too large file size
.
|
| 17700015 | Multiple haps have inconsistent configured information
.
|
| 17700016 | No disk space left for installation
.
|
| 17700017 | Downgrade installation is prohibited
.
|
| 17700101 | The system service is excepted
.
|
| 17700103 | I/O operation is failed
.
|
**示例:**
...
...
@@ -171,9 +171,9 @@ uninstall(bundleName: string, installParam: InstallParam, callback: AsyncCallbac
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 |
包名
|
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,卸载应用成功,err为undefined,否则为错误对象 |
| bundleName | string | 是 |
待卸载应用的包名。
|
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数
。
|
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,卸载应用成功,err为undefined,否则为错误对象
。
|
**错误码:**
...
...
@@ -181,9 +181,9 @@ uninstall(bundleName: string, installParam: InstallParam, callback: AsyncCallbac
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| 17700004 | The specified userId is not existed |
| 17700020 | The specified bundle is pre-installed bundle which cannot be uninstalled |
| 17700101 | The system service is excepted |
| 17700004 | The specified userId is not existed
.
|
| 17700020 | The specified bundle is pre-installed bundle which cannot be uninstalled
.
|
| 17700101 | The system service is excepted
.
|
**示例:**
...
...
@@ -229,9 +229,9 @@ recover(bundleName: string, installParam: InstallParam, callback: AsyncCallback&
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 |
包名
|
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,回滚应用成功,err为undefined,否则为错误对象 |
| bundleName | string | 是 |
待恢复应用的包名。
|
| installParam |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数
。
|
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,回滚应用成功,err为undefined,否则为错误对象
。
|
**错误码:**
...
...
@@ -239,7 +239,7 @@ recover(bundleName: string, installParam: InstallParam, callback: AsyncCallback&
| 错误码ID | 错误信息 |
| -------- | ----------------------------------- |
| 17700004 | The specified userId is not existed |
| 17700004 | The specified userId is not existed
.
|
**示例:**
...
...
@@ -271,7 +271,7 @@ try {
## HashParam
应用程序安装卸载
信息
应用程序安装卸载
哈希参数信息。
**系统能力:**
SystemCapability.BundleManager.BundleFramework.Core
...
...
@@ -279,12 +279,12 @@ try {
| 参数名 | 类型 | 说明 |
| ---------- | ------ | ---------------- |
| moduleName | string | 应用程序模块名称 |
| hashValue | string | 哈希值 |
| moduleName | string | 应用程序模块名称
。
|
| hashValue | string | 哈希值
。
|
## InstallParam
应用程序安装
卸载信息
应用程序安装
、卸载或恢复需指定的参数信息。
**系统能力:**
SystemCapability.BundleManager.BundleFramework.Core
...
...
@@ -292,8 +292,8 @@ try {
| 参数名 | 类型 | 说明 |
| ------------------------------ | ------------------------------ | ------------------ |
| userId | number | 指示用户id,可使用
[
queryOsAccountLocalIdFromProcess
](
js-apis-osAccount.md#queryosaccountlocalidfromprocess9
)
获取当前进程所在用户 |
| installFlag | number | 指示安装标志,枚举值:0:应用初次安装,1:应用覆盖安装 |
| isKeepData | boolean | 卸载时是否保留数据目录 |
| hashParams | Array
<
[
HashParam
](
#hashparam
)
>
| 哈希值参数 |
| crowdtestDeadline| number | 测试包的被杀死时间 |
\ No newline at end of file
| userId | number | 指示用户id,可使用
[
queryOsAccountLocalIdFromProcess
](
js-apis-osAccount.md#queryosaccountlocalidfromprocess9
)
获取当前进程所在用户。 |
| installFlag | number | 指示安装标志,枚举值:0:应用初次安装,1:应用覆盖安装。 |
| isKeepData | boolean | 卸载时是否保留数据目录。 |
| hashParams | Array
<
[
HashParam
](
#hashparam
)
>
| 哈希值参数。 |
| crowdtestDeadline| number |
[
众测
](
https://developer.huawei.com/consumer/cn/agconnect/crowd-test/
)
截止日期。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md
浏览文件 @
64241d6c
...
...
@@ -2,18 +2,18 @@
本模块支持launcher应用所需的查询能力,支持
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
、
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
信息的查询。
> **说明:**
> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
t
ypescript
```
t
s
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
```
## launcherBundlemanager.
**getLauncherAbilityInfo<sup>9+</sup>**
## launcherBundlemanager.
getLauncherAbilityInfo<sup>9+</sup>
getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallback
<Array
\<[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
>) : void;
...
...
@@ -36,18 +36,20 @@ getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallba
| 类型 | 说明 |
| ----------------------------------- | --------------------------------------------------- |
| AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | callback形式返回bundle包含的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
信息 |
| AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | callback形式返回bundle包含的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
信息。 |
**错误码:**
**相关错误码**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码
| 错误信息(此处仅提供错误抛出的关键信息)
|
| 错误码
ID | 错误信息
|
| -------- | ---------------------------------------- |
| 17700001 | The specified bundle name is not found. |
| 17700004 | The specified user
i
d is not found. |
| 17700004 | The specified user
I
d is not found. |
**示例:**
```
t
ypescript
```
t
s
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
try
{
...
...
@@ -62,6 +64,8 @@ try {
}
```
## launcherBundlemanager.getLauncherAbilityInfo<sup>9+</sup>
getLauncherAbilityInfo(bundleName: string, userId: number) : Promise
<Array
\<[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
>;
查询指定bundleName及用户的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
。
...
...
@@ -76,21 +80,23 @@ getLauncherAbilityInfo(bundleName: string, userId: number) : Promise<Array\<[Lau
| 参数名 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | 是 | 应用程序包名称
。|
| bundleName | string | 是 | 应用程序包名称。|
| userId | number | 是 | 被查询的用户id。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------- | -------------------------------------------------- |
| Promise
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | Promise形式返回bundle包含的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
信息 |
| Promise
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | Promise形式返回bundle包含的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
信息。 |
**错误码:**
**相关错误码**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码
| 错误信息(此处仅提供错误抛出的关键信息)
|
| 错误码
ID | 错误信息
|
| -------- | ---------------------------------------- |
| 17700001 | The specified bundle name is not found. |
| 17700004 | The specified user
id is not found.
|
| 17700004 | The specified user
Id is not found.
|
**示例:**
...
...
@@ -130,17 +136,19 @@ getAllLauncherAbilityInfo(userId: number, callback: AsyncCallback<Array\<[Launch
| 类型 | 说明 |
| ----------------------------------- | ------------------------------------------------------- |
| AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | callback形式返回指定用户下所有应用的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
|
| AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | callback形式返回指定用户下所有应用的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
。
|
**
相关错误码
**
**
错误码:
**
| 错误码 | 错误信息(此处仅提供错误抛出的关键信息) |
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 17700004 | The specified user
i
d is not found. |
| 17700004 | The specified user
I
d is not found. |
示例:
```
t
ypescript
```
t
s
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
try
{
...
...
@@ -149,11 +157,12 @@ try {
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
console
.
log
(
"
data is
"
+
JSON
.
stringify
(
data
));
})
})
;
}
catch
(
errData
)
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
```
## launcherBundlemanager.getAllLauncherAbilityInfo<sup>9+</sup>
getAllLauncherAbilityInfo(userId: number) : Promise
<Array
\<[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
>;
...
...
@@ -175,11 +184,19 @@ getAllLauncherAbilityInfo(userId: number) : Promise<Array\<[LauncherAbilityInfo]
| 类型 | 说明 |
| ----------------------------- | ------------------------------------------------------ |
| Promise
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | Promise形式返回指定用户下所有应用的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
|
| Promise
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
>
> | Promise形式返回指定用户下所有应用的
[
LauncherAbilityInfo
](
js-apis-bundleManager-launcherAbilityInfo.md
)
。
|
示例:
**错误码:**
```
typescript
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 17700004 | The specified userId is not found. |
**示例:**
```
ts
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
try
{
...
...
@@ -187,7 +204,7 @@ try {
console
.
log
(
"
data is
"
+
JSON
.
stringify
(
data
));
}).
catch
(
errData
=>
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
})
})
;
}
catch
(
errData
)
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
...
...
@@ -197,7 +214,7 @@ try {
getShortcutInfo(bundleName :string, callback: AsyncCallback
<Array
\<[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
>) : void;
查询当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
查询当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
...
...
@@ -213,11 +230,19 @@ getShortcutInfo(bundleName :string, callback: AsyncCallback<Array\<[ShortcutInfo
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| AsyncCallback
\<
Array
<
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
> | callback形式返回当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
|
| AsyncCallback
\<
Array
<
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
> | callback形式返回当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
。
|
示例:
**错误码:**
```
typescript
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 17700001 | The specified bundle name is not found. |
**示例:**
```
ts
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
try
{
...
...
@@ -226,14 +251,18 @@ try {
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
console
.
log
(
"
data is
"
+
JSON
.
stringify
(
data
));
})
})
;
}
catch
(
errData
)
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
```
## launcherBundlemanager.getShortcutInfo<sup>9+</sup>
getShortcutInfo(bundleName : string) : Promise
<Array
\<[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
>;
查询当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统接口:**
此接口为系统接口
...
...
@@ -248,11 +277,19 @@ getShortcutInfo(bundleName : string) : Promise<Array\<[ShortcutInfo](js-apis-bun
| 类型 | 说明 |
| ---------------------- | ----------------------------------------------- |
| Promise
\<
Array
<
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
> | Promise形式返回当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
|
| Promise
\<
Array
<
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
>
> | Promise形式返回当前用户下指定应用的
[
ShortcutInfo
](
js-apis-bundleManager-shortcutInfo.md
)
。
|
示例:
**错误码:**
```
typescript
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 17700001 | The specified bundle name is not found. |
**示例:**
```
ts
import
launcherBundleManager
from
'
@ohos.bundle.launcherBundleManager
'
;
try
{
...
...
@@ -260,7 +297,7 @@ try {
console
.
log
(
"
data is
"
+
JSON
.
stringify
(
data
));
}).
catch
(
errData
=>
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
})
})
;
}
catch
(
errData
)
{
console
.
log
(
`errData is errCode:
${
errData
.
code
}
message:
${
errData
.
message
}
`
);
}
...
...
zh-cn/application-dev/reference/apis/js-apis-zlib.md
浏览文件 @
64241d6c
...
...
@@ -2,7 +2,7 @@
本模块提供压缩解压缩文件的能力
> **说明:**
> **说明:**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...
...
@@ -25,9 +25,9 @@ zipFile(inFile: string, outFile: string, options: Options): Promise<void>
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
Stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定压缩结果的文件路径(文件的扩展名zip) |
| options |
[
Options
](
#options
)
| 否 | 压缩的可选参数
|
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
Stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定压缩结果的文件路径(文件的扩展名zip)
。
|
| options |
[
Options
](
#options
)
| 否 | 压缩的可选参数
。
|
**返回值:**
...
...
@@ -38,7 +38,7 @@ zipFile(inFile: string, outFile: string, options: Options): Promise<void>
**示例1:**
```
typescript
//【压缩文件 例子1】
//【压缩文件 例子1】
import
zlib
from
'
@ohos.zlib
'
;
let
inFile
=
'
/xxx/filename.xxx
'
;
let
outFile
=
'
/xxx/xxx.zip
'
;
...
...
@@ -89,9 +89,9 @@ unzipFile(inFile:string, outFile:string, options: Options): Promise<void>
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定的解压文件路径 |
| options |
[
Options
](
#options
)
| 否 | 解压的可选参数 |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定的解压文件路径
。
|
| options |
[
Options
](
#options
)
| 否 | 解压的可选参数
。
|
**返回值:**
...
...
@@ -102,7 +102,7 @@ unzipFile(inFile:string, outFile:string, options: Options): Promise<void>
**示例:**
```
typescript
// 【解压缩 例子1】
// 【解压缩 例子1】
import
zlib
from
'
@ohos.zlib
'
;
let
inFile
=
'
/xx/xxx.zip
'
;
let
outFile
=
'
/xxx
'
;
...
...
@@ -131,16 +131,16 @@ compressFile(inFile: string, outFile: string, options: Options, callback: AsyncC
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定的解压文件路径 |
| options |
[
Options
](
#options
)
| 是 | 压缩的配置参数 |
| AsyncCallback
<
**void**
>
| callback | 否 | 压缩时的回调函数 |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定的解压文件路径
。
|
| options |
[
Options
](
#options
)
| 是 | 压缩的配置参数
。
|
| AsyncCallback
<
**void**
>
| callback | 否 | 压缩时的回调函数
。
|
**相关错误码**
以下错误码的详细介绍请参见
[
ohos.zlib错误码
](
../errorcodes/errorcode-zlib.md
)
。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 401 | wrong param type |
| -------- | --------------------------------------|
| 900001 | The Input source file is invalid. |
| 900002 | The Input destination file is invalid. |
...
...
@@ -179,15 +179,16 @@ compressFile(inFile: string, outFile: string, options: Options): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定的解压文件路径 |
| options |
[
Options
](
#options
)
| 是 | 压缩的配置参数 |
| inFile | string | 是 | 指定压缩的文件夹路径或者文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定的解压文件路径
。
|
| options |
[
Options
](
#options
)
| 是 | 压缩的配置参数
。
|
**相关错误码**
以下错误码的详细介绍请参见
[
ohos.zlib错误码
](
../errorcodes/errorcode-zlib.md
)
。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 401 | wrong param type |
| -------- | ------------------------------------- |
| 900001 | The Input source file is invalid. |
| 900002 | The Input destination file is invalid. |
...
...
@@ -228,16 +229,17 @@ decompressFile(inFile: string, outFile: string, options: Options, callback: Asyn
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定的待解压缩文件的文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定的解压后的目录路径 |
| options |
[
Options
](
#options
)
| 是 | 解压的配置参数 |
| AsyncCallback
<
**void**
>
| callback | 否 | 解压是的回调函数 |
| inFile | string | 是 | 指定的待解压缩文件的文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定的解压后的目录路径
。
|
| options |
[
Options
](
#options
)
| 是 | 解压的配置参数
。
|
| AsyncCallback
<
**void**
>
| callback | 否 | 解压是的回调函数
。
|
**相关错误码**
| 错误码ID | 错误信息 |
| -------- | -------------------------------------- |
| 401 | wrong param type |
以下错误码的详细介绍请参见
[
ohos.zlib错误码
](
../errorcodes/errorcode-zlib.md
)
。
| 错误码ID | 错误信息
| -------- | --------------------------------------|
| 900001 | The Input source file is invalid. |
| 900002 | The Input destination file is invalid. |
...
...
@@ -276,15 +278,16 @@ decompressFile(inFile: string, outFile: string, options: Options): Promise\<void
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
| inFile | string | 是 | 指定的待解压缩文件的文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
|
| outFile | string | 是 | 指定的解压后的目录路径 |
| options |
[
Options
](
#options
)
| 是 | 解压时的配置参数 |
| inFile | string | 是 | 指定的待解压缩文件的文件路径,对应的路径参考
[
FA模型
](
js-apis-Context.md
)
,
[
stage模型
](
js-apis-application-context.md
)
。
|
| outFile | string | 是 | 指定的解压后的目录路径
。
|
| options |
[
Options
](
#options
)
| 是 | 解压时的配置参数
。
|
**相关错误码**
| 错误码 | 错误信息 |
| ------ | -------------------------------------- |
| 401 | wrong param type |
以下错误码的详细介绍请参见
[
ohos.zlib错误码
](
../errorcodes/errorcode-zlib.md
)
。
| 错误码ID | 错误信息 |
| ------ | ------------------------------------- |
| 900001 | The Input source file is invalid. |
| 900002 | The Input destination file is invalid. |
...
...
@@ -317,9 +320,9 @@ try {
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------- | ---- | --------------------------------------------------------- |
| level | CompressLeve | 否 | 参考
[
zip.CompressLevel枚举定义
](
#zipcompresslevel
)
|
| memLevel | MemLevel | 否 | 参考
[
zip.MemLevel枚举定义
](
#zipmemlevel
)
|
| strategy | CompressStrategy | 否 | 参考
[
zip.CompressStrategy枚举定义
](
#zipcompressstrategy
)
|
| level | CompressLeve | 否 | 参考
[
zip.CompressLevel枚举定义
](
#zipcompresslevel
)
。
|
| memLevel | MemLevel | 否 | 参考
[
zip.MemLevel枚举定义
](
#zipmemlevel
)
。
|
| strategy | CompressStrategy | 否 | 参考
[
zip.CompressStrategy枚举定义
](
#zipcompressstrategy
)
。
|
## zip.CompressLevel
...
...
@@ -327,10 +330,10 @@ try {
| 名称 | 值 | 说明 |
| ---------------------------------- | ---- | ----------------- |
| COMPRESS_LEVEL_NO_COMPRESSION | 0 | 压缩率为0压缩等级 |
| COMPRESS_LEVEL_BEST_SPEED | 1 | 最佳速度压缩等级 |
| COMPRESS_LEVEL_BEST_COMPRESSION | 9 | 最佳压缩等级 |
| COMPRESS_LEVEL_DEFAULT_COMPRESSION | -1 | 默认压缩等级 |
| COMPRESS_LEVEL_NO_COMPRESSION | 0 | 压缩率为0压缩等级
。
|
| COMPRESS_LEVEL_BEST_SPEED | 1 | 最佳速度压缩等级
。
|
| COMPRESS_LEVEL_BEST_COMPRESSION | 9 | 最佳压缩等级
。
|
| COMPRESS_LEVEL_DEFAULT_COMPRESSION | -1 | 默认压缩等级
。
|
## zip.MemLevel
...
...
@@ -338,9 +341,9 @@ try {
| 名称 | 值 | 说明 |
| ----------------- | ---- | -------------------------------- |
| MEM_LEVEL_MIN | 1 | zip 接口在压缩过程中最小使用内存 |
| MEM_LEVEL_MAX | 9 | zip 接口在压缩过程中最大使用内存 |
| MEM_LEVEL_DEFAULT | 8 | zip 接口在压缩过程中默认使用内存 |
| MEM_LEVEL_MIN | 1 | zip 接口在压缩过程中最小使用内存
。
|
| MEM_LEVEL_MAX | 9 | zip 接口在压缩过程中最大使用内存
。
|
| MEM_LEVEL_DEFAULT | 8 | zip 接口在压缩过程中默认使用内存
。
|
## zip.CompressStrategy
...
...
@@ -348,11 +351,11 @@ try {
| 名称 | 值 | 说明 |
| ---------------------------------- | ---- | ------------------------ |
| COMPRESS_STRATEGY_DEFAULT_STRATEGY | 0 | 常规数据策略 |
| COMPRESS_STRATEGY_FILTERED | 1 | 过滤器产生的数据压缩策略 |
| COMPRESS_STRATEGY_HUFFMAN_ONLY | 2 | 霍夫曼编码格式压缩策略 |
| COMPRESS_STRATEGY_RLE | 3 | 游标编码压缩策略 |
| COMPRESS_STRATEGY_FIXED | 4 | 固定的压缩策略 |
| COMPRESS_STRATEGY_DEFAULT_STRATEGY | 0 | 常规数据策略
。
|
| COMPRESS_STRATEGY_FILTERED | 1 | 过滤器产生的数据压缩策略
。
|
| COMPRESS_STRATEGY_HUFFMAN_ONLY | 2 | 霍夫曼编码格式压缩策略
。
|
| COMPRESS_STRATEGY_RLE | 3 | 游标编码压缩策略
。
|
| COMPRESS_STRATEGY_FIXED | 4 | 固定的压缩策略
。
|
## zip.ErrorCode
...
...
@@ -360,5 +363,5 @@ try {
| 名称 | 值 | 说明 |
| ---------------- | ---- | ------------ |
| ERROR_CODE_OK | 0 | 函数调用成功 |
| ERROR_CODE_ERRNO | -1 | 函数调用失败 |
| ERROR_CODE_OK | 0 | 函数调用成功
。
|
| ERROR_CODE_ERRNO | -1 | 函数调用失败
。
|
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录