提交 ec58683b 编写于 作者: zyjhandsome's avatar zyjhandsome

包名 -> Bundle名称,hap包 -> HAP

start build
Signed-off-by: zyjhandsome's avatarzyjhandsome <zyjhandsome@126.com>
上级 873fa242
......@@ -5,7 +5,7 @@ Delegator测试框架是OpenHarmony提供的一套开发者应用自测试框架
## 约束与限制
测试框架相关接口只能在测试hap包中使用,只有通过`aa test`命令或者DevEco Studio启动测试环境后相关接口才能生效。
测试框架相关接口只能在测试HAP中使用,只有通过`aa test`命令或者DevEco Studio启动测试环境后相关接口才能生效。
## 测试框架启动
......@@ -17,7 +17,7 @@ Delegator测试框架是OpenHarmony提供的一套开发者应用自测试框架
### aa test启动
开发者可通过 `aa test` 命令启动测试框架,开发者可以自行指定使用的TestRunner以及TestRunner所在hap包的package name或module name,具体命令示例如下:
开发者可通过 `aa test` 命令启动测试框架,开发者可以自行指定使用的TestRunner以及TestRunner所在HAP的package name或module name,具体命令示例如下:
**FA模型:**
......@@ -31,9 +31,9 @@ aa test -b BundleName -m com.example.myapplicationfaets -s unittest OpenHarmonyT
```
| 参数 | 是否必选 | 参数说明 |
| --------------- | -------- | ------------------------------------------------------------ |
| -b | 是 | TestRunner所在hap包的bundle name。 |
| -p | 是 | TestRunner所在hap包的package name,FA模型使用。 |
| -m | 是 | TestRunner所在hap包的module name,Stage模型使用。 |
| -b | 是 | TestRunner所在HAP的bundle name。 |
| -p | 是 | TestRunner所在HAP的package name,FA模型使用。 |
| -m | 是 | TestRunner所在HAP的module name,Stage模型使用。 |
| -s unittest | 是 | 启用的TestRunner名称,TestRunner名称和文件名需要保持一致。 |
| -w | 否 | 测试用例超时时间,单位为秒,如果未指定或指定小于等于0的整数,测试框架会一直等待测试代码调用finishTest才退出。 |
| -s \<key>\<value> | 否 | 支持以key-value的方式输入任何参数,输入的参数可通过AbilityDelegatorArgs.parameters以key-value的方式获取。示例:-s classname myTest,key为"-s classname",value为"myTest"。 |
......
......@@ -77,7 +77,7 @@ Ability为开发者提供了startAbility()方法来启动另外一个Ability。
开发者可以通过构造包含bundleName与abilityName的Want对象来设置目标Service信息。参数的含义如下:
- bundleName:表示对端应用的名称。
- bundleName:表示对端应用的Bundle名称。
- abilityName:表示待启动的Ability名称。
启动本地设备Service的代码示例如下:
......@@ -157,7 +157,7 @@ featureAbility.startAbility(
```ts
import prompt from '@system.prompt'
var option = {
onConnect: function onConnectCallback(element, proxy) {
console.log(`onConnectLocalService onConnectDone`);
......@@ -196,7 +196,7 @@ featureAbility.startAbility(
```ts
import featureAbility from '@ohos.ability.featureAbility'
let want = {
bundleName: "com.jstest.service",
abilityName: "com.jstest.service.ServiceAbility"
......@@ -210,7 +210,7 @@ featureAbility.startAbility(
```ts
import rpc from "@ohos.rpc"
class ServiceAbilityStub extends rpc.RemoteObject {
constructor(des: any) {
if (typeof des === 'string') {
......@@ -220,7 +220,7 @@ featureAbility.startAbility(
return;
}
}
onRemoteRequest(code: number, data: any, reply: any, option: any) {
console.log("onRemoteRequest called");
// 可根据code执行不同的业务逻辑
......@@ -237,7 +237,7 @@ featureAbility.startAbility(
return true;
}
}
export default {
onStart() {
console.log('ServiceAbility onStart');
......
......@@ -79,29 +79,29 @@ Ability功能如下(Ability类,具体的API详见[接口文档](../reference
onCreate(want, launchParam) {
console.log("MainAbility onCreate")
}
onDestroy() {
console.log("MainAbility onDestroy")
}
onWindowStageCreate(windowStage) {
console.log("MainAbility onWindowStageCreate")
windowStage.loadContent("pages/index").then(() => {
console.log("MainAbility load content succeed")
}).catch((error) => {
console.error("MainAbility load content failed with error: " + JSON.stringify(error))
})
}
onWindowStageDestroy() {
console.log("MainAbility onWindowStageDestroy")
}
onForeground() {
console.log("MainAbility onForeground")
}
onBackground() {
console.log("MainAbility onBackground")
}
......@@ -110,7 +110,7 @@ Ability功能如下(Ability类,具体的API详见[接口文档](../reference
### 获取AbilityStage及Ability的配置信息
AbilityStage类及Ability类均拥有context属性,应用可以通过`this.context`获取Ability实例的上下文,进而获取详细的配置信息。
如下示例展示了AbilityStage通过context属性获取包代码路径、hap包名、Ability名以及系统语言的方法。具体示例代码如下:
如下示例展示了AbilityStage通过context属性获取包代码路径、HAP包名、Ability名称以及系统语言的方法。具体示例代码如下:
```ts
import AbilityStage from "@ohos.application.AbilityStage"
......@@ -130,7 +130,7 @@ export default class MyAbilityStage extends AbilityStage {
}
```
如下示例展示了Ability通过context属性获取包代码路径、hap包名、Ability名以及系统语言的方法。具体示例代码如下:
如下示例展示了Ability通过context属性获取包代码路径、HAP包名、Ability名称以及系统语言的方法。具体示例代码如下:
```ts
import Ability from '@ohos.application.Ability'
export default class MainAbility extends Ability {
......
......@@ -2,13 +2,13 @@
## 设计思想
Stage模型的设计,是为了提供给开发者一个更好的开发方式,更好的适用于多设备、分布式场景。
Stage模型的设计,是为了提供给开发者一个更好的开发方式,更好的适用于多设备、分布式场景。
Stage模型的设计思想如下图所示。
Stage模型的设计思想如下图所示。
![stagedesign](figures/stagedesign.png)
Stage模型的设计基于如下三个出发点:
Stage模型的设计基于如下三个出发点:
- **应用进程的有序管理**
......@@ -32,7 +32,7 @@ Stage模型重新定义了Ability的生命周期。系统在架构上,将应
- **Bundle**:通过appid标识的OpenHarmony应用,Bundle可以包含多个HAP,每个应用都有一个bundleName,但是bundleName并不能唯一标识一个应用,appid中包含bundleName以及其他的更多信息,能够唯一标识一个应用;
- **AbilityStage**:对应HAP的运行期对象,在HAP首次加载到进程中时创建,运行期开发者可见;
- **Application**:对应Bundle的运行期对象,运行期开发者不可见;
- **Context**:提供运行期开发者可以调用的各种能力,Ability组件和各种ExtensionAbility都有各自不同的Context类,他们都继承自基类Context,基类提供包名、moduleName、路径等信息;
- **Context**:提供运行期开发者可以调用的各种能力,Ability组件和各种ExtensionAbility都有各自不同的Context类,他们都继承自基类Context,基类提供Bundle名称、moduleName、路径等信息;
- **Ability**:提供生命周期回调,持有AbilityContext,支持组件的跨端迁移和多端协同;
- **ExtensionAbility**:基于场景的扩展能力统称,系统定义了多种场景的ExtensionAbility类,它们持有各自的ExtensionContext;
- **WindowStage**:本地窗口管理器;
......
# 应用/组件级配置
开发者在开发应用时,需要配置应用的一些标签,例如应用的包名、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。
开发者在开发应用时,需要配置应用的一些标签,例如应用的Bundle名称、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。
- **应用包名配置**
......
......@@ -238,7 +238,7 @@
4. 连接一个后台服务。
- 实现IAbilityConnection接口。IAbilityConnection提供了以下方法供开发者实现:onConnect()是用来处理连接Service成功的回调,onDisconnect()是用来处理Service异常终止的回调,onFailed()是用来处理连接Service失败的回调。
- 设置目标组件参数,包括目标设备ID、包名、ability名
- 设置目标组件参数,包括目标设备ID、Bundle名称、Ability名称
- 调用connectServiceExtensionAbility发起连接。
- 连接成功,收到目标设备返回的服务句柄。
- 进行跨设备调用,获得目标端服务返回的结果。
......
......@@ -4,9 +4,9 @@
OpenHarmony的进程模型如下图所示:
- 应用中(同一包名)的所有UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个独立进程中,即图中绿色部分的“Main Process”。
- 应用中(同一Bundle名称)的所有UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个独立进程中,即图中绿色部分的“Main Process”。
- 应用中(同一包名)的同一类型ExtensionAbility(除ServiceExtensionAbility和DataShareExtensionAbility外)运行在一个独立进程中,即图中蓝色部分的“FormExtensionAbility Process”、“InputMethodExtensionAbility Process”、其他ExtensionAbility Process。
- 应用中(同一Bundle名称)的同一类型ExtensionAbility(除ServiceExtensionAbility和DataShareExtensionAbility外)运行在一个独立进程中,即图中蓝色部分的“FormExtensionAbility Process”、“InputMethodExtensionAbility Process”、其他ExtensionAbility Process。
- WebView拥有独立的渲染进程,即图中黄色部分的“Render Process”。
......
......@@ -3,7 +3,7 @@
## Want的定义与用途
[Want](../reference/apis/js-apis-app-ability-want.md)是对象间信息传递的载体,可以用于应用组件间的信息传递。其使用场景之一是作为startAbility()的参数,包含了指定的启动目标以及启动时需携带的相关数据,如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA启动UIAbilityB并需要传入一些数据给UIAbilityB时,Want可以作为一个载体将数据传给UIAbilityB。
[Want](../reference/apis/js-apis-app-ability-want.md)是对象间信息传递的载体,可以用于应用组件间的信息传递。其使用场景之一是作为startAbility()的参数,包含了指定的启动目标以及启动时需携带的相关数据,如bundleName和abilityName字段分别指明目标Ability所在应用的Bundle名称以及对应包内的Ability名称。当UIAbilityA启动UIAbilityB并需要传入一些数据给UIAbilityB时,Want可以作为一个载体将数据传给UIAbilityB。
**图1** Want用法示意
<img src="figures/usage-of-want.png" alt="usage-of-want" style="zoom:80%;" />
......@@ -12,7 +12,7 @@
## Want的类型
- **显式Want**:在启动Ability时指定了abilityName和bundleName的Want称为显式Want。
当有明确处理请求的对象时,通过提供目标Ability所在应用的包名信息(bundleName),并在Want内指定abilityName便可启动目标Ability。显式Want通常用于在当前应用开发中启动某个已知的Ability。参数说明参见[Want参数说明](want-overview.md#Want参数说明)
当有明确处理请求的对象时,通过提供目标Ability所在应用的Bundle名称信息(bundleName),并在Want内指定abilityName便可启动目标Ability。显式Want通常用于在当前应用开发中启动某个已知的Ability。参数说明参见[Want参数说明](want-overview.md#Want参数说明)
```ts
let wantInfo = {
......
......@@ -180,7 +180,7 @@ export default function abilityTest() {
| 执行参数全写 | 执行参数缩写 | 执行参数含义 | 执行参数示例 |
| ------------- | ------------ | -------------------------------------- | ---------------------------------- |
| --bundleName | -b | 应用包名 | - b com.test.example |
| --bundleName | -b | 应用Bundle名称 | - b com.test.example |
| --packageName | -p | 应用模块名,适用于FA模型应用 | - p com.test.example.entry |
| --moduleName | -m | 应用模块名,适用于STAGE模型应用 | -m entry |
| NA | -s | 特定参数,以<key, value>键值对方式传入 | - s unittest OpenHarmonyTestRunner |
......
......@@ -17,7 +17,7 @@
**表1** 分布式数据对象实例创建接口
| 包名 | 接口名 | 描述 |
| Bundle名称 | 接口名 | 描述 |
| -------- | -------- | -------- |
| ohos.data.distributedDataObject| createDistributedObject(source: object): DistributedObject | 创建一个分布式数据对象实例,用于数据操作。 <br>-&nbsp;source:设置分布式数据对象的属性。<br>-&nbsp;DistributedObject:返回值是创建好的分布式数据对象。 |
......@@ -27,7 +27,7 @@
**表2** 分布式数据对象sessionId创建接口
| 包名 | 接口名 | 描述 |
| Bundle名称 | 接口名 | 描述 |
| -------- | -------- | -------- |
| ohos.data.distributedDataObject| genSessionId(): string | 创建一个sessionId,可作为分布式数据对象的sessionId。 |
......@@ -125,7 +125,7 @@
grantPermission();
```
3. 获取分布式数据对象实例。
```js
......@@ -176,7 +176,7 @@
});
}
}
// 发起方要在changeCallback里刷新界面,则需要将正确的this绑定给changeCallback
localObject.on("change", this.changeCallback.bind(this));
```
......
......@@ -24,7 +24,7 @@
**表1** 首选项实例创建接口
| 包名 | 接口名 | 描述 |
| Bundle名称 | 接口名 | 描述 |
| --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| ohos.data.preferences | getPreferences(context: Context, name: string): Promise\<Preferences> | 读取指定首选项持久化文件,将数据加载到Preferences实例,用于数据操作。 |
......@@ -75,7 +75,7 @@
**表6** 首选项删除接口
| 包名 | 接口名 | 描述 |
| Bundle名称 | 接口名 | 描述 |
| --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| ohos.data.preferences | deletePreferences(context: Context, name: string): Promise\<void> | 从缓存中移除已加载的Preferences对象,同时从设备上删除对应的文件。 |
| ohos.data.preferences | removePreferencesFromCache(context: Context, name: string): Promise\<void> | 仅从缓存中移除已加载的Preferences对象,主要用于释放内存。 |
......
......@@ -91,11 +91,11 @@ Ability配置中缺少startWindowIcon属性配置,需要在module.json5中abil
推荐使用方式参考:[Stage模型的Context详细介绍](../application-models/application-context-stage.md)
## 如何在应用A中去获取应用B的Hap包的安装路径
## 如何在应用A中去获取应用B的HAP包的安装路径
适用于:OpenHarmony SDK 3.0以上版本, API9 Stage模型
首先需要申请系统权限,具体参看文档:[自动化签名](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465)。导入bundle模块,通过调用bundle.getApplicationInfo()接口,通过包名获取应用信息。然后通过application.moduleSourceDirs获取应用存储路径。
首先需要申请系统权限,具体参看文档:[自动化签名](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-auto-configuring-signature-information-0000001271659465)。导入bundle模块,通过调用bundle.getApplicationInfo()接口,通过Bundle名称获取应用信息。然后通过application.moduleSourceDirs获取应用存储路径。
## 调用方使用startAbilityForResult,被调用方如何返回数据
......
......@@ -78,12 +78,12 @@ DevEco Studio的基本使用,请参考[DevEco Studio使用指南](../../quick-
通过修改每个模块中的配置文件(module.json5)对模块进行配置,配置文件中各字段含义详见[配置文件说明](../../quick-start/module-configuration-file.md)
- 将default模块的deviceTypes配置为["default", "tablet"],同时将其type字段配置为entry。
即default模块编译出的hap包在默认设备和平板上安装和运行。
即default模块编译出的HAP在默认设备和平板上安装和运行。
![zh-cn_image_0000001267914116](figures/zh-cn_image_0000001267914116.png)
- 将wearable模块的deviceTypes配置为["wearable"],同时将其type字段配置为entry。
即wearable模块编译出的hap包仅在智能穿戴设备上安装和运行。
即wearable模块编译出的HAP仅在智能穿戴设备上安装和运行。
![zh-cn_image_0000001267514192](figures/zh-cn_image_0000001267514192.png)
......
......@@ -140,7 +140,7 @@ OpenHarmony提供了方舟开发框架(简称:ArkUI),提供开发者进
│ ├── feature1 # 子功能1, har类型的module
│ ├── feature2 # 子功能2, har类型的module
│ └── ...
└── product # 必选。产品层目录, entry类型的module,编译后为hap包
└── product # 必选。产品层目录, entry类型的module,编译后为HAP
```
部署模型B对应的代码工程结构抽象后一般如下所示:
......@@ -154,8 +154,8 @@ OpenHarmony提供了方舟开发框架(简称:ArkUI),提供开发者进
│ ├── feature2 # 子功能2, har类型的module
│ └── ...
└── product # 必选。产品层目录
├── wearable # 智能穿戴泛类目录, entry类型的module,编译后为hap包
├── default # 默认设备泛类目录, entry类型的module,编译后为hap包
├── wearable # 智能穿戴泛类目录, entry类型的module,编译后为HAP
├── default # 默认设备泛类目录, entry类型的module,编译后为HAP
└── ...
```
......
......@@ -34,7 +34,7 @@ app.json5配置文件包含以下标签。
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| bundleName | 标识应用的包名,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则&nbsp;<br/>-&nbsp;字符串以字母、数字、下划线和符号“.”组成。<br/>-&nbsp;以字母开头。<br/>-&nbsp;最小长度7个字节,最大长度127个字节。<br/>推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。<br/>其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,&nbsp;ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| bundleName | 标识应用的Bundle名称,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则&nbsp;<br/>-&nbsp;字符串以字母、数字、下划线和符号“.”组成。<br/>-&nbsp;以字母开头。<br/>-&nbsp;最小长度7个字节,最大长度127个字节。<br/>推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。<br/>其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,&nbsp;ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| debug | 标识应用是否可调试,该标签由IDE编译构建时生成。<br/>-&nbsp;true:可调试。<br/>-&nbsp;false:不可调式。 | 布尔值 | 该标签可以缺省,缺省为false。 |
| icon | 标识[应用的图标](../application-models/application-component-configuration-stage.md),标签值为图标资源文件的索引。 | 字符串 | 该标签不可缺省。 |
| label | 标识[应用的名称](../application-models/application-component-configuration-stage.md),标签值为字符串资源的索引。 | 字符串 | 该标签不可缺省。 |
......
......@@ -7,7 +7,7 @@ app对象包含应用全局配置信息,内部结构如下:
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| bundleName | 标识应用的包名,用于标识应用的唯一性。包名是由字母、数字、下划线(_)和点号(.)组成的字符串,必须以字母开头。支持的字符串长度为7~127字节。包名通常采用反向域名形式表示(例如,"com.example.myapplication")。建议第一级为域名后缀"com",第二级为厂商/个人名,也可以采用多级。 | 字符串 | 不可缺省。 |
| bundleName | 标识应用的Bundle名称,用于标识应用的唯一性。Bundle名称是由字母、数字、下划线(_)和点号(.)组成的字符串,必须以字母开头。支持的字符串长度为7~127字节。Bundle名称通常采用反向域名形式表示(例如,"com.example.myapplication")。建议第一级为域名后缀"com",第二级为厂商/个人名,也可以采用多级。 | 字符串 | 不可缺省。 |
| vendor | 标识对应用开发厂商的描述。字符串长度不超过255字节。 | 字符串 | 可缺省,缺省值为空。 |
|version | 标识应用的版本信息。 | 对象 | 不可缺省。 |
| apiVersion | 标识应用程序所依赖的OpenHarmony&nbsp;API版本。 | 对象 | 可缺省,缺省值为空。 |
......
......@@ -7,7 +7,7 @@
应用配置文件需申明以下内容:
- 应用的软件名称,应用的开发厂商,版本号等应用的基本配置信息,这些信息被要求设置在app这个字段下。
- 应用的软件Bundle名称,应用的开发厂商,版本号等应用的基本配置信息,这些信息被要求设置在app这个字段下。
- 应用的组件的基本信息,包括所有的Ability,设备类型,组件的类型以及当前组件所使用的语法类型。
......
......@@ -10,7 +10,7 @@
[app.json5](app-configuration-file.md)主要包含以下内容:
- 应用的全局配置信息,包含应用的包名、开发厂商、版本号等基本信息。
- 应用的全局配置信息,包含应用的Bundle名称、开发厂商、版本号等基本信息。
- 特定设备类型的配置信息。
......
......@@ -441,7 +441,7 @@ metadata中指定shortcut信息,其中:
| shortcutId | 标识快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 该标签不可缺省。 |
| label | 标识快捷方式的标签信息,即快捷方式对外显示的文字描述信息。取值可以是描述性内容,也可以是标识label的资源索引。字符串最大长度为255字节。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识快捷方式的图标,标签值为资源文件的索引。 | 字符串 | 该标签可缺省,缺省值为空。 |
| [wants](../application-models/want-overview.md) | 标识快捷方式内定义的目标wants信息集合,每个wants可配置bundleName和abilityName两个子标签。<br/>bundleName:表示快捷方式的目标包名,字符串类型。<br/>abilityName:表示快捷方式的目标组件名,字符串类型。 | 对象 | 该标签可缺省,缺省为空。 |
| [wants](../application-models/want-overview.md) | 标识快捷方式内定义的目标wants信息集合,每个wants可配置bundleName和abilityName两个子标签。<br/>bundleName:表示快捷方式的目标Bundle名称,字符串类型。<br/>abilityName:表示快捷方式的目标组件名,字符串类型。 | 对象 | 该标签可缺省,缺省为空。 |
1. 在/resource/base/profile/目录下配置shortcuts_config.json配置文件。
......
......@@ -10,7 +10,7 @@ IDE支持在一个应用工程中进行多个HAP的开发与构建,如下图
1. IDE开发态视图
- AppScope目录
- [app.json5](app-configuration-file.md):配置应用全局描述信息,例如应用包名、版本号、应用图标、应用名称和依赖的SDK版本号等。
- [app.json5](app-configuration-file.md):配置应用全局描述信息,例如应用Bundle名称、版本号、应用图标、应用名称和依赖的SDK版本号等。
- resources目录:放置应用的图标资源和应用名称字符串资源。
**说明:**
......
......@@ -4,7 +4,7 @@
多HAP机制主要是为方便开发者进行模块化管理。HAP和应用运行时的进程并不是一一对应的,具体运行机制如下:
- 默认情况下,应用中(同一包名)的所有UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个独立进程中,其他同类型ExtensionAbility分别运行在单独的进程。
- 默认情况下,应用中(同一Bundle名称)的所有UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个独立进程中,其他同类型ExtensionAbility分别运行在单独的进程。
- HAP支持在module.json5(Stage模型)或者config.json(FA模型)中通过process标签配置单独的进程(仅系统应用支持,三方应用不支持)。配置了process的HAP,其组件运行在单独的process进程中,多个HAP可以配置相同的process,则这些HAP运行在相同进程中,process配置的详细说明请参见[module.json5配置文件](module-configuration-file.md)
......
......@@ -21,7 +21,7 @@ SystemCapability.BundleManager.BundleFramework
getLauncherAbilityInfos(bundleName: string, userId: number, callback: AsyncCallback&lt;Array&lt;LauncherAbilityInfo&gt;&gt;) : void;
以异步方法根据给定的包名获取LauncherAbilityInfos,使用callback形式返回结果。
以异步方法根据给定的Bundle名称获取LauncherAbilityInfos,使用callback形式返回结果。
> 从API version 9开始不再支持。建议使用[launcherBundleManager#getLauncherAbilityInfo](js-apis-launcherBundleManager.md)替代。
**需要权限:**
......@@ -38,18 +38,18 @@ SystemCapability.BundleManager.BundleFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------ |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
| callback | AsyncCallback\<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
## innerBundleManager.getLauncherAbilityInfos<sup>(deprecated)</sup>
getLauncherAbilityInfos(bundleName: string, userId: number) : Promise&lt;Array&lt;LauncherAbilityInfo&gt;&gt;
以异步方法根据给定的包名获取LauncherAbilityInfos,使用Promise形式返回结果。
以异步方法根据给定的Bundle名称获取LauncherAbilityInfos,使用Promise形式返回结果。
> 从API version 9开始不再支持。建议使用[launcherBundleManager#getLauncherAbilityInfo](js-apis-launcherBundleManager.md)替代。
**需要权限:**
......@@ -66,9 +66,9 @@ SystemCapability.BundleManager.BundleFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ----------------------------- |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| userId | number | 是 | 用户ID。取值范围:大于等于0。 |
**返回值:**
......@@ -254,7 +254,7 @@ SystemCapability.BundleManager.BundleFramework
getShortcutInfos(bundleName :string, callback: AsyncCallback&lt;Array&lt;ShortcutInfo&gt;&gt;) : void;
以异步方法根据给定的包名获取快捷方式信息,使用callback形式返回结果。
以异步方法根据给定的Bundle名称获取快捷方式信息,使用callback形式返回结果。
> 从API version 9开始不再支持。建议使用[launcherBundleManager#getShortcutInfo](js-apis-launcherBundleManager.md)替代。
**需要权限:**
......@@ -273,14 +273,14 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback\<Array<[ShortcutInfo](js-apis-bundle-ShortcutInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回快捷方式信息。 |
## innerBundleManager.getShortcutInfos<sup>(deprecated)</sup>
getShortcutInfos(bundleName : string) : Promise&lt;Array&lt;ShortcutInfo&gt;&gt;
以异步方法根据给定的包名获取快捷方式信息,使用Promise形式返回结果。
以异步方法根据给定的Bundle名称获取快捷方式信息,使用Promise形式返回结果。
> 从API version 9开始不再支持。建议使用[launcherBundleManager#getShortcutInfo](js-apis-launcherBundleManager.md)替代。
**需要权限:**
......@@ -299,7 +299,7 @@ SystemCapability.BundleManager.BundleFramework
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------ |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
**返回值:**
......
......@@ -68,7 +68,7 @@ onBundleAdded(bundleName: string): void
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| bundleName | string | 是 | 安装应用包名。 |
| bundleName | string | 是 | 安装应用Bundle名称。 |
**示例:**
......@@ -94,7 +94,7 @@ onBundleRemoved(bundleName: string): void
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| bundleName | string | 是 | 卸载应用包名。 |
| bundleName | string | 是 | 卸载应用Bundle名称。 |
**示例:**
......
......@@ -31,7 +31,7 @@ class MainAbility extends Ability {
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| abilityInfo | AbilityInfo | 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前hap包的信息 |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前HAP的信息 |
| config | [Configuration](js-apis-application-configuration.md) | 是 | 否 | 表示配置信息。 |
## AbilityContext.startAbility
......
......@@ -50,7 +50,7 @@ want操作的常数。
| ACTION_MARKET_DOWNLOAD <sup>9+</sup> | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| ACTION_MARKET_CROWDTEST <sup>9+</sup> | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_SANDBOX<sup>9+</sup> |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_BUNDLE_NAME<sup>9+</sup> |ohos.dlp.params.bundleName |指示DLP名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_BUNDLE_NAME<sup>9+</sup> |ohos.dlp.params.bundleName |指示DLP Bundle名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_MODULE_NAME<sup>9+</sup> |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_ABILITY_NAME<sup>9+</sup> |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_INDEX<sup>9+</sup> |ohos.dlp.params.index |指示DLP索引参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
......
......@@ -51,8 +51,8 @@ import accessibility from '@ohos.accessibility';
| -------- | -------- | -------- | -------- | -------- |
| id | string | 是 | 否 | ability&nbsp;id。 |
| name | string | 是 | 否 | ability 名。 |
| bundleName | string | 是 | 否 | 包名。 |
| targetBundleNames<sup>9+</sup> | Array&lt;string&gt; | 是 | 否 | 关注的目标包名。 |
| bundleName | string | 是 | 否 | Bundle名称。 |
| targetBundleNames<sup>9+</sup> | Array&lt;string&gt; | 是 | 否 | 关注的目标Bundle名称。 |
| abilityTypes | Array&lt;[AbilityType](#abilitytype)&gt; | 是 | 否 | 辅助应用类型。 |
| capabilities | Array&lt;[Capability](#capability)&gt; | 是 | 否 | 辅助应用能力列表。 |
| description | string | 是 | 否 | 辅助应用描述。 |
......@@ -209,7 +209,7 @@ try {
console.error('failed to subscribe caption manager style state change, because ' + JSON.stringify(exception));
}
```
### off('enableChange')
off(type: 'enableChange', callback?: Callback&lt;boolean&gt;): void;
......@@ -773,7 +773,7 @@ accessibility.isOpenTouchGuide((err, data) => {
}
console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data))
});
```
```
## accessibility.sendEvent<sup>(deprecated)</sup>
......
......@@ -44,9 +44,9 @@ onAcceptWant(want: Want): string;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
**返回值:**
......
......@@ -320,7 +320,7 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void
**系统API**:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
......@@ -540,10 +540,10 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
**示例:**
......@@ -578,11 +578,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\<void\> | 是 | 切断account进程的回调函数。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\<void\> | 是 | 切断account进程的回调函数。 |
**示例:**
......@@ -603,7 +603,7 @@ appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountC
killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
通过包名终止进程。
通过Bundle名称终止进程。
**需要权限**:ohos.permission.CLEAN_BACKGROUND_PROCESSES
......@@ -615,7 +615,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例:**
......@@ -640,7 +640,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
killProcessesByBundleName(bundleName: string): Promise\<void>;
通过包名终止进程。
通过Bundle名称终止进程。
**需要权限**:ohos.permission.CLEAN_BACKGROUND_PROCESSES
......@@ -652,7 +652,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
**返回值:**
......@@ -681,7 +681,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
通过包名清除应用数据。
通过Bundle名称清除应用数据。
**需要权限**:ohos.permission.CLEAN_APPLICATION_DATA
......@@ -693,7 +693,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例:**
......@@ -718,7 +718,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
clearUpApplicationData(bundleName: string): Promise\<void>;
通过包名清除应用数据。
通过Bundle名称清除应用数据。
**需要权限**:ohos.permission.CLEAN_APPLICATION_DATA
......@@ -730,7 +730,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
**返回值:**
......
......@@ -22,7 +22,7 @@ hap级别的快速修复信息。
| 名称 | 类型 | 必填 | 说明 |
| ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| moduleName | string | 是 | hap包的名称。 |
| moduleName | string | 是 | HAP的名称。 |
| originHapHash | string | 是 | 指示hap的哈希值。 |
| quickFixFilePath | string | 是 | 指示快速修复文件的安装路径。 |
......@@ -36,7 +36,7 @@ hap级别的快速修复信息。
| 名称 | 类型 | 必填 | 说明 |
| ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 应用的包名。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| bundleVersionCode | number | 是 | 应用的版本号。 |
| bundleVersionName | string | 是 | 应用版本号的文字描述。 |
| quickFixVersionCode | number | 是 | 快速修复补丁包的版本号。 |
......@@ -132,10 +132,10 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 |应用的包名。 |
| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 是 | 应用的快速修复信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 |应用Bundle名称。 |
| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 是 | 应用的快速修复信息。 |
**示例:**
......@@ -168,9 +168,9 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的包名。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用Bundle名称。 |
**返回值:**
......@@ -191,4 +191,4 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
} catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message);
}
```
\ No newline at end of file
```
\ No newline at end of file
......@@ -225,7 +225,7 @@ onNewWant(want: Want, launchParams: UIAbilityConstant.LaunchParam): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数,如ability名称,包名等。 |
| want | [Want](js-apis-app-ability-want.md) | 是 | Want类型参数,如Ability名称,Bundle名称等。 |
| launchParams | UIAbilityConstant.LaunchParam | 是 | UIAbility启动的原因、上次异常退出的原因信息。 |
**示例:**
......
......@@ -44,12 +44,12 @@ want操作的常数。
| INTENT_PARAMS_INTENT | ability.want.params.INTENT | 指示用行为选择器来展示选择的操作。 |
| INTENT_PARAMS_TITLE | ability.want.params.TITLE | 指示与行为选择器一起使用时的字符序列对话框标题。 |
| ACTION_FILE_SELECT | ohos.action.fileSelect | 指示选择文件的操作。 |
| PARAMS_STREAM | ability.params.stream | 指示发送数据时与目标关联的数据流的URI | |
| PARAMS_STREAM | ability.params.stream | 指示发送数据时与目标关联的数据流的URI |
| ACTION_APP_ACCOUNT_AUTH | account.appAccount.action.auth | 指示提供auth服务的操作。 |
| ACTION_MARKET_DOWNLOAD | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| ACTION_MARKET_CROWDTEST | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_SANDBOX |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。<br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_BUNDLE_NAME |ohos.dlp.params.bundleName |指示DLP名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_BUNDLE_NAME |ohos.dlp.params.bundleName |指示DLP Bundle名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_MODULE_NAME |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_ABILITY_NAME |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
| DLP_PARAMS_INDEX |ohos.dlp.params.index |指示DLP索引参数的操作。 <br>**系统API**:该接口为系统接口,三方应用不支持调用。 |
......
......@@ -231,7 +231,7 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括名称、能力名称、模块名称、卡片名和卡片维度。 |
| want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括Bundle名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例:**
......
......@@ -857,7 +857,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback&lt;Array&lt;formInfo.Fo
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback&lt;Array&lt;[FormInfo](js-apis-app-form-formInfo.md)&gt;&gt; | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,err为undefined,data为查询到的卡片信息;否则为错误对象。 |
**错误码:**
......@@ -897,7 +897,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback&lt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| moduleName | string | 是 | 要查询的模块名称。 |
| callback | AsyncCallback&lt;Array&lt;[FormInfo](js-apis-app-form-formInfo.md)&gt;&gt; | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,err为undefined,data为查询到的卡片信息;否则为错误对象。 |
......@@ -938,7 +938,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise&lt;Array&lt;formI
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| moduleName | string | 否 | 要查询的模块名称。 |
**返回值:**
......
......@@ -20,8 +20,8 @@ import formInfo from '@ohos.app.form.formInfo';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
| bundleName | string | 是 | 否 | 卡片所属包的包名。 |
| moduleName | string | 是 | 否 | 卡片所属模块的模块名 |
| bundleName | string | 是 | 否 | 卡片所属包的Bundle名称。 |
| moduleName | string | 是 | 否 | 卡片所属模块的模块名称。 |
| abilityName | string | 是 | 否 | 卡片所属的Ability名称。 |
| name | string | 是 | 否 | 卡片名称。 |
| description | string | 是 | 否 | 卡片描述。 |
......@@ -31,7 +31,7 @@ import formInfo from '@ohos.app.form.formInfo';
| isDefault | boolean | 是 | 否 | 卡片是否是默认卡片。 |
| updateEnabled | boolean | 是 | 否 | 卡片是否使能更新。 |
| formVisibleNotify | string | 是 | 否 | 卡片是否使能可见通知。 |
| relatedBundleName | string | 是 | 否 | 卡片所属的相关联包名。 |
| relatedBundleName | string | 是 | 否 | 卡片所属的相关联Bundle名称。 |
| scheduledUpdateTime | string | 是 | 否 | 卡片更新时间。 |
| formConfigAbility | string | 是 | 否 | 卡片配置ability。指定长按卡片弹出的选择框内,编辑选项所对应的ability。 |
| updateDuration | string | 是 | 否 | 卡片更新周期。 |
......@@ -102,7 +102,7 @@ import formInfo from '@ohos.app.form.formInfo';
| TEMPORARY_KEY | "ohos.extra.param.key.form_temporary" | 临时卡片。 |
| ABILITY_NAME_KEY | "ohos.extra.param.key.ability_name" | ability名称 |
| DEVICE_ID_KEY | "ohos.extra.param.key.device_id" | 设备标识。<br/>**系统接口**: 此接口为系统接口。 |
| BUNDLE_NAME_KEY | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。|
| BUNDLE_NAME_KEY | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑Bundle名称的键。 |
## FormDimension
......
......@@ -30,7 +30,7 @@ setDisposedStatus(appId: string, disposedWant: Want): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| appId | string | 是 | 需要设置处置状态的应用的appId。<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 需要设置处置状态的应用的appId。<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| disposedWant | Want | 是 | 对应用的处置意图。 |
**返回值:**
......@@ -81,7 +81,7 @@ setDisposedStatus(appId: string, disposedWant: Want, callback: AsyncCallback\<vo
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------- | ---- | --------------------------------------- |
| appId | string | 是 | 需要设置处置的应用的appId<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 需要设置处置的应用的appId<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| disposedWant | Want | 是 | 对应用的处置意图。 |
| callback | AsyncCallback\<void> | 是 | 回调函数,当设置处置状态成功,err为undefined,否则为错误对象。 |
......@@ -128,7 +128,7 @@ getDisposedStatus(appId: string): Promise\<Want>;
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| appId | string | 是 | 要查询的应用的appId<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 要查询的应用的appId<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
**返回值:**
......@@ -177,7 +177,7 @@ getDisposedStatus(appId: string, callback: AsyncCallback\<Want>): void;
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| appId | string | 是 | 要查询的应用的appId<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 要查询的应用的appId<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| callback | AsyncCallback\<Want> | 是 | 回调函数。当获取应用的处置状态成功时,err为undefined,data为获取到的处置状态;否则为错误对象。 |
**错误码:**
......@@ -222,7 +222,7 @@ deleteDisposedStatus(appId: string): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| appId | string | 是 | 要删除处置状态的应用的appId<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 要删除处置状态的应用的appId<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
**返回值:**
......@@ -271,7 +271,7 @@ deleteDisposedStatus(appId: string, callback: AsyncCallback\<void>) : void
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| appId | string | 是 | 要查询的应用的appId。<br> appId是应用的唯一标识,由应用的包名和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| appId | string | 是 | 要查询的应用的appId。<br> appId是应用的唯一标识,由应用Bundle名称和签名信息决定,获取方法参见[获取应用的appId](#获取应用的appid) |
| callback | AsyncCallback\<void> | 是 | 回调函数,当设置处置状态成功时,err返回undefined。否则回调函数返回具体错误对象。 |
**错误码:**
......@@ -301,7 +301,7 @@ try {
## 获取应用的appId
appId是应用的唯一标识,由应用的包名和签名信息决定,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)接口获取。
appId是应用的唯一标识,由应用Bundle名称和签名信息决定,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)接口获取。
**示例:**
......
......@@ -225,10 +225,10 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,如ability名称,包名等。 |
| launchParams | AbilityConstant.LaunchParam | 是 | Ability启动的原因、上次异常退出的原因信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,如Ability名称,Bundle名称等。 |
| launchParams | AbilityConstant.LaunchParam | 是 | Ability启动的原因、上次异常退出的原因信息。 |
**示例:**
......@@ -724,7 +724,7 @@ off(method: string): void;
}
}
```
## OnReleaseCallBack
(msg: string): void;
......
......@@ -358,7 +358,7 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\
**系统API**:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| observerId | number | 是 | 表示观察者的编号代码。 |
......@@ -490,10 +490,10 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
**示例:**
......@@ -524,11 +524,11 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\<void\> | 是 | 切断account进程的回调函数。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\<void\> | 是 | 切断account进程的回调函数。 |
**示例:**
......@@ -549,7 +549,7 @@ appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountC
killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
通过包名终止进程。
通过Bundle名称终止进程。
**需要权限**:ohos.permission.CLEAN_BACKGROUND_PROCESSES
......@@ -561,7 +561,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例:**
......@@ -582,7 +582,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
killProcessesByBundleName(bundleName: string): Promise\<void>;
通过包名终止进程。
通过Bundle名称终止进程。
**需要权限**:ohos.permission.CLEAN_BACKGROUND_PROCESSES
......@@ -594,7 +594,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
**返回值:**
......@@ -603,9 +603,9 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| Promise\<void> | 返回执行结果。 |
**示例:**
```ts
var bundleName = 'bundleName';
var bundleName = 'com.example.myapplication';
appManager.killProcessesByBundleName(bundleName)
.then((data) => {
console.log('------------ killProcessesByBundleName success ------------', data);
......@@ -619,7 +619,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
通过包名清除应用数据。
通过Bundle名称清除应用数据。
**需要权限**:ohos.permission.CLEAN_APPLICATION_DATA
......@@ -631,7 +631,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
**示例:**
......@@ -652,7 +652,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
clearUpApplicationData(bundleName: string): Promise\<void>;
通过包名清除应用数据。
通过Bundle名称清除应用数据。
**需要权限**:ohos.permission.CLEAN_APPLICATION_DATA
......@@ -664,7 +664,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 表示包名。 |
| bundleName | string | 是 | 表示Bundle名称。 |
**返回值:**
......
......@@ -232,7 +232,7 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括名称、能力名称、模块名称、卡片名和卡片维度。 |
| want | [Want](js-apis-application-want.md) | 是 | want表示获取卡片状态的描述。描述包括Bundle名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例:**
......
......@@ -650,7 +650,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback&lt;Array&lt;formInfo.Fo
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用Bundle名称。 |
| callback | AsyncCallback&lt;Array&lt;[FormInfo](js-apis-application-formInfo.md)&gt;&gt; | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,err为undefined,data为查询到的卡片信息;否则为错误对象。 |
**示例:**
......@@ -679,7 +679,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback&lt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用程序Bundle名称。 |
| moduleName | string | 是 | 要查询的模块名称。 |
| callback | AsyncCallback&lt;Array&lt;[FormInfo](js-apis-application-formInfo.md)&gt;&gt; | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功,err为undefined,data为查询到的卡片信息;否则为错误对象。 |
......@@ -709,7 +709,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise&lt;Array&lt;formI
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| bundleName | string | 是 | 要查询的应用程序Bundle名称。 |
| moduleName | string | 否 | 要查询的模块名称。 |
**返回值:**
......
......@@ -21,7 +21,7 @@ import formInfo from '@ohos.application.formInfo';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ |
| bundleName | string | 是 | 否 | 表示卡片所属包的包名。 |
| bundleName | string | 是 | 否 | 表示卡片所属包的Bundle名称。 |
| moduleName | string | 是 | 否 | 表示卡片所属模块的模块名。 |
| abilityName | string | 是 | 否 | 表示卡片所属的Ability名称。 |
| name | string | 是 | 否 | 表示卡片名称。 |
......@@ -32,7 +32,7 @@ import formInfo from '@ohos.application.formInfo';
| isDefault | boolean | 是 | 否 | 表示是否是默认卡片。 |
| updateEnabled | boolean | 是 | 否 | 表示卡片是否使能更新。 |
| formVisibleNotify | string | 是 | 否 | 表示卡片是否使能可见通知。 |
| relatedBundleName | string | 是 | 否 | 表示卡片所属的相关联包名。 |
| relatedBundleName | string | 是 | 否 | 表示卡片所属的相关联Bundle名称。 |
| scheduledUpdateTime | string | 是 | 否 | 表示卡片更新时间。 |
| formConfigAbility | string | 是 | 否 | 表示卡片配置ability。 |
| updateDuration | string | 是 | 否 | 表示卡片更新周期。 |
......
# @ohos.application.Want (Want)
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用Bundle名称以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
> **说明:**
>
......
......@@ -13,32 +13,32 @@ Ability信息,未做特殊说明的属性,均通过[GET_BUNDLE_DEFAULT](js-a
**系统能力:** 以下各项对应的系统能力均为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 | 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](js-apis-Bundle.md)获取。 |
| 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是否可用。 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 否 | 应用Bundle名称。 |
| 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](js-apis-Bundle.md)获取。 |
| 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是否可用。 |
......@@ -25,10 +25,10 @@ SystemCapability.BundleManager.BundleFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleFilePaths | Array&lt;string&gt; | 是 | 指示存储hap包的沙箱路径。沙箱路径的获取方法参见[获取应用的沙箱路径](#获取应用的沙箱路径)|
| param | [InstallParam](#installparamdeprecated) | 是 | 指定安装所需的其他参数。 |
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleFilePaths | Array&lt;string&gt; | 是 | 指示存储HAP的沙箱路径。沙箱路径的获取方法参见[获取应用的沙箱路径](#获取应用的沙箱路径)|
| param | [InstallParam](#installparamdeprecated) | 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
**示例:**
......@@ -75,10 +75,10 @@ SystemCapability.BundleManager.BundleFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 应用包名。 |
| param | [InstallParam](#installparamdeprecated) | 是 | 指定卸载所需的其他参数。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| param | [InstallParam](#installparamdeprecated) | 是 | 指定卸载所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
**示例:**
......@@ -124,10 +124,10 @@ SystemCapability.BundleManager.BundleFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 应用包名。 |
| param | [InstallParam](#installparamdeprecated) | 是 | 指定应用恢复所需的其他参数。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| bundleName | string | 是 | 应用Bundle名称。 |
| param | [InstallParam](#installparamdeprecated) | 是 | 指定应用恢复所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatusdeprecated)&gt; | 是 | 程序启动作为入参的回调函数,返回应用恢复状态信息。 |
**示例:**
......
......@@ -18,7 +18,7 @@ ElementName信息,标识Ability的基本信息,通过接口[Context.getEleme
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| deviceId | string | 是 | 是 | 设备id。 |
| bundleName | string | 是 | 是 | 应用包名。 |
| bundleName | string | 是 | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | 是 | Ability名称。 |
| uri | string | 是 | 是 | 资源标识符。 |
| shortName | string | 是 | 是 | Ability短名称。 |
\ No newline at end of file
......@@ -32,7 +32,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- |
| id | string | 是 | 否 | 快捷方式所属应用程序的Id。 |
| bundleName | string | 是 | 否 | 包含该快捷方式的包名称。 |
| bundleName | string | 是 | 否 | 包含该快捷方式的Bundle名称。 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息。 |
| icon | string | 是 | 否 | 快捷方式的图标。 |
| iconId<sup>8+</sup> | number | 是 | 否 | 快捷方式的图标Id。 |
......
......@@ -11,7 +11,7 @@ Ability信息,系统应用可以通过[getBundleInfo](js-apis-bundleManager.md
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | -------------------------------------------------------- | ---- | ---- | ----------------------------------------- |
| bundleName | string | 是 | 否 | 应用包名 |
| bundleName | string | 是 | 否 | 应用Bundle名称 |
| moduleName | string | 是 | 否 | Ability所属的HAP包的名称 |
| name | string | 是 | 否 | Ability名称 |
| label | string | 是 | 否 | Ability对用户显示的名称 |
......
......@@ -11,8 +11,8 @@ ElementName信息,通过接口[Context.getElementName](js-apis-inner-app-conte
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| deviceId | string | 是 | 是 | 设备id。 |
| bundleName | string | 是 | 是 | 应用包名。 |
| deviceId | string | 是 | 是 | 设备ID。 |
| bundleName | string | 是 | 是 | 应用Bundle名称。 |
| abilityName | string | 是 | 是 | Ability名称。 |
| uri | string | 是 | 是 | 资源标识符。 |
| shortName | string | 是 | 是 | Ability短名称。 |
......
......@@ -9,19 +9,19 @@ ExtensionAbility信息,系统应用可以通过[getBundleInfo](js-apis-bundleM
**系统能力**: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------------- | ----------------------------------------------------------- | ---- | ---- | -------------------------------------------------- |
| bundleName | string | 是 | 否 | 应用包名 |
| moduleName | string | 是 | 否 | ExtensionAbility所属的HAP包的名称 |
| name | string | 是 | 否 | ExtensionAbility名称 |
| labelId | number | 是 | 否 | ExtensionAbility的标签资源id |
| descriptionId | number | 是 | 否 | ExtensionAbility的描述资源id |
| iconId | number | 是 | 否 | ExtensionAbility的图标资源id |
| isVisible | boolean | 是 | 否 | 判断ExtensionAbility是否可以被其他应用调用 |
| extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是 | 否 | ExtensionAbility类型 |
| permissions | Array\<string> | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合 |
| applicationInfo | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 是 | 否 | 应用程序的配置信息 |
| metadata | Array\<[Metadata](js-apis-bundleManager-metadata.md)> | 是 | 否 | ExtensionAbility的元信息 |
| enabled | boolean | 是 | 否 | ExtensionAbility是否可用 |
| readPermission | string | 是 | 否 | 读取ExtensionAbility数据所需的权限 |
| writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限 |
\ No newline at end of file
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------------------------------------- |
| bundleName | string | 是 | 否 | 应用Bundle名称 |
| moduleName | string | 是 | 否 | ExtensionAbility所属的HAP包的名称 |
| name | string | 是 | 否 | ExtensionAbility名称 |
| labelId | number | 是 | 否 | ExtensionAbility的标签资源id |
| descriptionId | number | 是 | 否 | ExtensionAbility的描述资源id |
| iconId | number | 是 | 否 | ExtensionAbility的图标资源id |
| isVisible | boolean | 是 | 否 | 判断ExtensionAbility是否可以被其他应用调用 |
| extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是 | 否 | ExtensionAbility类型 |
| permissions | Array\<string> | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合 |
| applicationInfo | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 是 | 否 | 应用程序的配置信息 |
| metadata | Array\<[Metadata](js-apis-bundleManager-metadata.md)> | 是 | 否 | ExtensionAbility的元信息 |
| enabled | boolean | 是 | 否 | ExtensionAbility是否可用 |
| readPermission | string | 是 | 否 | 读取ExtensionAbility数据所需的权限 |
| writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限 |
\ No newline at end of file
......@@ -47,10 +47,10 @@
**系统能力:** SystemCapability.BundleManager.BundleFrameWork.FreeInstall
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------- | ------------------- | ---- | ---- | ---------------------------------- |
| bundleName | string | 是 | 否 | 应用的包名,用于标识应用的唯一性。 |
| version | [Version](#version) | 是 | 否 | 包的版本。 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------- | ------------------- | ---- | ---- | -------------------------------------- |
| bundleName | string | 是 | 否 | 应用Bundle名称,用于标识应用的唯一性。 |
| version | [Version](#version) | 是 | 否 | 包的版本。 |
## ModuleConfigInfo
......
......@@ -15,9 +15,9 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------- | ------ | ---- | ---- | -------------------- |
| targetBundle | string | 是 | 否 | 快捷方式的目标bundleName |
| targetModule | string | 是 | 否 | 快捷方式的目标moduleName |
| targetAbility | string | 是 | 否 | 快捷方式所需的目标abilityName |
| targetBundle | string | 是 | 否 | 快捷方式的目标bundleName |
| targetModule | string | 是 | 否 | 快捷方式的目标moduleName |
| targetAbility | string | 是 | 否 | 快捷方式所需的目标abilityName |
## ShortcutInfo
......@@ -27,14 +27,14 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- |
| id | string | 是 | 否 | 快捷方式所属应用程序的Id |
| bundleName | string | 是 | 否 | 包含快捷方式的包名称 |
| moduleName | string | 是 | 否 | 快捷方式的模块名 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability名称 |
| icon | string | 是 | 否 | 快捷方式的图标 |
| iconId | number | 是 | 否 | 快捷方式的图标Id |
| label | string | 是 | 否 | 快捷方式的标签 |
| labelId | number | 是 | 否 | 快捷方式的标签Id |
| wants | Array\<[ShortcutWant](#shortcutwant)> | 是 | 否 | 快捷方式所需要的信息 |
| id | string | 是 | 否 | 快捷方式所属应用程序的ID。 |
| bundleName | string | 是 | 否 | 包含快捷方式的Bundle名称。 |
| moduleName | string | 是 | 否 | 快捷方式的模块名 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability名称 |
| icon | string | 是 | 否 | 快捷方式的图标 |
| iconId | number | 是 | 否 | 快捷方式的图标ID。 |
| label | string | 是 | 否 | 快捷方式的标签 |
| labelId | number | 是 | 否 | 快捷方式的标签ID。 |
| wants | Array\<[ShortcutWant](#shortcutwant)> | 是 | 否 | 快捷方式所需要的信息 |
<!--no_check-->
\ No newline at end of file
......@@ -272,7 +272,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback:
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| bundleFlags | [number](#bundleflag) | 是 | 指定返回的BundleInfo所包含的信息。|
| userId | number | 是 | 表示用户ID。 |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象。 |
......@@ -345,7 +345,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| bundleFlags | [number](#bundleflag) | 是 | 指定返回的BundleInfo所包含的信息。|
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 |
......@@ -396,7 +396,7 @@ getBundleInfo(bundleName: string, bundleFlags: [number](#bundleflag), userId?: n
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| bundleFlags | [number](#bundleflag) | 是 | 指定返回的BundleInfo所包含的信息。 |
| userId | number | 否 | 表示用户ID。 |
......@@ -469,7 +469,7 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 |
| userId | number | 是 | 表示用户ID。 |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 |
......@@ -521,7 +521,7 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), cal
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 |
......@@ -571,7 +571,7 @@ getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), use
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---------------------------- |
| bundleName | string | 是 | 表示要查询的应用程序包名称。 |
| bundleName | string | 是 | 表示要查询的应用Bundle名称。 |
| appFlags | [number](#applicationflag) | 是 | 指定返回的ApplicationInfo所包含的信息。 |
| userId | number | 否 | 表示用户ID。 |
......@@ -915,7 +915,7 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId: numbe
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| abilityFlags | [number](#abilityflag) | 是 | 指定返回的AbilityInfo所包含的信息。 |
| userId | number | 是 | 表示用户ID。 |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
......@@ -972,7 +972,7 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), callback: Asy
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | -------------------------------------------------------|
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| abilityFlags | [number](#abilityflag) | 是 | 指定返回的AbilityInfo所包含的信息。 |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
......@@ -1027,7 +1027,7 @@ queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId?: numb
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| abilityFlags | [number](#abilityflag) | 是 | 表示指定返回的AbilityInfo所包含的信息。 |
| userId | number | 否 | 表示用户ID。 |
......@@ -1106,10 +1106,10 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| extensionAbilityType | [ExtensionAbilityType](#extensionabilitytype) | 是 | 标识extensionAbility的类型。 |
| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
| userId | number | 是 | 表示用户ID。 |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| extensionAbilityType | [ExtensionAbilityType](#extensionabilitytype) | 是 | 标识extensionAbility的类型。 |
| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
| userId | number | 是 | 表示用户ID。 |
| callback | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
**错误码:**
......@@ -1164,9 +1164,9 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| extensionAbilityType | [ExtensionAbilityType](#extensionabilitytype) | 是 | 标识extensionAbility的类型。 |
| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| extensionAbilityType | [ExtensionAbilityType](#extensionabilitytype) | 是 | 标识extensionAbility的类型。 |
| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
| callback | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
**错误码:**
......@@ -1218,9 +1218,9 @@ queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityTyp
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | --------------------------------------------- | ---- | ------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用程序包名称的Want。 |
| 参数名 | 类型 | 必填 | 说明 |
| --------------------- | --------------------------------------------- | ---- | --------------------------------------------------------- |
| want | Want | 是 | 表示包含要查询的应用Bundle名称的Want。 |
| extensionAbilityType | [ExtensionAbilityType](#extensionabilitytype) | 是 | 标识extensionAbility的类型。 |
| extensionAbilityFlags | [number](#extensionabilityflag) | 是 | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
| userId | number | 否 | 表示用户ID。 |
......
......@@ -28,7 +28,7 @@ import bundleMonitor from '@ohos.bundle.bundleMonitor';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------- | ------ | ---- | ---- | -------------------------- |
| bundleName | string | 是 | 否 | 应用状态发生变化的应用包名。 |
| bundleName | string | 是 | 否 | 应用状态发生变化的应用Bundle名称。 |
| userId | number | 是 | 否 | 应用状态发生变化的用户id。 |
## bundleMonitor.on
......
......@@ -67,8 +67,8 @@ isDefaultService(elementName: ElementName, type: CardType): boolean
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | ----------------------- |
| elementName | [ElementName](js-apis-bundleManager-elementName.md#elementname) | 是 | 应用的描述,由包名和组件名组成。 |
| type | [CardType](#cardtype) | 是 | 应用的描述,由包名和组件名组成。 |
| elementName | [ElementName](js-apis-bundleManager-elementName.md#elementname) | 是 | 应用的描述,由Bundle名称和组件名称组成。 |
| type | [CardType](#cardtype) | 是 | 应用的描述,由Bundle名称和组件名称组成。 |
**返回值:**
......
......@@ -1244,7 +1244,7 @@ subscriber.finishCommonEvent().then(() => {
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------- |-------------------- | ---- | ---- | ------------------------------------------------------- |
| event | string | 是 | 否 | 表示当前接收的公共事件名称。 |
| bundleName | string | 是 | 否 | 表示包名称。 |
| bundleName | string | 是 | 否 | 表示Bundle名称。 |
| code | number | 是 | 否 | 表示公共事件的结果代码,用于传递int类型的数据。 |
| data | string | 是 | 否 | 表示公共事件的自定义结果数据,用于传递string类型的数据。 |
| parameters | {[key: string]: any} | 是 | 否 | 表示公共事件的附加信息。 |
......@@ -1258,7 +1258,7 @@ subscriber.finishCommonEvent().then(() => {
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | -------------------- | ---- | ---- | ---------------------------- |
| bundleName | string | 是 | 否 | 表示包名称。 |
| bundleName | string | 是 | 否 | 表示Bundle名称。 |
| code | number | 是 | 否 | 表示公共事件的结果代码。 |
| data | string | 是 | 否 | 表示公共事件的自定义结果数据。 |
| subscriberPermissions | Array\<string> | 是 | 否 | 表示订阅者的权限。 |
......
......@@ -1695,11 +1695,11 @@ email.email = "xxx@email.com";
**系统能力**:以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- | ---- | ---- | ---------- |
| bundleName | string | 是 | 否 | 包名。 |
| displayName | string | 是 | 否 | 应用名称。 |
| holderId | number | 是 | 是 | 应用id。 |
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ------ | ---- | ---- | ------------ |
| bundleName | string | 是 | 否 | Bundle名称。 |
| displayName | string | 是 | 否 | 应用名称。 |
| holderId | number | 是 | 是 | 应用ID。 |
**对象创建示例:**
......
......@@ -15,7 +15,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| deviceType | Array\<string> | 是 | 是 | 表示设备类型。|
| targetBundle | string | 是 | 是 | 表示目标包名。 |
| targetBundle | string | 是 | 是 | 表示目标Bundle名称。 |
| description | string | 是 | 是 | 表示设备过滤的描述。 |
| filter | any | 是 | 是 | 表示设备过滤的参数。 |
| continuationMode | [ContinuationMode](js-apis-continuation-continuationManager.md#continuationmode) | 是 | 是 | 表示协同的模式。 |
......
......@@ -34,10 +34,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback&lt;DeviceManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------- | ---- | ------------------------------------ |
| bundleName | string | 是 | 指示应用程序的包名。 |
| callback | AsyncCallback&lt;[DeviceManager](#devicemanager)&gt; | 是 | DeviceManager实例创建时调用的回调,返回设备管理器对象实例。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------------------- | ---- | ----------------------------------------------------------- |
| bundleName | string | 是 | 指示应用程序的Bundle名称。 |
| callback | AsyncCallback&lt;[DeviceManager](#devicemanager)&gt; | 是 | DeviceManager实例创建时调用的回调,返回设备管理器对象实例。 |
**错误码:**
......@@ -638,7 +638,7 @@ publishDeviceDiscovery(publishInfo: PublishInfo): void
console.error("publishDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
}
```
### unPublishDeviceDiscovery<sup>9+</sup>
unPublishDeviceDiscovery(publishId: number): void
......
......@@ -37,7 +37,7 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ------ | ------ |
| config | [KVManagerConfig](#kvmanagerconfig) | 是 | 提供KVManager实例的配置信息,包括调用方的包名和用户信息。 |
| config | [KVManagerConfig](#kvmanagerconfig) | 是 | 提供KVManager实例的配置信息,包括调用方的Bundle名称和用户信息。 |
| callback | AsyncCallback&lt;[KVManager](#kvmanager)&gt; | 是 | 回调函数。返回创建的KVManager对象实例。 |
**示例:**
......@@ -112,14 +112,14 @@ try {
## KVManagerConfig
提供KVManager实例的配置信息,包括调用方的包名和用户信息。
提供KVManager实例的配置信息,包括调用方的Bundle名称和用户信息。
**系统能力:** SystemCapability.DistributedDataManager.KVStore.Core
| 名称 | 类型 | 必填 | 说明 |
| ----- | ------ | ------ | ------ |
| userInfo | [UserInfo](#userinfo) | 是 | 调用方的用户信息。 |
| bundleName | string | 是 | 调用方的包名。 |
| bundleName | string | 是 | 调用方的Bundle名称。 |
## UserInfo
......
......@@ -63,7 +63,7 @@ setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: Upg
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | ---------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag | [UpgradeFlag](#upgradeflag) | 是 | 仅供内部系统使用标志位 |
| callback | AsyncCallback\<void> | 是 | 回调函数。当函数调用成功,err为null,否则为错误对象。 |
......@@ -113,7 +113,7 @@ setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: Upg
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag | [UpgradeFlag](#upgradeflag) | 是 | 仅供内部系统使用标志位。|
......@@ -166,7 +166,7 @@ isHapModuleRemovable(bundleName: string, moduleName: string, callback: AsyncCall
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ---------------------- | ---- | --------------------------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| callback | AsyncCallback\<boolean> | 是 | 回调函数。返回true表示可以移除;返回false表示不可移除。 |
......@@ -214,7 +214,7 @@ isHapModuleRemovable(bundleName: string, moduleName: string): Promise\<boolean>;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------ |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
**返回值:**
......@@ -265,8 +265,8 @@ getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag, callback:
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 是 | 应用程序包名称。 |
| bundlePackFlag | [BundlePackFlag](#bundlepackflag) | 是 | 指示要查询的应用包标志。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| bundlePackFlag | [BundlePackFlag](#bundlepackflag) | 是 | 指示要查询的应用包标志。 |
| callback | AsyncCallback<[BundlePackInfo](js-apis-bundleManager-packInfo.md)> | 是 | 回调函数。当函数调用成功,err为null,data为获取到的BundlePackInfo信息。否则为错误对象。 |
**错误码:**
......@@ -311,7 +311,7 @@ getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag): Promise\
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | --------------------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用程序Bundle名称。 |
| bundlePackFlag | [BundlePackFlag](#bundlepackflag) | 是 | 指示要查询的应用包标志。|
**返回值:**
......
# Want
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为[startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为[startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的Bundle名称以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
> **说明:**
>
......@@ -11,7 +11,7 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传
| 名称 | 类型 | 必填 | 说明 |
| ----------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | string | 否 | 表示包名。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| bundleName | string | 否 | 表示Bundle名称。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| abilityName | string | 否 | 表示待启动的Ability名称。如果在Want中该字段同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。AbilityName需要在一个应用的范围内保证唯一。 |
| uri | string | 否 | 表示Uri。如果在Want中指定了Uri,则Want将匹配指定的Uri信息,包括scheme, schemeSpecificPart, authority和path信息。 |
| type | string | 否 | 表示MIME type类型,打开文件的类型,主要用于文管打开文件。比如:"text/xml" 、 "image/*"等,MIME定义参考:https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
......
......@@ -7,7 +7,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| pid<sup>8+</sup> | number | 是 | 否 | 进程ID。 |
| bundleName<sup>8+</sup> | string | 是 | 否 | 应用包名。 |
| bundleName<sup>8+</sup> | string | 是 | 否 | 应用Bundle名称。 |
| abilityName<sup>8+</sup> | string | 是 | 否 | Ability名称。 |
| uid<sup>8+</sup> | number | 是 | 否 | 用户ID。 |
| state<sup>8+</sup> | number | 是 | 否 | Ability状态。 |
......
......@@ -8,7 +8,7 @@
| 名称 | 类型 | 必填 | 说明 |
| ------------------------- | ------ | ---- | --------- |
| bundleName<sup>8+</sup> | string | 否 | 包名。 |
| bundleName<sup>8+</sup> | string | 否 | Bundle名称。 |
| uid<sup>8+</sup> | number | 否 | 应用程序的uid。 |
| state<sup>8+</sup> | number | 否 | 应用状态。<br>0:初始化状态,应用正在初始化<br>1:就绪状态,应用已初始化完毕<br>2:前台状态,应用位于前台<br>3:获焦状态。(预留状态,当前暂不支持)<br>4:后台状态,应用位于后台<br>5:退出状态,应用已退出 |
......
......@@ -29,7 +29,7 @@ Context模块提供了ability或application的上下文的能力,包括访问
createBundleContext(bundleName: string): Context;
根据包名创建安装包的上下文。
根据Bundle名称创建安装包的上下文。
**需要权限**: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
......@@ -39,7 +39,7 @@ createBundleContext(bundleName: string): Context;
| 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | 包名。 |
| bundleName | string | 是 | Bundle名称。 |
**返回值:**
......@@ -107,7 +107,7 @@ try {
createModuleContext(bundleName: string, moduleName: string): Context;
根据包名和模块名创建上下文。
根据Bundle名称和模块名称创建上下文。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......@@ -115,7 +115,7 @@ createModuleContext(bundleName: string, moduleName: string): Context;
| 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | 包名。 |
| bundleName | string | 是 | Bundle名称。 |
| moduleName | string | 是 | 模块名。 |
**返回值:**
......
......@@ -9,7 +9,7 @@
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| pid<sup>8+</sup> | number | 是 | 否 | 进程ID。 |
| bundleName<sup>8+</sup> | string | 是 | 否 | 应用包名。 |
| bundleName<sup>8+</sup> | string | 是 | 否 | Bundle名称。 |
| uid<sup>8+</sup> | number | 是 | 否 | 用户ID。 |
| isContinuousTask<sup>9+</sup> | boolean | 是 | 否 | 判断过程是否为连续任务。 |
| isKeepAlive<sup>9+</sup> | boolean | 是 | 否 | 判断该过程是否保持活跃。 |
......
......@@ -15,7 +15,7 @@
| pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 |
| processName | string | 是 | 否 | 进程名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的Bundle名称。 |
## 使用说明
......
......@@ -27,4 +27,4 @@ appManager.getProcessRunningInformation((error, data) => {
| pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 |
| processName | string | 是 | 否 | 进程名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的Bundle名称。 |
......@@ -38,7 +38,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 |
**错误码:**
......@@ -105,7 +105,7 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
| options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 |
**返回值:**
......@@ -1079,7 +1079,7 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。 |
| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | ConnectOptions类型的回调函数,返回服务连接成功、断开或连接失败后的信息。 |
**返回值:**
......
......@@ -29,7 +29,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number, callback: AsyncCallba
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| userId | number | 是 | 被查询的用户id。|
**返回值:**
......@@ -81,7 +81,7 @@ getLauncherAbilityInfo(bundleName: string, userId: number) : Promise<Array\<[Lau
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | 是 | 应用程序包名称。|
| bundleName | string | 是 | 应用Bundle名称。 |
| userId | number | 是 | 被查询的用户id。 |
**返回值:**
......@@ -226,7 +226,7 @@ getShortcutInfo(bundleName :string, callback: AsyncCallback<Array\<[ShortcutInfo
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
**返回值:**
......@@ -274,7 +274,7 @@ getShortcutInfo(bundleName : string) : Promise<Array\<[ShortcutInfo](js-apis-bun
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | -------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundleName | string | 是 | 应用Bundle名称。 |
**返回值:**
......
......@@ -431,7 +431,7 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标hap包名。 |
| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标HAP名。 |
| abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 |
......@@ -443,7 +443,7 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明提醒到达时自动拉起的目标hap包名(如果设备在使用中,则只弹出通知横幅框)。 |
| pkgName | string | 是 | 指明提醒到达时自动拉起的目标HAP名(如果设备在使用中,则只弹出通知横幅框)。 |
| abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名(如果设备在使用中,则只弹出通知横幅框)。 |
......
......@@ -580,7 +580,7 @@ try {
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标hap包名。 |
| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标HAP名。 |
| abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 |
......@@ -592,7 +592,7 @@ try {
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明提醒到达时自动拉起的目标hap包名(如果设备在使用中,则只弹出通知横幅框)。 |
| pkgName | string | 是 | 指明提醒到达时自动拉起的目标HAP名(如果设备在使用中,则只弹出通知横幅框)。 |
| abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名(如果设备在使用中,则只弹出通知横幅框)。 |
......
......@@ -1476,7 +1476,7 @@ FA的使用信息的属性集合。
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | ---------------------------------------- | ---- | ----------------------------- |
| deviceId | string | 否 | FA所属deviceId。 |
| bundleName | string | 是 | FA所属应用包名。 |
| bundleName | string | 是 | FA所属应用Bundle名称。 |
| moduleName | string | 是 | FA所属module名。 |
| abilityName | string | 否 | FA的MainAbility名。 |
| appLabelId | number | 否 | FA的应用labelId。 |
......
......@@ -77,7 +77,7 @@ export default {
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。 |
| bundleName | string | 是 | 应用Bundle名称。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
\ No newline at end of file
......@@ -134,7 +134,7 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => {
getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
获取WantAgent实例的包名(callback形式)。
获取WantAgent实例的Bundle名称(callback形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......@@ -206,7 +206,7 @@ WantAgent.getBundleName(wantAgent, getBundleNameCallback)
getBundleName(agent: WantAgent): Promise\<string\>
获取WantAgent实例的包名(Promise形式)。
获取WantAgent实例的Bundle名称(Promise形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......@@ -218,9 +218,9 @@ getBundleName(agent: WantAgent): Promise\<string\>
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<string\> | 以Promise形式返回获取WantAgent实例的包名。 |
| 类型 | 说明 |
| ----------------- | ------------------------------------------------ |
| Promise\<string\> | 以Promise形式返回获取WantAgent实例的Bundle名称。 |
**示例:**
......
......@@ -31,15 +31,15 @@ path: string, container: object, render: string, loop: boolean, autoplay: boolea
**参数:**
| 参数 | 类型 | 必填 | 描述 |
| -------------- | --------------------------- | ---- | ---------------------------------------- |
| path | string | 是 | hap包内动画资源文件路径,仅支持json格式。示例:path:&nbsp;"common/lottie/data.json" |
| container | object | 是 | canvas绘图上下文,声明范式需提前声明CanvasRenderingContext2D。 |
| render | string | 是 | 渲染类型,仅支持“canvas”。 |
| loop | boolean&nbsp;\|&nbsp;number | 否 | 动画播放结束后,是否循环播放,默认值true。值类型为number,且大于等于1时为设置的重复播放的次数。 |
| autoplay | boolean | 否 | 是否自动播放动画,默认值true。 |
| name | string | 否 | 开发者自定义的动画名称,后续支持通过该名称引用控制动画,默认为空。 |
| initialSegment | [number,&nbsp;number] | 否 | 指定动画播放的起始帧号,指定动画播放的结束帧号。 |
| 参数 | 类型 | 必填 | 描述 |
| -------------- | --------------------------- | ---- | ------------------------------------------------------------ |
| path | string | 是 | HAP内动画资源文件路径,仅支持json格式。示例:path:&nbsp;"common/lottie/data.json" |
| container | object | 是 | canvas绘图上下文,声明范式需提前声明CanvasRenderingContext2D。 |
| render | string | 是 | 渲染类型,仅支持“canvas”。 |
| loop | boolean&nbsp;\|&nbsp;number | 否 | 动画播放结束后,是否循环播放,默认值true。值类型为number,且大于等于1时为设置的重复播放的次数。 |
| autoplay | boolean | 否 | 是否自动播放动画,默认值true。 |
| name | string | 否 | 开发者自定义的动画名称,后续支持通过该名称引用控制动画,默认为空。 |
| initialSegment | [number,&nbsp;number] | 否 | 指定动画播放的起始帧号,指定动画播放的结束帧号。 |
## lottie.destroy
......
......@@ -16,8 +16,8 @@ Input error. The specified ability name does not exist.
**处理步骤**
1. 检查名称是否正确。
2. 检查包名对应的Ability是否正确。
1. 检查Bundle名称是否正确。
2. 检查Bundle名称对应的Ability是否正确。
## 16000002 接口调用Ability类型错误
......
......@@ -116,12 +116,12 @@ The specified device ID is not found.
Failed to install the HAP because the HAP fails to be parsed.
**错误描述**<br/>
调用installer模块中的install接口时,传入的HAP解析失败。
调用installer模块中的install接口时,传入的HAP解析失败。
**可能原因**<br/>
1. hap包的格式不是zip格式。
2. hap包的配置文件不满足json格式。
3. hap包的配置文件缺少必要的字段。
1. HAP的格式不是zip格式。
2. HAP的配置文件不满足json格式。
3. HAP的配置文件缺少必要的字段。
**处理步骤**<br/>
1. 确认hap的格式是zip。
......@@ -138,9 +138,9 @@ Failed to install the HAP because the HAP signature fails to be verified.
**可能原因**<br/>
1. hap包没有签名。
1. HAP没有签名。
2. hap签名信息来源不可靠。
3. 升级的hap包与已安装的hap包签名信息不一致。
3. 升级的HAP与已安装的HAP签名信息不一致。
4. 多个hap的签名信息不一致。
**处理步骤**<br/>
......@@ -157,28 +157,28 @@ Failed to install the HAP because the HAP path is invalid or the HAP is too larg
调用installer模块中的install接口时,安装包路径无效或者文件过大导致应用安装失败。
**可能原因**<br/>
1. 输入错误,hap包的文件路径不存在。
2. hap包的路径无法访问。
3. hap包的大小超过最大限制4G。
1. 输入错误,HAP的文件路径不存在。
2. HAP的路径无法访问。
3. HAP的大小超过最大限制4G。
**处理步骤**<br/>
1. 确认hap是否存在。
2. 查看hap的可执行权限,是否可读。
3. 查看hap包的大小是否超过4G。
3. 查看HAP的大小是否超过4G。
## 17700015 多个hap包配置信息不同导致应用安装失败
## 17700015 多个HAP配置信息不同导致应用安装失败
**错误信息**<br/>
Failed to install the HAPs because they have different configuration information.
**错误描述**<br/>
调用installer模块中的install接口时,多个hap包配置信息不同导致应用安装失败。
调用installer模块中的install接口时,多个HAP配置信息不同导致应用安装失败。
**可能原因**<br/>
多个hap包中配置文件app下面的字段不一致。
多个HAP中配置文件app下面的字段不一致。
**处理步骤**<br/>
确认多个hap包中配置文件app下面的字段是否一致。
确认多个HAP中配置文件app下面的字段是否一致。
## 17700016 系统磁盘空间不足导致应用安装失败
......
......@@ -94,7 +94,7 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
}
```
也可以使用want格式绑定参数跳转到目标应用,want定义了ability名称、包名、携带的参数字段等。
也可以使用want格式绑定参数跳转到目标应用,want定义了Ability名称、Bundle名称、携带的参数字段等。
| 选择器 | 类型 | 默认值 | 样例描述 |
| ------ | ------ | -------- | ---------------------------------------- |
......@@ -102,7 +102,7 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
| want | [Want](../apis/js-apis-app-ability-want.md) | - | 跳转目标应用的信息,参考want格式表。 |
```json
```json
{
"data": {
"mainAbility": "xxx.xxx.xxx"
......@@ -124,9 +124,9 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组
}
}
}
```
```
在API Version 8,want参数需要在app.js或app.ets文件的onCreate方法中调用[featureAbility.getWant](../apis/js-apis-ability-featureAbility.md)接口接收相关参数。
在API Version 8,want参数需要在app.js或app.ets文件的onCreate方法中调用[featureAbility.getWant](../apis/js-apis-ability-featureAbility.md)接口接收相关参数。
- 消息事件格式
......
......@@ -212,7 +212,7 @@
```json
[
{
"bundleName": "com.ohos.myapplication", // 包名
"bundleName": "com.ohos.myapplication", // Bundle名称
"app_signature":[], // 指纹信息
"permissions":[
{
......
......@@ -68,7 +68,7 @@ HarmonyAppProvision文件示例:
| developer-id | 表示开发者的唯一ID号,用于OEM厂商标识开发者,开源社区版本该属性不做强制要求。 | 字符串 | 必选 | 不可缺省 |
| development-certificate | 表示[调试证书](hapsigntool-guidelines.md)的信息。 | 数值 | 当type属性为debug时,该属性必选;否则,该属性可选。 | 不可缺省 |
| distribution-certificate | 表示[发布证书](hapsigntool-guidelines.md)的信息。 | 数值 | 当type属性为release时,该标签必选;否则,该标签可选。 | 不可缺省 |
| bundle-name | 表示应用程序的包名。 | 字符串 | 必选 | 不可缺省 |
| bundle-name | 表示应用程序的Bundle名称。 | 字符串 | 必选 | 不可缺省 |
| apl | 表示应用程序的[APL级别](accesstoken-overview.md),系统预定义的apl包括:normal、system_basic和system_core。 | 字符串 | 必选 | 不可缺省 |
| app-feature | 表示应用程序的类型,系统预定义的app-feature包括hos_system_app (系统应用)和hos_normal_app(普通应用)。只有系统应用才允许调用系统API,普通应用调用系统API可能会调用失败或运行异常。 | 字符串 | 必选 | 不可缺省 |
......
......@@ -26,8 +26,8 @@ WorkInfo设置参数约束见[延迟任务调度约束](./background-task-overvi
参数名| 类型 |描述
---------------------------------------------------------|-----------------------------------------|---------------------------------------------------------
workId| number | 延迟任务Id(必填)
bundleName| string | 延迟任务包名(必填)
workId| number | 延迟任务ID(必填)
bundleName| string | 延迟任务Bundle名称(必填)
abilityName| string | 延迟任务回调通知的组件名(必填)
networkType | [NetworkType](../reference/apis/js-apis-resourceschedule-workScheduler.md#networktype) | 网络类型
isCharging| boolean | 是否充电
......
......@@ -28,14 +28,14 @@ Advanced Notification Manager(通知管理工具,简称anm)是实现通知
参数如下表所示
| 参数 | 参数说明 |
| ---------------- | -------------------------------- |
| -A/--active | 打印所有活跃的通知信息 |
| -R/--recent | 打印最近的通知信息 |
| -D/--distributed | 打印来自其他设备的分布式通知信息 |
| -b/--bundle | 可选参数,设置指定的包名打印 |
| -u/--user-id | 可选参数,设置指定的用户ID打印 |
| -h/--help | 帮助信息 |
| 参数 | 参数说明 |
| ---------------- | ---------------------------------- |
| -A/--active | 打印所有活跃的通知信息 |
| -R/--recent | 打印最近的通知信息 |
| -D/--distributed | 打印来自其他设备的分布式通知信息 |
| -b/--bundle | 可选参数,设置指定的Bundle名称打印 |
| -u/--user-id | 可选参数,设置指定的用户ID打印 |
| -h/--help | 帮助信息 |
* **示例**:打印活跃的通知信息
......
......@@ -75,7 +75,7 @@ bm uninstall [-h help] [-n bundleName] [-m moduleName] [-u userId] [-k]
| 命令 | 是否必选 | 描述 |
| -------- | -------- | -------- |
| -h | 否,默认输出帮助信息 | 显示uninstall支持的命令信息 |
| -n | 是 | 指定包名卸载应用 |
| -n | 是 | 指定Bundle名称卸载应用 |
| -m | 否,默认卸载所有模块 | 指定卸载应用的一个模块 |
| -u | 否,默认卸载当前所有用户下该应用 | 指定用户卸载应用 |
| -k | 否,默认卸载应用时不保存应用数据 | 卸载应用时保存应用数据 |
......@@ -106,16 +106,16 @@ bm dump [-h help] [-a] [-n bundleName] [-s shortcutInfo] [-u userId] [-d deviceI
| -------- | -------- | -------- |
| -h | 否,默认输出帮助信息 | 显示dump支持的命令信息 |
| -a | 是 | 查询系统已经安装的所有应用 |
| -n | 是 | 查询指定包名的详细信息 |
| -s | 是 | 查询指定包名下的快捷方式信息 |
| -n | 是 | 查询指定Bundle名称的详细信息 |
| -s | 是 | 查询指定Bundle名称下的快捷方式信息 |
| -d | 否,默认查询当前设备 | 查询指定设备中的包信息 |
| -u | 否,默认查询当前设备上的所有用户 | 查询指定用户下指定包名的详细信息 |
| -u | 否,默认查询当前设备上的所有用户 | 查询指定用户下指定Bundle名称的详细信息 |
示例:
```bash
# 显示所有已安装的包名
# 显示所有已安装的Bundle名称
bm dump -a
# 查询该应用的详细信息
bm dump -n com.ohos.app -u 100
......@@ -141,9 +141,9 @@ bm clean [-h] [-c] [-n bundleName] [-d] [-u userId]
| 命令 | 描述 |
| -------- | -------- |
| -h | 显示clean支持的命令信息 |
| -c&nbsp;-n | 清除指定包名的缓存数据 |
| -d&nbsp;-n | 清除指定包名的数据目录 |
| -u | 清除指定用户下包名的缓存数据 |
| -c&nbsp;-n | 清除指定Bundle名称的缓存数据 |
| -d&nbsp;-n | 清除指定Bundle名称的数据目录 |
| -u | 清除指定用户下Bundle名称的缓存数据 |
示例:
......@@ -175,9 +175,9 @@ bm enable [-h] [-n bundleName] [-a abilityName] [-u userId]
| 命令 | 描述 |
| -------- | -------- |
| -h | 显示enable支持的命令信息 |
| -n | 使能指定包名的应用 |
| -a | 使能指定包名下的元能力模块 |
| -u | 使能指定用户和包名的应用 |
| -n | 使能指定Bundle名称的应用 |
| -a | 使能指定Bundle名称下的元能力模块 |
| -u | 使能指定用户和Bundle名称的应用 |
示例:
......@@ -205,9 +205,9 @@ bm disable [-h] [-n bundleName] [-a abilityName] [-u userId]
| 命令 | 描述 |
| -------- | -------- |
| -h | 显示disable支持的命令信息 |
| -n | 禁用指定包名的应用 |
| -a | 禁用指定包名下的元能力模块 |
| -u | 禁用指定用户和包名下的应用 |
| -n | 禁用指定Bundle名称的应用 |
| -a | 禁用指定Bundle名称下的元能力模块 |
| -u | 禁用指定用户和Bundle名称下的应用 |
示例:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册