diff --git a/zh-cn/application-dev/ability-deprecated/ability-brief.md b/zh-cn/application-dev/ability-deprecated/ability-brief.md index e889c585c2c147c911334f92c266d1fa55364be0..926465629e11a788a32ae1a28a22c0bb21098902 100644 --- a/zh-cn/application-dev/ability-deprecated/ability-brief.md +++ b/zh-cn/application-dev/ability-deprecated/ability-brief.md @@ -18,7 +18,7 @@ Stage模型的设计，主要是为了开发者更加方便地开发出分布式 | 应用组件开发方式 | 类Web的开发方式。 | 面向对象的开发方式。 | | 引擎实例 | 每个Ability实例独占一个虚拟机实例。 | 多个Ability实例可以共享同一个虚拟机实例。 | | 进程内对象共享 | 不支持。 | 支持。 | -| 包描述文件 | 使用`config.json`描述HAP包和组件信息，组件必须使用固定的文件名。 | 使用`module.json5`描述HAP包和组件信息，可以指定入口文件名。 | +| 包描述文件 | 使用`config.json`描述HAP和组件信息，组件必须使用固定的文件名。 | 使用`module.json5`描述HAP和组件信息，可以指定入口文件名。 | | 组件 | 提供PageAbility(页面展示)，ServiceAbility(服务)，DataAbility(数据分享)以及FormAbility(卡片)。 | 提供UIAbility(页面展示)、Extension(基于场景的服务扩展)。 | 除了上述设计上的差异外，对于开发者而言，两种模型的主要区别在于： diff --git a/zh-cn/application-dev/ability-deprecated/ability-delegator.md b/zh-cn/application-dev/ability-deprecated/ability-delegator.md index 1a6dc8e016b98eda0fc6633e55d46d0b51491b33..d96a2db2a8c0b7c859f3cf964b4762c4af766299 100644 --- a/zh-cn/application-dev/ability-deprecated/ability-delegator.md +++ b/zh-cn/application-dev/ability-deprecated/ability-delegator.md @@ -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的方式输入任何参数，输入的参数可通过AbilityDelegatorArgs.parameters以key-value的方式获取。示例：-s classname myTest，key为"-s classname"，value为"myTest"。 | @@ -58,7 +58,7 @@ AbilityDelegatorArgs是测试框架提供的测试参数类。开发者可以使 ## AbilityMonitor介绍 -AbilityMonitor是测试框架提供用来绑定并监听Ability类。开发者可以使用AbilityMonitor绑定Ability，并将AbilityMonitor添加到监听列表。绑定后Ability的创建、生命周期变化等会触发AbilityMonitor内相关回调函数，开发者可以在对应回调函数内进行测试验证。具体详细内容请参考AbilityMonitor API接口说明[AbilityMonitor](../reference/apis/js-apis-application-abilityMonitor.md)。 +AbilityMonitor是测试框架提供用来绑定并监听Ability类。开发者可以使用AbilityMonitor绑定Ability，并将AbilityMonitor添加到监听列表。绑定后Ability的创建、生命周期变化等会触发AbilityMonitor内相关回调函数，开发者可以在对应回调函数内进行测试验证。具体详细内容请参考AbilityMonitor API接口说明[AbilityMonitor](../reference/apis/js-apis-inner-application-abilityMonitor.md)。 **示例** diff --git a/zh-cn/application-dev/ability-deprecated/fa-serviceability.md b/zh-cn/application-dev/ability-deprecated/fa-serviceability.md index a83d5d636f89554c77d74b72982ac3751d25d4d9..30748a3a20b06416e094705e7387ef4f6b608a2f 100644 --- a/zh-cn/application-dev/ability-deprecated/fa-serviceability.md +++ b/zh-cn/application-dev/ability-deprecated/fa-serviceability.md @@ -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'); diff --git a/zh-cn/application-dev/ability-deprecated/stage-ability.md b/zh-cn/application-dev/ability-deprecated/stage-ability.md index f7892537e8102e903888e672e1df4ef29cac6d45..c9e85aa3ddc7643d6e566e5fdf2f8eaec462691e 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-ability.md +++ b/zh-cn/application-dev/ability-deprecated/stage-ability.md @@ -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 { diff --git a/zh-cn/application-dev/ability-deprecated/stage-brief.md b/zh-cn/application-dev/ability-deprecated/stage-brief.md index 4f024f13b779ae478eb276396a608dd261b6b584..c709016430e055c274b4738b0c875dbb9ac55678 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-brief.md +++ b/zh-cn/application-dev/ability-deprecated/stage-brief.md @@ -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**：本地窗口管理器； diff --git a/zh-cn/application-dev/application-models/app-deviceconfig-switch.md b/zh-cn/application-dev/application-models/app-deviceconfig-switch.md index d2385781ad11bc7cde09d9fad25feb2809e7ee72..5360e745e14e81f9f27e3abe3daea6c23d56668d 100644 --- a/zh-cn/application-dev/application-models/app-deviceconfig-switch.md +++ b/zh-cn/application-dev/application-models/app-deviceconfig-switch.md @@ -21,11 +21,11 @@ app.json5中对原先config.json中的[deviceConfig](../quick-start/deviceconfig **表2** 配置文件deviceConfig标签差异对比 -| FA中deviceConfig标签 | 描述 | stage模型中 | 差异比对 | +| FA中deviceConfig标签 | 描述 | stage模型中 | 差异比对 | | -------- | -------- | -------- | -------- | -| deviceConfig标签 | deviceConfig标签配置了设备信息 | / | Stage模型中没有该标签，直接在app标签下配置设备信息 | -| process | 标识应用或者Ability的进程名。如果在deviceConfig标签下配置了process标签，则该应用的所有Ability都运行在这个进程中。如果在abilities标签下也为某个Ability配置了process标签，则该Ability就运行在这个进程中。 | / | Stage模型不支持配置进程名称 | -| keepAlive | 标识应用是否始终保持运行状态，仅支持系统应用配置，三方应用配置不生效。 | / | Stage模型不支持系统应用模型管控方式变更 | -| supportBackup | 标识应用是否支持备份和恢复。 | / | Stage模型不支持 | -| compressNativeLibs | 标识libs库是否以压缩存储的方式打包到HAP包。 | / | Stage模型不支持 | -| network | 标识网络安全性配置。 | / | Stage模型不支持 | +| deviceConfig标签 | deviceConfig标签配置了设备信息 | / | Stage模型中没有该标签，直接在app标签下配置设备信息 | +| process | 标识应用或者Ability的进程名。如果在deviceConfig标签下配置了process标签，则该应用的所有Ability都运行在这个进程中。如果在abilities标签下也为某个Ability配置了process标签，则该Ability就运行在这个进程中。 | / | Stage模型不支持配置进程名称 | +| keepAlive | 标识应用是否始终保持运行状态，仅支持系统应用配置，三方应用配置不生效。 | / | Stage模型不支持系统应用模型管控方式变更 | +| supportBackup | 标识应用是否支持备份和恢复。 | / | Stage模型不支持 | +| compressNativeLibs | 标识libs库是否以压缩存储的方式打包到HAP。 | / | Stage模型不支持 | +| network | 标识网络安全性配置。 | / | Stage模型不支持 | diff --git a/zh-cn/application-dev/application-models/application-component-configuration-fa.md b/zh-cn/application-dev/application-models/application-component-configuration-fa.md index d4c3c1bc4624ff9ce140a4e9cf4145658c810820..d9b9818c96c022086762392b33cfbd08414a5f13 100644 --- a/zh-cn/application-dev/application-models/application-component-configuration-fa.md +++ b/zh-cn/application-dev/application-models/application-component-configuration-fa.md @@ -1,7 +1,7 @@ # 应用/组件级配置 -开发者在开发应用时，需要配置应用的一些标签，例如应用的包名、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。 +开发者在开发应用时，需要配置应用的一些标签，例如应用的Bundle名称、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。 - **应用包名配置** diff --git a/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md b/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md index ddbaa1f565cb4c1dfce7b67792752a49e12008a3..8a2d2bc692d05e3c010b1d4a70c5d4d72168edcd 100644 --- a/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md +++ b/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md @@ -238,7 +238,7 @@ 4. 连接一个后台服务。 - 实现IAbilityConnection接口。IAbilityConnection提供了以下方法供开发者实现：onConnect()是用来处理连接Service成功的回调，onDisconnect()是用来处理Service异常终止的回调，onFailed()是用来处理连接Service失败的回调。 - - 设置目标组件参数，包括目标设备ID、包名、ability名。 + - 设置目标组件参数，包括目标设备ID、Bundle名称、Ability名称。 - 调用connectServiceExtensionAbility发起连接。 - 连接成功，收到目标设备返回的服务句柄。 - 进行跨设备调用，获得目标端服务返回的结果。 diff --git a/zh-cn/application-dev/application-models/process-model-stage.md b/zh-cn/application-dev/application-models/process-model-stage.md index 152d9b6cf9cb1479e4ef21818dd4836d975a9bc8..88b9af254cfa2be9baaa03cd3d88a62785c8f74b 100644 --- a/zh-cn/application-dev/application-models/process-model-stage.md +++ b/zh-cn/application-dev/application-models/process-model-stage.md @@ -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”。 diff --git a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md index 9c8edd0f194631026a93d353a0cdd89f0217cd81..66922f71b0e27e43205a7d0da555379d16e92828 100644 --- a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md +++ b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md @@ -26,7 +26,7 @@ UIAbility是系统调度的最小单元。在设备内的功能模块之间跳 假设应用中有两个UIAbility：EntryAbility和FuncAbility（可以在应用的一个Module中，也可以在的不同Module中），需要从EntryAbility的页面中启动FuncAbility。 -1. 在EntryAbility中，通过调用startAbility()方法启动UIAbility，[want](../reference/apis/js-apis-app-ability-want.md)为UIAbility实例启动的入口参数，其中bundleName为待启动应用的Bundle名称，abilityName为待启动的UIAbility名称，moduleName在待启动的UIAbility属于不同的Module时添加，parameters为自定义信息参数。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 +1. 在EntryAbility中，通过调用startAbility()方法启动UIAbility，[want](../reference/apis/js-apis-app-ability-want.md)为UIAbility实例启动的入口参数，其中bundleName为待启动应用的Bundle名称，abilityName为待启动的Ability名称，moduleName在待启动的UIAbility属于不同的Module时添加，parameters为自定义信息参数。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 ```ts let wantInfo = { diff --git a/zh-cn/application-dev/application-models/uiability-lifecycle.md b/zh-cn/application-dev/application-models/uiability-lifecycle.md index 38ed7c2a10227a117e5cba90e38f56c1b26c66f6..c246043a81d555acef9b36c3a67a9500f7a25dea 100644 --- a/zh-cn/application-dev/application-models/uiability-lifecycle.md +++ b/zh-cn/application-dev/application-models/uiability-lifecycle.md @@ -83,6 +83,13 @@ export default class EntryAbility extends UIAbility { onWindowStageDestroy() { // 释放UI界面资源 + // 例如在onWindowStageDestroy()中注销获焦/失焦等WindowStage事件 + try { + windowStage.off('windowStageEvent'); + } catch (exception) { + console.error('Failed to disable the listener for window stage event changes. Cause:' + + JSON.stringify(exception)); + }; } } ``` diff --git a/zh-cn/application-dev/application-models/want-overview.md b/zh-cn/application-dev/application-models/want-overview.md index cefeef69ebce6b8d22aeabc1239dc3b9d1622d1e..b02617e6192c92214808fdb0d7d1c6d9c63db37d 100644 --- a/zh-cn/application-dev/application-models/want-overview.md +++ b/zh-cn/application-dev/application-models/want-overview.md @@ -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用法示意 usage-of-want @@ -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 = { diff --git a/zh-cn/application-dev/application-test/arkxtest-guidelines.md b/zh-cn/application-dev/application-test/arkxtest-guidelines.md index 42c90e5cb471b247fb42d68215755541a9d27529..f68c9bf5743ec6e5687c372963e2864d653ee4bb 100644 --- a/zh-cn/application-dev/application-test/arkxtest-guidelines.md +++ b/zh-cn/application-dev/application-test/arkxtest-guidelines.md @@ -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 | 特定参数，以键值对方式传入 | - s unittest OpenHarmonyTestRunner | diff --git a/zh-cn/application-dev/database/database-distributedobject-guidelines.md b/zh-cn/application-dev/database/database-distributedobject-guidelines.md index b18ca1730cce8cb3c8f89d63f4cfb3b140a7d763..d17f68d9f8e04e6984eafd04577f397e42a79c99 100644 --- a/zh-cn/application-dev/database/database-distributedobject-guidelines.md +++ b/zh-cn/application-dev/database/database-distributedobject-guidelines.md @@ -17,7 +17,7 @@ **表1** 分布式数据对象实例创建接口 -| 包名 | 接口名 | 描述 | +| Bundle名称 | 接口名 | 描述 | | -------- | -------- | -------- | | ohos.data.distributedDataObject| createDistributedObject(source: object): DistributedObject | 创建一个分布式数据对象实例，用于数据操作。
- source：设置分布式数据对象的属性。
- 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)); ``` diff --git a/zh-cn/application-dev/database/database-preference-guidelines.md b/zh-cn/application-dev/database/database-preference-guidelines.md index 6094421564b42b230011e98f1f66a55e0f239b0c..005155f3ef55643f3fddc9f4b5e7d9921742755f 100644 --- a/zh-cn/application-dev/database/database-preference-guidelines.md +++ b/zh-cn/application-dev/database/database-preference-guidelines.md @@ -24,7 +24,7 @@ **表1** 首选项实例创建接口 -| 包名 | 接口名 | 描述 | +| Bundle名称 | 接口名 | 描述 | | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | ohos.data.preferences | getPreferences(context: Context, name: string): Promise\ | 读取指定首选项持久化文件，将数据加载到Preferences实例，用于数据操作。 | @@ -75,7 +75,7 @@ **表6** 首选项删除接口 -| 包名 | 接口名 | 描述 | +| Bundle名称 | 接口名 | 描述 | | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | ohos.data.preferences | deletePreferences(context: Context, name: string): Promise\ | 从缓存中移除已加载的Preferences对象，同时从设备上删除对应的文件。 | | ohos.data.preferences | removePreferencesFromCache(context: Context, name: string): Promise\ | 仅从缓存中移除已加载的Preferences对象，主要用于释放内存。 | diff --git a/zh-cn/application-dev/faqs/faqs-ability.md b/zh-cn/application-dev/faqs/faqs-ability.md index c79f76f2a40628bf027c28a6f1ed765fb87bb282..1fff0339c34e982898a3e85236e47c085170a3aa 100644 --- a/zh-cn/application-dev/faqs/faqs-ability.md +++ b/zh-cn/application-dev/faqs/faqs-ability.md @@ -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，被调用方如何返回数据 diff --git a/zh-cn/application-dev/faqs/faqs-hdc-std.md b/zh-cn/application-dev/faqs/faqs-hdc-std.md index 3690a4d9c69c27514f233c00d8bd62640241d563..20cdb7205dd9fca003b2b3b2ea0d6bc152d60e62 100644 --- a/zh-cn/application-dev/faqs/faqs-hdc-std.md +++ b/zh-cn/application-dev/faqs/faqs-hdc-std.md @@ -24,7 +24,7 @@ 执行完命令后重启DevEco Studio。 -## 用IDE安装HAP包到开发板上无法打开 +## 用IDE安装HAP到开发板上无法打开 适用于：OpenHarmony SDK 3.2.5.3版本，API9 Stage模型 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/case.md b/zh-cn/application-dev/key-features/multi-device-app-dev/case.md index 0615998148d7b2c305025d73d22b2ad0caa857a2..f1dc34b9e0514708dca74b4e1f67889d730d57f7 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/case.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/case.md @@ -6,7 +6,7 @@ ## 概览 -[短信](https://gitee.com/openharmony/applications_mms/tree/master)是OpenHarmony中预置的系统应用，主要包含信息查看、发送短信、接收短信、短信送达报告、删除短信等功能。在不同类型设备上，短信应用的功能完全相同，故短信应用适合使用[部署模型A](introduction.md#部署模型)（即：不同类型的设备上安装运行相同的HAP包或HAP包组合）。 +[短信](https://gitee.com/openharmony/applications_mms/tree/master)是OpenHarmony中预置的系统应用，主要包含信息查看、发送短信、接收短信、短信送达报告、删除短信等功能。在不同类型设备上，短信应用的功能完全相同，故短信应用适合使用[部署模型A](introduction.md#部署模型)（即：不同类型的设备上安装运行相同的HAP或HAP组合）。 本案例中，在会话详情页面利用[方舟开发框架](introduction.md#方舟开发框架)提供的“一多”能力，用一套代码同时适配默认设备和平板。 @@ -59,7 +59,7 @@ 短信应用在开发阶段，采用了一层工程结构。由于功能较为简单，所以并没有规划共用的feature和common目录，仅采用了一层product目录。 - 业务形态层（product） - 该目录采用IDE工程默认创建的entry目录，开发者可根据需要在创建Module时自行更改该目录名。不同产品形态，编译出相同的短信HAP包。 + 该目录采用IDE工程默认创建的entry目录，开发者可根据需要在创建Module时自行更改该目录名。不同产品形态，编译出相同的短信HAP。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/faq.md b/zh-cn/application-dev/key-features/multi-device-app-dev/faq.md index b05ae7ef0c5a4618ec4ffd0f0a868fcf7640d7a2..68a8b425f18f6c362bb3d264b52ed9e1d7d4981e 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/faq.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/faq.md @@ -81,7 +81,7 @@ 默认设备屏幕尺寸较小，采用standard启动模式不仅无法给用户提供便利，反而可能消耗更多系统资源，故通常采用singleton启动模式。平板屏幕尺寸较大且可能支持自由窗口，对于文档编辑、网页浏览等场景，使用standard启动模式可以提升用户体验。 -本文中将默认设备和平板等归为同一泛类，推荐同一泛类的设备共用HAP包，同时本文也介绍了如何通过自适应布局能力和响应式布局能力开发出适配不同设备的页面。这里将补充介绍，如何实现Ability在不同设备上以不同的模式启动。 +本文中将默认设备和平板等归为同一泛类，推荐同一泛类的设备共用HAP，同时本文也介绍了如何通过自适应布局能力和响应式布局能力开发出适配不同设备的页面。这里将补充介绍，如何实现Ability在不同设备上以不同的模式启动。 launchType字段配置为specified时，系统会根据AbilityStage的onAcceptWant的返回值确定是否创建新的实例。对于同一个应用，如果key已经存在，则复用该key对应的Ability，如果key不存在则新创建Ability。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md b/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md index eac761f3396c396c848e1c1c2c27aa1fae7223c7..2574e81c459765fa5a5a2b43df0d8f56665984bb 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md @@ -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) diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md b/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md index cb28e448d84b8ec4147c98ac6f9f634207a8d107..bebdaf58854ad5114941a569cf6c8c4d3d9ebdb2 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md @@ -37,9 +37,9 @@ ### 应用程序包结构 -OpenHarmony 的应用以APP Pack (Application Package) 形式发布，它是由一个或多个HAP包以及描述每个HAP包属性的pack.info文件组成。 +OpenHarmony 的应用以APP Pack (Application Package) 形式发布，它是由一个或多个HAP以及描述每个HAP属性的pack.info文件组成。 -HAP包是OpenHarmony的安装包，一个HAP在工程目录中对应一个Module，由Module编译而来，可分为entry和feature两种类型的HAP。 +HAP是OpenHarmony的安装包，一个HAP在工程目录中对应一个Module，由Module编译而来，可分为entry和feature两种类型的HAP。 - **entry**：应用的主模块包。一个APP中，对于同一设备类型，可以有一个或多个entry类型的HAP，来支持该设备类型中不同规格（如API版本、屏幕规格等）的具体设备。 @@ -48,7 +48,7 @@ HAP包是OpenHarmony的安装包，一个HAP在工程目录中对应一个Module ![zh-cn_image_0000001266965046](figures/zh-cn_image_0000001266965046.png) > **说明：** -> - Module是开发者开发的相对独立的功能模块，由代码、资源、第三方库及应用配置文件组成，属于IDE开发视图的概念。Module分为entry、feature及har三种类型，相应的可以编译生成entry类型的HAP包、feature类型的HAP包，以及har包。 +> - Module是开发者开发的相对独立的功能模块，由代码、资源、第三方库及应用配置文件组成，属于IDE开发视图的概念。Module分为entry、feature及har三种类型，相应的可以编译生成entry类型的HAP、feature类型的HAP，以及har包。 > > - 如果需要了解应用程序包结构更多详情，可以查看[包结构说明](../../quick-start/application-package-structure-stage.md)。 @@ -81,9 +81,9 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 “一多”有两种部署模型： -- **部署模型A**：不同类型的设备上按照一定的工程结构组织方式，通过一次编译生成**相同**的HAP包（或HAP包组合）。 +- **部署模型A**：不同类型的设备上按照一定的工程结构组织方式，通过一次编译生成**相同**的HAP（或HAP组合）。 -- **部署模型B**：不同类型的设备上按照一定的工程结构组织方式，通过一次编译生成**不同**的HAP包（或HAP包组合）。 +- **部署模型B**：不同类型的设备上按照一定的工程结构组织方式，通过一次编译生成**不同**的HAP（或HAP组合）。 建议开发者从设备类型及应用功能两个维度，结合具体的业务场景，考虑选择哪种部署模型。但不管采用哪种部署模型，都应该采用一次编译。 @@ -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 └── ... ``` diff --git a/zh-cn/application-dev/quick-start/app-configuration-file.md b/zh-cn/application-dev/quick-start/app-configuration-file.md index 8c7195d724e22f55af15ba2e6d906f64f1f5ac6e..1f8d24a694a3117e71810ba1a0b7c3b5c947c5fa 100644 --- a/zh-cn/application-dev/quick-start/app-configuration-file.md +++ b/zh-cn/application-dev/quick-start/app-configuration-file.md @@ -34,7 +34,7 @@ app.json5配置文件包含以下标签。 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | -| bundleName | 标识应用的包名，用于标识应用的唯一性。该标签不可缺省。标签的值命名规则 ：
- 字符串以字母、数字、下划线和符号“.”组成。
- 以字母开头。
- 最小长度7个字节，最大长度127个字节。
推荐采用反域名形式命名（如com.example.demo，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。
其中，随系统源码编译的应用建议命名为“com.ohos.demo”形式， ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 | +| bundleName | 标识应用的Bundle名称，用于标识应用的唯一性。该标签不可缺省。标签的值命名规则 ：
- 字符串以字母、数字、下划线和符号“.”组成。
- 以字母开头。
- 最小长度7个字节，最大长度127个字节。
推荐采用反域名形式命名（如com.example.demo，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。
其中，随系统源码编译的应用建议命名为“com.ohos.demo”形式， ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 | | debug | 标识应用是否可调试，该标签由IDE编译构建时生成。
- true：可调试。
- false：不可调式。 | 布尔值 | 该标签可以缺省，缺省为false。 | | icon | 标识[应用的图标](../application-models/application-component-configuration-stage.md)，标签值为图标资源文件的索引。 | 字符串 | 该标签不可缺省。 | | label | 标识[应用的名称](../application-models/application-component-configuration-stage.md)，标签值为字符串资源的索引。 | 字符串 | 该标签不可缺省。 | diff --git a/zh-cn/application-dev/quick-start/app-structure.md b/zh-cn/application-dev/quick-start/app-structure.md index 6cbaa6665dfe4b6966acd7b309d1d939f490f75a..b865b4bb2e485ca84117a61496c44ef49d447d81 100644 --- a/zh-cn/application-dev/quick-start/app-structure.md +++ b/zh-cn/application-dev/quick-start/app-structure.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 API版本。 | 对象 | 可缺省，缺省值为空。 | diff --git a/zh-cn/application-dev/quick-start/application-configuration-file-overview-fa.md b/zh-cn/application-dev/quick-start/application-configuration-file-overview-fa.md index c7e0627fba1d5a7f2197d12cf5393854bc4cda3d..7db321a4cfce86759db2e2fca0218fa735c5aefc 100644 --- a/zh-cn/application-dev/quick-start/application-configuration-file-overview-fa.md +++ b/zh-cn/application-dev/quick-start/application-configuration-file-overview-fa.md @@ -7,7 +7,7 @@ 应用配置文件需申明以下内容： -- 应用的软件包名称，应用的开发厂商，版本号等应用的基本配置信息，这些信息被要求设置在app这个字段下。 +- 应用的软件Bundle名称，应用的开发厂商，版本号等应用的基本配置信息，这些信息被要求设置在app这个字段下。 - 应用的组件的基本信息，包括所有的Ability，设备类型，组件的类型以及当前组件所使用的语法类型。 diff --git a/zh-cn/application-dev/quick-start/application-configuration-file-overview-stage.md b/zh-cn/application-dev/quick-start/application-configuration-file-overview-stage.md index c55b1e8efe9775472a5615002bc4116dd5078da9..6fe06ff209f927a182deb971d1195c3ce373cbba 100644 --- a/zh-cn/application-dev/quick-start/application-configuration-file-overview-stage.md +++ b/zh-cn/application-dev/quick-start/application-configuration-file-overview-stage.md @@ -10,7 +10,7 @@ [app.json5](app-configuration-file.md)主要包含以下内容： -- 应用的全局配置信息，包含应用的包名、开发厂商、版本号等基本信息。 +- 应用的全局配置信息，包含应用的Bundle名称、开发厂商、版本号等基本信息。 - 特定设备类型的配置信息。 diff --git a/zh-cn/application-dev/quick-start/application-package-structure-stage.md b/zh-cn/application-dev/quick-start/application-package-structure-stage.md index 08b89d43bfc8cdb517d1094d2a9c26424c927c6c..b484f0ab579c178fd2e1dd0a62452ee54c0e2157 100644 --- a/zh-cn/application-dev/quick-start/application-package-structure-stage.md +++ b/zh-cn/application-dev/quick-start/application-package-structure-stage.md @@ -18,7 +18,7 @@ - 每个OpenHarmony应用可以包含多个.hap文件，一个应用中的.hap文件合在一起称为一个Bundle，而bundleName就是应用的唯一标识（请参见[app.json5配置文件](app-configuration-file.md)中的bundleName标签）。需要特别说明的是：在应用上架到应用市场时，需要把应用包含的所有.hap文件（即Bundle）打包为一个.app后缀的文件用于上架，这个.app文件称为App Pack（Application Package），其中同时包含了描述App Pack属性的pack.info文件；在云端分发和端侧安装时，都是以HAP为单位进行分发和安装的。 -- 打包后的HAP包结构包括ets、libs、resources等文件夹和resources.index、module.json、pack.info等文件。 +- 打包后的HAP结构包括ets、libs、resources等文件夹和resources.index、module.json、pack.info等文件。 - ets目录用于存放应用代码编译后的字节码文件。 - libs目录用于存放库文件。库文件是OpenHarmony应用依赖的第三方代码（.so二进制文件）。 - resources目录用于存放应用的资源文件（字符串、图片等），便于开发者使用和维护，详见[资源文件的使用](../key-features/multi-device-app-dev/resource-usage.md)。 diff --git a/zh-cn/application-dev/quick-start/arkts-basic-ui-description.md b/zh-cn/application-dev/quick-start/arkts-basic-ui-description.md index c705d35f5cca6c34cd7d52986153663246946f67..bf975b96765f0b4b0ab94ac3c80dda0aa320eb73 100644 --- a/zh-cn/application-dev/quick-start/arkts-basic-ui-description.md +++ b/zh-cn/application-dev/quick-start/arkts-basic-ui-description.md @@ -121,7 +121,7 @@ Text(`count: ${this.count}`) ```ts Button('add counter') .onClick(() => { - this.counter += 2 + this.counter += 2; }) ``` @@ -130,7 +130,7 @@ Text(`count: ${this.count}`) ```ts Button('add counter') .onClick(function () { - this.counter += 2 + this.counter += 2; }.bind(this)) ``` @@ -138,11 +138,11 @@ Text(`count: ${this.count}`) ```ts myClickHandler(): void { - this.counter += 2 + this.counter += 2; } ... - + Button('add counter') .onClick(this.myClickHandler.bind(this)) ``` @@ -174,10 +174,10 @@ Text(`count: ${this.count}`) .height(100) Button('click +1') .onClick(() => { - console.info('+1 clicked!') + console.info('+1 clicked!'); }) } - + Divider() Row() { Image('test2.jpg') @@ -185,10 +185,10 @@ Text(`count: ${this.count}`) .height(100) Button('click +2') .onClick(() => { - console.info('+2 clicked!') + console.info('+2 clicked!'); }) } - + Divider() Row() { Image('test3.jpg') @@ -196,7 +196,7 @@ Text(`count: ${this.count}`) .height(100) Button('click +3') .onClick(() => { - console.info('+3 clicked!') + console.info('+3 clicked!'); }) } } diff --git a/zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md b/zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md index 0f67972ef260d3e515a5d9a9d4b35694d8e35d1b..16408cd682801e6fe41c4c48871dd6250887c1c0 100644 --- a/zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md +++ b/zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md @@ -91,6 +91,8 @@ struct MyComponent { - 支持多个实例：一个组件中可以定义多个标有@Prop的属性； - 创建自定义组件时将值传递给@Prop变量进行初始化：在创建组件的新实例时，必须初始化所有@Prop变量，不支持在组件内部进行初始化。 +> **说明：** @Prop修饰的变量不能在组件内部进行初始化。 + **示例：** 在下面的示例中，当按“+1”或“-1”按钮时，父组件状态发生变化，重新执行build方法，此时将创建一个新的CountDownComponent组件实例。父组件的countDownStartValue状态变量被用于初始化子组件的@Prop变量，当按下子组件的“count - costOfOneAttempt”按钮时，其@Prop变量count将被更改，CountDownComponent重新渲染，但是count值的更改不会影响父组件的countDownStartValue值。 @@ -156,7 +158,7 @@ struct CountDownComponent { - 双向通信：子组件对@Link变量的更改将同步修改父组件中的@State变量； - 创建自定义组件时需要将变量的引用传递给@Link变量，在创建组件的新实例时，必须使用命名参数初始化所有@Link变量。@Link变量可以使用@State变量或@Link变量的引用进行初始化，@State变量可以通过`'$'`操作符创建引用。 -> **说明：** @Link变量不能在组件内部进行初始化。 +> **说明：** @Link修饰的变量不能在组件内部进行初始化。 **简单类型示例：** diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index b87c63a5b12c92f357813e47db6af53efbc3f981..589b09c9a522c192528963712d4c439634b2f51d 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -441,7 +441,7 @@ metadata中指定shortcut信息，其中： | shortcutId | 标识快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 该标签不可缺省。 | | label | 标识快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值可以是描述性内容，也可以是标识label的资源索引。字符串最大长度为255字节。 | 字符串 | 该标签可缺省，缺省值为空。 | | icon | 标识快捷方式的图标，标签值为资源文件的索引。 | 字符串 | 该标签可缺省，缺省值为空。 | -| [wants](../application-models/want-overview.md) | 标识快捷方式内定义的目标wants信息集合，每个wants可配置bundleName和abilityName两个子标签。
bundleName：表示快捷方式的目标包名，字符串类型。
abilityName：表示快捷方式的目标组件名，字符串类型。 | 对象 | 该标签可缺省，缺省为空。 | +| [wants](../application-models/want-overview.md) | 标识快捷方式内定义的目标wants信息集合，每个wants可配置bundleName和abilityName两个子标签。
bundleName：表示快捷方式的目标Bundle名称，字符串类型。
abilityName：表示快捷方式的目标组件名，字符串类型。 | 对象 | 该标签可缺省，缺省为空。 | 1. 在/resource/base/profile/目录下配置shortcuts_config.json配置文件。 diff --git a/zh-cn/application-dev/quick-start/multi-hap-build-view.md b/zh-cn/application-dev/quick-start/multi-hap-build-view.md index a1c7dfe5bc1f0b48e09f9bce5289aba340282fbe..9989efb8ca74673aef45a9548632d72e3694df08 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-build-view.md +++ b/zh-cn/application-dev/quick-start/multi-hap-build-view.md @@ -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目录：放置应用的图标资源和应用名称字符串资源。 **说明：** diff --git a/zh-cn/application-dev/quick-start/multi-hap-principles.md b/zh-cn/application-dev/quick-start/multi-hap-principles.md index 0587c5bd8e324a668940bbeba98deb12b4611b6f..78e9b228052f0ee54ec7217388bfc199bbba8cf0 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-principles.md +++ b/zh-cn/application-dev/quick-start/multi-hap-principles.md @@ -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)。 diff --git a/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md b/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md index 755009c273442c1579296bce884bb88cb3e63e6b..eb7cfba1fceaa9fbc36f81b30f1a0652d7aafb6c 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md +++ b/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md @@ -5,7 +5,7 @@ 开发者通过[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio)工具按照业务的需要创建多个Module，在相应的Module中完成自身业务的开发。 ## 2. 调试 -通过DevEco Studio编译打包，生成单个或者多个HAP包。真机基于HAP包进行安装、卸载调试，调试指南可参考[应用程序包调试方法](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-debugging-and-running-0000001263040487#section10491183521520)，其中包括了单HAP与多HAP通过DevEco Studio工具的安装调试方法。 +通过DevEco Studio编译打包，生成单个或者多个HAP。真机基于HAP进行安装、卸载调试，调试指南可参考[应用程序包调试方法](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-debugging-and-running-0000001263040487#section10491183521520)，其中包括了单HAP与多HAP通过DevEco Studio工具的安装调试方法。 应用程序包也可以通过[hdc_std工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)(可通过OpenHarmony SDK获取，在SDK的toolchains目录下)进行安装、更新与卸载，通过hdc_std安装HAP时，HAP的路径为开发平台上的文件路径，以Windows开发平台为例，命令参考如下： ``` diff --git a/zh-cn/application-dev/quick-start/start-with-ets-fa.md b/zh-cn/application-dev/quick-start/start-with-ets-fa.md index c7248ea8c98565038505a58391d26ab9353c7fc9..6e2818d8f7a3065560aa033caeff44f41f17aeeb 100644 --- a/zh-cn/application-dev/quick-start/start-with-ets-fa.md +++ b/zh-cn/application-dev/quick-start/start-with-ets-fa.md @@ -40,7 +40,7 @@ - **src > main > ets > MainAbility > pages > index.ets**：pages列表中的第一个页面，即应用的首页入口。 - **src > main > ets > MainAbility > app.ets**：承载Ability生命周期。 - **src > main > resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。 - - **src > main > config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。 + - **src > main > config.json**：模块配置文件。主要包含HAP的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 diff --git a/zh-cn/application-dev/quick-start/start-with-ets-stage.md b/zh-cn/application-dev/quick-start/start-with-ets-stage.md index 344a02a8034ca201db21f7207006c939a8d4bbc6..e4e5190da97ca8b0ffc8cb1f78b019cd4924e3ac 100644 --- a/zh-cn/application-dev/quick-start/start-with-ets-stage.md +++ b/zh-cn/application-dev/quick-start/start-with-ets-stage.md @@ -38,7 +38,7 @@ - **src > main > ets > entryability**：应用/服务的入口。 - **src > main > ets > pages**：应用/服务包含的页面。 - **src > main > resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源文件的分类](resource-categories-and-access.md#资源分类)。 - - **src > main > module.json5**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[module.json5配置文件](module-configuration-file.md)。 + - **src > main > module.json5**：模块配置文件。主要包含HAP的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[module.json5配置文件](module-configuration-file.md)。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 diff --git a/zh-cn/application-dev/quick-start/start-with-js-fa.md b/zh-cn/application-dev/quick-start/start-with-js-fa.md index 8dc0d1b5f542dda575ef77925d3b265d21b2cfe9..1cf6350ac7ab98dd7e4ece38e4c517d571507d85 100644 --- a/zh-cn/application-dev/quick-start/start-with-js-fa.md +++ b/zh-cn/application-dev/quick-start/start-with-js-fa.md @@ -39,7 +39,7 @@ - **src > main > js > MainAbility > app.js**：承载Ability生命周期。 - **src > main > resources**：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见[资源限定与访问](../ui/js-framework-resource-restriction.md)。 - - **src > main > config.json**：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。 + - **src > main > config.json**：模块配置文件。主要包含HAP的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见[应用配置文件（FA模型）](application-configuration-file-overview-fa.md)。 - **build-profile.json5**：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。 - **hvigorfile.ts**：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md index 69a1083779c9f4cef700bf5e78bbf33e198b60f4..e2a66d7d3e301aa1234e5230b292e1a42a4b858f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-Bundle-InnerBundleManager.md @@ -21,7 +21,7 @@ SystemCapability.BundleManager.BundleFramework getLauncherAbilityInfos(bundleName: string, userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : 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\> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------ | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | +| userId | number | 是 | 用户ID。取值范围：大于等于0。 | +| callback | AsyncCallback\> | 是 | 程序启动作为入参的回调函数，返回程序信息。 | ## innerBundleManager.getLauncherAbilityInfos(deprecated) getLauncherAbilityInfos(bundleName: string, userId: number) : Promise<Array<LauncherAbilityInfo>> -以异步方法根据给定的包名获取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<Array<ShortcutInfo>>) : 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\> | 是 | 程序启动作为入参的回调函数，返回快捷方式信息。 | ## innerBundleManager.getShortcutInfos(deprecated) getShortcutInfos(bundleName : string) : Promise<Array<ShortcutInfo>> -以异步方法根据给定的包名获取快捷方式信息，使用Promise形式返回结果。 +以异步方法根据给定的Bundle名称获取快捷方式信息，使用Promise形式返回结果。 > 从API version 9开始不再支持。建议使用[launcherBundleManager#getShortcutInfo](js-apis-launcherBundleManager.md)替代。 **需要权限：** @@ -299,7 +299,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-Bundle.md b/zh-cn/application-dev/reference/apis/js-apis-Bundle.md index 96e8181a144eee675332a2bd43d5919f53a1f375..250302245b41ad7c8dd07de9979a919565d2e5cd 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-Bundle.md +++ b/zh-cn/application-dev/reference/apis/js-apis-Bundle.md @@ -29,7 +29,7 @@ import bundle from '@ohos.bundle'; getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\ -以异步方法根据给定的包名获取ApplicationInfo。使用Promise异步回调。 +以异步方法根据给定的Bundle名称获取ApplicationInfo。使用Promise异步回调。 获取调用方自己的信息时不需要权限。 @@ -45,7 +45,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | @@ -75,7 +75,7 @@ bundle.getApplicationInfo(bundleName, bundleFlags, userId) getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\): void -以异步方法根据给定的包名获取指定用户下的ApplicationInfo，使用callback形式返回结果。 +以异步方法根据给定的Bundle名称获取指定用户下的ApplicationInfo，使用callback形式返回结果。 获取调用方自己的信息时不需要权限。 @@ -91,9 +91,9 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 | -| userId | number | 是 | 用户ID。取值范围：大于等于0。 | +| userId | number | 是 | 用户ID。取值范围：大于等于0。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | **示例：** @@ -118,7 +118,7 @@ bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => { getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void -以异步方法根据给定的包名获取ApplicationInfo，使用callback形式返回结果。 +以异步方法根据给定的Bundle名称获取ApplicationInfo，使用callback形式返回结果。 获取调用方自己的信息时不需要权限。 @@ -134,7 +134,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 | | callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | @@ -280,7 +280,7 @@ bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => { getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise\ -以异步方法根据给定的包名获取BundleInfo，使用Promise异步回调。 +以异步方法根据给定的Bundle名称获取BundleInfo，使用Promise异步回调。 获取调用方自己的信息时不需要权限。 @@ -296,7 +296,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------- | ---- |---------------------------------------------------------------------| -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 | | options | [BundleOptions](#bundleoptions) | 否 | 包含userid的查询选项。 | @@ -328,7 +328,7 @@ bundle.getBundleInfo(bundleName, bundleFlags, options) getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\): void -以异步方法根据给定的包名获取BundleInfo，使用callback异步回调。 +以异步方法根据给定的Bundle名称获取BundleInfo，使用callback异步回调。 获取调用方自己的信息时不需要权限。 @@ -342,11 +342,11 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ---------------------------------------------------------- | ---- |---------------------------------------------------------------------| -| bundleName | string | 是 | 需要查询的应用程序包名称。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| bundleName | string | 是 | 需要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 | -| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | +| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | **示例：** @@ -368,7 +368,7 @@ bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => { getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback\): void -以异步方法根据给定的包名获取BundleInfo，使用callback异步回调。 +以异步方法根据给定的Bundle名称获取BundleInfo，使用callback异步回调。 获取调用方自己的信息时不需要权限。 @@ -384,7 +384,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | -| bundleName | string | 是 | 要查询的应用包名。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 | | options | [BundleOptions](#bundleoptions) | 是 | 包含userid。 | | callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | @@ -505,7 +505,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------- | ---- | ------------------------------------- | -| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称。 | +| bundleName | string | 是 | 指示要清除其缓存数据的应用Bundle名称。 | | callback | AsyncCallback\ | 是 | 回调函数。 | **示例：** @@ -546,7 +546,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------------------- | -| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称。 | +| bundleName | string | 是 | 指示要清除其缓存数据的应用Bundle名称。 | **返回值：** @@ -590,7 +590,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------- | ---- |--------------------------------| -| bundleName | string | 是 | 指示需要启用或禁用的应用程序包名称。 | +| bundleName | string | 是 | 指示需要启用或禁用的应用Bundle名称。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false表示禁用。 | | callback | AsyncCallback\ | 是 | 回调函数。 | @@ -630,9 +630,9 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ------- | ---- |------------------------------| -| bundleName | string | 是 | 指示需要启用或禁用的应用程序包名称。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------- | ---- | ----------------------------------------------- | +| bundleName | string | 是 | 指示需要启用或禁用的应用Bundle名称。 | | isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用，false禁用。 | **返回值：** @@ -942,7 +942,7 @@ bundle.getAllApplicationInfo(bundleFlags, (err, data) => { getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise\ -获取有关HAP包中包含的应用程序包的信息，使用Promise形式返回结果。 +获取有关HAP中包含的应用程序包的信息，使用Promise形式返回结果。 **系统能力：** @@ -956,9 +956,9 @@ SystemCapability.BundleManager.BundleFramework | bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 | **返回值：** -| 类型 | 说明 | -| -------------- | -------------------------------------- | -| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象，Promise中包含有关hap包中包含的应用程序的信息。 | +| 类型 | 说明 | +| ---------------------------------------------------- | ------------------------------------------------------------ | +| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象，Promise中包含有关HAP中包含的应用程序的信息。 | **示例：** @@ -979,7 +979,7 @@ bundle.getBundleArchiveInfo(hapFilePath, bundleFlags) getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\) : void -以异步方法获取有关HAP包中包含的应用程序包的信息，使用callback形式返回结果。 +以异步方法获取有关HAP中包含的应用程序包的信息，使用callback形式返回结果。 **系统能力：** @@ -991,7 +991,7 @@ SystemCapability.BundleManager.BundleFramework | ---------- | ------ | ---- | ------------ | | hapFilePath | string | 是 | HAP存放路径，支持当前应用程序的绝对路径和数据目录沙箱路径。 | | bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflag)中包信息相关flag。 | -| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回HAP包中包含的应用程序包的信息。| +| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回HAP中包含的应用程序包的信息。 | **示例：** @@ -1013,7 +1013,7 @@ bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => { getAbilityInfo(bundleName: string, abilityName: string): Promise\ -通过包名称和组件名获取Ability组件信息，使用Promise形式异步回调。 +通过Bundle名称和组件名获取Ability组件信息，使用Promise形式异步回调。 获取调用方自己的信息时不需要权限。 @@ -1029,7 +1029,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- |------------| -| bundleName | string | 是 | 应用程序包名称。 | +| bundleName | string | 是 | 应用Bundle名称。 | | abilityName | string | 是 | Ability组件名称。 | **返回值：** @@ -1057,7 +1057,7 @@ bundle.getAbilityInfo(bundleName, abilityName) getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\): void; -通过包名称和组件名获取Ability组件信息，使用callback形式返回结果。 +通过Bundle名称和组件名获取Ability组件信息，使用callback形式返回结果。 获取调用方自己的信息时不需要权限。 @@ -1073,7 +1073,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------ | ---- |----------------------------| -| bundleName | string | 是 | 应用程序包名称。 | +| bundleName | string | 是 | 应用Bundle名称。 | | abilityName | string | 是 | Ability名称。 | | callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | @@ -1097,7 +1097,7 @@ bundle.getAbilityInfo(bundleName, abilityName, (err, data) => { getAbilityLabel(bundleName: string, abilityName: string): Promise\ -通过包名称和ability名称获取应用名称，使用Promise形式返回结果。 +通过Bundle名称和ability名称获取应用名称，使用Promise形式返回结果。 获取调用方自己的信息时不需要权限。 @@ -1111,10 +1111,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -|-------------|--------|-----|------------| -| bundleName | string | 是 | 应用程序包名称。 | -| abilityName | string | 是 | Ability名称。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------ | ---- | ---------------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| abilityName | string | 是 | Ability名称。 | **返回值：** @@ -1141,7 +1141,7 @@ bundle.getAbilityLabel(bundleName, abilityName) getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback\): void -通过包名称和Ability组件名获取应用名称，使用callback形式返回结果。 +通过Bundle名称和Ability组件名获取应用名称，使用callback形式返回结果。 获取调用方自己的信息时不需要权限。 @@ -1155,10 +1155,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -|-------------|------------------------|-----|-------------------------| -| bundleName | string | 是 | 应用程序包名称。 | -| abilityName | string | 是 | Ability名称。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ---------------------- | ---- | ---------------------------------------------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| abilityName | string | 是 | Ability名称。 | | callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数，返回应用名称信息。 | **示例：** @@ -1264,7 +1264,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | **返回值：** @@ -1300,7 +1300,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ----------------------- | ---- | ------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | callback | AsyncCallback\ | 是 | 回调函数，返回boolean代表是否启用。 | **示例：** @@ -1338,7 +1338,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------- | -| want | [Want](js-apis-application-want.md) | 是 | 包含要查询的应用程序包名称的意图。 | +| want | [Want](js-apis-application-want.md) | 是 | 包含要查询的应用Bundle名称的意图。 | | bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 | | userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | @@ -1387,12 +1387,12 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------| -| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 | -| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 | -| userId | number | 是 | 用户ID。取值范围：大于等于0。 | -| callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用Bundle名称的意图。 | +| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 | +| userId | number | 是 | 用户ID。取值范围：大于等于0。 | +| callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | **示例：** @@ -1432,11 +1432,11 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------| -| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用程序包名称的意图。 | -| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 | -| callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用Bundle名称的意图。 | +| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 | +| callback | AsyncCallback> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | **示例：** @@ -1477,7 +1477,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------ | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | **返回值：** | 类型 | 说明 | @@ -1516,7 +1516,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ---------- | --------------------------------------------------- | ---- | -------------------------------------------------------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | callback | AsyncCallback\<[Want](js-apis-application-want.md)> | 是 | 程序启动作为入参的回调函数，返回拉起指定应用的want对象。 | **示例：** @@ -1539,7 +1539,7 @@ bundle.getLaunchWantForBundle(bundleName, (err, data) => { getNameForUid(uid: number): Promise\ -以异步方法通过uid获取对应的包名，使用Promise形式返回结果。 +以异步方法通过uid获取对应的Bundle名称，使用Promise形式返回结果。 **系统能力：** @@ -1554,7 +1554,7 @@ SystemCapability.BundleManager.BundleFramework **返回值：** | 类型 | 说明 | | ---------------- | --------------------------------- | -| Promise\ | 返回值为Promise对象，Promise中包含指定uid的包名称。 | +| Promise\ | 返回值为Promise对象，Promise中包含指定uid的Bundle名称。 | **示例：** @@ -1574,7 +1574,7 @@ bundle.getNameForUid(uid) getNameForUid(uid: number, callback: AsyncCallback\) : void -以异步方法通过uid获取对应的包名，使用callback形式返回结果。 +以异步方法通过uid获取对应的Bundle名称，使用callback形式返回结果。 **系统能力：** @@ -1582,10 +1582,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -|----------|------------------------|-----|----------------------------| -| uid | number | 是 | 要查询的uid。 | -| callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数，返回指定uid的包名称。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------- | ---- | ----------------------------------------------------- | +| uid | number | 是 | 要查询的uid。 | +| callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数，返回指定uid的Bundle名称。 | **示例：** @@ -1621,10 +1621,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ------ | ---- |-----------------| -| bundleName | string | 是 | 要查询的应用包名。 | -| abilityName | string | 是 | 要查询的Ability组件名。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ------ | ---- | ------------------------ | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | +| abilityName | string | 是 | 要查询的Ability组件名。 | **返回值：** | 类型 | 说明 | @@ -1667,7 +1667,7 @@ SystemCapability.BundleManager.BundleFramework | 参数名 | 类型 | 必填 | 说明 | | ----------- | ---------------------------------------- | ---- |-------------------------------------------------| -| bundleName | string | 是 | 要查询的应用包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | abilityName | string | 是 | 要查询的Ability组件名。 | | callback | AsyncCallback\ | 是 | 程序启动作为入参的回调函数，返回指定[PixelMap](js-apis-image.md)。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md index fde9e837463a5245961b1b29a0c039aa0edafb3b..4b52a7987bec96def8c77a4e8c149822b02662ed 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md @@ -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名称。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md index 0b0770c266c89840477e4242b85972395a52dd90..dd2ecaa22d0fb1bf6541edc3abc9800290982954 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md @@ -50,7 +50,7 @@ want操作的常数。 | ACTION_MARKET_DOWNLOAD 9+ | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | ACTION_MARKET_CROWDTEST 9+ | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_SANDBOX9+ |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | -| DLP_PARAMS_BUNDLE_NAME9+ |ohos.dlp.params.bundleName |指示DLP包名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_BUNDLE_NAME9+ |ohos.dlp.params.bundleName |指示DLP Bundle名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_MODULE_NAME9+ |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_ABILITY_NAME9+ |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_INDEX9+ |ohos.dlp.params.index |指示DLP索引参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index 50128354f890d189389d269fbb347b012bee51ff..16b2e9bef518ae6fe58c830c4373a9deaf34b81a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -51,8 +51,8 @@ import accessibility from '@ohos.accessibility'; | -------- | -------- | -------- | -------- | -------- | | id | string | 是 | 否 | ability id。 | | name | string | 是 | 否 | ability 名。 | -| bundleName | string | 是 | 否 | 包名。 | -| targetBundleNames9+ | Array<string> | 是 | 否 | 关注的目标包名。 | +| bundleName | string | 是 | 否 | Bundle名称。 | +| targetBundleNames9+ | Array<string> | 是 | 否 | 关注的目标Bundle名称。 | | abilityTypes | Array<[AbilityType](#abilitytype)> | 是 | 否 | 辅助应用类型。 | | capabilities | Array<[Capability](#capability)> | 是 | 否 | 辅助应用能力列表。 | | 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<boolean>): void; @@ -773,7 +773,7 @@ accessibility.isOpenTouchGuide((err, data) => { } console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data)) }); - ``` +``` ## accessibility.sendEvent(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md index 23b02af0d62fd9283c0af456acb57a643fcb03a0..596e674e4dfc9d3ae9f4a244b12c0674af4a7cc1 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityStage.md @@ -1,6 +1,6 @@ # @ohos.app.ability.AbilityStage (AbilityStage) -AbilityStage是HAP包的运行时类。 +AbilityStage是HAP的运行时类。 AbilityStage类提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。 @@ -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名称等。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md index 64fa38e2773fb2c49dda6cc313cd326e8b71d9f1..21f26501512a9e38441ce15fbf890e7fd13b4953 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md @@ -320,7 +320,7 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\ **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | 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\ | 是 | 切断account进程的回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | +| callback | AsyncCallback\ | 是 | 切断account进程的回调函数。 | **示例：** @@ -603,7 +603,7 @@ appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountC killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); -通过包名终止进程。 +通过Bundle名称终止进程。 **需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES @@ -615,7 +615,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | | callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -640,7 +640,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); killProcessesByBundleName(bundleName: string): Promise\; -通过包名终止进程。 +通过Bundle名称终止进程。 **需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES @@ -652,7 +652,7 @@ killProcessesByBundleName(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | **返回值：** @@ -681,7 +681,7 @@ killProcessesByBundleName(bundleName: string): Promise\; clearUpApplicationData(bundleName: string, callback: AsyncCallback\); -通过包名清除应用数据。 +通过Bundle名称清除应用数据。 **需要权限**：ohos.permission.CLEAN_APPLICATION_DATA @@ -693,7 +693,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | | callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -718,7 +718,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); clearUpApplicationData(bundleName: string): Promise\; -通过包名清除应用数据。 +通过Bundle名称清除应用数据。 **需要权限**：ohos.permission.CLEAN_APPLICATION_DATA @@ -730,7 +730,7 @@ clearUpApplicationData(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md index a7a78fa0134de40aaaf00b086b7a36bfd79c00a7..e506298900dd3804470993b0c3dcc7b1817035cd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md @@ -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\ | 是 | 应用的快速修复信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 |应用Bundle名称。 | +| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 是 | 应用的快速修复信息。 | **示例：** @@ -168,9 +168,9 @@ getApplicationQuickFixInfo(bundleName: string): Promise\ **说明：** > diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md index 91383bd62de559f15313821736fd0281ca8029f6..3eb59cab78930721cff47fbb5606611d18ea4022 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantConstant.md @@ -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 | 表示从应用程序市场下载应用程序的的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | ACTION_MARKET_CROWDTEST | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_SANDBOX |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | -| DLP_PARAMS_BUNDLE_NAME |ohos.dlp.params.bundleName |指示DLP包名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_BUNDLE_NAME |ohos.dlp.params.bundleName |指示DLP Bundle名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_MODULE_NAME |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_ABILITY_NAME |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | DLP_PARAMS_INDEX |ohos.dlp.params.index |指示DLP索引参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md index 6acbe99c6ea59a3ffe9e23622721af1230d5ff06..4175a69a6016cecd855876af5ebbd0c7111c3fb6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formExtensionAbility.md @@ -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名称、能力名称、模块名称、卡片名和卡片维度。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md index f7e0324ca30d9fc23fb7eeda1bb7d12731c1f9ad..d903617a76e09a06aac287347d8ba863860a101c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md @@ -857,7 +857,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-formInfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 | **错误码：** @@ -897,7 +897,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback< | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | moduleName | string | 是 | 要查询的模块名称。 | | callback | AsyncCallback<Array<[FormInfo](js-apis-app-form-formInfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 | @@ -938,7 +938,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | moduleName | string | 否 | 要查询的模块名称。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md index 40a7493130806351bd0ff2c242e4b1a5687eaae1..5cc2bab3d9de476e4e07cf84f351a61283f946d8 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md @@ -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" | 设备标识。
**系统接口**: 此接口为系统接口。 | -| BUNDLE_NAME_KEY | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑包名称的键。| +| BUNDLE_NAME_KEY | "ohos.extra.param.key.bundle_name" | 指示指定要获取的捆绑Bundle名称的键。 | ## FormDimension diff --git a/zh-cn/application-dev/reference/apis/js-apis-appControl.md b/zh-cn/application-dev/reference/apis/js-apis-appControl.md index c8a6d76f550bfae81c21c6a35eafbe03d01c256b..9828a6572aca1404994332613f241686102babeb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appControl.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appControl.md @@ -30,7 +30,7 @@ setDisposedStatus(appId: string, disposedWant: Want): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | -| appId | string | 是 | 需要设置处置状态的应用的appId。
appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 需要设置处置状态的应用的appId。
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | | disposedWant | Want | 是 | 对应用的处置意图。 | **返回值：** @@ -81,7 +81,7 @@ setDisposedStatus(appId: string, disposedWant: Want, callback: AsyncCallback\ appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 需要设置处置的应用的appId
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | | disposedWant | Want | 是 | 对应用的处置意图。 | | callback | AsyncCallback\ | 是 | 回调函数，当设置处置状态成功，err为undefined，否则为错误对象。 | @@ -128,7 +128,7 @@ getDisposedStatus(appId: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | -| appId | string | 是 | 要查询的应用的appId
appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 要查询的应用的appId
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | **返回值：** @@ -177,7 +177,7 @@ getDisposedStatus(appId: string, callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | -| appId | string | 是 | 要查询的应用的appId
appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 要查询的应用的appId
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | | callback | AsyncCallback\ | 是 | 回调函数。当获取应用的处置状态成功时，err为undefined，data为获取到的处置状态；否则为错误对象。 | **错误码：** @@ -222,7 +222,7 @@ deleteDisposedStatus(appId: string): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | -| appId | string | 是 | 要删除处置状态的应用的appId
appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 要删除处置状态的应用的appId
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | **返回值：** @@ -271,7 +271,7 @@ deleteDisposedStatus(appId: string, callback: AsyncCallback\) : void | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | --------------------------------------- | -| appId | string | 是 | 要查询的应用的appId。
appId是应用的唯一标识，由应用的包名和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | +| appId | string | 是 | 要查询的应用的appId。
appId是应用的唯一标识，由应用Bundle名称和签名信息决定，获取方法参见[获取应用的appId](#获取应用的appid)。 | | callback | AsyncCallback\ | 是 | 回调函数，当设置处置状态成功时，err返回undefined。否则回调函数返回具体错误对象。 | **错误码：** @@ -301,7 +301,7 @@ try { ## 获取应用的appId -appId是应用的唯一标识，由应用的包名和签名信息决定，可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)接口获取。 +appId是应用的唯一标识，由应用Bundle名称和签名信息决定，可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)接口获取。 **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md index 079a7b576aa6471bfb805e0b261ff432b2b2f245..222bd012a3eb1b695d3d24a0afe4c473eb7c6995 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md @@ -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启动的原因、上次异常退出的原因信息。 | **示例：** @@ -725,7 +725,7 @@ off(method: string): void; } } ``` - + ## OnReleaseCallBack (msg: string): void; diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md index 1fe541aa5524c3c340276b00940a2dcf5cfc81ff..4717cc9388c56c7d4eeede9bbf0cdb2fdcf4fc7c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityStage.md @@ -1,6 +1,6 @@ # @ohos.application.AbilityStage (AbilityStage) -AbilityStage是HAP包的运行时类。 +AbilityStage是HAP的运行时类。 AbilityStage模块提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。 @@ -46,13 +46,13 @@ onAcceptWant(want: Want): string; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 | +| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的UIAbility的信息，如Ability名称，Bundle名称等。 | **返回值：** | 类型 | 说明 | | -------- | -------- | -| string | 用户返回一个ability标识，如果之前启动过标识的ability，不创建新的实例并拉回栈顶，否则创建新的实例并启动。 | +| string | 用户返回一个UIAbility标识，如果之前启动过标识的UIAbility实例，不创建新的实例并拉回栈顶，否则创建新的实例并启动。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md index 56b0ea96828b70b584dd3ee2ffa6d18b2bc2ea34..857b8d58aafecde495ac5e72b72341855e98ddef 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-appManager.md @@ -358,7 +358,7 @@ unregisterApplicationStateObserver(observerId: number, callback: AsyncCallback\ **系统API**：该接口为系统接口，三方应用不支持调用。 **参数：** - + | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | observerId | number | 是 | 表示观察者的编号代码。 | @@ -490,10 +490,10 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\ **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | 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\ | 是 | 切断account进程的回调函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | +| callback | AsyncCallback\ | 是 | 切断account进程的回调函数。 | **示例：** @@ -549,7 +549,7 @@ appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountC killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); -通过包名终止进程。 +通过Bundle名称终止进程。 **需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES @@ -561,7 +561,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | | callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -582,7 +582,7 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); killProcessesByBundleName(bundleName: string): Promise\; -通过包名终止进程。 +通过Bundle名称终止进程。 **需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES @@ -594,7 +594,7 @@ killProcessesByBundleName(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | **返回值：** @@ -603,9 +603,9 @@ killProcessesByBundleName(bundleName: string): Promise\; | Promise\ | 返回执行结果。 | **示例：** - + ```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\; clearUpApplicationData(bundleName: string, callback: AsyncCallback\); -通过包名清除应用数据。 +通过Bundle名称清除应用数据。 **需要权限**：ohos.permission.CLEAN_APPLICATION_DATA @@ -631,7 +631,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | | callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -652,7 +652,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); clearUpApplicationData(bundleName: string): Promise\; -通过包名清除应用数据。 +通过Bundle名称清除应用数据。 **需要权限**：ohos.permission.CLEAN_APPLICATION_DATA @@ -664,7 +664,7 @@ clearUpApplicationData(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 表示包名。 | +| bundleName | string | 是 | 表示Bundle名称。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-dataShareExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-dataShareExtensionAbility.md index 49e2ec26612ff745fb16d42a6e87aeb719ab6c43..5aca9fc590489d7aa3d7030b1cfcaa98c50e8afb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-dataShareExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-dataShareExtensionAbility.md @@ -37,7 +37,7 @@ DataShare客户端连接DataShareExtensionAbility服务端时，服务端回调 | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ------ | ------ | -| want | [Want](js-apis-application-want.md#want) | 是 | Want类型信息，包括ability名称、bundle名称等。 | +| want | [Want](js-apis-application-want.md#want) | 是 | Want类型信息，包括Ability名称、Bundle名称等。 | | callback | AsyncCallback<void> | 是 | 回调函数。无返回值。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-formExtension.md b/zh-cn/application-dev/reference/apis/js-apis-application-formExtension.md index 7ddbd2070327bb2db1786f6186b1e17b2645863a..741a99c544f9beaab9111eb5de9813e70645370d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-formExtension.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-formExtension.md @@ -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名称、能力名称、模块名称、卡片名和卡片维度。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-formHost.md b/zh-cn/application-dev/reference/apis/js-apis-application-formHost.md index 1badfbc1f6ebf92f5643f34377fced401ad0c102..0e427503557cd4c69774e4b8e2e3e719eaafdab4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-formHost.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-formHost.md @@ -650,7 +650,7 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用Bundle名称。 | | callback | AsyncCallback<Array<[FormInfo](js-apis-application-formInfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 | **示例：** @@ -679,7 +679,7 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback< | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用程序Bundle名称。 | | moduleName | string | 是 | 要查询的模块名称。 | | callback | AsyncCallback<Array<[FormInfo](js-apis-application-formInfo.md)>> | 是 | 回调函数。当获取设备上指定应用程序提供的卡片信息成功，err为undefined，data为查询到的卡片信息；否则为错误对象。 | @@ -709,7 +709,7 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| bundleName | string | 是 | 要查询的应用程序包名称。 | +| bundleName | string | 是 | 要查询的应用程序Bundle名称。 | | moduleName | string | 否 | 要查询的模块名称。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md b/zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md index c48ccb0e1412e5781f69e0aca377994271df050a..d50fb82a221268f5746f1ef887d8192809702a56 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-formInfo.md @@ -21,9 +21,9 @@ import formInfo from '@ohos.application.formInfo'; | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------- | -------- |-------- | -------------------- | ------------------------------------------------------------ | -| bundleName | string | 是 | 否 | 表示卡片所属包的包名。 | +| bundleName | string | 是 | 否 | 表示卡片所属包的Bundle名称。 | | moduleName | string | 是 | 否 | 表示卡片所属模块的模块名。 | -| abilityName | string | 是 | 否 | 表示卡片所属的Ability名称。 | +| abilityName | string | 是 | 否 | 表示卡片所属的Ability名称。 | | name | string | 是 | 否 | 表示卡片名称。 | | description | string | 是 | 否 | 表示卡片描述。 | | type | [FormType](#formtype) | 是 | 否 | 表示卡片类型，当前支持JS卡片。 | @@ -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 | 是 | 否 | 表示卡片更新周期。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-want.md b/zh-cn/application-dev/reference/apis/js-apis-application-want.md index 4458fd9a1dc9ae2f553dc26e6c8e45a3fdaa5d0b..a6b40f6271cc8350a61635fe1cfe58b5017b65b9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-want.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-want.md @@ -1,6 +1,6 @@ # @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。 > **说明：** > diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md index a03f5b352e1d055f408bbf0144f64c87971f0016..6f82c803d4cce42903fb5d6b152d34c8a52b7e31 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md @@ -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。
此属性仅可在FA模型下使用。 | -| backgroundModes | number | 是 | 否 | 表示后台服务的类型。
此属性仅可在FA模型下使用。 | -| isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用。 | -| formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力。
此属性仅可在FA模型下使用。 | -| type | AbilityType | 是 | 否 | Ability类型。
此属性仅可在FA模型下使用。 | -| orientation | [DisplayOrientation](js-apis-Bundle.md#displayorientationdeprecated) | 是 | 否 | Ability的显示模式。 | -| launchMode | [LaunchMode](js-apis-Bundle.md#launchmodedeprecated) | 是 | 否 | Ability的启动模式。 | -| permissions | Array\ | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合。
通过传入GET_ABILITY_INFO_WITH_PERMISSION获取。 | -| deviceTypes | Array\ | 是 | 否 | Ability支持的设备类型。 | -| deviceCapabilities | Array\ | 是 | 否 | Ability需要的设备能力。 | -| readPermission | string | 是 | 否 | 读取Ability数据所需的权限。
此属性仅可在FA模型下使用。| -| writePermission | string | 是 | 否 | 向Ability写数据所需的权限。
此属性仅可在FA模型下使用。 | -| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息。
通过传入[GET_ABILITY_INFO_WITH_APPLICATION](js-apis-Bundle.md)获取。 | -| uri | string | 是 | 否 | 获取Ability的统一资源标识符（URI）。
此属性仅可在FA模型下使用。 | -| labelId | number | 是 | 否 | Ability的标签id。 | -| subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型。
此属性仅可在FA模型下使用。 | -| metadata8+ | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的元信息。
通过传入GET_ABILITY_INFO_WITH_METADATA获取。 | -| enabled8+ | 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。
此属性仅可在FA模型下使用。 | +| backgroundModes | number | 是 | 否 | 表示后台服务的类型。
此属性仅可在FA模型下使用。 | +| isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用。 | +| formEnabled | boolean | 是 | 否 | 判断Ability是否提供卡片能力。
此属性仅可在FA模型下使用。 | +| type | AbilityType | 是 | 否 | Ability类型。
此属性仅可在FA模型下使用。 | +| orientation | [DisplayOrientation](js-apis-Bundle.md#displayorientationdeprecated) | 是 | 否 | Ability的显示模式。 | +| launchMode | [LaunchMode](js-apis-Bundle.md#launchmodedeprecated) | 是 | 否 | Ability的启动模式。 | +| permissions | Array\ | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合。
通过传入GET_ABILITY_INFO_WITH_PERMISSION获取。 | +| deviceTypes | Array\ | 是 | 否 | Ability支持的设备类型。 | +| deviceCapabilities | Array\ | 是 | 否 | Ability需要的设备能力。 | +| readPermission | string | 是 | 否 | 读取Ability数据所需的权限。
此属性仅可在FA模型下使用。 | +| writePermission | string | 是 | 否 | 向Ability写数据所需的权限。
此属性仅可在FA模型下使用。 | +| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息。
通过传入[GET_ABILITY_INFO_WITH_APPLICATION](js-apis-Bundle.md)获取。 | +| uri | string | 是 | 否 | 获取Ability的统一资源标识符（URI）。
此属性仅可在FA模型下使用。 | +| labelId | number | 是 | 否 | Ability的标签id。 | +| subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型。
此属性仅可在FA模型下使用。 | +| metadata8+ | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的元信息。
通过传入GET_ABILITY_INFO_WITH_METADATA获取。 | +| enabled8+ | boolean | 是 | 否 | ability是否可用。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md index 3521b7df34e11e214ef23ec4b91613cc80609a1c..8e1c7bdee07eac1042cf3c8e4cb9a39fe1790561 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md @@ -11,31 +11,31 @@ **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework。 -| 名称 | 类型 | 可读 | 可写 | 说明 | -| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | -| name | string | 是 | 否 | 应用包的名称。 | -| type | string | 是 | 否 | 应用包类型。 | -| appId | string | 是 | 否 | 应用包里应用程序的id。 | -| uid | number | 是 | 否 | 应用包里应用程序的uid。 | -| installTime | number | 是 | 否 | HAP包安装时间。 | -| updateTime | number | 是 | 否 | HAP包更新时间。 | -| appInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息。 | -| abilityInfos | Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 否 | Ability的配置信息
通过传入GET_BUNDLE_WITH_ABILITIES获取。 | -| reqPermissions | Array\ | 是 | 否 | 应用运行时需向系统申请的权限集合
通过传入GET_BUNDLE_WITH_REQUESTED_PERMISSION获取。 | -| reqPermissionDetails | Array\<[ReqPermissionDetail](#reqpermissiondetaildeprecated)> | 是 | 否 | 应用运行时需向系统申请的权限集合的详细信息
通过传入GET_BUNDLE_WITH_REQUESTED_PERMISSION获取。 | -| vendor | string | 是 | 否 | 应用包的供应商。 | -| versionCode | number | 是 | 否 | 应用包的版本号。 | -| versionName | string | 是 | 否 | 应用包的版本文本描述信息。 | -| compatibleVersion | number | 是 | 否 | 运行应用包所需要最低的SDK版本号。 | -| targetVersion | number | 是 | 否 | 运行应用包所需要最高SDK版本号。 | -| isCompressNativeLibs | boolean | 是 | 否 | 是否压缩应用包的本地库，默认为true。 | -| hapModuleInfos | Array\<[HapModuleInfo](js-apis-bundle-HapModuleInfo.md)> | 是 | 否 | 模块的配置信息。 | -| entryModuleName | string | 是 | 否 | Entry的模块名称。 | -| cpuAbi | string | 是 | 否 | 应用包的cpuAbi信息。 | -| isSilentInstallation | string | 是 | 否 | 是否通过静默安装。 | -| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。 | -| entryInstallationFree | boolean | 是 | 否 | Entry是否支持免安装。 | -| reqPermissionStates8+ | Array\ | 是 | 否 | 申请权限的授予状态。0表示申请成功，-1表示申请失败。 | +| 名称 | 类型 | 可读 | 可写 | 说明 | +| -------------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | +| name | string | 是 | 否 | 应用包的名称。 | +| type | string | 是 | 否 | 应用包类型。 | +| appId | string | 是 | 否 | 应用包里应用程序的id。 | +| uid | number | 是 | 否 | 应用包里应用程序的uid。 | +| installTime | number | 是 | 否 | HAP安装时间。 | +| updateTime | number | 是 | 否 | HAP更新时间。 | +| appInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息。 | +| abilityInfos | Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 否 | Ability的配置信息
通过传入GET_BUNDLE_WITH_ABILITIES获取。 | +| reqPermissions | Array\ | 是 | 否 | 应用运行时需向系统申请的权限集合
通过传入GET_BUNDLE_WITH_REQUESTED_PERMISSION获取。 | +| reqPermissionDetails | Array\<[ReqPermissionDetail](#reqpermissiondetaildeprecated)> | 是 | 否 | 应用运行时需向系统申请的权限集合的详细信息
通过传入GET_BUNDLE_WITH_REQUESTED_PERMISSION获取。 | +| vendor | string | 是 | 否 | 应用包的供应商。 | +| versionCode | number | 是 | 否 | 应用包的版本号。 | +| versionName | string | 是 | 否 | 应用包的版本文本描述信息。 | +| compatibleVersion | number | 是 | 否 | 运行应用包所需要最低的SDK版本号。 | +| targetVersion | number | 是 | 否 | 运行应用包所需要最高SDK版本号。 | +| isCompressNativeLibs | boolean | 是 | 否 | 是否压缩应用包的本地库，默认为true。 | +| hapModuleInfos | Array\<[HapModuleInfo](js-apis-bundle-HapModuleInfo.md)> | 是 | 否 | 模块的配置信息。 | +| entryModuleName | string | 是 | 否 | Entry的模块名称。 | +| cpuAbi | string | 是 | 否 | 应用包的cpuAbi信息。 | +| isSilentInstallation | string | 是 | 否 | 是否通过静默安装。 | +| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本。 | +| entryInstallationFree | boolean | 是 | 否 | Entry是否支持免安装。 | +| reqPermissionStates8+ | Array\ | 是 | 否 | 申请权限的授予状态。0表示申请成功，-1表示申请失败。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md index f9b6507b22f9eb0138a419b396ce7d0733d6053f..39de3d5e9086a794be8e568e7089fc978ade1d38 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md @@ -25,10 +25,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | -| bundleFilePaths | Array<string> | 是 | 指示存储hap包的沙箱路径。沙箱路径的获取方法参见[获取应用的沙箱路径](#获取应用的沙箱路径)。| -| param | [InstallParam](#installparamdeprecated) | 是 | 指定安装所需的其他参数。 | +| 参数名 | 类型 | 必填 | 说明 | +| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| bundleFilePaths | Array<string> | 是 | 指示存储HAP的沙箱路径。沙箱路径的获取方法参见[获取应用的沙箱路径](#获取应用的沙箱路径)。 | +| param | [InstallParam](#installparamdeprecated) | 是 | 指定安装所需的其他参数。 | | callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 | **示例：** @@ -75,10 +75,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- | -| bundleName | string | 是 | 应用包名。 | -| param | [InstallParam](#installparamdeprecated) | 是 | 指定卸载所需的其他参数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------------------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| param | [InstallParam](#installparamdeprecated) | 是 | 指定卸载所需的其他参数。 | | callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | 是 | 程序启动作为入参的回调函数，返回安装状态信息。 | **示例：** @@ -124,10 +124,10 @@ SystemCapability.BundleManager.BundleFramework **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- | -| bundleName | string | 是 | 应用包名。 | -| param | [InstallParam](#installparamdeprecated) | 是 | 指定应用恢复所需的其他参数。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- | +| bundleName | string | 是 | 应用Bundle名称。 | +| param | [InstallParam](#installparamdeprecated) | 是 | 指定应用恢复所需的其他参数。 | | callback | AsyncCallback<[InstallStatus](#installstatusdeprecated)> | 是 | 程序启动作为入参的回调函数，返回应用恢复状态信息。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md index 3bec9fa67ed900d215c855bbc14fe5ad6024b840..a066cf5bc3603432a525b81b09f8cee8922f35ff 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md @@ -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 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md index 2a6ef57c17bcd50ed138b49447d00210286e1948..ed3855f05f8b458db170d785ef36a83c91b8bcfa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-ShortcutInfo.md @@ -32,7 +32,7 @@ | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- | | id | string | 是 | 否 | 快捷方式所属应用程序的Id。 | -| bundleName | string | 是 | 否 | 包含该快捷方式的包名称。 | +| bundleName | string | 是 | 否 | 包含该快捷方式的Bundle名称。 | | hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息。 | | icon | string | 是 | 否 | 快捷方式的图标。 | | iconId8+ | number | 是 | 否 | 快捷方式的图标Id。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md index a611d687ba77938c1da5a025e74bbc31abfa00ee..4bc6eebde4629bbda01513e5a25c0b27d1fc4d0a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md @@ -11,8 +11,8 @@ Ability信息，系统应用可以通过[getBundleInfo](js-apis-bundleManager.md | 名称 | 类型 | 可读 | 可写 | 说明 | | --------------------- | -------------------------------------------------------- | ---- | ---- | ----------------------------------------- | -| bundleName | string | 是 | 否 | 应用包名 | -| moduleName | string | 是 | 否 | Ability所属的HAP包的名称 | +| bundleName | string | 是 | 否 | 应用Bundle名称 | +| moduleName | string | 是 | 否 | Ability所属的HAP的名称 | | name | string | 是 | 否 | Ability名称 | | label | string | 是 | 否 | Ability对用户显示的名称 | | labelId | number | 是 | 否 | Ability的标签资源id | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md index 0752e44e680eaa0f6b5c73c49da03e47030a1195..a58a3641d4403418ccecdfc581a01bac96a2bbe8 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md @@ -11,9 +11,9 @@ 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短名称。 | -| moduleName | string | 是 | 是 | Ability所属的HAP包的模块名称。 | \ No newline at end of file +| moduleName | string | 是 | 是 | Ability所属的HAP的模块名称。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-extensionAbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-extensionAbilityInfo.md index 9088cc70a3a2c6e1fd91767fe06388bb8045762c..1cb1d8756d30d8e4a00189a08d461425a506260f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-extensionAbilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-extensionAbilityInfo.md @@ -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\ | 是 | 否 | 被其他应用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\ | 是 | 否 | 被其他应用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 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-packInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-packInfo.md index d6152ec79d315ad6ad5b1aae007050fabc266ef3..3c10f48e0f0efbaa4b3b215e067dd500a44ed95c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-packInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-packInfo.md @@ -47,10 +47,10 @@ **系统能力：** SystemCapability.BundleManager.BundleFrameWork.FreeInstall -| 名称 | 类型 | 可读 | 可写 | 说明 | -| ---------- | ------------------- | ---- | ---- | ---------------------------------- | -| bundleName | string | 是 | 否 | 应用的包名，用于标识应用的唯一性。 | -| version | [Version](#version) | 是 | 否 | 包的版本。 | +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ---------- | ------------------- | ---- | ---- | -------------------------------------- | +| bundleName | string | 是 | 否 | 应用Bundle名称，用于标识应用的唯一性。 | +| version | [Version](#version) | 是 | 否 | 包的版本。 | ## ModuleConfigInfo diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md index 164c8d8492ad6fa3637686c3124f61bef97f9749..67b3a567cde25339020af03a067b7a4d51f68791 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-shortcutInfo.md @@ -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 newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md index 6c2c935ed82c80a3c0abf01d4e58874efc5afd11..f9e360f9cfabb0753382ca2d1245e013ff24968f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -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> | 是 | 回调函数，当获取成功时，err为null，data为获取到的Array\；否则为错误对象。 | @@ -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> | 是 | 回调函数，当获取成功时，err为null，data为获取到的Array\；否则为错误对象。 | @@ -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> | 是 | 回调函数，当获取成功时，err为null，data为获取到Array\；否则为错误对象。 | **错误码：** @@ -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> | 是 | 回调函数，当获取成功时，err为null，data为获取到Array\；否则为错误对象。 | **错误码：** @@ -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。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md index 1755bef89e594996fc48c0febe7ed86593cc02d4..0c4f4fe181ad774d6f00a3ed9904fae6aae07673 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleMonitor.md @@ -28,7 +28,7 @@ import bundleMonitor from '@ohos.bundle.bundleMonitor'; | 名称 | 类型 | 可读 | 可写 | 说明 | | ---------- | ------ | ---- | ---- | -------------------------- | -| bundleName | string | 是 | 否 | 应用状态发生变化的应用包名。 | +| bundleName | string | 是 | 否 | 应用状态发生变化的应用Bundle名称。 | | userId | number | 是 | 否 | 应用状态发生变化的用户id。 | ## bundleMonitor.on diff --git a/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md b/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md index 55635168340b262a37f109b58395a2280ea42293..46d0485bb53d43d6ae53c01e6934d49bb25f755d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md @@ -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名称和组件名称组成。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-commonEvent.md b/zh-cn/application-dev/reference/apis/js-apis-commonEvent.md index bdf0553502f89fea52a33a45cf6288e9dd0e6204..58ec8675e61161db27d3efd6882a6d11b8292634 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-commonEvent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-commonEvent.md @@ -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\ | 是 | 否 | 表示订阅者的权限。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-contact.md b/zh-cn/application-dev/reference/apis/js-apis-contact.md index e361f2cfc2e84ace608a91f82a2377155d6ac311..2c6cb8f66a8dd544d343bdee6de8639f6c2db45d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-contact.md +++ b/zh-cn/application-dev/reference/apis/js-apis-contact.md @@ -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。 | **对象创建示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationExtraParams.md b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationExtraParams.md index 14b615cf20e96836c14086d9c79d5565cd1fc8e4..a715bc5e45535e140973fd4f899122e974ea9543 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationExtraParams.md +++ b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationExtraParams.md @@ -15,7 +15,7 @@ | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | deviceType | Array\ | 是 | 是 | 表示设备类型。| -| targetBundle | string | 是 | 是 | 表示目标包名。 | +| targetBundle | string | 是 | 是 | 表示目标Bundle名称。 | | description | string | 是 | 是 | 表示设备过滤的描述。 | | filter | any | 是 | 是 | 表示设备过滤的参数。 | | continuationMode | [ContinuationMode](js-apis-continuation-continuationManager.md#continuationmode) | 是 | 是 | 表示协同的模式。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md index c668a792b21145a26d8ccbbb5dae80a1f82636f3..ba3b1bd98d4d0a430a5e427ff49a29df9ccd6038 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md @@ -34,10 +34,10 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---------- | ---------------------------------------- | ---- | ------------------------------------ | - | bundleName | string | 是 | 指示应用程序的包名。 | - | callback | AsyncCallback<[DeviceManager](#devicemanager)> | 是 | DeviceManager实例创建时调用的回调，返回设备管理器对象实例。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ---------------------------------------------------- | ---- | ----------------------------------------------------------- | +| bundleName | string | 是 | 指示应用程序的Bundle名称。 | +| callback | AsyncCallback<[DeviceManager](#devicemanager)> | 是 | DeviceManager实例创建时调用的回调，返回设备管理器对象实例。 | **错误码：** @@ -638,7 +638,7 @@ publishDeviceDiscovery(publishInfo: PublishInfo): void console.error("publishDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message); } ``` - + ### unPublishDeviceDiscovery9+ unPublishDeviceDiscovery(publishId: number): void diff --git a/zh-cn/application-dev/reference/apis/js-apis-distributed-data.md b/zh-cn/application-dev/reference/apis/js-apis-distributed-data.md index 0d9e28f090c17ff153c65bad60cc278b2f417f89..385a0aa56f3ffbe2e53b49445f1ef59bad60fac9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-distributed-data.md +++ b/zh-cn/application-dev/reference/apis/js-apis-distributed-data.md @@ -37,7 +37,7 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback<KVManager> | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ------ | ------ | -| config | [KVManagerConfig](#kvmanagerconfig) | 是 | 提供KVManager实例的配置信息，包括调用方的包名和用户信息。 | +| config | [KVManagerConfig](#kvmanagerconfig) | 是 | 提供KVManager实例的配置信息，包括调用方的Bundle名称和用户信息。 | | callback | AsyncCallback<[KVManager](#kvmanager)> | 是 | 回调函数。返回创建的KVManager对象实例。 | **示例：** @@ -112,14 +112,14 @@ try { ## KVManagerConfig -提供KVManager实例的配置信息，包括调用方的包名和用户信息。 +提供KVManager实例的配置信息，包括调用方的Bundle名称和用户信息。 **系统能力：** SystemCapability.DistributedDataManager.KVStore.Core | 名称 | 类型 | 必填 | 说明 | | ----- | ------ | ------ | ------ | | userInfo | [UserInfo](#userinfo) | 是 | 调用方的用户信息。 | -| bundleName | string | 是 | 调用方的包名。 | +| bundleName | string | 是 | 调用方的Bundle名称。 | ## UserInfo diff --git a/zh-cn/application-dev/reference/apis/js-apis-freeInstall.md b/zh-cn/application-dev/reference/apis/js-apis-freeInstall.md index 43950b82feebedc9fde5ee77085828ad6bcfd94b..38bb665fbaa007edeabfae89ba27d81173cda37b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-freeInstall.md +++ b/zh-cn/application-dev/reference/apis/js-apis-freeInstall.md @@ -63,7 +63,7 @@ setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: Upg | 参数名 | 类型 | 必填 | 说明 | | ----------- | --------------------------- | ---- | ---------------------------- | -| bundleName | string | 是 | 应用程序包名称。 | +| bundleName | string | 是 | 应用Bundle名称。 | | moduleName | string | 是 | 应用程序模块名称。 | | upgradeFlag | [UpgradeFlag](#upgradeflag) | 是 | 仅供内部系统使用标志位 | | callback | AsyncCallback\ | 是 | 回调函数。当函数调用成功，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\ | 是 | 回调函数。返回true表示可以移除；返回false表示不可移除。 | @@ -214,7 +214,7 @@ isHapModuleRemovable(bundleName: string, moduleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------ | -| 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) | 是 | 指示要查询的应用包标志。| **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md index be9ed68779a7f88e1d9bcb7111e06587c034d791..b0bea630d59c478157e97fc0f93aa59de9f01727 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-want.md @@ -1,6 +1,6 @@ # 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。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStateData.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStateData.md index eba70773f6a3c727192a366f6a85c2f224fc9fd3..94e7fb47420c00a713ea8c8ba7200af9449ec7dd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStateData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStateData.md @@ -7,10 +7,10 @@ | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------- | ---------| ---- | ---- | ------------------------- | | pid8+ | number | 是 | 否 | 进程ID。 | -| bundleName8+ | string | 是 | 否 | 应用包名。 | +| bundleName8+ | string | 是 | 否 | 应用Bundle名称。 | | abilityName8+ | string | 是 | 否 | Ability名称。 | | uid8+ | number | 是 | 否 | 用户ID。 | | state8+ | number | 是 | 否 | Ability状态。 | -| moduleName9+ | string | 是 | 否 | Ability所属的HAP包的名称。 | +| moduleName9+ | string | 是 | 否 | Ability所属的HAP的名称。 | | abilityType8+ | string | 是 | 否 | Ability类型：页面或服务等。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md index 6117ebdb4fc41e9f8a2e334c94e96a7bd090b6c0..3c2aa81352a868d340d34e67f6f70dc97b893f1e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md @@ -8,7 +8,7 @@ | 名称 | 类型 | 必填 | 说明 | | ------------------------- | ------ | ---- | --------- | -| bundleName8+ | string | 否 | 包名。 | +| bundleName8+ | string | 否 | Bundle名称。 | | uid8+ | number | 否 | 应用程序的uid。 | | state8+ | number | 否 | 应用状态。
0：初始化状态，应用正在初始化
1：就绪状态，应用已初始化完毕
2：前台状态，应用位于前台
3：获焦状态。（预留状态，当前暂不支持）
4：后台状态，应用位于后台
5：退出状态，应用已退出 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md index d49747bbd53414c1246ae90cd652f6f1a1d254a7..eadb6087fe22dda7c1d04469a5db38daac207b84 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md @@ -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 | 是 | 模块名。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md index 67c5ea0ea220addb82b5756641f331731a78bacd..de30f7ae379fd758d19c11e02d38c1587afd5b6a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processData.md @@ -9,7 +9,7 @@ | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------- | ---------| ---- | ---- | ------------------------- | | pid8+ | number | 是 | 否 | 进程ID。 | -| bundleName8+ | string | 是 | 否 | 应用包名。 | +| bundleName8+ | string | 是 | 否 | Bundle名称。 | | uid8+ | number | 是 | 否 | 用户ID。 | | isContinuousTask9+ | boolean | 是 | 否 | 判断过程是否为连续任务。 | | isKeepAlive9+ | boolean | 是 | 否 | 判断该过程是否保持活跃。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md index fc37e715b753b0dbf862f67057ff053795cc7098..92eaef536c9f8e696ff097a5884539a4e344ccf3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInfo.md @@ -15,7 +15,7 @@ | pid | number | 是 | 否 | 进程ID。 | | uid | number | 是 | 否 | 用户ID。 | | processName | string | 是 | 否 | 进程名称。 | -| bundleNames | Array<string> | 是 | 否 | 进程中所有运行的包名称。 | +| bundleNames | Array<string> | 是 | 否 | 进程中所有运行的Bundle名称。 | ## 使用说明 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md index 6369bace76dc55fb55bdb32546eadb70a0a58f91..15f69daae2ec2fad6279a4312952f1181fa1e66d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-processRunningInformation.md @@ -27,4 +27,4 @@ appManager.getProcessRunningInformation((error, data) => { | pid | number | 是 | 否 | 进程ID。 | | uid | number | 是 | 否 | 用户ID。 | | processName | string | 是 | 否 | 进程名称。 | -| bundleNames | Array<string> | 是 | 否 | 进程中所有运行的包名称。 | +| bundleNames | Array<string> | 是 | 否 | 进程中所有运行的Bundle名称。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md index 85861abfda9517597aba145bed6686b1c049e841..6093db18b6c3155bbed540f2649dde823162bf16 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md @@ -38,7 +38,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如ability名称，包名等。 | +| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。 | | callback | AsyncCallback<void> | 否 | 回调函数，返回接口调用是否成功的结果。 | **错误码：** @@ -105,7 +105,7 @@ startAbility(want: Want, options?: StartOptions): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| 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类型的回调函数，返回服务连接成功、断开或连接失败后的信息。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md index 70b4bfef685058a4ddfae58082bb60a17f3a3b80..6397099e815327383b0ab1a62903a59277eb7f25 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md @@ -14,7 +14,7 @@ UIAbilityContext是[UIAbility](js-apis-app-ability-uiAbility.md)的上下文环 | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | abilityInfo | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是 | 否 | UIAbility的相关信息。 | -| currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前HAP包的信息。 | +| currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前HAP的信息。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 与UIAbility相关的配置信息，如语言、颜色模式等。 | > **关于示例代码的说明：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-installer.md b/zh-cn/application-dev/reference/apis/js-apis-installer.md index 21f6661377d5a192e8ab444f7e883797cd2db7ee..6ff03076c5db03c4e37fdfce443f7d4a9fa5740c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-installer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-installer.md @@ -99,7 +99,7 @@ install(hapFilePaths: Array<string>, installParam: InstallParam, callback: | 参数名 | 类型 | 必填 | 说明 | | --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | -| hapFilePaths | Array<string> | 是 | 存储应用程序包的路径。路径应该是当前应用程序中存放HAP包的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP包，且这些HAP包的签名需要保持一致。 | +| hapFilePaths | Array<string> | 是 | 存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。 | | installParam | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 | | callback | AsyncCallback<void> | 是 | 回调函数，安装应用成功，err为undefined，否则为错误对象。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md index 08b8e4a38a70eb211328bf6570ecfd45165fad83..be132d3f887219bb55d89c63cbd09be6f7b42d59 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-launcherBundleManager.md @@ -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 { // success @@ -103,8 +103,8 @@ try { data1: 'message', data2: { data3: [123, 456, 789] - }, - }, + } + } }, (err) => { if (err) { console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); @@ -157,8 +157,8 @@ try { data1: 'message', data2: { data3: [123, 456, 789] - }, - }, + } + } }, router.RouterMode.Standard) .then(() => { // success @@ -207,8 +207,8 @@ try { data1: 'message', data2: { data3: [123, 456, 789] - }, - }, + } + } }, router.RouterMode.Standard, (err) => { if (err) { console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); @@ -257,8 +257,8 @@ try { router.replaceUrl({ url: 'pages/detail', params: { - data1: 'message', - }, + data1: 'message' + } }) .then(() => { // success @@ -302,8 +302,8 @@ try { router.replaceUrl({ url: 'pages/detail', params: { - data1: 'message', - }, + data1: 'message' + } }, (err) => { if (err) { console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); @@ -354,8 +354,8 @@ try { router.replaceUrl({ url: 'pages/detail', params: { - data1: 'message', - }, + data1: 'message' + } }, router.RouterMode.Standard) .then(() => { // success @@ -400,8 +400,8 @@ try { router.replaceUrl({ url: 'pages/detail', params: { - data1: 'message', - }, + data1: 'message' + } }, router.RouterMode.Standard, (err) => { if (err) { console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); @@ -465,7 +465,7 @@ getLength(): string **示例：** ```js -var size = router.getLength(); +let size = router.getLength(); console.log('pages stack size = ' + size); ``` @@ -486,7 +486,7 @@ getState(): RouterState **示例：** ```js -var page = router.getState(); +let page = router.getState(); console.log('current index = ' + page.index); console.log('current name = ' + page.name); console.log('current path = ' + page.path); @@ -618,8 +618,8 @@ export default { router.push({ url: 'pages/detail/detail', params: { - data1: 'message', - }, + data1: 'message' + } }); } } @@ -649,7 +649,7 @@ struct Index { text: '这是第一页的值', data: { array: [12, 45, 78] - }, + } } } try { @@ -741,8 +741,8 @@ router.push({ data1: 'message', data2: { data3: [123, 456, 789] - }, - }, + } + } }); ``` ## router.push(deprecated) @@ -772,8 +772,8 @@ router.push({ data1: 'message', data2: { data3: [123, 456, 789] - }, - }, + } + } },router.RouterMode.Standard); ``` @@ -799,8 +799,8 @@ replace(options: RouterOptions): void router.replace({ url: 'pages/detail', params: { - data1: 'message', - }, + data1: 'message' + } }); ``` @@ -827,8 +827,8 @@ replace(options: RouterOptions, mode: RouterMode): void router.replace({ url: 'pages/detail/detail', params: { - data1: 'message', - }, + data1: 'message' + } }, router.RouterMode.Standard); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-package.md b/zh-cn/application-dev/reference/apis/js-apis-system-package.md index 45389b3307208a433dc7f1a9ba00cad35456a000..d5723d98d044a465a2c02c8cd67eb05bb632a42f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-package.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-package.md @@ -77,7 +77,7 @@ export default { | 名称 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 是 | 应用包名。 | +| bundleName | string | 是 | 应用Bundle名称。 | | success | Function | 否 | 接口调用成功的回调函数。 | | fail | Function | 否 | 接口调用失败的回调函数。 | | complete | Function | 否 | 接口调用结束的回调函数。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md index 53e174701707ee071cad97c77062c1ddc4282ba6..ad9dc69baca1dbaad80bd3d73d7b5ce067d9cc7b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md @@ -63,7 +63,12 @@ getColorsSync(wallpaperType: WallpaperType): Array<RgbaColor> **示例**： ```js -let colors = wallpaper.getColorsSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); +try { + let colors = wallpaper.getColorsSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); + console.log(`success to getColorsSync: ${JSON.stringify(colors)}`); +} catch (error) { + console.error(`failed to getColorsSync because: ${JSON.stringify(error)}`); +} ``` ## wallpaper.getIdSync9+ @@ -89,7 +94,12 @@ getIdSync(wallpaperType: WallpaperType): number **示例**： ```js -let id = wallpaper.getIdSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); +try { + let id = wallpaper.getIdSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); + console.log(`success to getIdSync: ${JSON.stringify(id)}`); +} catch (error) { + console.error(`failed to getIdSync because: ${JSON.stringify(error)}`); +} ``` ## wallpaper.getMinHeightSync9+ @@ -365,7 +375,12 @@ getFileSync(wallpaperType: WallpaperType): number; **示例：** ```js -let file = wallpaper.getFileSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); +try { + let file = wallpaper.getFileSync(wallpaper.WallpaperType.WALLPAPER_SYSTEM); + console.log(`success to getFileSync: ${JSON.stringify(file)}`); +} catch (error) { + console.error(`failed to getFileSync because: ${JSON.stringify(error)}`); +} ``` ## wallpaper.getImage9+ @@ -452,10 +467,14 @@ on(type: 'colorChange', callback: (colors: Array<RgbaColor>, wallpaperType **示例：** ```js -let listener = (colors, wallpaperType) => { - console.log(`wallpaper color changed.`); -}; -wallpaper.on('colorChange', listener); +try { + let listener = (colors, wallpaperType) => { + console.log(`wallpaper color changed.`); + }; + wallpaper.on('colorChange', listener); +} catch (error) { + console.error(`failed to on because: ${JSON.stringify(error)}`); +} ``` ## wallpaper.off('colorChange')9+ @@ -479,11 +498,25 @@ off(type: 'colorChange', callback?: (colors: Array<RgbaColor>, wallpaperTy let listener = (colors, wallpaperType) => { console.log(`wallpaper color changed.`); }; -wallpaper.on('colorChange', listener); -// 取消订阅listener -wallpaper.off('colorChange', listener); -// 取消所有'colorChange'类型的订阅 -wallpaper.off('colorChange'); +try { + wallpaper.on('colorChange', listener); +} catch (error) { + console.error(`failed to on because: ${JSON.stringify(error)}`); +} + +try { + // 取消订阅listener + wallpaper.off('colorChange', listener); +} catch (error) { + console.error(`failed to off because: ${JSON.stringify(error)}`); +} + +try { + // 取消所有'colorChange'类型的订阅 + wallpaper.off('colorChange'); +} catch (error) { + console.error(`failed to off because: ${JSON.stringify(error)}`); +} ``` ## wallpaper.getColors(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md index 7026ace598effba73af71e941860dd46f0964bda..7a67ad66eb81f3aca814479cbe1c3d2482f06295 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md @@ -134,7 +134,7 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => { getBundleName(agent: WantAgent, callback: AsyncCallback\): void -获取WantAgent实例的包名（callback形式）。 +获取WantAgent实例的Bundle名称（callback形式）。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -206,7 +206,7 @@ WantAgent.getBundleName(wantAgent, getBundleNameCallback) getBundleName(agent: WantAgent): Promise\ -获取WantAgent实例的包名（Promise形式）。 +获取WantAgent实例的Bundle名称（Promise形式）。 **系统能力**：SystemCapability.Ability.AbilityRuntime.Core @@ -218,9 +218,9 @@ getBundleName(agent: WantAgent): Promise\ **返回值：** -| 类型 | 说明 | -| ----------------------------------------------------------- | ------------------------------------------------------------ | -| Promise\ | 以Promise形式返回获取WantAgent实例的包名。 | +| 类型 | 说明 | +| ----------------- | ------------------------------------------------ | +| Promise\ | 以Promise形式返回获取WantAgent实例的Bundle名称。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-window.md b/zh-cn/application-dev/reference/apis/js-apis-window.md index 05548fba0405541c2986c97719a0a3fae90e3284..6fb39162efe913ac2f65843264619acd47f5838e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-window.md +++ b/zh-cn/application-dev/reference/apis/js-apis-window.md @@ -248,7 +248,7 @@ import window from '@ohos.window'; | 名称 | 值 | 说明 | | ---------- | ------ | -------------- | -| DEFAULT | 0 | 默认色域模式。 | +| DEFAULT | 0 | 默认SRGB色域模式。 | | WIDE_GAMUT | 1 | 广色域模式。 | ## ScaleOptions9+ @@ -1548,6 +1548,8 @@ moveWindowTo(x: number, y: number, callback: AsyncCallback<void>): void 移动窗口位置，使用callback异步回调。 +全屏模式窗口不支持该操作。 + **系统能力：** SystemCapability.WindowManager.WindowManager.Core **参数：** @@ -1589,6 +1591,8 @@ moveWindowTo(x: number, y: number): Promise<void> 移动窗口位置，使用Promise异步回调。 +全屏模式窗口不支持该操作。 + **系统能力：** SystemCapability.WindowManager.WindowManager.Core **参数：** @@ -1640,6 +1644,8 @@ resize(width: number, height: number, callback: AsyncCallback<void>): void 设置的宽度与高度受到此约束限制。 +全屏模式窗口不支持该操作。 + **系统能力：** SystemCapability.WindowManager.WindowManager.Core **参数：** @@ -1687,6 +1693,8 @@ resize(width: number, height: number): Promise<void> 设置的宽度与高度受到此约束限制。 +全屏模式窗口不支持该操作。 + **系统能力：** SystemCapability.WindowManager.WindowManager.Core **参数：** @@ -4314,6 +4322,8 @@ moveTo(x: number, y: number, callback: AsyncCallback<void>): void 移动窗口位置，使用callback异步回调。 +全屏模式窗口不支持该操作。 + > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，推荐使用[moveWindowTo()](#movewindowto9)。 @@ -4346,6 +4356,8 @@ moveTo(x: number, y: number): Promise<void> 移动窗口位置，使用Promise异步回调。 +全屏模式窗口不支持该操作。 + > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，推荐使用[moveWindowTo()](#movewindowto9-1)。 @@ -4388,6 +4400,8 @@ resetSize(width: number, height: number, callback: AsyncCallback<void>): v 设置的宽度与高度受到此约束限制。 +全屏模式窗口不支持该操作。 + > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，推荐使用[resize()](#resize9)。 @@ -4426,6 +4440,8 @@ resetSize(width: number, height: number): Promise<void> 设置的宽度与高度受到此约束限制。 +全屏模式窗口不支持该操作。 + > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，推荐使用[resize()](#resize9-1)。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md index 2dab45e8523430be89c0723ba7e7dff2b38352e4..36064dceb6c9c2435cd52f880fa8a7823dd9952a 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md @@ -31,15 +31,15 @@ path: string, container: object, render: string, loop: boolean, autoplay: boolea **参数：** -| 参数 | 类型 | 必填 | 描述 | -| -------------- | --------------------------- | ---- | ---------------------------------------- | -| path | string | 是 | hap包内动画资源文件路径，仅支持json格式。示例：path: "common/lottie/data.json" | -| container | object | 是 | canvas绘图上下文，声明范式需提前声明CanvasRenderingContext2D。 | -| render | string | 是 | 渲染类型，仅支持“canvas”。 | -| loop | boolean \| number | 否 | 动画播放结束后，是否循环播放，默认值true。值类型为number，且大于等于1时为设置的重复播放的次数。 | -| autoplay | boolean | 否 | 是否自动播放动画，默认值true。 | -| name | string | 否 | 开发者自定义的动画名称，后续支持通过该名称引用控制动画，默认为空。 | -| initialSegment | [number, number] | 否 | 指定动画播放的起始帧号，指定动画播放的结束帧号。 | +| 参数 | 类型 | 必填 | 描述 | +| -------------- | --------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | HAP内动画资源文件路径，仅支持json格式。示例：path: "common/lottie/data.json" | +| container | object | 是 | canvas绘图上下文，声明范式需提前声明CanvasRenderingContext2D。 | +| render | string | 是 | 渲染类型，仅支持“canvas”。 | +| loop | boolean \| number | 否 | 动画播放结束后，是否循环播放，默认值true。值类型为number，且大于等于1时为设置的重复播放的次数。 | +| autoplay | boolean | 否 | 是否自动播放动画，默认值true。 | +| name | string | 否 | 开发者自定义的动画名称，后续支持通过该名称引用控制动画，默认为空。 | +| initialSegment | [number, number] | 否 | 指定动画播放的起始帧号，指定动画播放的结束帧号。 | ## lottie.destroy diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md index 47ff618136fd82249f3f687ca5e9f64f201599fd..fe33e7e9bd2a464ec43fd9a138c9b5a2320583d6 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md @@ -58,16 +58,16 @@ struct PositionExample1 { .direction(Direction.Ltr) // 父容器设置direction为Direction.Rtl，子元素从右到左排列 Row() { - Text('1').height(50).width('25%').fontSize(16).backgroundColor(0xF5DEB3) - Text('2').height(50).width('25%').fontSize(16).backgroundColor(0xD2B48C) - Text('3').height(50).width('25%').fontSize(16).backgroundColor(0xF5DEB3) - Text('4').height(50).width('25%').fontSize(16).backgroundColor(0xD2B48C) + Text('1').height(50).width('25%').fontSize(16).backgroundColor(0xF5DEB3).textAlign(TextAlign.End) + Text('2').height(50).width('25%').fontSize(16).backgroundColor(0xD2B48C).textAlign(TextAlign.End) + Text('3').height(50).width('25%').fontSize(16).backgroundColor(0xF5DEB3).textAlign(TextAlign.End) + Text('4').height(50).width('25%').fontSize(16).backgroundColor(0xD2B48C).textAlign(TextAlign.End) } .width('90%') .direction(Direction.Rtl) } } - .width('100%').margin({ top: 5 }).direction(Direction.Rtl) + .width('100%').margin({ top: 5 }) } } ``` diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-ability.md b/zh-cn/application-dev/reference/errorcodes/errorcode-ability.md index d5aa62b58c0c5d3a97e72f9d9e0cc82afb15a30f..cc739e400bfe01b6300e9b15cb9a1d8a9acea75b 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-ability.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-ability.md @@ -16,8 +16,8 @@ Input error. The specified ability name does not exist. **处理步骤** -1. 检查包名称是否正确。 -2. 检查包名对应的Ability是否正确。 +1. 检查Bundle名称是否正确。 +2. 检查Bundle名称对应的Ability是否正确。 ## 16000002 接口调用Ability类型错误 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-bundle.md b/zh-cn/application-dev/reference/errorcodes/errorcode-bundle.md index 5059b68b1deb6a7c0a5b465cba8b4541c6e6a8f0..9e79f06c6c46eb7a31844efd4516e8f9c533b32e 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-bundle.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-bundle.md @@ -116,12 +116,12 @@ The specified device ID is not found. Failed to install the HAP because the HAP fails to be parsed. **错误描述**
-调用installer模块中的install接口时，传入的HAP包解析失败。 +调用installer模块中的install接口时，传入的HAP解析失败。 **可能原因**
-1. hap包的格式不是zip格式。 -2. hap包的配置文件不满足json格式。 -3. hap包的配置文件缺少必要的字段。 +1. HAP的格式不是zip格式。 +2. HAP的配置文件不满足json格式。 +3. HAP的配置文件缺少必要的字段。 **处理步骤**
1. 确认hap的格式是zip。 @@ -138,9 +138,9 @@ Failed to install the HAP because the HAP signature fails to be verified. **可能原因**
-1. hap包没有签名。 +1. HAP没有签名。 2. hap签名信息来源不可靠。 -3. 升级的hap包与已安装的hap包签名信息不一致。 +3. 升级的HAP与已安装的HAP签名信息不一致。 4. 多个hap的签名信息不一致。 **处理步骤**
@@ -157,28 +157,28 @@ Failed to install the HAP because the HAP path is invalid or the HAP is too larg 调用installer模块中的install接口时，安装包路径无效或者文件过大导致应用安装失败。 **可能原因**
-1. 输入错误，hap包的文件路径不存在。 -2. hap包的路径无法访问。 -3. hap包的大小超过最大限制4G。 +1. 输入错误，HAP的文件路径不存在。 +2. HAP的路径无法访问。 +3. HAP的大小超过最大限制4G。 **处理步骤**
1. 确认hap是否存在。 2. 查看hap的可执行权限，是否可读。 -3. 查看hap包的大小是否超过4G。 +3. 查看HAP的大小是否超过4G。 -## 17700015 多个hap包配置信息不同导致应用安装失败 +## 17700015 多个HAP配置信息不同导致应用安装失败 **错误信息**
Failed to install the HAPs because they have different configuration information. **错误描述**
-调用installer模块中的install接口时，多个hap包配置信息不同导致应用安装失败。 +调用installer模块中的install接口时，多个HAP配置信息不同导致应用安装失败。 **可能原因**
-多个hap包中配置文件app下面的字段不一致。 +多个HAP中配置文件app下面的字段不一致。 **处理步骤**
-确认多个hap包中配置文件app下面的字段是否一致。 +确认多个HAP中配置文件app下面的字段是否一致。 ## 17700016 系统磁盘空间不足导致应用安装失败 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-distributedKVStore.md b/zh-cn/application-dev/reference/errorcodes/errorcode-distributedKVStore.md index 381d687e85d54dec77c865096f180217a1f80419..ad8fb47ea9149b0bf14fd1907c681f4b1a76a613 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-distributedKVStore.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-distributedKVStore.md @@ -66,20 +66,20 @@ Not found. **错误描述** -该错误码表示在调用数据库deleteKVStore、delete、deleteBatch、get等接口时，未找到相关数据。 +该错误码表示在调用数据库deleteKVStore、sync、get等接口时，未找到相关数据。 **可能原因** 在调用删除数据库、数据查询、数据删除等接口时未找到相关数据，可能原因如下。 1. 删除数据库操作时，数据库不存在或已删除。 2. 数据库数据查询操作时，相关数据不存在或已删除。 -3. 数据库数据删除操作时，相关数据不存在或已删除。 +3. 数据库数据同步操作时，数据库不存在或已删除。 **处理步骤** 1. 在删除数据库操作前，请检查数据库名称是否正确或是否重复删除。 2. 在数据库数据查询操作前，请检查查询关键字是否正确。 -3. 在数据库数据删除操作前，请检查删除关键字是否正确或是否重复删除。 +3. 在数据库数据同步操作前，请检查相关数据库是否已经删除。 ## 15100005 数据库或查询结果集已关闭 diff --git a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md index aab1b2529434e24ee563ef399aaee74526af422c..3cafcb4415cdd3b4ab806b077fc6e4537489da7d 100644 --- a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md +++ b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-hml.md @@ -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)接口接收相关参数。 - 消息事件格式 diff --git a/zh-cn/application-dev/reference/native-apis/_raw_file_descriptor.md b/zh-cn/application-dev/reference/native-apis/_raw_file_descriptor.md index e72c69ef55b51c2ef152473ac894b27c473c75e0..3364447f8b1375f3e6b739d2ba623bfee77eb462 100644 --- a/zh-cn/application-dev/reference/native-apis/_raw_file_descriptor.md +++ b/zh-cn/application-dev/reference/native-apis/_raw_file_descriptor.md @@ -5,7 +5,7 @@ 提供rawfile文件描述符信息。 -RawFileDescriptor是[OH_ResourceManager_GetRawFileDescriptor()](rawfile.md#oh_resourcemanager_getrawfiledescriptor)的输出参数，涵盖了rawfile文件的文件描述符以及在HAP包中的起始位置和长度。 +RawFileDescriptor是[OH_ResourceManager_GetRawFileDescriptor()](rawfile.md#oh_resourcemanager_getrawfiledescriptor)的输出参数，涵盖了rawfile文件的文件描述符以及在HAP中的起始位置和长度。 **自从：** @@ -21,11 +21,11 @@ RawFileDescriptor是[OH_ResourceManager_GetRawFileDescriptor()](rawfile.md#oh_re ### 成员变量 - | 成员变量名称 | 描述 | +| 成员变量名称 | 描述 | | -------- | -------- | -| [fd](#fd) | rawfile文件描述符 | -| [start](#start) | rawfile在HAP包中的长度 | -| [length](#length) | rawfile在HAP包中的起始位置 | +| [fd](#fd) | rawfile文件描述符 | +| [start](#start) | rawfile在HAP中的长度 | +| [length](#length) | rawfile在HAP中的起始位置 | ## 结构体成员变量说明 @@ -33,7 +33,7 @@ RawFileDescriptor是[OH_ResourceManager_GetRawFileDescriptor()](rawfile.md#oh_re ### fd - + ``` int RawFileDescriptor::fd ``` @@ -45,23 +45,23 @@ rawfile文件描述符 ### length - + ``` long RawFileDescriptor::length ``` **描述：** -rawfile在HAP包中的长度 +rawfile在HAP中的长度 ### start - + ``` long RawFileDescriptor::start ``` **描述：** -rawfile在HAP包中的起始位置 +rawfile在HAP中的起始位置 diff --git a/zh-cn/application-dev/reference/native-apis/rawfile.md b/zh-cn/application-dev/reference/native-apis/rawfile.md index c613f611d50323b5efa35294e960cc3796f88c9e..01f4faf838864e83489a68d56587197b364b9222 100644 --- a/zh-cn/application-dev/reference/native-apis/rawfile.md +++ b/zh-cn/application-dev/reference/native-apis/rawfile.md @@ -215,10 +215,10 @@ bool OH_ResourceManager_GetRawFileDescriptor (const RawFile * rawFile, RawFileDe **参数：** -| Name | 描述 | -| ---------- | -------------------------------- | -| rawFile | 表示指向[RawFile](#rawfile)的指针。 | -| descriptor | 显示rawfile文件描述符，以及在HAP包中的起始位置和长度。 | +| Name | 描述 | +| ---------- | ---------------------------------------------------- | +| rawFile | 表示指向[RawFile](#rawfile)的指针。 | +| descriptor | 显示rawfile文件描述符，以及在HAP中的起始位置和长度。 | **返回：** @@ -482,9 +482,9 @@ bool OH_ResourceManager_ReleaseRawFileDescriptor (const RawFileDescriptor & desc **参数：** -| Name | 描述 | -| ---------- | -------------------------------- | -| descriptor | 包含rawfile文件描述符，以及在HAP包中的起始位置和长度。 | +| Name | 描述 | +| ---------- | ---------------------------------------------------- | +| descriptor | 包含rawfile文件描述符，以及在HAP中的起始位置和长度。 | **返回：** diff --git a/zh-cn/application-dev/security/accesstoken-guidelines.md b/zh-cn/application-dev/security/accesstoken-guidelines.md index d9978837ede7a1dba49d1f35fdd7e33be692a3e7..ba7341ef845e6681a17eb645264a696d1701e08a 100644 --- a/zh-cn/application-dev/security/accesstoken-guidelines.md +++ b/zh-cn/application-dev/security/accesstoken-guidelines.md @@ -212,7 +212,7 @@ ```json [ { - "bundleName": "com.ohos.myapplication", // 包名 + "bundleName": "com.ohos.myapplication", // Bundle名称 "app_signature":[], // 指纹信息 "permissions":[ { diff --git a/zh-cn/application-dev/security/app-provision-structure.md b/zh-cn/application-dev/security/app-provision-structure.md index 542660387d477046f84009bfe31cd54458c22818..2abbb9a52bfbd146f48d1150b273dcb665ee9a56 100644 --- a/zh-cn/application-dev/security/app-provision-structure.md +++ b/zh-cn/application-dev/security/app-provision-structure.md @@ -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可能会调用失败或运行异常。 | 字符串 | 必选 | 不可缺省 | diff --git a/zh-cn/application-dev/security/hapsigntool-overview.md b/zh-cn/application-dev/security/hapsigntool-overview.md index 0b5b41070fbecfe753411a5fe6b333484521fb04..993d56023533862a6121ad98243441669091f3d1 100644 --- a/zh-cn/application-dev/security/hapsigntool-overview.md +++ b/zh-cn/application-dev/security/hapsigntool-overview.md @@ -20,7 +20,7 @@ Hap包签名工具支持本地签名需求的开发，为OpenHarmony应用提供 OpenHarmony采用RFC5280标准构建X509证书信任体系。用于应用签名的OpenHarmony证书共有三级，分为：根CA证书、中间CA证书、最终实体证书，其中最终实体证书分为应用签名证书和profile签名证书。应用签名证书表示应用开发者的身份，可保证系统上安装的应用来源可追溯，profile签名证书实现对profile文件的签名进行验签，保证profile文件的完整性。 - - HAP包： + - HAP： HAP（OpenHarmony Ability Package）是Ability的部署包，OpenHarmony应用代码围绕Ability组件展开，它是由一个或者多个Ability组成。 diff --git a/zh-cn/application-dev/task-management/transient-task-dev-guide.md b/zh-cn/application-dev/task-management/transient-task-dev-guide.md index dd24e2ff224c76436f0a8d0cef3ed60707844d37..3acef00b7632e9bb398141a48dbfb457973505ef 100644 --- a/zh-cn/application-dev/task-management/transient-task-dev-guide.md +++ b/zh-cn/application-dev/task-management/transient-task-dev-guide.md @@ -3,12 +3,14 @@ ## 场景说明 当应用退到后台默认有6到12秒的运行时长，超过该时间后，系统会将应用置为挂起状态。对于绝大多数应用，6到12秒的时间，足够执行一些重要的任务，但如果应用需要更多的时间，可以通过短时任务接口，扩展应用的执行时间。 -建议不要等到应用退后台后，才调用requestSuspendDelay方法申请延迟挂起，而是应该在执行任何的耗时操作前，都应该调用该接口，向系统申明扩展应用的执行时间。 -当应用在前台时，使用requestSuspendDelay方法，不会影响应用的短时任务配额。 -由于每个应用每天的短时任务配额时间有限，当执行完耗时任务后，应当及时取消延迟挂起的申请。 +建议不要等到应用退后台后，才调用[requestSuspendDelay()](../reference/apis/js-apis-resourceschedule-backgroundTaskManager.md#backgroundtaskmanagerrequestsuspenddelay)方法申请延迟挂起，而是应该在执行任何的耗时操作前，都应该调用该接口，向系统申明扩展应用的执行时间。 -一些典型的耗时任务有，需要保存一些状态数据到本地数据库，需要打开和处理一个大型文件，需要同步一些数据到应用的云端服务器等。 +当应用在前台时，使用[requestSuspendDelay()](../reference/apis/js-apis-resourceschedule-backgroundTaskManager.md#backgroundtaskmanagerrequestsuspenddelay)方法，不会影响应用的短时任务配额。 + +根据需要调用[getRemainingDelayTime()](../reference/apis/js-apis-resourceschedule-backgroundTaskManager.md#backgroundtaskmanagergetremainingdelaytimecallback)接口获取应用程序进入挂起状态前的剩余时间。由于每个应用每天的短时任务配额时间有限，当执行完耗时任务后，应当及时调用[cancelSuspendDelay()](../reference/apis/js-apis-resourceschedule-backgroundTaskManager.md#backgroundtaskmanagercancelsuspenddelay)接口取消延迟挂起的申请。 + +一些典型的耗时任务，例如保存一些状态数据到本地数据库、打开和处理一个大型文件、同步一些数据到应用的云端服务器等。 ## 接口说明 @@ -25,7 +27,7 @@ ## 开发步骤 -1、当应用需要开始执行一个耗时的任务时。调用短时任务申请接口，并且在任务执行完后，调用短时任务取消接口。 +当应用需要开始执行一个耗时的任务时。调用短时任务申请接口，并且在任务执行完后，调用短时任务取消接口。 ```js import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; diff --git a/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md index 1b454be58cf699e69e0d5909913c416045c7e772..87bc72823acf2dccecfeab599872541e1495dc9b 100644 --- a/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md +++ b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md @@ -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 | 是否充电 diff --git a/zh-cn/application-dev/tools/anm-tool.md b/zh-cn/application-dev/tools/anm-tool.md index f91ad97ae854237ac5ec4afbae827f62a23494d3..13c100f8c51d7b7a787102e986ec78da34149c33 100644 --- a/zh-cn/application-dev/tools/anm-tool.md +++ b/zh-cn/application-dev/tools/anm-tool.md @@ -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 | 帮助信息 | * **示例**：打印活跃的通知信息 diff --git a/zh-cn/application-dev/tools/bm-tool.md b/zh-cn/application-dev/tools/bm-tool.md index 6b7fade3819c991b669bb5b3d183f208cdbee0c0..bd45b86df9b7723fbc4d78a4190d0d73f15f1f90 100644 --- a/zh-cn/application-dev/tools/bm-tool.md +++ b/zh-cn/application-dev/tools/bm-tool.md @@ -48,10 +48,10 @@ bm install [-h] [-p path] [-u userId] [-r] [-w waitting-time] | 命令 | 是否必选 | 描述 | | -------- | -------- | -------- | | -h | 否，默认输出帮助信息 | 显示install支持的命令信息 | -| -p | 是 | 安装HAP包路径，支持指定路径和多个HAP同时安装 | -| -u | 否，默认安装到当前所有用户上 | 给指定用户安装一个HAP包 | -| -r | 否，默认值为覆盖安装 | 覆盖安装一个HAP包 | -| -w | 否，默认等待5s | 安装HAP包时指定bm工具等待时间，最小的等待时长为5s，最大的等待时长为600s, 默认缺省为5s | +| -p | 是 | 安装HAP路径，支持指定路径和多个HAP同时安装 | +| -u | 否，默认安装到当前所有用户上 | 给指定用户安装一个HAP | +| -r | 否，默认值为覆盖安装 | 覆盖安装一个HAP | +| -w | 否，默认等待5s | 安装HAP时指定bm工具等待时间，最小的等待时长为5s，最大的等待时长为600s, 默认缺省为5s | 示例： @@ -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 -n | 清除指定包名的缓存数据 | -| -d -n | 清除指定包名的数据目录 | -| -u | 清除指定用户下包名的缓存数据 | +| -c -n | 清除指定Bundle名称的缓存数据 | +| -d -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名称下的应用 | 示例： diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-container.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-container.md new file mode 100644 index 0000000000000000000000000000000000000000..23f4ce5addb9e28937c2ca0033159fd160515eaf --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-container.md @@ -0,0 +1,23 @@ +# commonlibrary子系统JS API变更Changelog + +OpenHarmony 3.2.10.1(Mr)版本相较于OpenHarmony 3.2.beta4版本，container子系统的API变更如下 + +## cl.commonlibrary.1 错误码及信息变更 +commonlibrary子系统中ArrayList、List、LinkedList、Stack、Queue、Deque、PlainArray、LightWeightMap、LightWeightSet、HashMap、HashSet、TreeMap、TreeSet类的接口抛出的错误码及信息变更： + +变更后的错误码详细介绍请参见[语言基础类库错误码](../../../application-dev/reference/errorcodes/errorcode-utils.md)。 + +已使用相关接口开发的应用无需重新适配。 + +**关键的接口/组件变更** +各个类中的接口重新定义了错误码抛出的信息，并在对应模块的`*.d.ts`声明文件中通过'@throws'标签进行标示。 +示例如下： +ArrayList类变更前： +constructor(); +ArrayList类变更后： +@throws { BusinessError } 10200012 - The ArrayList's constructor cannot be directly invoked. +constructor(); + +**变更影响** + +暂无影响。 diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.1/changelogs-account_os_account.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.1/changelogs-account_os_account.md index 1f4cd0b795b68596745ce9230485531e39c17c2d..bf26a15f894d6fd568f51a3fcaf6a269d33ad999 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.1/changelogs-account_os_account.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.1.1/changelogs-account_os_account.md @@ -13,7 +13,7 @@ **关键接口/组件变更** 变更前： - - 昵称长度限制为20个字符，头像大小限制为2M + - 昵称长度限制为20个字符，头像大小限制为3M 变更后： - 昵称长度限制为1024个字符，头像大小限制为10M