Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
(_灬幸福相伴
Docs
提交
4f2c1724
D
Docs
项目概览
(_灬幸福相伴
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
4f2c1724
编写于
11月 30, 2022
作者:
O
openharmony_ci
提交者:
Gitee
11月 30, 2022
浏览文件
操作
浏览文件
下载
差异文件
!11243 包管理API参考内容优化改进
Merge pull request !11243 from xsz233/master
上级
3d5aa6f0
86314cca
变更
15
展开全部
显示空白变更内容
内联
并排
Showing
15 changed file
with
583 addition
and
333 deletion
+583
-333
zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
...n-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-Bundle-distributedBundle.md
...on-dev/reference/apis/js-apis-Bundle-distributedBundle.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-Bundle.md
zh-cn/application-dev/reference/apis/js-apis-Bundle.md
+313
-175
zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
...lication-dev/reference/apis/js-apis-bundle-AbilityInfo.md
+30
-30
zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
...tion-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
+23
-23
zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
...plication-dev/reference/apis/js-apis-bundle-BundleInfo.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md
...tion-dev/reference/apis/js-apis-bundle-BundleInstaller.md
+113
-17
zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md
...cation-dev/reference/apis/js-apis-bundle-CustomizeData.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
...cation-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
+16
-16
zh-cn/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
...plication-dev/reference/apis/js-apis-bundle-ModuleInfo.md
+3
-3
zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
...cation-dev/reference/apis/js-apis-bundle-PermissionDef.md
+5
-5
zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
...ication-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
+12
-12
zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
...on-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
...plication-dev/reference/apis/js-apis-defaultAppManager.md
+10
-16
zh-cn/application-dev/reference/apis/js-apis-system-package.md
.../application-dev/reference/apis/js-apis-system-package.md
+41
-19
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md
浏览文件 @
4f2c1724
...
...
@@ -41,7 +41,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。
默认值:调用方所在用户,
取值范围:大于等于0。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
| callback | AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundle-LauncherAbilityInfo.md
)
>
> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
...
...
@@ -69,7 +69,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。
默认值:调用方所在用户,
取值范围:大于等于0。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
**返回值:**
...
...
@@ -216,7 +216,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| userId | number | 是 | 用户ID。
默认值:调用方所在用户,
取值范围:大于等于0。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
| callback | AsyncCallback
\<
Array
<
[
LauncherAbilityInfo
](
js-apis-bundle-LauncherAbilityInfo.md
)
>
> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
## innerBundleManager.getAllLauncherAbilityInfos<sup>(deprecated)</sup>
...
...
@@ -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接口)
本模块提供分布式包的管理
本模块提供分布式包的管理
。
> **说明:**
>
...
...
@@ -109,8 +109,8 @@ SystemCapability.BundleManager.DistributedBundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementNames | Array
<
[
ElementName
](
js-apis-bundle-ElementName.md
)
>
| 是 | ElementName信息
,最大数组长度为10
|
| callback | AsyncCallback
<Array
<[
RemoteAbilityInfo
](
js-apis-bundle-remoteAbilityInfo.md
)
>
> | 是 | 程序启动作为入参的回调函数,返回远程基本能力信息。 |
| elementNames | Array
<
[
ElementName
](
js-apis-bundle-ElementName.md
)
>
| 是 | ElementName信息
,最大数组长度为10。
|
| callback | AsyncCallback
<
Array
<[
RemoteAbilityInfo
](
js-apis-bundle-remoteAbilityInfo.md
)
>
> | 是 | 程序启动作为入参的回调函数,返回远程基本能力信息。 |
...
...
@@ -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
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md
浏览文件 @
4f2c1724
...
...
@@ -5,7 +5,7 @@
Ability信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获取
Ability信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获取
。
## AbilityInfo<sup>(deprecated)<sup>
...
...
@@ -14,31 +14,31 @@ Ability信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获取
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | -------------------------------------------------------- | ---- | ---- | -----------------------------------------
-------------------
|
| --------------------- | -------------------------------------------------------- | ---- | ---- | ----------------------------------------- |
| bundleName | string | 是 | 否 | 应用包名 |
| name | string | 是 | 否 | Ability名称 |
| label | string | 是 | 否 | Ability对用户显示的名称 |
| description | string | 是 | 否 | Ability的描述 |
| icon | string | 是 | 否 | Ability的图标资源文件索引 |
| descriptionId | number | 是 | 否 | Ability的描述id |
| iconId | number | 是 | 否 | Ability的图标id |
| moduleName | string | 是 | 否 | Ability所属的HAP包的名称 |
| process | string | 是 | 否 | Ability的进程,如果不设置,默认为包的名称 |
| targetAbility | string | 是 | 否 | 当前Ability重用的目标Ability
<br
/>
此属性仅可在FA模型下使用 |
| backgroundModes | number | 是 | 否 | 表示后台服务的类型
<br
/>
此属性仅可在FA模型下使用 |
| isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用 |
| formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力
<br
/>
此属性仅可在FA模型下使用 |
| type | bundle.AbilityType | 是 | 否 | Ability类型
<br
/>
此属性仅可在FA模型下使用 |
| orientation | bundle.DisplayOrientation | 是 | 否 | Ability的显示模式 |
| launchMode | bundle.LaunchMode | 是 | 否 | Ability的启动模式 |
| permissions | Array
\<
string> | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合
<br
/>
通过传入GET_ABILITY_INFO_WITH_PERMISSION获取 |
| deviceTypes | Array
\<
string> | 是 | 否 | Ability支持的设备类型 |
| deviceCapabilities | Array
\<
string> | 是 | 否 | Ability需要的设备能力 |
| readPermission | string | 是 | 否 | 读取Ability数据所需的权限
<br
/>
此属性仅可在FA模型下使用 |
| writePermission | string | 是 | 否 | 向Ability写数据所需的权限
<br
/>
此属性仅可在FA模型下使用 |
| applicationInfo |
[
ApplicationInfo
](
js-apis-bundle-ApplicationInfo.md
)
| 是 | 否 | 应用程序的配置信息
<br
/>
通过传入GET_ABILITY_INFO_WITH_APPLICATION获取 |
| uri | string | 是 | 否 | 获取Ability的统一资源标识符(URI)
<br
/>
此属性仅可在FA模型下使用 |
| labelId | number | 是 | 否 | Ability的标签id |
| subType | bundle.AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型
<br
/>
此属性仅可在FA模型下使用 |
| metadata
<sup>
8+
</sup>
| Array
\<
[
CustomizeData
](
js-apis-bundle-CustomizeData.md
)
> | 是 | 否 | ability的元信息
<br
/>
通过传入GET_ABILITY_INFO_WITH_METADATA获取 |
| enabled
<sup>
8+
</sup>
| boolean | 是 | 否 | ability是否可用 |
\ No newline at end of file
| name | string | 是 | 否 | Ability名称。 |
| label | string | 是 | 否 | Ability对用户显示的名称。 |
| description | string | 是 | 否 | Ability的描述。 |
| icon | string | 是 | 否 | Ability的图标资源文件索引。 |
| descriptionId | number | 是 | 否 | Ability的描述id。 |
| iconId | number | 是 | 否 | Ability的图标id。 |
| moduleName | string | 是 | 否 | Ability所属的HAP包的名称。 |
| process | string | 是 | 否 | Ability的进程,如果不设置,默认为包的名称。 |
| targetAbility | string | 是 | 否 | 当前Ability重用的目标Ability。
<br
/>
此属性仅可在FA模型下使用。 |
| backgroundModes | number | 是 | 否 | 表示后台服务的类型。
<br
/>
此属性仅可在FA模型下使用。 |
| isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用。 |
| formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力。
<br
/>
此属性仅可在FA模型下使用。 |
| type | AbilityType | 是 | 否 | Ability类型。
<br
/>
此属性仅可在FA模型下使用。 |
| orientation |
[
DisplayOrientation
](
js-apis-Bundle.md#displayorientationdeprecated
)
| 是 | 否 | Ability的显示模式。 |
| launchMode |
[
LaunchMode
](
js-apis-Bundle.md#launchmodedeprecated
)
| 是 | 否 | Ability的启动模式。 |
| permissions | Array
\<
string> | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合。
<br
/>
通过传入GET_ABILITY_INFO_WITH_PERMISSION获取。 |
| deviceTypes | Array
\<
string> | 是 | 否 | Ability支持的设备类型。 |
| deviceCapabilities | Array
\<
string> | 是 | 否 | Ability需要的设备能力。 |
| readPermission | string | 是 | 否 | 读取Ability数据所需的权限。
<br
/>
此属性仅可在FA模型下使用。|
| writePermission | string | 是 | 否 | 向Ability写数据所需的权限。
<br
/>
此属性仅可在FA模型下使用。 |
| applicationInfo |
[
ApplicationInfo
](
js-apis-bundle-ApplicationInfo.md
)
| 是 | 否 | 应用程序的配置信息。
<br
/>
通过传入GET_ABILITY_INFO_WITH_APPLICATION获取。 |
| uri | string | 是 | 否 | 获取Ability的统一资源标识符(URI)。
<br
/>
此属性仅可在FA模型下使用。 |
| labelId | number | 是 | 否 | Ability的标签id。 |
| subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型。
<br
/>
此属性仅可在FA模型下使用。 |
| metadata
<sup>
8+
</sup>
| Array
\<
[
CustomizeData
](
js-apis-bundle-CustomizeData.md
)
> | 是 | 否 | ability的元信息。
<br
/>
通过传入GET_ABILITY_INFO_WITH_METADATA获取。 |
| enabled
<sup>
8+
</sup>
| boolean | 是 | 否 | ability是否可用。 |
zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md
浏览文件 @
4f2c1724
...
...
@@ -14,18 +14,18 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
|
-------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------
|
|
----------------------------|------------------------------------------------------------------------|-----|-----|----------------------------------------------------------------------------------------------------------------------------------------------------------------------
|
| name | string | 是 | 否 | 应用程序的名称。 |
| description | string | 是 | 否 | 应用程序的描述。 |
| descriptionId | number | 是 | 否 | 应用程序的描述id。 |
| systemApp | boolean | 是 | 否 | 判断是否为系统应用程序,默认为false。 |
| enabled | boolean | 是 | 否 | 判断应用程序是否可以使用,默认为true。 |
| label | string
| 是 | 否 | 应用程序的标签。
|
| labelId
<sup>
(deprecated)
</sup>
| string | 是 | 否 | 应用程序的标签id。
<br
/>
\-
**说明:**
从API version 9开始废弃,使用labelIndex。
|
| label | string
| 是 | 否 | 应用程序显示的标签。
|
| labelId
| string | 是 | 否 | 应用程序的标签id。
|
| icon | string | 是 | 否 | 应用程序的图标。 |
| iconId
<sup>
(deprecated)
</sup>
| string | 是 | 否 | 应用程序的图标id。
<br
/>
\-
**说明:**
从API version 9开始废弃,使用iconIndex。
|
| iconId
| string | 是 | 否 | 应用程序的图标id。
|
| process | string | 是 | 否 | 应用程序的进程,如果不设置,默认为包的名称。 |
| supportedModes | number
| 是 | 否 | 应用程序支持的运行模式。
|
| supportedModes | number
| 是 | 否 | 标识应用支持的运行模式,当前只定义了驾驶模式(drive)。该标签只适用于车机。
|
| moduleSourceDirs | Array
\<
string> | 是 | 否 | 应用程序的资源存放的相对路径。 |
| permissions | Array
\<
string> | 是 | 否 | 访问应用程序所需的权限。
<br
/>
通过传入GET_APPLICATION_INFO_WITH_PERMISSION获取 |
| moduleInfos | Array
\<
[
ModuleInfo
](
js-apis-bundle-ModuleInfo.md
)
> | 是 | 否 | 应用程序的模块信息。 |
...
...
@@ -35,4 +35,4 @@
| removable
<sup>
8+
</sup>
| boolean | 是 | 否 | 应用程序是否可以被移除。 |
| accessTokenId
<sup>
8+
</sup>
| number | 是 | 否 | 应用程序的accessTokenId。 |
| uid
<sup>
8+
</sup>
| number | 是 | 否 | 应用程序的uid。 |
| entityType
<sup>
8+
</sup>
| string | 是 | 否 | 应用程序的实体类型。 |
\ No newline at end of file
| entityType
<sup>
8+
</sup>
| string | 是 | 否 | 该标签标记该应用的类别,具体有 :游戏类(game),影音类(media)、社交通信类(communication)、新闻类(news)、出行类(travel)、工具类(utility)、购物类(shopping)、教育类(education)、少儿类(kids)、商务类(business)、拍摄类(photography)。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md
浏览文件 @
4f2c1724
...
...
@@ -35,7 +35,7 @@
| isSilentInstallation | string | 是 | 否 | 是否通过静默安装。 |
| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。 |
| 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 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
在设备上安装、升级和卸载应用
本模块提供设备上安装、升级和卸载应用的能力。
## BundleInstaller.install<sup>(deprecated)<sup>
...
...
@@ -11,7 +11,7 @@
install(bundleFilePaths: Array
<
string
>
, param: InstallParam, callback: AsyncCallback
<
InstallStatus
>
): void;
以异步方法在
HAP中安装应用程序,
使用callback形式返回结果。
以异步方法在
应用中安装hap,支持多hap安装。
使用callback形式返回结果。
**需要权限:**
...
...
@@ -27,9 +27,33 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleFilePaths | Array
<
string
>
| 是 | 指示存储应用程序包的路径。路径应该是当前应用程序的数据目录的相对路径。 |
| param |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatus)
>
| 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
| bundleFilePaths | Array
<
string
>
| 是 | 指示存储hap包的沙箱路径。沙箱路径的获取方法参见
[
获取应用的沙箱路径
](
#获取应用的沙箱路径
)
|
| param |
[
InstallParam
](
#installparamdeprecated
)
| 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatusdeprecated)
>
| 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
**示例:**
```
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>
...
...
@@ -37,7 +61,7 @@ SystemCapability.BundleManager.BundleFramework
uninstall(bundleName: string, param: InstallParam, callback: AsyncCallback
<
InstallStatus
>
): void;
以异步方法卸载应用程序,使用callback
形式返回结果
。
以异步方法卸载应用程序,使用callback
异步回调,返回安装状态信息
。
**需要权限:**
...
...
@@ -54,16 +78,39 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 |
| param |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatus)
>
| 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
| param |
[
InstallParam
](
#installparamdeprecated
)
| 是 | 指定卸载所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatusdeprecated)
>
| 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
**示例:**
```
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>
> 从API version 9开始不再维护,建议使用[recover](js-apis-installer.md)替代。
recover(bundleName: string, param: InstallParam, callback: AsyncCallback
<
InstallStatus
>
): void;
以异步方法恢复一个应用程序,使用callback形式返回结果。
以异步方法恢复一个应用程序,使用callback形式返回结果。
当预置应用被卸载后,可以通过此接口进行恢复。
**需要权限:**
...
...
@@ -79,13 +126,38 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 |
| param |
[
InstallParam
](
#installparam
)
| 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatus)
>
| 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
| bundleName | string | 是 | 应用包名。 |
| param |
[
InstallParam
](
#installparamdeprecated
)
| 是 | 指定应用恢复所需的其他参数。 |
| callback | AsyncCallback
<
[InstallStatus](#installstatusdeprecated)
>
| 是 | 程序启动作为入参的回调函数,返回应用恢复状态信息。 |
**示例:**
```
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>
应用程序安装卸载信息
安装、恢复或卸载时需要指定的参数。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...
...
@@ -99,7 +171,7 @@ SystemCapability.BundleManager.BundleFramework
## InstallStatus<sup>(deprecated)<sup>
应用程序安装
状态
应用程序安装
卸载的结果。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...
...
@@ -107,5 +179,29 @@ SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------ |
| status | bundle.
[
InstallErrorCode
](
js-apis-Bundle.md#installerrorcode
)
| 是 | 否 | 表示安装或卸载错误状态码 |
| statusMessage | string | 是 | 否 | 表示安装或卸载的字符串结果信息 |
| status | bundle.
[
InstallErrorCode
](
js-apis-Bundle.md#installerrorcode
)
| 是 | 否 | 表示安装或卸载错误状态码。 |
| 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 @@
自定义元数据
自定义元数据
。
## CustomizeData<sup>(deprecated)</sup>
...
...
@@ -19,6 +19,6 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------ | ------ | ---- | ---- | ---------------- |
| name | string | 是 | 是 | 自定义元数据名称 |
| value | string | 是 | 是 | 自定义元数据值 |
| extra
<sup>
8+
</sup>
| string | 是 | 是 | 自定义资源 |
\ No newline at end of file
| name | string | 是 | 是 | 标识自定义数据项的键名称。 |
| value | string | 是 | 是 | 标识自定义数据项的值名称。 |
| extra
<sup>
8+
</sup>
| string | 是 | 是 | 标识用户自定义数据格式,标签值为标识该数据的资源的索引值。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md
浏览文件 @
4f2c1724
...
...
@@ -7,7 +7,7 @@
Hap模块信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获取
Hap模块信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获取
。
## HapModuleInfo<sup>(deprecated)<sup>
...
...
@@ -19,19 +19,19 @@ Hap模块信息,未做特殊说明的属性,均通过GET_BUNDLE_DEFAULT获
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- |
| name | string | 是 | 否 | 模块名称 |
| description | string | 是 | 否 | 模块描述信息 |
| descriptionId | number | 是 | 否 | 描述信息ID |
| icon | string | 是 | 否 | 模块图标 |
| label | string | 是 | 否 | 模块标签 |
| labelId | number | 是 | 否 | 模块标签ID |
| iconId | number | 是 | 否 | 模块图标ID |
| backgroundImg | string | 是 | 否 | 模块背景图片 |
| supportedModes | number | 是 | 否 | 模块支持的模式 |
| reqCapabilities | Array
\<
string> | 是 | 否 | 模块运行需要的能力 |
| deviceTypes | Array
\<
string> | 是 | 否 | 支持运行的设备类型 |
| abilityInfo | Array
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 是 | 否 | Ability信息 |
| moduleName | string | 是 | 否 | 模块名 |
| mainAbilityName | string | 是 | 否 | 入口Ability名称 |
| installationFree | boolean | 是 | 否 | 是否支持免安装 |
| name | string | 是 | 否 | 模块名称
。
|
| description | string | 是 | 否 | 模块描述信息
。
|
| descriptionId | number | 是 | 否 | 描述信息ID
。
|
| icon | string | 是 | 否 | 模块图标
。
|
| label | string | 是 | 否 | 模块标签
。
|
| labelId | number | 是 | 否 | 模块标签ID
。
|
| iconId | number | 是 | 否 | 模块图标ID
。
|
| backgroundImg | string | 是 | 否 | 模块背景图片
。
|
| supportedModes | number | 是 | 否 | 模块支持的模式
。
|
| reqCapabilities | Array
\<
string> | 是 | 否 | 模块运行需要的能力
。
|
| deviceTypes | Array
\<
string> | 是 | 否 | 支持运行的设备类型
。
|
| abilityInfo | Array
\<
[
AbilityInfo
](
js-apis-bundle-AbilityInfo.md
)
> | 是 | 否 | Ability信息
。
|
| moduleName | string | 是 | 否 | 模块名
。
|
| mainAbilityName | string | 是 | 否 | 入口Ability名称
。
|
| installationFree | boolean | 是 | 否 | 是否支持免安装
。
|
zh-cn/application-dev/reference/apis/js-apis-bundle-ModuleInfo.md
浏览文件 @
4f2c1724
...
...
@@ -2,7 +2,7 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
应用程序的模块信息
应用程序的模块信息
。
## ModuleInfo<sup>(deprecated)<sup>
> 从API version 9开始不再维护,建议使用[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)替代。
...
...
@@ -10,5 +10,5 @@
**系统能力**
: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------ | ---- | ---- | -------- |
| moduleName | string | 是 | 否 | 模块名称 |
| moduleSourceDir | string | 是 | 否 | 安装目录 |
\ No newline at end of file
| moduleName | string | 是 | 否 | 模块名称。 |
| moduleSourceDir | string | 是 | 否 | 安装目录。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md
浏览文件 @
4f2c1724
...
...
@@ -7,7 +7,7 @@
配置文件中定义的权限详细信息
配置文件中定义的权限详细信息
。
## **PermissionDef**<sup>(deprecated)<sup>
...
...
@@ -19,7 +19,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------- | ------ | ---- | ---- | -------------- |
| permissionName | string | 是 | 否 | 用户权限名称 |
| grantMode | number | 是 | 否 | 权限的授予模式 |
| labelId | number | 是 | 否 | 权限的标签ID |
| descriptionId | number | 是 | 否 | 描述权限的ID |
\ No newline at end of file
| permissionName | string | 是 | 否 | 权限名称。 |
| grantMode | number | 是 | 否 | 权限的授予模式,0表示安装后系统自动授予该权限,1表示使用时动态申请,用户授权后方可使用。 |
| labelId | number | 是 | 否 | 权限的标签ID。 |
| descriptionId | number | 是 | 否 | 描述权限的ID。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md
浏览文件 @
4f2c1724
...
...
@@ -33,15 +33,15 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- |
| id | string | 是 | 否 | 快捷方式所属应用程序的Id |
| bundleName | string | 是 | 否 | 包含快捷方式的包名称 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息 |
| icon | string | 是 | 否 | 快捷方式的图标 |
| iconId
<sup>
8+
</sup>
| number | 是 | 否 | 快捷方式的图标Id |
| label | string | 是 | 否 | 快捷方式的标签 |
| labelId
<sup>
8+
</sup>
| number | 是 | 否 | 快捷方式的标签Id |
| disableMessage | string | 是 | 否 | 快捷方式的禁用消息 |
| wants | Array
<
[ShortcutWant](#shortcutwant)
>
| 是 | 否 | 快捷方式所需要的信息 |
| isStatic | boolean | 是 | 否 | 快捷方式是否为静态 |
| isHomeShortcut | boolean | 是 | 否 | 快捷方式是否为主页面快捷方式 |
| isEnabled | boolean | 是 | 否 | 是否启用快捷方式 |
\ No newline at end of file
| id | string | 是 | 否 | 快捷方式所属应用程序的Id。 |
| bundleName | string | 是 | 否 | 包含该快捷方式的包名称。 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息。 |
| icon | string | 是 | 否 | 快捷方式的图标。 |
| iconId
<sup>
8+
</sup>
| number | 是 | 否 | 快捷方式的图标Id。 |
| label | string | 是 | 否 | 快捷方式的名称。 |
| labelId
<sup>
8+
</sup>
| number | 是 | 否 | 快捷方式的名称Id。 |
| disableMessage | string | 是 | 否 | 快捷方式的禁用消息。 |
| wants | Array
<
[ShortcutWant](#shortcutwant)
>
| 是 | 否 | 快捷方式意图列表。 |
| isStatic | boolean | 是 | 否 | 快捷方式是否为静态。 |
| isHomeShortcut | boolean | 是 | 否 | 快捷方式是否为主页面快捷方式。 |
| isEnabled | boolean | 是 | 否 | 是否启用快捷方式。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md
浏览文件 @
4f2c1724
...
...
@@ -7,7 +7,7 @@
包含基本远程能力信息
remoteAbility信息。
## RemoteAbilityInfo<sup>(deprecated)<sup>
...
...
@@ -20,6 +20,6 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- |
| elementName |
[
ElementName
](
js-apis-bundle-ElementName.md
)
| 是 | 否 |
指明的ability信息
|
| label | string | 是 | 否 | 指明ability的
标签信息
|
| icon | string | 是 | 否 | 指明的ability的图标信息 |
| elementName |
[
ElementName
](
js-apis-bundle-ElementName.md
)
| 是 | 否 |
ability元素资源信息。
|
| label | 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';
## defaultAppMgr.ApplicationType
应用类型
默认应用的应用类型。
**系统能力:**
SystemCapability.BundleManager.BundleFramework.DefaultApp
...
...
@@ -88,7 +88,7 @@ isDefaultApplication(type: string, callback: AsyncCallback\<boolean>): void
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
isDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
(
err
,
data
)
=>
{
if
(
err
)
{
...
...
@@ -136,7 +136,7 @@ getDefaultApplication(type: string, userId?: number): Promise\<BundleInfo>
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
getDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
)
.
then
((
data
)
=>
{
...
...
@@ -187,7 +187,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\<Bun
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
let
userId
=
100
;
defaultAppMgr
.
getDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
userId
,
(
err
,
data
)
=>
{
...
...
@@ -238,7 +238,7 @@ getDefaultApplication(type: string, callback: AsyncCallback\<BundleInfo>) : void
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
getDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
(
err
,
data
)
=>
{
if
(
err
)
{
...
...
@@ -260,12 +260,6 @@ defaultAppMgr.getDefaultApplication("image/png", (err, data) => {
setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise
\<
void>
| 类型 | 说明 |
| ----------------------------------------------------------- | --------------------------- |
| Promise
\<
void> | Promise对象,返回BundleInfo |
>
以异步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型设置默认应用,使用Promise形式返回结果。
**需要权限:**
ohos.permission.SET_DEFAULT_APPLICATION
...
...
@@ -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):
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
setDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
{
bundleName
:
"
com.test.app
"
,
...
...
@@ -367,7 +361,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
let
userId
=
100
;
defaultAppMgr
.
setDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
{
...
...
@@ -484,7 +478,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\<void>
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
let
userId
=
100
;
defaultAppMgr
.
resetDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
userId
)
...
...
@@ -535,7 +529,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\<v
**示例:**
```
j
s
```
t
s
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
let
userId
=
100
;
defaultAppMgr
.
resetDefaultApplication
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
userId
,
(
err
,
data
)
=>
{
...
...
zh-cn/application-dev/reference/apis/js-apis-system-package.md
浏览文件 @
4f2c1724
...
...
@@ -12,7 +12,7 @@
```
import p
kg
from '@system.package';
import p
ackage
from '@system.package';
```
...
...
@@ -31,12 +31,9 @@ hasInstalled(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
|options |
[
CheckPackageHasInstalledOptions
](
#checkpackagehasinstalledoptions
)
| 是 | 选项参数。 |
success返回值:
**返回值:**
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
...
...
@@ -44,10 +41,10 @@ success返回值:
**示例:**
```
```
ts
export
default
{
hasInstalled
()
{
p
kg.hasInstalled({
p
ackage
.
hasInstalled
({
bundleName
:
'
com.example.bundlename
'
,
success
:
function
(
data
)
{
console
.
log
(
'
package has installed:
'
+
data
);
...
...
@@ -59,3 +56,28 @@ export default {
},
}
```
## 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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录