Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 4f2c1724 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!11243 包管理API参考内容优化改进 

Merge pull request !11243 from xsz233/master
上级 3d5aa6f0 86314cca
隐藏空白更改
内联 并排
Showing with 583 addition and 333 deletion
zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
浏览文件 @ 4f2c1724
...@@ -41,7 +41,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -41,7 +41,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- | | ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 | | bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | | callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 |
...@@ -69,7 +69,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -69,7 +69,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ----------------------------------------------------- | | ---------- | ------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 | | bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
**返回值：** **返回值：**
...@@ -216,7 +216,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -216,7 +216,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- | | -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | | callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回程序信息。 |
## innerBundleManager.getAllLauncherAbilityInfos<sup>(deprecated)</sup> ## innerBundleManager.getAllLauncherAbilityInfos<sup>(deprecated)</sup>
...@@ -242,7 +242,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -242,7 +242,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ----------------------------------------------------- | | ------ | ------ | ---- | ----------------------------------------------------- |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-Bundle-distributedBundle.md
浏览文件 @ 4f2c1724
# distributedBundle模块(JS端SDK接口) # distributedBundle模块(JS端SDK接口)
本模块提供分布式包的管理 本模块提供分布式包的管理。
> **说明：** > **说明：**
> >
...@@ -109,8 +109,8 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -109,8 +109,8 @@ SystemCapability.BundleManager.DistributedBundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- | | ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息,最大数组长度为10 | | elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息，最大数组长度为10。 |
| callback | AsyncCallback<Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回远程基本能力信息。 | | callback | AsyncCallback< Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回远程基本能力信息。 |
...@@ -138,7 +138,7 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -138,7 +138,7 @@ SystemCapability.BundleManager.DistributedBundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------------ | --------------------------------------------------- | ---- | ----------------------- | | ------------ | --------------------------------------------------- | ---- | ----------------------- |
| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息,最大数组长度为10。 | | elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息，最大数组长度为10。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-Bundle.md
浏览文件 @ 4f2c1724
# Bundle模块(JS端SDK接口) # Bundle模块(JS端SDK接口)
本模块提供应用信息查询能力，支持BundleInfo、ApplicationInfo、Ability、ExtensionAbility、应用状态等信息的查询 本模块提供应用信息查询能力，支持[包信息](js-apis-bundle-BundleInfo.md)、[应用信息](js-apis-bundle-ApplicationInfo.md)、[Ability组件信息](js-apis-bundle-AbilityInfo.md)等信息的查询，以及应用禁用状态的查询、设置等。
> **说明：** > **说明：**
> >
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
```js ```ts
import bundle from '@ohos.bundle'; import bundle from '@ohos.bundle';
``` ```
## 权限列表 ## 权限列表
| 权限 | 权限等级 | 描述 | | 权限 | 权限等级 | 描述 |
| ------------------------------------------ | ------------ | ------------------ | |--------------------------------------------|--------------|---------------|
| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息 | | ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息 |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 | | ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
| ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用 | | ohos.permission.INSTALL_BUNDLE | system_core | 可安装、卸载应用 |
| ohos.permission.MANAGE_DISPOSED_APP_STATUS | system_core | 可设置和查询应用的处置状态 | | ohos.permission.MANAGE_DISPOSED_APP_STATUS | system_core | 可设置和查询应用的处置状态 |
权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明)。 权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明)。
...@@ -28,11 +28,12 @@ import bundle from '@ohos.bundle'; ...@@ -28,11 +28,12 @@ import bundle from '@ohos.bundle';
getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\<ApplicationInfo> getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\<ApplicationInfo>
以异步方法根据给定的包名获取ApplicationInfo，使用Promise形式返回结果。 以异步方法根据给定的包名获取ApplicationInfo。使用Promise异步回调。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -43,7 +44,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -43,7 +44,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------------------------------------------ | | ----------- | ------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 要查询的应用程序包名称。 | | bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
**返回值：** **返回值：**
...@@ -54,7 +55,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -54,7 +55,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 0; let bundleFlags = 0;
let userId = 100; let userId = 100;
...@@ -77,6 +78,7 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, call ...@@ -77,6 +78,7 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, call
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -87,13 +89,13 @@ SystemCapability.BundleManager.BundleFramework ...@@ -87,13 +89,13 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 要查询的应用程序包名称。 | | bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 0; let bundleFlags = 0;
let userId = 100; let userId = 100;
...@@ -114,10 +116,10 @@ bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => { ...@@ -114,10 +116,10 @@ bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => {
getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<ApplicationInfo>): void getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<ApplicationInfo>): void
以异步方法根据给定的包名获取ApplicationInfo，使用callback形式返回结果。 以异步方法根据给定的包名获取ApplicationInfo，使用callback形式返回结果。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -128,12 +130,12 @@ SystemCapability.BundleManager.BundleFramework ...@@ -128,12 +130,12 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 要查询的应用程序包名称。 | | bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 0; let bundleFlags = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => { bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
...@@ -152,7 +154,7 @@ bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => { ...@@ -152,7 +154,7 @@ bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array\<BundleInfo>> getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array\<BundleInfo>>
以异步方法获取系统中所有可用的BundleInfo，使用Promise形式返回结果。 以异步方法获取指定用户所有的BundleInfo，使用Promise形式异步回调，
**需要权限：** **需要权限：**
...@@ -166,7 +168,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -166,7 +168,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------- | ---- | ------------------------------------------------------------ | | ---------- | ---------- | ---- | ------------------------------------------------------------ |
| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlag | BundleFlag | 是 | 用于指定返回的包信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
**返回值：** **返回值：**
...@@ -177,7 +179,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -177,7 +179,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleFlag = 0; let bundleFlag = 0;
let userId = 100; let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId) bundle.getAllBundleInfo(bundleFlag, userId)
...@@ -195,7 +197,7 @@ bundle.getAllBundleInfo(bundleFlag, userId) ...@@ -195,7 +197,7 @@ bundle.getAllBundleInfo(bundleFlag, userId)
getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array\<BundleInfo>>): void getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array\<BundleInfo>>): void
以异步方法获取系统中所有可用的BundleInfo，使用callback形式返回结果。 以异步方法获取当前用户所有的BundleInfo，使用callback形式返回结果。
**需要权限：** **需要权限：**
...@@ -209,12 +211,12 @@ SystemCapability.BundleManager.BundleFramework ...@@ -209,12 +211,12 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回所有可用的BundleInfo。 | | callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回所有可用的BundleInfo。 |
**示例：** **示例：**
```js ```ts
let bundleFlag = 0; let bundleFlag = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) => { bundle.getAllBundleInfo(bundleFlag, (err, data) => {
if (err) { if (err) {
...@@ -232,7 +234,7 @@ bundle.getAllBundleInfo(bundleFlag, (err, data) => { ...@@ -232,7 +234,7 @@ bundle.getAllBundleInfo(bundleFlag, (err, data) => {
getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback<Array\<BundleInfo>>): void getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback<Array\<BundleInfo>>): void
以异步方法获取系统中指定用户下所有可用的BundleInfo，使用callback形式返回结果。 以异步方法获取系统中指定用户下所有的BundleInfo，使用callback形式返回结果。
**需要权限：** **需要权限：**
...@@ -244,15 +246,16 @@ SystemCapability.BundleManager.BundleFramework ...@@ -244,15 +246,16 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | |------------|-------------------------------------------------------------------|-----|---------------------------------------------------------------------|
| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回所有可用的BundleInfo。 | | callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回指定用户下所有包的BundleInfo。 |
|
**示例：** **示例：**
```js ```ts
let bundleFlag = 0; let bundleFlag = 0;
let userId = 100; let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => { bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
...@@ -271,11 +274,12 @@ bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => { ...@@ -271,11 +274,12 @@ bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise\<BundleInfo> getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise\<BundleInfo>
以异步方法根据给定的包名获取BundleInfo，使用Promise形式返回结果。 以异步方法根据给定的包名获取BundleInfo，使用Promise异步回调。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -283,21 +287,21 @@ SystemCapability.BundleManager.BundleFramework ...@@ -283,21 +287,21 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------- | ---- | --------------------------------------- | | ----------- | ------------- | ---- |---------------------------------------------------------------------|
| bundleName | string | 是 | 包名 | | bundleName | string | 是 | 要查询的应用程序包名称 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| options | [BundleOptions](#bundleoptions) | 否 | 包含userid。 | | options | [BundleOptions](#bundleoptions) | 否 | 包含userid的查询选项。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| -------------------- | ---------------------------- | | -------------------- | ---------------------------- |
| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象，Promise中包含包信息。 | | Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Promise对象，获取成功时返回包信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 1; let bundleFlags = 1;
let options = { let options = {
...@@ -317,11 +321,12 @@ bundle.getBundleInfo(bundleName, bundleFlags, options) ...@@ -317,11 +321,12 @@ bundle.getBundleInfo(bundleName, bundleFlags, options)
getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>): void getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>): void
以异步方法根据给定的包名获取BundleInfo，使用callback形式返回结果。 以异步方法根据给定的包名获取BundleInfo，使用callback异步回调。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -329,15 +334,15 @@ SystemCapability.BundleManager.BundleFramework ...@@ -329,15 +334,15 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | | ----------- | ---------------------------------------------------------- | ---- |---------------------------------------------------------------------|
| bundleName | string | 是 | 包名 | | bundleName | string | 是 | 需要查询的应用程序包名称。 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 1; let bundleFlags = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => { bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
...@@ -356,11 +361,12 @@ bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => { ...@@ -356,11 +361,12 @@ bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback\<BundleInfo>): void getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback\<BundleInfo>): void
以异步方法根据给定的包名获取BundleInfo，使用callback形式返回结果。 以异步方法根据给定的包名获取BundleInfo，使用callback异步回调。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -371,13 +377,13 @@ SystemCapability.BundleManager.BundleFramework ...@@ -371,13 +377,13 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | | ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 包名 | | bundleName | string | 是 | 包名 |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag |
| options | [BundleOptions](#bundleoptions) | 是 | 包含userid。 | | options | [BundleOptions](#bundleoptions) | 是 | 包含userid。 |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let bundleFlags = 1; let bundleFlags = 1;
let options = { let options = {
...@@ -400,7 +406,7 @@ bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => { ...@@ -400,7 +406,7 @@ bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
getBundleInstaller(): Promise&lt;BundleInstaller&gt;; getBundleInstaller(): Promise&lt;BundleInstaller&gt;;
获取用于安装包的接口 获取用于安装包的接口，使用Promise异步回调，返回安装接口对象。
**需要权限：** **需要权限：**
...@@ -418,7 +424,17 @@ SystemCapability.BundleManager.BundleFramework ...@@ -418,7 +424,17 @@ SystemCapability.BundleManager.BundleFramework
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------------------------------ | -------------------------------------------- | | ------------------------------------------------------------ | -------------------------------------------- |
| Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 返回值为Promise对象，Promise中包含安装信息。 | | Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Promise对象，返回安装接口对象。 |
**示例：**
```ts
bundle.getBundleInstaller().then((data) => {
console.info('getBundleInstaller successfully.');
}).catch((error) => {
console.error('getBundleInstaller failed.');
});
```
## bundle.getBundleInstaller<sup>deprecated<sup> ## bundle.getBundleInstaller<sup>deprecated<sup>
...@@ -426,7 +442,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -426,7 +442,7 @@ SystemCapability.BundleManager.BundleFramework
getBundleInstaller(callback: AsyncCallback&lt;BundleInstaller&gt;): void; getBundleInstaller(callback: AsyncCallback&lt;BundleInstaller&gt;): void;
获取用于安装包的接口 获取用于安装包的接口，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -444,15 +460,26 @@ SystemCapability.BundleManager.BundleFramework ...@@ -444,15 +460,26 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ---------------- | | -------- | ------------------------------------------------------------ | ---- | ---------------- |
| callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 是 | 安装应用程序包。 | | callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 是 | 回调函数，返回安装接口对象。 |
**示例：**
```ts
bundle.getBundleInstaller((err, data) => {
if (err.code == 0) {
console.error('getBundleInstaller failed.');
} else {
console.info('getBundleInstaller successfully');
}
});
```
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup> ## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
> 从API version 9开始不再维护，建议使用[bundleManager.cleanBundleCacheFiles](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.cleanBundleCacheFiles](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles)替代。
cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback&lt;void&gt;): void; cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback&lt;void&gt;): void;
清除指定应用程序的缓存数据 清除指定应用程序的缓存数据，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -470,8 +497,22 @@ SystemCapability.BundleManager.BundleFramework ...@@ -470,8 +497,22 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------- | ---- | ------------------------------------- | | ---------- | ------------------- | ---- | ------------------------------------- |
| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. | | bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称。 |
| callback | AsyncCallback\<void> | 是 | 为返回操作结果而调用的回调。 | | callback | AsyncCallback\<void> | 是 | 回调函数。 |
**示例：**
```ts
let bundleName = "com.example.myapplication";
bundle.cleanBundleCacheFiles(bundleName, err => {
if (err) {
console.error('cleanBundleCacheFiles failed.');
} else {
console.info('cleanBundleCacheFiles successfully.');
}
});
```
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup> ## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
...@@ -479,7 +520,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -479,7 +520,7 @@ SystemCapability.BundleManager.BundleFramework
cleanBundleCacheFiles(bundleName: string): Promise&lt;void&gt; cleanBundleCacheFiles(bundleName: string): Promise&lt;void&gt;
清除指定应用程序的缓存数据 清除指定应用程序的缓存数据，使用Promise异步回调。
**需要权限：** **需要权限：**
...@@ -497,13 +538,25 @@ SystemCapability.BundleManager.BundleFramework ...@@ -497,13 +538,25 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------------------- | | ---------- | ------ | ---- | ------------------------------------- |
| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. | | bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ------------------------------------ | | ------------- | ------------------------------------ |
| Promise\<void> | 返回值为Promise对象，Promise中为空。 | | Promise\<void> | Promise对象，无返回结果的Promise对象。 |
**示例：**
```ts
let bundleName = "com.example.myapplication";
bundle.cleanBundleCacheFiles(bundleName).then(()=> {
console.info('cleanBundleCacheFiles successfully.');
}).catch(err=> {
console.error('cleanBundleCacheFiles failed.');
});
```
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup> ## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
...@@ -511,7 +564,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -511,7 +564,7 @@ SystemCapability.BundleManager.BundleFramework
setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void; setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;
设置是否启用指定的应用程序 设置是否启用指定的应用程序，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -527,11 +580,25 @@ SystemCapability.BundleManager.BundleFramework ...@@ -527,11 +580,25 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------- | ---- | ----------------------------------------------- | | ---------- | ------------------- | ---- |--------------------------------|
| bundleName | string | 是 | 应用程序包名称。 | | bundleName | string | 是 | 指示需要启用或禁用的应用程序包名称。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false表示禁用。 |
| callback | AsyncCallback\<void> | 是 | 为返回操作结果而调用的回调。 | | callback | AsyncCallback\<void> | 是 | 回调函数。 |
**示例：**
```ts
let bundleName = "com.example.myapplication";
bundle.setApplicationEnabled(bundleName, false, err => {
if (err) {
console.error('setApplicationEnabled failed.');
} else {
console.info('setApplicationEnabled successfully.');
}
});
```
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup> ## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
...@@ -539,7 +606,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -539,7 +606,7 @@ SystemCapability.BundleManager.BundleFramework
setApplicationEnabled(bundleName: string, isEnable: boolean): Promise&lt;void&gt; setApplicationEnabled(bundleName: string, isEnable: boolean): Promise&lt;void&gt;
设置是否启用指定的应用程序 设置是否启用指定的应用程序，使用Promise异步回调。
**需要权限：** **需要权限：**
...@@ -555,16 +622,28 @@ SystemCapability.BundleManager.BundleFramework ...@@ -555,16 +622,28 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------- | ---- | ----------------------------------------------- | | ---------- | ------- | ---- |------------------------------|
| bundleName | string | 是 | 应用程序包名称。 | | bundleName | string | 是 | 指示需要启用或禁用的应用程序包名称。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ------------------------------------ | | ------------- | ------------------------------------ |
| Promise\<void> | 返回值为Promise对象，Promise中为空。 | | Promise\<void> | Promise对象，无返回结果的Promise对象。 |
**示例：**
```ts
let bundleName = "com.example.myapplication";
bundleManager.setApplicationEnabled(bundleName, false).then(()=> {
console.info('setApplicationEnabled successfully.');
}).catch(err=> {
console.error('setApplicationEnabled failed.');
});
```
## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup> ## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
...@@ -572,7 +651,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -572,7 +651,7 @@ SystemCapability.BundleManager.BundleFramework
setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void; setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;
设置是否启用指定的功能 设置是否启用指定的Ability组件，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -590,7 +669,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -590,7 +669,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- | | -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息。 | | info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息，指示需要设置启用状态的Ability。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 |
| callback | AsyncCallback\<void> | 是 | 为返回操作结果而调用的回调。 | | callback | AsyncCallback\<void> | 是 | 为返回操作结果而调用的回调。 |
...@@ -600,7 +679,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -600,7 +679,7 @@ SystemCapability.BundleManager.BundleFramework
setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise&lt;void&gt; setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise&lt;void&gt;
设置是否启用指定的功能 设置是否启用指定的Ability组件，使用Promise异步回调。
**需要权限：** **需要权限：**
...@@ -618,22 +697,44 @@ SystemCapability.BundleManager.BundleFramework ...@@ -618,22 +697,44 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- | | -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息。 | | info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息，指示需要设置启用状态的Ability。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | ------------------------------------ | | ------------- | ------------------------------------ |
| Promise\<void> | 返回值为Promise对象，Promise中为空。 | | Promise\<void> | Promise对象，无返回结果的Promise对象。 |
**示例：**
```ts
let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
let userId = 100;
let want = {
bundleName : "com.example.myapplication",
abilityName : "com.example.myapplication.MainAbility"
};
bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => {
console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));
bundle.setAbilityEnabled(abilityInfo, false).then(data => {
console.info('setAbilityEnabled successfully.');
}).catch(err => {
console.error('setAbilityEnabled failed:' + JSON.stringify(err));
})
}).catch(error => {
console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
});
```
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup> ## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
> 从API version 9开始不再维护，建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。
getPermissionDef(permissionName: string, callback: AsyncCallback&lt;PermissionDef&gt;): void; getPermissionDef(permissionName: string, callback: AsyncCallback&lt;PermissionDef&gt;): void;
按权限名称获取权限的详细信息 按权限名称获取权限的详细信息，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -651,16 +752,29 @@ SystemCapability.BundleManager.BundleFramework ...@@ -651,16 +752,29 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------ | | -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------ |
| permissionName | string | 是 | 指定权限的名称。 | | permissionName | string | 是 | 需要查询的权限的名称。 |
| callback | AsyncCallback<[PermissionDef](js-apis-bundle-PermissionDef)> | 是 | 程序启动作为入参的回调函数，返回定义的权限信息。 | | callback | AsyncCallback<[PermissionDef](js-apis-bundle-PermissionDef)> | 是 | 程序启动作为入参的回调函数，返回定义的权限信息。 |
**示例：**
```ts
let permission = "ohos.permission.GET_BUNDLE_INFO";
bundleManager.getPermissionDef(permission, (err, data) => {
if (err) {
console.error('getPermissionDef failed:' + err.message);
} else {
console.info('getPermissionDef successfully:' + JSON.stringify(data));
}
});
```
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup> ## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
> 从API version 9开始不再维护，建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。
getPermissionDef(permissionName: string): Promise&lt;PermissionDef&gt; getPermissionDef(permissionName: string): Promise&lt;PermissionDef&gt;
按权限名称获取权限的详细信息 按权限名称获取权限的详细信息，使用promise异步回调。。
**需要权限：** **需要权限：**
...@@ -678,14 +792,24 @@ SystemCapability.BundleManager.BundleFramework ...@@ -678,14 +792,24 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------ | ---- | ---------------- | | -------------- | ------ | ---- | ---------------- |
| permissionName | string | 是 | 指定权限的名称。 | | permissionName | string | 是 | 需要查询的权限的名称。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------------------------ | ------------------------------------------------------ | | ------------------------------------------------------ | ------------------------------------------------------ |
| Promise<[PermissionDef](js-apis-bundle-PermissionDef)> | 返回值为Promise对象，Promise中包含定义的权限信息对象。 | | Promise<[PermissionDef](js-apis-bundle-PermissionDef)> | Promise对象，获取成功时返回权限详细信息。 |
**示例：**
```ts
let permissionName = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permissionName).then((data) => {
console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
}).catch(error => {
console.error('getPermissionDef failed. Cause: ' + error.message);
});
```
## bundle.getAllApplicationInfo<sup>deprecated<sup> ## bundle.getAllApplicationInfo<sup>deprecated<sup>
...@@ -693,7 +817,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -693,7 +817,7 @@ SystemCapability.BundleManager.BundleFramework
getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array\<ApplicationInfo>> getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array\<ApplicationInfo>>
获取指定用户下所有已安装的应用信息，通过Promise获取返回值。 获取指定用户下所有已安装的应用信息，使用promise异步回调。
**需要权限：** **需要权限：**
...@@ -707,18 +831,18 @@ SystemCapability.BundleManager.BundleFramework ...@@ -707,18 +831,18 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------------------------------------------ | | ----------- | ------ | ---- | ------------------------------------------------------------ |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| -------------------------------- | ------------------------------- | | -------------------------------- | ------------------------------- |
| Promise<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 返回值为Promise对象，Promise中包含应用信息列表。 | | Promise<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | Promise对象，获取成功时返回应用信息列表。 |
**示例：** **示例：**
```js ```ts
let bundleFlags = 8; let bundleFlags = 8;
let userId = 100; let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId) bundle.getAllApplicationInfo(bundleFlags, userId)
...@@ -735,7 +859,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId) ...@@ -735,7 +859,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId)
getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array\<ApplicationInfo>>): void getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array\<ApplicationInfo>>): void
获取指定用户下所有已安装的应用信息，使用callback形式返回结果。 获取指定用户下所有已安装的应用信息，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -749,14 +873,14 @@ SystemCapability.BundleManager.BundleFramework ...@@ -749,14 +873,14 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 | | callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 |
**示例：** **示例：**
```js ```ts
let bundleFlags = 8; let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId = 100; let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => { bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
if (err) { if (err) {
...@@ -774,7 +898,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => { ...@@ -774,7 +898,7 @@ bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array\<ApplicationInfo>>) : void; getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array\<ApplicationInfo>>) : void;
获取所有已安装的应用信息，使用callback形式返回结果。 获取所有已安装的应用信息，使用callback异步回调。
**需要权限：** **需要权限：**
...@@ -788,13 +912,13 @@ SystemCapability.BundleManager.BundleFramework ...@@ -788,13 +912,13 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 | | callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 |
**示例：** **示例：**
```js ```ts
let bundleFlags = 8; let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
bundle.getAllApplicationInfo(bundleFlags, (err, data) => { bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
if (err) { if (err) {
console.error('Operation failed. Cause: ' + JSON.stringify(err)); console.error('Operation failed. Cause: ' + JSON.stringify(err));
...@@ -810,7 +934,7 @@ bundle.getAllApplicationInfo(bundleFlags, (err, data) => { ...@@ -810,7 +934,7 @@ bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise\<BundleInfo> getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise\<BundleInfo>
以异步方法获取有关HAP包中包含的应用程序包的信息，使用Promise形式返回结果。 获取有关HAP包中包含的应用程序包的信息，使用Promise形式返回结果。
**系统能力：** **系统能力：**
...@@ -820,8 +944,8 @@ SystemCapability.BundleManager.BundleFramework ...@@ -820,8 +944,8 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------ | | ---------- | ------ | ---- | ------------ |
| hapFilePath | string | 是 | HAP存放路径。路径应指向当前应用程序的数据目录的相对目录。 | | hapFilePath | string | 是 | HAP存放路径。支持当前应用程序的绝对路径和数据目录沙箱路径。 |
| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -830,8 +954,8 @@ SystemCapability.BundleManager.BundleFramework ...@@ -830,8 +954,8 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let hapFilePath = "/data/xxx/test.hap"; let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0; let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags) bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => { .then((data) => {
...@@ -857,14 +981,14 @@ SystemCapability.BundleManager.BundleFramework ...@@ -857,14 +981,14 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------ | | ---------- | ------ | ---- | ------------ |
| hapFilePath | string | 是 | HAP存放路径。路径应指向当前应用程序的数据目录的相对目录。 | | hapFilePath | string | 是 | HAP存放路径，支持当前应用程序的绝对路径和数据目录沙箱路径。 |
| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag | | bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回HAP包中包含的应用程序包的信息。| | callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回HAP包中包含的应用程序包的信息。|
**示例：** **示例：**
```js ```ts
let hapFilePath = "/data/xxx/test.hap"; let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0; let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => { bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
if (err) { if (err) {
...@@ -882,11 +1006,12 @@ bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => { ...@@ -882,11 +1006,12 @@ bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
getAbilityInfo(bundleName: string, abilityName: string): Promise\<AbilityInfo> getAbilityInfo(bundleName: string, abilityName: string): Promise\<AbilityInfo>
通过包名称和abilityName获取Ability信息，使用Promise形式返回结果。 通过包名称和组件名获取Ability组件信息，使用Promise形式异步回调。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -894,10 +1019,10 @@ SystemCapability.BundleManager.BundleFramework ...@@ -894,10 +1019,10 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------- | | ----------- | ------ | ---- |------------|
| bundleName | string | 是 | 应用程序包名。 | | bundleName | string | 是 | 应用程序包名称。 |
| abilityName | string | 是 | Ability名称。 | | abilityName | string | 是 | Ability组件名称。 |
**返回值：** **返回值：**
...@@ -907,7 +1032,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -907,7 +1032,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName) bundle.getAbilityInfo(bundleName, abilityName)
...@@ -924,11 +1049,12 @@ bundle.getAbilityInfo(bundleName, abilityName) ...@@ -924,11 +1049,12 @@ bundle.getAbilityInfo(bundleName, abilityName)
getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\<AbilityInfo>): void; getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\<AbilityInfo>): void;
通过包名称和abilityName获取Ability信息，使用callback形式返回结果。 通过包名称和组件名获取Ability组件信息，使用callback形式返回结果。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -936,15 +1062,15 @@ SystemCapability.BundleManager.BundleFramework ...@@ -936,15 +1062,15 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------ | ---- | ---------------- | | ----------- | ------------ | ---- |----------------------------|
| bundleName | string | 是 | 应用程序包名。 | | bundleName | string | 是 | 应用程序包名称。 |
| abilityName | string | 是 | Ability名称。 | | abilityName | string | 是 | Ability名称。 |
| callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | | callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) => { bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
...@@ -962,11 +1088,12 @@ bundle.getAbilityInfo(bundleName, abilityName, (err, data) => { ...@@ -962,11 +1088,12 @@ bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
getAbilityLabel(bundleName: string, abilityName: string): Promise\<string> getAbilityLabel(bundleName: string, abilityName: string): Promise\<string>
通过包名称和abilityName获取应用名称，使用Promise形式返回结果。 通过包名称和ability名称获取应用名称，使用Promise形式返回结果。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -974,10 +1101,10 @@ SystemCapability.BundleManager.BundleFramework ...@@ -974,10 +1101,10 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------- | |-------------|--------|-----|------------|
| bundleName | string | 是 | 应用程序包名。 | | bundleName | string | 是 | 应用程序包名称。 |
| abilityName | string | 是 | Ability名称。 | | abilityName | string | 是 | Ability名称。 |
**返回值：** **返回值：**
...@@ -987,7 +1114,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -987,7 +1114,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName) bundle.getAbilityLabel(bundleName, abilityName)
...@@ -1004,11 +1131,12 @@ bundle.getAbilityLabel(bundleName, abilityName) ...@@ -1004,11 +1131,12 @@ bundle.getAbilityLabel(bundleName, abilityName)
getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback\<string>): void getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback\<string>): void
通过包名称和abilityName获取应用名称，使用callback形式返回结果。 通过包名称和Ability组件名获取应用名称，使用callback形式返回结果。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1016,15 +1144,15 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1016,15 +1144,15 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------- | ---- | ---------------- | |-------------|------------------------|-----|-------------------------|
| bundleName | string | 是 | 应用程序包名。 | | bundleName | string | 是 | 应用程序包名称。 |
| abilityName | string | 是 | Ability名称。 | | abilityName | string | 是 | Ability名称。 |
| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回应用名称信息。 | | callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回应用名称信息。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) => { bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
...@@ -1062,7 +1190,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1062,7 +1190,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{ bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
...@@ -1095,7 +1223,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1095,7 +1223,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{ bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
...@@ -1135,7 +1263,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1135,7 +1263,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName) bundle.isApplicationEnabled(bundleName)
.then((data) => { .then((data) => {
...@@ -1166,7 +1294,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1166,7 +1294,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName, (err, data) => { bundle.isApplicationEnabled(bundleName, (err, data) => {
if (err) { if (err) {
...@@ -1183,11 +1311,12 @@ bundle.isApplicationEnabled(bundleName, (err, data) => { ...@@ -1183,11 +1311,12 @@ bundle.isApplicationEnabled(bundleName, (err, data) => {
queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise<Array\<AbilityInfo>> queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise<Array\<AbilityInfo>>
以异步方法根据给定的意图获取Ability信息，使用Promise形式返回结果。 以异步方法根据给定的意图获取Ability组件信息，使用Promise形式返回结果。
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1198,8 +1327,8 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1198,8 +1327,8 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ------------------------------------- | | ----------- | ------ | ---- | ------------------------------------- |
| want | [Want](js-apis-application-Want.md) | 是 | 包含要查询的应用程序包名称的意图。 | | want | [Want](js-apis-application-Want.md) | 是 | 包含要查询的应用程序包名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag | | bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 |
**返回值：** **返回值：**
...@@ -1209,7 +1338,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1209,7 +1338,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleFlags = 0; let bundleFlags = 0;
let userId = 100; let userId = 100;
let want = { let want = {
...@@ -1237,6 +1366,7 @@ queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: As ...@@ -1237,6 +1366,7 @@ queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: As
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1244,16 +1374,16 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1244,16 +1374,16 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | |-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
| want | [Want](js-apis-application-Want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 | | want | [Want](js-apis-application-Want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag | | bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0 | | userId | number | 是 | 用户ID。取值范围：大于等于0。 |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | | callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |
**示例：** **示例：**
```js ```ts
let bundleFlags = 0; let bundleFlags = 0;
let userId = 100; let userId = 100;
let want = { let want = {
...@@ -1280,6 +1410,7 @@ queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Arra ...@@ -1280,6 +1410,7 @@ queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Arra
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1287,15 +1418,15 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1287,15 +1418,15 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | |-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
| want | [Want](js-apis-application-Want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 | | want | [Want](js-apis-application-Want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 |
| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。默认值：0，取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag | | bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | | callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 |
**示例：** **示例：**
```js ```ts
let bundleFlags = 0; let bundleFlags = 0;
let want = { let want = {
bundleName : "com.example.myapplication", bundleName : "com.example.myapplication",
...@@ -1341,7 +1472,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1341,7 +1472,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName) bundle.getLaunchWantForBundle(bundleName)
.then((data) => { .then((data) => {
...@@ -1376,7 +1507,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1376,7 +1507,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) => { bundle.getLaunchWantForBundle(bundleName, (err, data) => {
if (err) { if (err) {
...@@ -1409,11 +1540,11 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1409,11 +1540,11 @@ SystemCapability.BundleManager.BundleFramework
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------- | --------------------------------- | | ---------------- | --------------------------------- |
| Promise\<string> | 返回值为Promise对象，Promise中包含指定uid的包名。 | | Promise\<string> | 返回值为Promise对象，Promise中包含指定uid的包名称。 |
**示例：** **示例：**
```js ```ts
let uid = 20010005; let uid = 20010005;
bundle.getNameForUid(uid) bundle.getNameForUid(uid)
.then((data) => { .then((data) => {
...@@ -1437,14 +1568,14 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1437,14 +1568,14 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ----------------------------------------------- | |----------|------------------------|-----|----------------------------|
| uid | number | 是 | 要查询的uid。 | | uid | number | 是 | 要查询的uid。 |
| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回指定uid的包名。 | | callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回指定uid的包名称。 |
**示例：** **示例：**
```js ```ts
let uid = 20010005; let uid = 20010005;
bundle.getNameForUid(uid, (err, data) => { bundle.getNameForUid(uid, (err, data) => {
if (err) { if (err) {
...@@ -1467,6 +1598,7 @@ getAbilityIcon(bundleName: string, abilityName: string): Promise\<image.PixelMap ...@@ -1467,6 +1598,7 @@ getAbilityIcon(bundleName: string, abilityName: string): Promise\<image.PixelMap
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1474,10 +1606,10 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1474,10 +1606,10 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------- | | ----------- | ------ | ---- |-----------------|
| bundleName | string | 是 | 要查询的bundleName。 | | bundleName | string | 是 | 要查询的应用包名。 |
| abilityName | string | 是 | 要查询的abilityName。 | | abilityName | string | 是 | 要查询的Ability组件名。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1486,7 +1618,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1486,7 +1618,7 @@ SystemCapability.BundleManager.BundleFramework
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName) bundle.getAbilityIcon(bundleName, abilityName)
...@@ -1508,6 +1640,8 @@ getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\ ...@@ -1508,6 +1640,8 @@ getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\
**需要权限：** **需要权限：**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
<br>获取调用方自己的信息时不需要权限。
**系统能力：** **系统能力：**
...@@ -1515,15 +1649,15 @@ SystemCapability.BundleManager.BundleFramework ...@@ -1515,15 +1649,15 @@ SystemCapability.BundleManager.BundleFramework
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------------------- | ---- | ---------------------------------------- | | ----------- | ---------------------------------------- | ---- |-------------------------------------------------|
| bundleName | string | 是 | 要查询的bundleName。 | | bundleName | string | 是 | 要查询的应用包名称。 |
| abilityName | string | 是 | 要查询的abilityName。 | | abilityName | string | 是 | 要查询的Ability组件名。 |
| callback | AsyncCallback\<image.PixelMap> | 是 | 程序启动作为入参的回调函数，返回指定[PixelMap](js-apis-image.md)。 | | callback | AsyncCallback\<image.PixelMap> | 是 | 程序启动作为入参的回调函数，返回指定[PixelMap](js-apis-image.md)。 |
**示例：** **示例：**
```js ```ts
let bundleName = "com.example.myapplication"; let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility"; let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
...@@ -1567,7 +1701,11 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { ...@@ -1567,7 +1701,11 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
> 从API version 9开始不再维护，建议使用[bundleManager.BundleFlag](js-apis-bundleManager.md#bundleflag)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.BundleFlag](js-apis-bundleManager.md#bundleflag)替代。
包的标志 包信息标志，指示需要获取的包信息的内容。
当接口与标志不匹配时，该标志会被忽略，例如获取application时使用GET_ABILITY_INFO_WITH_PERMISSION对结果不会产生影响。
标志可以叠加使用，例如使用GET_APPLICATION_INFO_WITH_PERMISSION + GET_APPLICATION_INFO_WITH_DISABLE可以使结果同时包含应用权限信息和被禁用的应用信息。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1589,7 +1727,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { ...@@ -1589,7 +1727,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
## BundleOptions<sup>deprecated<sup> ## BundleOptions<sup>deprecated<sup>
> 从API version 9开始不再维护，不推荐使用。 > 从API version 9开始不再维护，不推荐使用。
包的选项 查询选项，包含userId。
**系统能力:** SystemCapability.BundleManager.BundleFramework **系统能力:** SystemCapability.BundleManager.BundleFramework
...@@ -1601,7 +1739,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { ...@@ -1601,7 +1739,7 @@ bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
> 从API version 9开始不再维护，建议使用[bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype)替代。
Ability类型 Ability组件类型。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1616,7 +1754,7 @@ Ability类型 ...@@ -1616,7 +1754,7 @@ Ability类型
> 从API version 9开始不再维护，建议使用[bundleManager.DisplayOrientation](js-apis-bundleManager.md#displayorientation)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.DisplayOrientation](js-apis-bundleManager.md#displayorientation)替代。
屏幕显示方向 屏幕显示方向。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1630,7 +1768,7 @@ Ability类型 ...@@ -1630,7 +1768,7 @@ Ability类型
> 从API version 9开始不再维护，建议使用[bundleManager.LaunchType](js-apis-bundleManager.md#launchtype)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.LaunchType](js-apis-bundleManager.md#launchtype)替代。
启动模式 Ability组件的启动模式。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1642,7 +1780,7 @@ Ability类型 ...@@ -1642,7 +1780,7 @@ Ability类型
## AbilitySubType<sup>deprecated<sup> ## AbilitySubType<sup>deprecated<sup>
> 从API version 9开始不再维护，不推荐使用。 > 从API version 9开始不再维护，不推荐使用。
Ability的子类型 Ability组件的子类型。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1654,7 +1792,7 @@ Ability的子类型 ...@@ -1654,7 +1792,7 @@ Ability的子类型
## ColorMode<sup>deprecated<sup> ## ColorMode<sup>deprecated<sup>
> 从API version 9开始不再维护，不推荐使用。 > 从API version 9开始不再维护，不推荐使用。
颜色模式 应用、卡片等的颜色模式。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -1669,11 +1807,11 @@ Ability的子类型 ...@@ -1669,11 +1807,11 @@ Ability的子类型
> 从API version 9开始不再维护，建议使用[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)替代。 > 从API version 9开始不再维护，建议使用[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)替代。
授予状态 权限授予状态。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------ | ---- | ------------ | | ------------------ | ---- | ------------ |
| PERMISSION_DENIED | -1 | 拒绝授予权限 | | PERMISSION_DENIED | -1 | 拒绝授予权限 |
| PERMISSION_GRANTED | 0 | 授予权限 | | PERMISSION_GRANTED | 0 | 授予权限 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
浏览文件 @ 4f2c1724
...@@ -5,7 +5,7 @@ ...@@ -5,7 +5,7 @@
Ability信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取 Ability信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取。
## AbilityInfo<sup>(deprecated)<sup> ## AbilityInfo<sup>(deprecated)<sup>
...@@ -13,32 +13,32 @@ Ability信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取 ...@@ -13,32 +13,32 @@ Ability信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | -------------------------------------------------------- | ---- | ---- | ------------------------------------------------------------ | | --------------------- | -------------------------------------------------------- | ---- | ---- | ----------------------------------------- |
| bundleName | string | 是 | 否 | 应用包名 | | bundleName | string | 是 | 否 | 应用包名 |
| name | string | 是 | 否 | Ability名称 | | name | string | 是 | 否 | Ability名称。 |
| label | string | 是 | 否 | Ability对用户显示的名称 | | label | string | 是 | 否 | Ability对用户显示的名称。 |
| description | string | 是 | 否 | Ability的描述 | | description | string | 是 | 否 | Ability的描述。 |
| icon | string | 是 | 否 | Ability的图标资源文件索引 | | icon | string | 是 | 否 | Ability的图标资源文件索引。 |
| descriptionId | number | 是 | 否 | Ability的描述id | | descriptionId | number | 是 | 否 | Ability的描述id。 |
| iconId | number | 是 | 否 | Ability的图标id | | iconId | number | 是 | 否 | Ability的图标id。 |
| moduleName | string | 是 | 否 | Ability所属的HAP包的名称 | | moduleName | string | 是 | 否 | Ability所属的HAP包的名称。 |
| process | string | 是 | 否 | Ability的进程，如果不设置，默认为包的名称 | | process | string | 是 | 否 | Ability的进程，如果不设置，默认为包的名称。 |
| targetAbility | string | 是 | 否 | 当前Ability重用的目标Ability<br />此属性仅可在FA模型下使用 | | targetAbility | string | 是 | 否 | 当前Ability重用的目标Ability。<br />此属性仅可在FA模型下使用。 |
| backgroundModes | number | 是 | 否 | 表示后台服务的类型<br />此属性仅可在FA模型下使用 | | backgroundModes | number | 是 | 否 | 表示后台服务的类型。<br />此属性仅可在FA模型下使用。 |
| isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用 | | isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用。 |
| formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力<br />此属性仅可在FA模型下使用 | | formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力。<br />此属性仅可在FA模型下使用。 |
| type | bundle.AbilityType | 是 | 否 | Ability类型<br />此属性仅可在FA模型下使用 | | type | AbilityType | 是 | 否 | Ability类型。<br />此属性仅可在FA模型下使用。 |
| orientation | bundle.DisplayOrientation | 是 | 否 | Ability的显示模式 | | orientation | [DisplayOrientation](js-apis-Bundle.md#displayorientationdeprecated) | 是 | 否 | Ability的显示模式。 |
| launchMode | bundle.LaunchMode | 是 | 否 | Ability的启动模式 | | launchMode | [LaunchMode](js-apis-Bundle.md#launchmodedeprecated) | 是 | 否 | Ability的启动模式。 |
| permissions | Array\<string> | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合<br />通过传入GET_ABILITY_INFO_WITH_PERMISSION获取 | | permissions | Array\<string> | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合。<br />通过传入GET_ABILITY_INFO_WITH_PERMISSION获取。 |
| deviceTypes | Array\<string> | 是 | 否 | Ability支持的设备类型 | | deviceTypes | Array\<string> | 是 | 否 | Ability支持的设备类型。 |
| deviceCapabilities | Array\<string> | 是 | 否 | Ability需要的设备能力 | | deviceCapabilities | Array\<string> | 是 | 否 | Ability需要的设备能力。 |
| readPermission | string | 是 | 否 | 读取Ability数据所需的权限<br />此属性仅可在FA模型下使用 | | readPermission | string | 是 | 否 | 读取Ability数据所需的权限。<br />此属性仅可在FA模型下使用。|
| writePermission | string | 是 | 否 | 向Ability写数据所需的权限<br />此属性仅可在FA模型下使用 | | writePermission | string | 是 | 否 | 向Ability写数据所需的权限。<br />此属性仅可在FA模型下使用。 |
| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息<br />通过传入GET_ABILITY_INFO_WITH_APPLICATION获取 | | applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息。<br />通过传入GET_ABILITY_INFO_WITH_APPLICATION获取。 |
| uri | string | 是 | 否 | 获取Ability的统一资源标识符（URI）<br />此属性仅可在FA模型下使用 | | uri | string | 是 | 否 | 获取Ability的统一资源标识符（URI）。<br />此属性仅可在FA模型下使用。 |
| labelId | number | 是 | 否 | Ability的标签id | | labelId | number | 是 | 否 | Ability的标签id。 |
| subType | bundle.AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型<br />此属性仅可在FA模型下使用 | | subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型。<br />此属性仅可在FA模型下使用。 |
| metadata<sup>8+</sup> | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的元信息<br />通过传入GET_ABILITY_INFO_WITH_METADATA获取 | | metadata<sup>8+</sup> | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的元信息。<br />通过传入GET_ABILITY_INFO_WITH_METADATA获取。 |
| enabled<sup>8+</sup> | boolean | 是 | 否 | ability是否可用 | | enabled<sup>8+</sup> | boolean | 是 | 否 | ability是否可用。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
浏览文件 @ 4f2c1724
...@@ -13,26 +13,26 @@ ...@@ -13,26 +13,26 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | |----------------------------|------------------------------------------------------------------------|-----|-----|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| name | string | 是 | 否 | 应用程序的名称。 | | name | string | 是 | 否 | 应用程序的名称。 |
| description | string | 是 | 否 | 应用程序的描述。 | | description | string | 是 | 否 | 应用程序的描述。 |
| descriptionId | number | 是 | 否 | 应用程序的描述id。 | | descriptionId | number | 是 | 否 | 应用程序的描述id。 |
| systemApp | boolean | 是 | 否 | 判断是否为系统应用程序，默认为false。 | | systemApp | boolean | 是 | 否 | 判断是否为系统应用程序，默认为false。 |
| enabled | boolean | 是 | 否 | 判断应用程序是否可以使用，默认为true。 | | enabled | boolean | 是 | 否 | 判断应用程序是否可以使用，默认为true。 |
| label | string | 是 | 否 | 应用程序的标签。 | | label | string | 是 | 否 | 应用程序显示的标签。 |
| labelId<sup>(deprecated)</sup> | string | 是 | 否 | 应用程序的标签id。<br />\- **说明：** 从API version 9开始废弃，使用labelIndex。 | | labelId | string | 是 | 否 | 应用程序的标签id。 |
| icon | string | 是 | 否 | 应用程序的图标。 | | icon | string | 是 | 否 | 应用程序的图标。 |
| iconId<sup>(deprecated)</sup> | string | 是 | 否 | 应用程序的图标id。<br />\- **说明：** 从API version 9开始废弃，使用iconIndex。 | | iconId | string | 是 | 否 | 应用程序的图标id。 |
| process | string | 是 | 否 | 应用程序的进程，如果不设置，默认为包的名称。 | | process | string | 是 | 否 | 应用程序的进程，如果不设置，默认为包的名称。 |
| supportedModes | number | 是 | 否 | 应用程序支持的运行模式。 | | supportedModes | number | 是 | 否 | 标识应用支持的运行模式，当前只定义了驾驶模式（drive）。该标签只适用于车机。 |
| moduleSourceDirs | Array\<string> | 是 | 否 | 应用程序的资源存放的相对路径。 | | moduleSourceDirs | Array\<string> | 是 | 否 | 应用程序的资源存放的相对路径。 |
| permissions | Array\<string> | 是 | 否 | 访问应用程序所需的权限。<br />通过传入GET_APPLICATION_INFO_WITH_PERMISSION获取 | | permissions | Array\<string> | 是 | 否 | 访问应用程序所需的权限。<br />通过传入GET_APPLICATION_INFO_WITH_PERMISSION获取 |
| moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | 是 | 否 | 应用程序的模块信息。 | | moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | 是 | 否 | 应用程序的模块信息。 |
| entryDir | string | 是 | 否 | 应用程序的文件保存路径。 | | entryDir | string | 是 | 否 | 应用程序的文件保存路径。 |
| codePath<sup>8+</sup> | string | 是 | 否 | 应用程序的安装目录。 | | codePath<sup>8+</sup> | string | 是 | 否 | 应用程序的安装目录。 |
| metaData<sup>8+</sup> | Map\<string, Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)>> | 是 | 否 | 应用程序的自定义元信息。<br />通过传入GET_APPLICATION_INFO_WITH_METADATA获取 | | metaData<sup>8+</sup> | Map\<string, Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)>> | 是 | 否 | 应用程序的自定义元信息。<br />通过传入GET_APPLICATION_INFO_WITH_METADATA获取 |
| removable<sup>8+</sup> | boolean | 是 | 否 | 应用程序是否可以被移除。 | | removable<sup>8+</sup> | boolean | 是 | 否 | 应用程序是否可以被移除。 |
| accessTokenId<sup>8+</sup> | number | 是 | 否 | 应用程序的accessTokenId。 | | accessTokenId<sup>8+</sup> | number | 是 | 否 | 应用程序的accessTokenId。 |
| uid<sup>8+</sup> | number | 是 | 否 | 应用程序的uid。 | | uid<sup>8+</sup> | number | 是 | 否 | 应用程序的uid。 |
| entityType<sup>8+</sup> | string | 是 | 否 | 应用程序的实体类型。 | | entityType<sup>8+</sup> | string | 是 | 否 | 该标签标记该应用的类别，具体有 :游戏类(game)，影音类（media）、社交通信类（communication）、新闻类（news）、出行类（travel）、工具类（utility）、购物类（shopping）、教育类（education）、少儿类（kids）、商务类（business）、拍摄类（photography）。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
浏览文件 @ 4f2c1724
...@@ -35,7 +35,7 @@ ...@@ -35,7 +35,7 @@
| isSilentInstallation | string | 是 | 否 | 是否通过静默安装。 | | isSilentInstallation | string | 是 | 否 | 是否通过静默安装。 |
| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。 | | minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。 |
| entryInstallationFree | boolean | 是 | 否 | Entry是否支持免安装。 | | entryInstallationFree | boolean | 是 | 否 | Entry是否支持免安装。 |
| reqPermissionStates<sup>8+</sup> | Array\<number> | 是 | 否 | 申请权限的授予状态。 | | reqPermissionStates<sup>8+</sup> | Array\<number> | 是 | 否 | 申请权限的授予状态。0表示申请成功，-1表示申请失败。 |
......
zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md
浏览文件 @ 4f2c1724
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
在设备上安装、升级和卸载应用 本模块提供设备上安装、升级和卸载应用的能力。
## BundleInstaller.install<sup>(deprecated)<sup> ## BundleInstaller.install<sup>(deprecated)<sup>
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
install(bundleFilePaths: Array&lt;string&gt;, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void; install(bundleFilePaths: Array&lt;string&gt;, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法在HAP中安装应用程序，使用callback形式返回结果。 以异步方法在应用中安装hap，支持多hap安装。使用callback形式返回结果。
**需要权限：** **需要权限：**
...@@ -27,9 +27,33 @@ SystemCapability.BundleManager.BundleFramework ...@@ -27,9 +27,33 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | | --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleFilePaths | Array&lt;string&gt; | 是 | 指示存储应用程序包的路径。路径应该是当前应用程序的数据目录的相对路径。 | | bundleFilePaths | Array&lt;string&gt; | 是 | 指示存储hap包的沙箱路径。沙箱路径的获取方法参见[获取应用的沙箱路径](#获取应用的沙箱路径)|
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 | | param | [InstallParam](#installparamdeprecated) | 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 | | callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 |
**示例：**
```ts
import bundle from '@ohos.bundle';
let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
let installParam = {
userId: 100,
isKeepData: false,
installFlag: 1,
};
bundle.getBundleInstaller().then(installer=>{
installer.install(hapFilePaths, installParam, err => {
if (err) {
console.error('install failed:' + JSON.stringify(err));
} else {
console.info('install successfully.');
}
});
}).catch(error => {
console.error('getBundleInstaller failed. Cause: ' + error.message);
});
```
## BundleInstaller.uninstall<sup>(deprecated)<sup> ## BundleInstaller.uninstall<sup>(deprecated)<sup>
...@@ -37,7 +61,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -37,7 +61,7 @@ SystemCapability.BundleManager.BundleFramework
uninstall(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void; uninstall(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法卸载应用程序，使用callback形式返回结果。 以异步方法卸载应用程序，使用callback异步回调，返回安装状态信息。
**需要权限：** **需要权限：**
...@@ -54,16 +78,39 @@ SystemCapability.BundleManager.BundleFramework ...@@ -54,16 +78,39 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- | | ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 | | bundleName | string | 是 | 包名 |
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 | | param | [InstallParam](#installparamdeprecated) | 是 | 指定卸载所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 | | callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 |
**示例：**
```ts
import bundle from '@ohos.bundle';
let bundleName = 'com.example.myapplication';
let installParam = {
userId: 100,
isKeepData: false,
installFlag: 1,
};
bundle.getBundleInstaller().then(installer=>{
installer.uninstall(bundleName, installParam, err => {
if (err) {
console.error('uninstall failed:' + JSON.stringify(err));
} else {
console.info('uninstall successfully.');
}
});
}).catch(error => {
console.error('getBundleInstaller failed. Cause: ' + error.message);
});
```
## BundleInstaller.recover<sup>(deprecated)<sup> ## BundleInstaller.recover<sup>(deprecated)<sup>
> 从API version 9开始不再维护，建议使用[recover](js-apis-installer.md)替代。 > 从API version 9开始不再维护，建议使用[recover](js-apis-installer.md)替代。
recover(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void; recover(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法恢复一个应用程序，使用callback形式返回结果。 以异步方法恢复一个应用程序，使用callback形式返回结果。当预置应用被卸载后，可以通过此接口进行恢复。
**需要权限：** **需要权限：**
...@@ -79,13 +126,38 @@ SystemCapability.BundleManager.BundleFramework ...@@ -79,13 +126,38 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- | | ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 | | bundleName | string | 是 | 应用包名。 |
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 | | param | [InstallParam](#installparamdeprecated) | 是 | 指定应用恢复所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 | | callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数，返回应用恢复状态信息。 |
**示例：**
```ts
import bundle from '@ohos.bundle';
let bundleName = 'com.example.myapplication';
let installParam = {
userId: 100,
isKeepData: false,
installFlag: 1,
};
bundle.getBundleInstaller().then(installer=>{
installer.recover(bundleName, installParam, err => {
if (err) {
console.error('recover failed:' + JSON.stringify(err));
} else {
console.info('recover successfully.');
}
});
}).catch(error => {
console.error('getBundleInstaller failed. Cause: ' + error.message);
});
```
## InstallParam<sup>(deprecated)<sup> ## InstallParam<sup>(deprecated)<sup>
应用程序安装卸载信息 安装、恢复或卸载时需要指定的参数。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -99,7 +171,7 @@ SystemCapability.BundleManager.BundleFramework ...@@ -99,7 +171,7 @@ SystemCapability.BundleManager.BundleFramework
## InstallStatus<sup>(deprecated)<sup> ## InstallStatus<sup>(deprecated)<sup>
应用程序安装状态 应用程序安装卸载的结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -107,5 +179,29 @@ SystemCapability.BundleManager.BundleFramework ...@@ -107,5 +179,29 @@ SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------ | | ------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------ |
| status | bundle.[InstallErrorCode](js-apis-Bundle.md#installerrorcode) | 是 | 否 | 表示安装或卸载错误状态码 | | status | bundle.[InstallErrorCode](js-apis-Bundle.md#installerrorcode) | 是 | 否 | 表示安装或卸载错误状态码。 |
| statusMessage | string | 是 | 否 | 表示安装或卸载的字符串结果信息 | | statusMessage | string | 是 | 否 | 表示安装或卸载的字符串结果信息。 |
## 获取应用的沙箱路径
对于FA模型，应用的沙箱路径可以通过[Context](js-apis-Context.md)中的方法获取；对于Stage模型，应用的沙箱路径可以通过[Context](js-apis-ability-context.md#abilitycontext)中的属性获取。下面以获取沙箱文件路径为例。
**示例：**
``` ts
// Stage模型
import Ability from '@ohos.application.Ability';
class MainAbility extends Ability {
onWindowStageCreate(windowStage) {
let context = this.context;
let pathDir = context.filesDir;
console.info('sandbox path is ' + pathDir);
}
}
// FA模型
import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext();
context.getFilesDir().then((data) => {
let pathDir = data;
console.info('sandbox path is ' + pathDir);
});
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md
浏览文件 @ 4f2c1724
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
自定义元数据 自定义元数据。
## CustomizeData<sup>(deprecated)</sup> ## CustomizeData<sup>(deprecated)</sup>
...@@ -19,6 +19,6 @@ ...@@ -19,6 +19,6 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------ | ------ | ---- | ---- | ---------------- | | ------------------ | ------ | ---- | ---- | ---------------- |
| name | string | 是 | 是 | 自定义元数据名称 | | name | string | 是 | 是 | 标识自定义数据项的键名称。 |
| value | string | 是 | 是 | 自定义元数据值 | | value | string | 是 | 是 | 标识自定义数据项的值名称。 |
| extra<sup>8+</sup> | string | 是 | 是 | 自定义资源 | | extra<sup>8+</sup> | string | 是 | 是 | 标识用户自定义数据格式，标签值为标识该数据的资源的索引值。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
浏览文件 @ 4f2c1724
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
Hap模块信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取 Hap模块信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获取。
## HapModuleInfo<sup>(deprecated)<sup> ## HapModuleInfo<sup>(deprecated)<sup>
...@@ -19,19 +19,19 @@ Hap模块信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获 ...@@ -19,19 +19,19 @@ Hap模块信息，未做特殊说明的属性，均通过GET_BUNDLE_DEFAULT获
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- | | --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- |
| name | string | 是 | 否 | 模块名称 | | name | string | 是 | 否 | 模块名称。 |
| description | string | 是 | 否 | 模块描述信息 | | description | string | 是 | 否 | 模块描述信息。 |
| descriptionId | number | 是 | 否 | 描述信息ID | | descriptionId | number | 是 | 否 | 描述信息ID。 |
| icon | string | 是 | 否 | 模块图标 | | icon | string | 是 | 否 | 模块图标。 |
| label | string | 是 | 否 | 模块标签 | | label | string | 是 | 否 | 模块标签。 |
| labelId | number | 是 | 否 | 模块标签ID | | labelId | number | 是 | 否 | 模块标签ID。 |
| iconId | number | 是 | 否 | 模块图标ID | | iconId | number | 是 | 否 | 模块图标ID。 |
| backgroundImg | string | 是 | 否 | 模块背景图片 | | backgroundImg | string | 是 | 否 | 模块背景图片。 |
| supportedModes | number | 是 | 否 | 模块支持的模式 | | supportedModes | number | 是 | 否 | 模块支持的模式。 |
| reqCapabilities | Array\<string> | 是 | 否 | 模块运行需要的能力 | | reqCapabilities | Array\<string> | 是 | 否 | 模块运行需要的能力。 |
| deviceTypes | Array\<string> | 是 | 否 | 支持运行的设备类型 | | deviceTypes | Array\<string> | 是 | 否 | 支持运行的设备类型。 |
| abilityInfo | Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 否 | Ability信息 | | abilityInfo | Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 否 | Ability信息。 |
| moduleName | string | 是 | 否 | 模块名 | | moduleName | string | 是 | 否 | 模块名。 |
| mainAbilityName | string | 是 | 否 | 入口Ability名称 | | mainAbilityName | string | 是 | 否 | 入口Ability名称。 |
| installationFree | boolean | 是 | 否 | 是否支持免安装 | | installationFree | boolean | 是 | 否 | 是否支持免安装。 |
zh-cn/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
浏览文件 @ 4f2c1724
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
应用程序的模块信息 应用程序的模块信息。
## ModuleInfo<sup>(deprecated)<sup> ## ModuleInfo<sup>(deprecated)<sup>
> 从API version 9开始不再维护，建议使用[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)替代。 > 从API version 9开始不再维护，建议使用[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)替代。
...@@ -10,5 +10,5 @@ ...@@ -10,5 +10,5 @@
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------ | ---- | ---- | -------- | | --------------- | ------ | ---- | ---- | -------- |
| moduleName | string | 是 | 否 | 模块名称 | | moduleName | string | 是 | 否 | 模块名称。 |
| moduleSourceDir | string | 是 | 否 | 安装目录 | | moduleSourceDir | string | 是 | 否 | 安装目录。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
浏览文件 @ 4f2c1724
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
配置文件中定义的权限详细信息 配置文件中定义的权限详细信息。
## **PermissionDef**<sup>(deprecated)<sup> ## **PermissionDef**<sup>(deprecated)<sup>
...@@ -19,7 +19,7 @@ ...@@ -19,7 +19,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------- | ------ | ---- | ---- | -------------- | | -------------- | ------ | ---- | ---- | -------------- |
| permissionName | string | 是 | 否 | 用户权限名称 | | permissionName | string | 是 | 否 | 权限名称。 |
| grantMode | number | 是 | 否 | 权限的授予模式 | | grantMode | number | 是 | 否 | 权限的授予模式，0表示安装后系统自动授予该权限，1表示使用时动态申请，用户授权后方可使用。 |
| labelId | number | 是 | 否 | 权限的标签ID | | labelId | number | 是 | 否 | 权限的标签ID。 |
| descriptionId | number | 是 | 否 | 描述权限的ID | | descriptionId | number | 是 | 否 | 描述权限的ID。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
浏览文件 @ 4f2c1724
...@@ -33,15 +33,15 @@ ...@@ -33,15 +33,15 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- | | ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- |
| id | string | 是 | 否 | 快捷方式所属应用程序的Id | | id | string | 是 | 否 | 快捷方式所属应用程序的Id。 |
| bundleName | string | 是 | 否 | 包含快捷方式的包名称 | | bundleName | string | 是 | 否 | 包含该快捷方式的包名称。 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息 | | hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息。 |
| icon | string | 是 | 否 | 快捷方式的图标 | | icon | string | 是 | 否 | 快捷方式的图标。 |
| iconId<sup>8+</sup> | number | 是 | 否 | 快捷方式的图标Id | | iconId<sup>8+</sup> | number | 是 | 否 | 快捷方式的图标Id。 |
| label | string | 是 | 否 | 快捷方式的标签 | | label | string | 是 | 否 | 快捷方式的名称。 |
| labelId<sup>8+</sup> | number | 是 | 否 | 快捷方式的标签Id | | labelId<sup>8+</sup> | number | 是 | 否 | 快捷方式的名称Id。 |
| disableMessage | string | 是 | 否 | 快捷方式的禁用消息 | | disableMessage | string | 是 | 否 | 快捷方式的禁用消息。 |
| wants | Array&lt;[ShortcutWant](#shortcutwant)&gt; | 是 | 否 | 快捷方式所需要的信息 | | wants | Array&lt;[ShortcutWant](#shortcutwant)&gt; | 是 | 否 | 快捷方式意图列表。 |
| isStatic | boolean | 是 | 否 | 快捷方式是否为静态 | | isStatic | boolean | 是 | 否 | 快捷方式是否为静态。 |
| isHomeShortcut | boolean | 是 | 否 | 快捷方式是否为主页面快捷方式 | | isHomeShortcut | boolean | 是 | 否 | 快捷方式是否为主页面快捷方式。 |
| isEnabled | boolean | 是 | 否 | 是否启用快捷方式 | | isEnabled | boolean | 是 | 否 | 是否启用快捷方式。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
浏览文件 @ 4f2c1724
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
包含基本远程能力信息 remoteAbility信息。
## RemoteAbilityInfo<sup>(deprecated)<sup> ## RemoteAbilityInfo<sup>(deprecated)<sup>
...@@ -20,6 +20,6 @@ ...@@ -20,6 +20,6 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- | | ----------- | -------------------------------------------- | ---- | ---- | ----------------------- |
| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 否 | 指明的ability信息 | | elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 否 | ability元素资源信息。 |
| label | string | 是 | 否 | 指明ability的标签信息 | | label | string | 是 | 否 | 指明ability的名称。 |
| icon | string | 是 | 否 | 指明的ability的图标信息 | | icon | string | 是 | 否 | 指明的ability的图标信息。 |
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
浏览文件 @ 4f2c1724
...@@ -23,7 +23,7 @@ import defaultAppMgr from '@ohos.bundle.defaultAppManager'; ...@@ -23,7 +23,7 @@ import defaultAppMgr from '@ohos.bundle.defaultAppManager';
## defaultAppMgr.ApplicationType ## defaultAppMgr.ApplicationType
应用类型 默认应用的应用类型。
**系统能力：** SystemCapability.BundleManager.BundleFramework.DefaultApp **系统能力：** SystemCapability.BundleManager.BundleFramework.DefaultApp
...@@ -88,7 +88,7 @@ isDefaultApplication(type: string, callback: AsyncCallback\<boolean>): void ...@@ -88,7 +88,7 @@ isDefaultApplication(type: string, callback: AsyncCallback\<boolean>): void
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => { defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => {
if (err) { if (err) {
...@@ -136,7 +136,7 @@ getDefaultApplication(type: string, userId?: number): Promise\<BundleInfo> ...@@ -136,7 +136,7 @@ getDefaultApplication(type: string, userId?: number): Promise\<BundleInfo>
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER) defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER)
.then((data) => { .then((data) => {
...@@ -187,7 +187,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\<Bun ...@@ -187,7 +187,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\<Bun
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100; let userId = 100;
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => { defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => {
...@@ -238,7 +238,7 @@ getDefaultApplication(type: string, callback: AsyncCallback\<BundleInfo>) : void ...@@ -238,7 +238,7 @@ getDefaultApplication(type: string, callback: AsyncCallback\<BundleInfo>) : void
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => { defaultAppMgr.getDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => {
if (err) { if (err) {
...@@ -260,12 +260,6 @@ defaultAppMgr.getDefaultApplication("image/png", (err, data) => { ...@@ -260,12 +260,6 @@ defaultAppMgr.getDefaultApplication("image/png", (err, data) => {
setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise\<void> setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise\<void>
| 类型 | 说明 |
| ----------------------------------------------------------- | --------------------------- |
| Promise\<void> | Promise对象，返回BundleInfo |
>
以异步方法根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型设置默认应用，使用Promise形式返回结果。 以异步方法根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型设置默认应用，使用Promise形式返回结果。
**需要权限：** ohos.permission.SET_DEFAULT_APPLICATION **需要权限：** ohos.permission.SET_DEFAULT_APPLICATION
...@@ -286,7 +280,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number): ...@@ -286,7 +280,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number):
| 类型 | 说明 | | 类型 | 说明 |
| -------------- | ---------------------------------- | | -------------- | ---------------------------------- |
| Promise\<void> | Promise对象，无返回结果的Promise。 | | Promise\<void> | Promise对象，无返回结果的Promise对象。 |
**错误码：** **错误码：**
...@@ -300,7 +294,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number): ...@@ -300,7 +294,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number):
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, {
bundleName: "com.test.app", bundleName: "com.test.app",
...@@ -367,7 +361,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca ...@@ -367,7 +361,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100; let userId = 100;
defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, {
...@@ -484,7 +478,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\<void> ...@@ -484,7 +478,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\<void>
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100; let userId = 100;
defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId) defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId)
...@@ -535,7 +529,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\<v ...@@ -535,7 +529,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\<v
**示例：** **示例：**
```js ```ts
import defaultAppMgr from '@ohos.bundle.defaultAppManager'; import defaultAppMgr from '@ohos.bundle.defaultAppManager';
let userId = 100; let userId = 100;
defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => { defaultAppMgr.resetDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, userId, (err, data) => {
......
zh-cn/application-dev/reference/apis/js-apis-system-package.md
浏览文件 @ 4f2c1724
...@@ -12,7 +12,7 @@ ...@@ -12,7 +12,7 @@
``` ```
import pkg from '@system.package'; import package from '@system.package';
``` ```
...@@ -31,12 +31,9 @@ hasInstalled(Object): void ...@@ -31,12 +31,9 @@ hasInstalled(Object): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 | |options | [CheckPackageHasInstalledOptions](#checkpackagehasinstalledoptions) | 是 | 选项参数。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值： **返回值：**
| 参数名 | 类型 | 说明 | | 参数名 | 类型 | 说明 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
...@@ -44,18 +41,43 @@ success返回值： ...@@ -44,18 +41,43 @@ success返回值：
**示例：** **示例：**
``` ``` ts
export default { export default {
hasInstalled() { hasInstalled() {
pkg.hasInstalled({ package.hasInstalled({
bundleName: 'com.example.bundlename', bundleName: 'com.example.bundlename',
success: function(data) { success: function(data) {
console.log('package has installed: ' + data); console.log('package has installed: ' + data);
}, },
fail: function(data, code) { fail: function(data, code) {
console.log('query package fail, code: ' + code + ', data: ' + data); console.log('query package fail, code: ' + code + ', data: ' + data);
}, },
}); });
}, },
} }
``` ```
\ No newline at end of file
## CheckPackageHasInstalledResponse
> 从API version 9开始不再维护。
指示应用包是否已安装。
**系统能力:** SystemCapability.BundleManager.BundleFramework。
| 名称 | 类型 | 说明 |
| --- | --- | ---- |
| result | boolean | 指示应用是否已安装。 |
## CheckPackageHasInstalledOptions
> 从API version 9开始不再维护。
查询包是否已安装时的选项。
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或