From b34421084ced0d61255d10196624137586ca9127 Mon Sep 17 00:00:00 2001 From: zyjhandsome Date: Tue, 17 Jan 2023 23:49:59 +0800 Subject: [PATCH] =?UTF-8?q?=E7=9B=B8=E5=85=B3=E5=BE=85=E5=81=9C=E7=94=A8?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E6=9B=BF=E6=8D=A2=E4=B8=BA=E6=96=B0=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zyjhandsome --- .../ability-deprecated/ability-delegator.md | 6 +- .../ability-deprecated/context-userguide.md | 2 +- .../ability-deprecated/fa-formability.md | 6 +- .../stage-ability-continuation.md | 2 +- .../ability-deprecated/stage-ability.md | 13 +- .../ability-deprecated/stage-formextension.md | 8 +- .../stage-serviceextension.md | 8 +- .../ability-deprecated/wantagent.md | 2 +- .../application-test/arkxtest-guidelines.md | 4 +- .../device/location-guidelines.md | 12 +- .../dfx/apprecovery-guidelines.md | 6 +- .../dfx/errormanager-guidelines.md | 2 +- .../faqs/faqs-event-notification.md | 2 +- .../key-features/multi-device-app-dev/faq.md | 2 +- .../media/avsession-guidelines.md | 4 +- .../quick-start/full-sdk-switch-guide.md | 4 +- .../apis/js-apis-ability-particleAbility.md | 4 +- .../apis/js-apis-app-ability-configuration.md | 44 ++--- .../apis/js-apis-app-form-formProvider.md | 6 +- .../apis/js-apis-application-ability.md | 29 ++- ...is-application-abilityDelegatorRegistry.md | 2 +- ...is-application-abilityLifecycleCallback.md | 2 +- .../js-apis-application-abilityManager.md | 8 +- .../apis/js-apis-application-appManager.md | 2 +- .../apis/js-apis-application-configuration.md | 1 - .../apis/js-apis-application-errorManager.md | 8 +- .../js-apis-application-formBindingData.md | 2 +- .../apis/js-apis-application-formProvider.md | 2 +- .../reference/apis/js-apis-avsession.md | 8 +- .../apis/js-apis-backgroundTaskManager.md | 8 +- .../apis/js-apis-geoLocationManager.md | 4 +- .../reference/apis/js-apis-geolocation.md | 4 +- ...apis-inner-application-abilityDelegator.md | 186 +++++++----------- ...-inner-application-abilityDelegatorArgs.md | 2 +- ...s-apis-inner-application-abilityMonitor.md | 3 +- ...is-inner-application-abilityRunningInfo.md | 3 +- ...s-inner-application-abilityStageContext.md | 3 +- ...s-inner-application-abilityStageMonitor.md | 2 +- ...er-application-applicationStateObserver.md | 2 +- ...apis-inner-application-extensionContext.md | 5 +- .../js-apis-inner-application-processData.md | 2 +- ...is-inner-application-processRunningInfo.md | 2 +- ...s-apis-inner-application-shellCmdResult.md | 2 +- ...-resourceschedule-backgroundTaskManager.md | 4 +- .../apis/js-apis-system-notification.md | 2 +- .../arkui-ts/ts-basic-components-image.md | 6 +- .../continuous-task-dev-guide.md | 6 +- zh-cn/application-dev/ui/arkui-overview.md | 13 +- .../windowmanager/application-window-stage.md | 2 +- .../windowmanager/system-window-stage.md | 2 +- 50 files changed, 208 insertions(+), 256 deletions(-) diff --git a/zh-cn/application-dev/ability-deprecated/ability-delegator.md b/zh-cn/application-dev/ability-deprecated/ability-delegator.md index d96a2db2a8..81a2ed58b7 100644 --- a/zh-cn/application-dev/ability-deprecated/ability-delegator.md +++ b/zh-cn/application-dev/ability-deprecated/ability-delegator.md @@ -63,7 +63,7 @@ AbilityMonitor是测试框架提供用来绑定并监听Ability类。开发者 **示例** ```javascript -import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); @@ -87,11 +87,11 @@ AbilityDelegator是测试框架主要功能类，提供了启动Ability、获取 **导入模块** ```javascript -import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; ``` ```javascript -var abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator() +var abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); ``` ### 启动Ability并监听Ability状态变化 diff --git a/zh-cn/application-dev/ability-deprecated/context-userguide.md b/zh-cn/application-dev/ability-deprecated/context-userguide.md index 52303aa9e4..d0f51a6da8 100644 --- a/zh-cn/application-dev/ability-deprecated/context-userguide.md +++ b/zh-cn/application-dev/ability-deprecated/context-userguide.md @@ -283,7 +283,7 @@ export default class EntryAbility extends UIAbility { ```ts // pages/index.ets -import context from '@ohos.application.context' +import context from '@ohos.app.ability.context' type Context = context.Context diff --git a/zh-cn/application-dev/ability-deprecated/fa-formability.md b/zh-cn/application-dev/ability-deprecated/fa-formability.md index aa9ed56854..68a4773419 100644 --- a/zh-cn/application-dev/ability-deprecated/fa-formability.md +++ b/zh-cn/application-dev/ability-deprecated/fa-formability.md @@ -62,9 +62,9 @@ FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-applic 1. 导入相关模块。 ```javascript - import formBindingData from '@ohos.application.formBindingData' - import formInfo from '@ohos.application.formInfo' - import formProvider from '@ohos.application.formProvider' + import formBindingData from '@ohos.app.form.formBindingData'; + import formInfo from '@ohos.app.form.formInfo'; + import formProvider from '@ohos.app.form.formProvider'; ``` 2. 实现LifecycleForm生命周期接口。 diff --git a/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md b/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md index 456df51507..ff0ef98bb4 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md +++ b/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md @@ -148,7 +148,7 @@ ```javascript import UIAbility from '@ohos.app.ability.UIAbility'; - import AbilityConstant from '@ohos.application.AbilityConstant'; + import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ``` 要实现迁移，此接口必须实现并返回AGREE，否则默认为拒绝迁移。 diff --git a/zh-cn/application-dev/ability-deprecated/stage-ability.md b/zh-cn/application-dev/ability-deprecated/stage-ability.md index d3c241ee0a..9d46fe8468 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-ability.md +++ b/zh-cn/application-dev/ability-deprecated/stage-ability.md @@ -56,8 +56,8 @@ Ability功能如下（Ability类，具体的API详见[接口文档](../reference ### 实现AbilityStage及Ability生命周期 创建Stage模型的Page Ability应用，需实现AbilityStage接口及Ability生命周期接口，并使用窗口提供的方法设置页面。具体示例代码如下： 1. 导入AbilityStage模块。 - ``` - import AbilityStage from "@ohos.application.AbilityStage" + ```ts + import AbilityStage from "@ohos.app.ability.AbilityStage"; ``` 2. 实现AbilityStage接口，接口生成的默认相对路径：entry\src\main\ets\Application\AbilityStage.ts。 ```ts @@ -113,7 +113,8 @@ AbilityStage类及Ability类均拥有context属性，应用可以通过`this.con 如下示例展示了AbilityStage通过context属性获取包代码路径、HAP名称、Ability名称以及系统语言的方法。具体示例代码如下： ```ts -import AbilityStage from "@ohos.application.AbilityStage" +import AbilityStage from "@ohos.app.ability.AbilityStage"; + export default class MyAbilityStage extends AbilityStage { onCreate() { console.log("MyAbilityStage onCreate") @@ -156,8 +157,8 @@ export default class EntryAbility extends UIAbility { 如下示例展示了AbilityStage的`onConfigurationUpdated`回调实现，系统语言和颜色模式发生变化时触发该回调。具体示例代码如下： ```ts -import AbilityStage from '@ohos.application.AbilityStage' -import ConfigurationConstant from '@ohos.application.ConfigurationConstant' +import AbilityStage from '@ohos.app.ability.AbilityStage'; +import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; export default class MyAbilityStage extends AbilityStage { onConfigurationUpdated(config) { @@ -171,7 +172,7 @@ export default class MyAbilityStage extends AbilityStage { 如下示例展示了Ability的`onConfigurationUpdated`回调实现，系统语言、颜色模式以及Display相关的参数，比如方向、Density，发生变化时触发该回调。具体示例代码如下： ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -import ConfigurationConstant from '@ohos.application.ConfigurationConstant'; +import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'; export default class EntryAbility extends UIAbility { direction : number; diff --git a/zh-cn/application-dev/ability-deprecated/stage-formextension.md b/zh-cn/application-dev/ability-deprecated/stage-formextension.md index 9559978c2f..26634f206c 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-formextension.md +++ b/zh-cn/application-dev/ability-deprecated/stage-formextension.md @@ -73,10 +73,10 @@ FormProvider类具体的API介绍详见[接口文档](../reference/apis/js-apis- 1. 导入相关模块 ```javascript - import FormExtension from '@ohos.application.FormExtension' - import formBindingData from '@ohos.application.formBindingData' - import formInfo from '@ohos.application.formInfo' - import formProvider from '@ohos.application.formProvider' + import FormExtension from '@ohos.app.ability.FormExtension'; + import formBindingData from '@ohos.app.form.formBindingData'; + import formInfo from '@ohos.app.form.formInfo'; + import formProvider from '@ohos.app.form.formProvider'; ``` 2. 实现FormExtension生命周期接口 diff --git a/zh-cn/application-dev/ability-deprecated/stage-serviceextension.md b/zh-cn/application-dev/ability-deprecated/stage-serviceextension.md index f52701d88d..fd8691f841 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-serviceextension.md +++ b/zh-cn/application-dev/ability-deprecated/stage-serviceextension.md @@ -42,9 +42,9 @@ OpenHarmony当前不支持三方应用创建ServiceExtensionAbility。 2. 开发者在定义Service的目录下创建TS文件，自定义类继承ServiceExtensionAbility，重写基类回调函数，接口生成的默认相对路径：entry\src\main\ets\ServiceExtAbility\ServiceExtAbility.ts，示例如下： ```js - import ServiceExtensionAbility from '@ohos.application.ServiceExtensionAbility' - import rpc from '@ohos.rpc' - + import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; + import rpc from '@ohos.rpc'; + class StubTest extends rpc.RemoteObject { constructor(des) { super(des); @@ -52,7 +52,7 @@ OpenHarmony当前不支持三方应用创建ServiceExtensionAbility。 onRemoteRequest(code, data, reply, option) { } } - + class ServiceExtAbility extends ServiceExtensionAbility { onCreate(want) { console.log('onCreate, want:' + want.abilityName); diff --git a/zh-cn/application-dev/ability-deprecated/wantagent.md b/zh-cn/application-dev/ability-deprecated/wantagent.md index 1d3609f819..10a59ef84f 100644 --- a/zh-cn/application-dev/ability-deprecated/wantagent.md +++ b/zh-cn/application-dev/ability-deprecated/wantagent.md @@ -15,7 +15,7 @@ WantAgent封装了一个行为意图信息，可以通过WantAgent.trigger接口 1. 导入WantAgent模块。 ```ts - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; ``` 2. 创建拉起Ability的WantAgentInfo信息。详细的WantAgentInfo信息数据类型及包含的参数请见[WantAgentInfo文档](../reference/apis/js-apis-wantAgent.md#wantagentinfo)介绍。 diff --git a/zh-cn/application-dev/application-test/arkxtest-guidelines.md b/zh-cn/application-dev/application-test/arkxtest-guidelines.md index 9fc6e8864a..8d31275f5d 100644 --- a/zh-cn/application-dev/application-test/arkxtest-guidelines.md +++ b/zh-cn/application-dev/application-test/arkxtest-guidelines.md @@ -63,8 +63,8 @@ DevEco Studio可参考其官网介绍进行[下载](https://developer.harmonyos. ## 编写单元测试脚本 ```TS -import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium' -import abilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium'; +import abilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; const delegator = abilityDelegatorRegistry.getAbilityDelegator() export default function abilityTest() { diff --git a/zh-cn/application-dev/device/location-guidelines.md b/zh-cn/application-dev/device/location-guidelines.md index 47da8c123b..46d12c9790 100644 --- a/zh-cn/application-dev/device/location-guidelines.md +++ b/zh-cn/application-dev/device/location-guidelines.md @@ -147,7 +147,7 @@ 以导航场景为例，实例化方式如下： - + ```ts let requestInfo = {'scenario': geoLocationManager.LocationRequestScenario.NAVIGATION, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; ``` @@ -159,13 +159,13 @@ ***定位优先级策略类型说明*** - 定位精度优先策略：ACCURACY
- 定位精度优先策略主要以GNSS定位技术为主，在开阔场景下可以提供米级的定位精度，具体性能指标依赖用户设备的定位硬件能力，但在室内等强遮蔽定位场景下，无法提供准确的位置服务。 + 定位精度优先策略主要以GNSS定位技术为主，在开阔场景下可以提供米级的定位精度，具体性能指标依赖用户设备的定位硬件能力，但在室内等强遮蔽定位场景下，无法提供准确的位置服务。 - 快速定位优先策略：FIRST_FIX
- 快速定位优先策略会同时使用GNSS定位、基站定位和WLAN、蓝牙定位技术，以便室内和户外场景下，通过此策略都可以获得位置结果，当各种定位技术都有提供位置结果时，系统会选择其中精度较好的结果返回给应用。因为对各种定位技术同时使用，对设备的硬件资源消耗较大，功耗也较大。 + 快速定位优先策略会同时使用GNSS定位、基站定位和WLAN、蓝牙定位技术，以便室内和户外场景下，通过此策略都可以获得位置结果，当各种定位技术都有提供位置结果时，系统会选择其中精度较好的结果返回给应用。因为对各种定位技术同时使用，对设备的硬件资源消耗较大，功耗也较大。 - 低功耗定位优先策略：LOW_POWER
- 低功耗定位优先策略主要使用基站定位和WLAN、蓝牙定位技术，也可以同时提供室内和户外场景下的位置服务，因为其依赖周边基站、可见WLAN、蓝牙设备的分布情况，定位结果的精度波动范围较大，如果对定位结果精度要求不高，或者使用场景多在有基站、可见WLAN、蓝牙设备高密度分布的情况下，推荐使用，可以有效节省设备功耗。 + 低功耗定位优先策略主要使用基站定位和WLAN、蓝牙定位技术，也可以同时提供室内和户外场景下的位置服务，因为其依赖周边基站、可见WLAN、蓝牙设备的分布情况，定位结果的精度波动范围较大，如果对定位结果精度要求不高，或者使用场景多在有基站、可见WLAN、蓝牙设备高密度分布的情况下，推荐使用，可以有效节省设备功耗。 ```ts export enum LocationRequestPriority { @@ -177,7 +177,7 @@ ``` 以定位精度优先策略为例，实例化方式如下： - + ```ts let requestInfo = {'priority': geoLocationManager.LocationRequestPriority.ACCURACY, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; ``` @@ -336,7 +336,7 @@ ```ts import geoLocationManager from '@ohos.geoLocationManager'; - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; ``` 3. 创建[WantAgentInfo](../reference/apis/js-apis-inner-wantAgent-wantAgentInfo.md)信息。 diff --git a/zh-cn/application-dev/dfx/apprecovery-guidelines.md b/zh-cn/application-dev/dfx/apprecovery-guidelines.md index 314c81ca94..028b2d6cfc 100644 --- a/zh-cn/application-dev/dfx/apprecovery-guidelines.md +++ b/zh-cn/application-dev/dfx/apprecovery-guidelines.md @@ -87,9 +87,9 @@ export default class MyAbilityStage extends AbilityStage { #### 导包 ```ts -import errorManager from '@ohos.app.ability.errorManager' -import appRecovery from '@ohos.app.ability.appRecovery' -import AbilityConstant from '@ohos.app.ability.AbilityConstant' +import errorManager from '@ohos.app.ability.errorManager'; +import appRecovery from '@ohos.app.ability.appRecovery'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; ``` #### 主动触发保存和恢复 diff --git a/zh-cn/application-dev/dfx/errormanager-guidelines.md b/zh-cn/application-dev/dfx/errormanager-guidelines.md index 8baf36b4d1..8a588efc18 100644 --- a/zh-cn/application-dev/dfx/errormanager-guidelines.md +++ b/zh-cn/application-dev/dfx/errormanager-guidelines.md @@ -37,7 +37,7 @@ ## 开发示例 ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -import errorManager from '@ohos.application.errorManager'; +import errorManager from '@ohos.app.ability.errorManager'; var registerId = -1; var callback = { diff --git a/zh-cn/application-dev/faqs/faqs-event-notification.md b/zh-cn/application-dev/faqs/faqs-event-notification.md index 9d9bfe04eb..b507f8f85c 100644 --- a/zh-cn/application-dev/faqs/faqs-event-notification.md +++ b/zh-cn/application-dev/faqs/faqs-event-notification.md @@ -17,7 +17,7 @@ emitter数据大小限制不超过10240。 示例： ```ts -import WantAgent from '@ohos.wantAgent'; +import WantAgent from '@ohos.app.ability.wantAgent'; async function publishNotification() { let wantAgentInfo = { 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 68a8b425f1..45870a9a83 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 @@ -94,7 +94,7 @@ launchType字段配置为specified时，系统会根据AbilityStage的onAcceptWa ```typescript // MyAbilityStage.ts -import AbilityStage from "@ohos.application.AbilityStage" +import AbilityStage from "@ohos.app.ability.AbilityStage" import deviceInfo from'@ohos.deviceInfo' export default class MyAbilityStage extends AbilityStage { diff --git a/zh-cn/application-dev/media/avsession-guidelines.md b/zh-cn/application-dev/media/avsession-guidelines.md index 96e7ce8701..761506bfbf 100644 --- a/zh-cn/application-dev/media/avsession-guidelines.md +++ b/zh-cn/application-dev/media/avsession-guidelines.md @@ -32,7 +32,7 @@ ```js import avSession from '@ohos.multimedia.avsession'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; import featureAbility from '@ohos.ability.featureAbility'; ``` @@ -372,7 +372,7 @@ currentSession.deactivate().then(() => { ```js import avSession from '@ohos.multimedia.avsession'; import {Action, KeyEvent} from '@ohos.multimodalInput.KeyEvent'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; import audio from '@ohos.multimedia.audio'; ``` diff --git a/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md b/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md index 1e9c4022a1..73c9190d9f 100644 --- a/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md +++ b/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md @@ -4,7 +4,7 @@ **full-SDK**是提供给OEM厂商开发应用的工具包，不能随DevEco Studio下载，包含了系统应用所需要的高权限API -三方开发者通过DevEco Studio自动下载的**API8版本**SDK均为**public版本**。public-SDK**不支持**开发者使用**所有的系统API**，包括animator组件、xcomponent组件、@ohos.application.abilityManager.d.ts、@ohos.application.formInfo.d.ts、@ohos.bluetooth.d.ts等，如工程必须依赖于系统API，请按照以下步骤替换**full-SDK**。 +三方开发者通过DevEco Studio自动下载的**API8版本**SDK均为**public版本**。public-SDK**不支持**开发者使用**所有的系统API**，包括animator组件、xcomponent组件、@ohos.app.ability.abilityManager.d.ts、@ohos.app.form.formInfo.d.ts、@ohos.bluetooth.d.ts等，如工程必须依赖于系统API，请按照以下步骤替换**full-SDK**。 > **说明**：本文中的截图仅为参考，具体的显示界面请以实际使用的DevEco Studio和SDK的版本为准。 @@ -32,7 +32,7 @@ full-SDK需要手动下载。请参考[版本说明书](../../release-notes/Open ![image-20220613220702504](figures/zh-cn_image_0000001655129232.png) - b.检查api中是否包含系统API（@ohos.application.abilityManager.d.ts、@ohos.application.formInfo.d.ts、@ohos.bluetooth.d.ts等） + b.检查api中是否包含系统API（@ohos.app.ability.abilityManager.d.ts、@ohos.app.form.formInfo.d.ts、@ohos.bluetooth.d.ts等） 注：系统api判定标准以发布api指导文档为主。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md index c78473d692..f85e7013ce 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md @@ -224,7 +224,7 @@ startBackgroundRunning(id: number, request: NotificationRequest, callback: Async ```ts import notification from '@ohos.notification'; import particleAbility from '@ohos.ability.particleAbility'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; function callback(err, data) { if (err) { @@ -293,7 +293,7 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise<voi ```ts import notification from '@ohos.notification'; import particleAbility from '@ohos.ability.particleAbility'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md index 6b644c9a21..0a958c87ae 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md @@ -9,7 +9,7 @@ ## 导入模块 ```ts -import Configuration from '@ohos.app.ability.Configuration' +import Configuration from '@ohos.app.ability.Configuration'; ``` **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase @@ -26,31 +26,31 @@ import Configuration from '@ohos.app.ability.Configuration' 具体字段描述参考ohos.app.ability.Configuration.d.ts文件 **示例：** - + ```ts - import UIAbility from '@ohos.app.ability.UIAbility'; +import UIAbility from '@ohos.app.ability.UIAbility'; - export default class EntryAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - let envCallback = { - onConfigurationUpdated(config) { - console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`) - let language = config.language; - let colorMode = config.colorMode; - let direction = config.direction; - let screenDensity = config.screenDensity; - let displayId = config.displayId; - let hasPointerDevice = config.hasPointerDevice; + let envCallback = { + onConfigurationUpdated(config) { + console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`) + let language = config.language; + let colorMode = config.colorMode; + let direction = config.direction; + let screenDensity = config.screenDensity; + let displayId = config.displayId; + let hasPointerDevice = config.hasPointerDevice; + } + }; + try { + let applicationContext = this.context.getApplicationContext(); + let callbackId = applicationContext.on("environment", envCallback); + console.log("callbackId: " + callbackId); + } catch (paramError) { + console.log("error: " + paramError.code + ", " + paramError.message); } - }; - try { - let applicationContext = this.context.getApplicationContext(); - let callbackId = applicationContext.on("environment", envCallback); - console.log("callbackId: " + callbackId); - } catch (paramError) { - console.log("error: " + paramError.code + ", " + paramError.message); - } } - } +} ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formProvider.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formProvider.md index 5d227bbcaa..9573cf4454 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formProvider.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formProvider.md @@ -124,7 +124,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call **示例：** ```ts -import formBindingData from '@ohos.application.formBindingData'; +import formBindingData from '@ohos.app.form.formBindingData'; import formProvider from '@ohos.app.form.formProvider'; let formId = "12400633174999288"; @@ -173,7 +173,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr **示例：** ```ts -import formBindingData from '@ohos.application.formBindingData'; +import formBindingData from '@ohos.app.form.formBindingData'; import formProvider from '@ohos.app.form.formProvider'; let formId = "12400633174999288"; @@ -349,7 +349,7 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, **示例：** ```ts -import formBindingData from '@ohos.application.formBindingData'; +import formBindingData from '@ohos.app.form.formBindingData'; import formProvider from '@ohos.app.form.formProvider'; let want = { 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 7f84afda2b..0f422ebb87 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 @@ -136,7 +136,7 @@ Ability生命周期回调，在销毁时回调，执行资源清理等操作。 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **示例：** - + ```ts export default class EntryAbility extends UIAbility { onDestroy() { @@ -155,7 +155,7 @@ Ability生命周期回调，当应用从后台转到前台时触发。 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **示例：** - + ```ts export default class EntryAbility extends UIAbility { onForeground() { @@ -174,7 +174,7 @@ Ability生命周期回调，当应用从前台转到后台时触发。 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore **示例：** - + ```ts export default class EntryAbility extends UIAbility { onBackground() { @@ -205,9 +205,10 @@ onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult; | AbilityConstant.OnContinueResult | 继续的结果。 | **示例：** - + ```ts - import AbilityConstant from "@ohos.application.AbilityConstant" + import AbilityConstant from "@ohos.app.ability.AbilityConstant"; + export default class EntryAbility extends UIAbility { onContinue(wantParams) { console.log('onContinue'); @@ -234,7 +235,7 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void; | launchParams | AbilityConstant.LaunchParam | 是 | Ability启动的原因、上次异常退出的原因信息。 | **示例：** - + ```ts export default class EntryAbility extends UIAbility { onNewWant(want, launchParams) { @@ -259,7 +260,7 @@ onConfigurationUpdated(config: Configuration): void; | config | [Configuration](js-apis-application-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 | **示例：** - + ```ts export default class EntryAbility extends UIAbility { onConfigurationUpdated(config) { @@ -283,7 +284,7 @@ dump(params: Array\): Array\; | params | Array\ | 是 | 表示命令形式的参数。| **示例：** - + ```ts export default class EntryAbility extends UIAbility { dump(params) { @@ -308,7 +309,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; | level | [AbilityConstant.MemoryLevel](js-apis-application-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别，显示当前内存使用状态。| **示例：** - + ```ts export default class EntryAbility extends UIAbility { onMemoryLevel(level) { @@ -341,7 +342,7 @@ onSaveState(reason: AbilityConstant.StateType, wantParam : {[key: string]: any}) **示例：** ```ts -import AbilityConstant from '@ohos.application.AbilityConstant'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; export default class EntryAbility extends UIAbility { onSaveState(reason, wantParam) { @@ -352,8 +353,6 @@ export default class EntryAbility extends UIAbility { } ``` - - ## Caller 通用组件Caller通信客户端调用接口, 用来向通用组件服务端发送约定数据。 @@ -390,7 +389,7 @@ call(method: string, data: rpc.Sequenceable): Promise<void>; | 16000050 | Internal Error. | **示例：** - + ```ts import UIAbility from '@ohos.app.ability.UIAbility'; @@ -548,7 +547,6 @@ release(): void; | 16000050 | Internal Error. | **示例：** - ```ts import UIAbility from '@ohos.app.ability.UIAbility'; @@ -592,7 +590,7 @@ release(): void; | callback | OnReleaseCallBack | 是 | 返回onRelease回调结果。 | **示例：** - + ```ts import UIAbility from '@ohos.app.ability.UIAbility'; @@ -719,7 +717,6 @@ off(method: string): void; **示例：** - ```ts import UIAbility from '@ohos.app.ability.UIAbility'; diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md index 6850a49cce..4d5b2ba0d9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegatorRegistry.md @@ -9,7 +9,7 @@ AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和A ## 导入模块 ```ts -import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'; ``` ## AbilityLifecycleState diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md index bc65594148..cd2faf8c58 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityLifecycleCallback.md @@ -156,7 +156,7 @@ onAbilityContinue(ability: Ability): void; **示例：** ```ts -import AbilityStage from "@ohos.application.AbilityStage"; +import AbilityStage from "@ohos.app.ability.AbilityStage"; var lifecycleId; diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md index 47cd213016..f10bf6565e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md @@ -10,7 +10,7 @@ AbilityManager模块提供对Ability相关信息和状态信息进行获取、 ## 导入模块 ```ts -import abilityManager from '@ohos.application.abilityManager' +import abilityManager from '@ohos.application.abilityManager'; ``` ## AbilityState @@ -38,7 +38,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void **需要权限**: ohos.permission.UPDATE_CONFIGURATION **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core - + **参数**： | 参数名 | 类型 | 必填 | 说明 | @@ -176,7 +176,7 @@ abilityManager.getExtensionRunningInfos(upperLimit, (err,data) => { getExtensionRunningInfos(upperLimit: number): Promise\> 获取关于运行扩展能力的信息（Promise形式）。 - + **需要权限**: ohos.permission.GET_RUNNING_INFO **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core @@ -232,7 +232,7 @@ abilityManager.getTopAbility((err,data) => { getTopAbility(): Promise\; 获取窗口焦点的ability接口（Promise形式）。 - + **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **返回值：** 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 ce602be043..a39b42400e 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 @@ -420,7 +420,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\; getForegroundApplications(callback: AsyncCallback\>): void; 获取所有当前处于前台的应用信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。 - + **需要权限**：ohos.permission.GET_RUNNING_INFO **系统能力**：SystemCapability.Ability.AbilityRuntime.Core diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md index 0af24476df..3c845b46de 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-configuration.md @@ -26,7 +26,6 @@ import Configuration from '@ohos.application.Configuration' 具体字段描述参考ohos.application.Configuration.d.ts文件 **示例：** - ```ts import hilog from '@ohos.hilog'; import UIAbility from '@ohos.app.ability.UIAbility'; diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-errorManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-errorManager.md index 186be6c6db..b3f85620f6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-errorManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-errorManager.md @@ -8,7 +8,7 @@ ErrorManager模块提供对错误观察器的注册和注销的能力。 ## 导入模块 ```ts -import errorManager from '@ohos.application.errorManager' +import errorManager from '@ohos.application.errorManager'; ``` ## ErrorManager.registerErrorObserver @@ -20,7 +20,7 @@ registerErrorObserver(observer: ErrorObserver): number; **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** - + | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | observer | [ErrorObserver](js-apis-inner-application-errorObserver.md) | 是 | 返回观察者的数字代码。 | @@ -45,7 +45,7 @@ unregisterErrorObserver(observerId: number, callback: AsyncCallback\): vo **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** - + | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | observerId | number | 是 | 返回观察者的数字代码。 | @@ -74,7 +74,7 @@ unregisterErrorObserver(observerId: number): Promise\; **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** - + | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | observerId | number | 是 | 返回观察者的数字代码。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md b/zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md index b2b44ab897..78f507d1bc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-formBindingData.md @@ -48,7 +48,7 @@ createFormBindingData(obj?: Object | string): FormBindingData **示例：** ```ts -import formBindingData from @ohos.application.formBindingData; +import formBindingData from '@ohos.application.formBindingData'; import fs from '@ohos.file.fs'; try { diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md b/zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md index 66db8400ea..6f78d8cb6f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md @@ -94,7 +94,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call **示例：** ```ts - import formBindingData from '@ohos.application.formBindingData'; + import formBindingData from '@ohos.app.form.formBindingData'; import formProvider from '@ohos.app.form.formProvider'; let formId = "12400633174999288"; diff --git a/zh-cn/application-dev/reference/apis/js-apis-avsession.md b/zh-cn/application-dev/reference/apis/js-apis-avsession.md index 3e9151bbab..6937049624 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-avsession.md +++ b/zh-cn/application-dev/reference/apis/js-apis-avsession.md @@ -1001,7 +1001,7 @@ setLaunchAbility(ability: WantAgent): Promise\ **示例：** ```js -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; //WantAgentInfo对象 let wantAgentInfo = { @@ -1066,7 +1066,7 @@ setLaunchAbility(ability: WantAgent, callback: AsyncCallback\): void **示例：** ```js -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; //WantAgentInfo对象 let wantAgentInfo = { @@ -2222,7 +2222,7 @@ getLaunchAbility(): Promise\ **示例：** ```js -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; controller.getLaunchAbility().then((agent) => { console.info(`GetLaunchAbility : SUCCESS : wantAgent : ${agent}`); @@ -2257,7 +2257,7 @@ getLaunchAbility(callback: AsyncCallback\): void **示例：** ```js -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; controller.getLaunchAbility(function (err, agent) { if (err) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md index 19b83a5790..605da99555 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md @@ -173,7 +173,7 @@ FA模型示例： ```js import backgroundTaskManager from '@ohos.backgroundTaskManager'; import featureAbility from '@ohos.ability.featureAbility'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; function callback(err, data) { if (err) { @@ -207,7 +207,7 @@ Stage模型示例： ```ts import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; function callback(err, data) { if (err) { @@ -270,7 +270,7 @@ FA模型示例： ```js import backgroundTaskManager from '@ohos.backgroundTaskManager'; import featureAbility from '@ohos.ability.featureAbility'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ @@ -299,7 +299,7 @@ Stage模型示例： ```ts import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md b/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md index f067a97642..1887a65686 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md @@ -775,7 +775,7 @@ on(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): vo ```ts import geoLocationManager from '@ohos.geoLocationManager'; - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ @@ -833,7 +833,7 @@ off(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): v ```ts import geoLocationManager from '@ohos.geoLocationManager'; - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ diff --git a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md index 16a018d2ce..ebe0fa3d29 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md @@ -404,7 +404,7 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; ```ts import geolocation from '@ohos.geolocation'; - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ @@ -452,7 +452,7 @@ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; ```ts import geolocation from '@ohos.geolocation'; - import wantAgent from '@ohos.wantAgent'; + import wantAgent from '@ohos.app.ability.wantAgent'; let wantAgentInfo = { wants: [ diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md index fe66bf067e..e032f3805e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md @@ -10,7 +10,7 @@ AbilityDelegator提供添加用于监视指定ability的生命周期状态更改 通过AbilityDelegatorRegistry中[getAbilityDelegator](js-apis-app-ability-abilityDelegatorRegistry.md#abilitydelegatorregistrygetabilitydelegator)方法获取。 ```ts -import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); ``` @@ -35,13 +35,13 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void **示例：** ```ts -var abilityDelegator; +let abilityDelegator; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -75,13 +75,13 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\; **示例：** ```ts -var abilityDelegator; +let abilityDelegator; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -92,8 +92,6 @@ abilityDelegator.addAbilityMonitor(monitor).then(() => { }); ``` - - ### removeAbilityMonitor9+ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void; @@ -112,13 +110,13 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): v **示例：** ```ts -var abilityDelegator; +let abilityDelegator; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -129,8 +127,6 @@ abilityDelegator.removeAbilityMonitor(monitor, (err : any) => { }); ``` - - ### removeAbilityMonitor9+ removeAbilityMonitor(monitor: AbilityMonitor): Promise\; @@ -154,13 +150,13 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\; - 示例 ```ts -var abilityDelegator; +let abilityDelegator; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -171,8 +167,6 @@ abilityDelegator.removeAbilityMonitor(monitor).then(() => { }); ``` - - ### waitAbilityMonitor9+ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void; @@ -191,13 +185,13 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\) **示例：** ```ts -var abilityDelegator; +let abilityDelegator; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -227,14 +221,14 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall **示例：** ```ts -var abilityDelegator; -var timeout = 100; +let abilityDelegator; +let timeout = 100; function onAbilityCreateCallback(data) { console.info("onAbilityCreateCallback"); } -var monitor = { +let monitor = { abilityName: "abilityname", onAbilityCreate: onAbilityCreateCallback } @@ -271,13 +265,13 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\ { }); ``` - - ### getAppContext9+ getAppContext(): Context; @@ -307,14 +299,12 @@ getAppContext(): Context; **示例：** ```ts -var abilityDelegator; +let abilityDelegator; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -var context = abilityDelegator.getAppContext(); +let context = abilityDelegator.getAppContext(); ``` - - ### getAbilityState9+ getAbilityState(ability: UIAbility): number; @@ -338,20 +328,18 @@ getAbilityState(ability: UIAbility): number; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { console.info("getCurrentTopAbility callback"); ability = data; - var state = abilityDelegator.getAbilityState(ability); + let state = abilityDelegator.getAbilityState(ability); console.info("getAbilityState" + state); }); ``` - - ### getCurrentTopAbility9+ getCurrentTopAbility(callback: AsyncCallback\): void; @@ -369,8 +357,8 @@ getCurrentTopAbility(callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { @@ -379,8 +367,6 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => { }); ``` - - ### getCurrentTopAbility9+ getCurrentTopAbility(): Promise\; @@ -398,8 +384,8 @@ getCurrentTopAbility(): Promise\; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility().then((data : any) => { @@ -408,8 +394,6 @@ abilityDelegator.getCurrentTopAbility().then((data : any) => { }); ``` - - ### startAbility9+ startAbility(want: Want, callback: AsyncCallback\): void; @@ -428,8 +412,8 @@ startAbility(want: Want, callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var want = { +let abilityDelegator; +let want = { bundleName: "bundleName", abilityName: "abilityName" }; @@ -440,8 +424,6 @@ abilityDelegator.startAbility(want, (err : any, data : any) => { }); ``` - - ### startAbility9+ startAbility(want: Want): Promise\; @@ -465,8 +447,8 @@ startAbility(want: Want): Promise\; **示例：** ```ts -var abilityDelegator; -var want = { +let abilityDelegator; +let want = { bundleName: "bundleName", abilityName: "abilityName" }; @@ -477,8 +459,6 @@ abilityDelegator.startAbility(want).then((data: any) => { }); ``` - - ### doAbilityForeground9+ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\): void; @@ -497,8 +477,8 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { @@ -510,8 +490,6 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => { }); ``` - - ### doAbilityForeground9+ doAbilityForeground(ability: UIAbility): Promise\; @@ -535,8 +513,8 @@ doAbilityForeground(ability: UIAbility): Promise\; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { @@ -548,8 +526,6 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => { }); ``` - - ### doAbilityBackground9+ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\): void; @@ -568,8 +544,8 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { @@ -581,8 +557,6 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => { }); ``` - - ### doAbilityBackground9+ doAbilityBackground(ability: UIAbility): Promise\; @@ -606,8 +580,8 @@ doAbilityBackground(ability: UIAbility): Promise\; **示例：** ```ts -var abilityDelegator; -var ability; +let abilityDelegator; +let ability; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.getCurrentTopAbility((err : any, data : any) => { @@ -619,8 +593,6 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => { }); ``` - - ### printSync9+ printSync(msg: string): void; @@ -638,15 +610,13 @@ printSync(msg: string): void; **示例：** ```ts -var abilityDelegator; -var msg = "msg"; +let abilityDelegator; +let msg = "msg"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.printSync(msg); ``` - - ### print print(msg: string, callback: AsyncCallback\): void; @@ -665,8 +635,8 @@ print(msg: string, callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var msg = "msg"; +let abilityDelegator; +let msg = "msg"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.print(msg, (err : any) => { @@ -674,8 +644,6 @@ abilityDelegator.print(msg, (err : any) => { }); ``` - - ### print print(msg: string): Promise\; @@ -699,8 +667,8 @@ print(msg: string): Promise\; **示例：** ```ts -var abilityDelegator; -var msg = "msg"; +let abilityDelegator; +let msg = "msg"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.print(msg).then(() => { @@ -708,8 +676,6 @@ abilityDelegator.print(msg).then(() => { }); ``` - - ### executeShellCommand executeShellCommand(cmd: string, callback: AsyncCallback\): void; @@ -728,8 +694,8 @@ executeShellCommand(cmd: string, callback: AsyncCallback\): void **示例：** ```ts -var abilityDelegator; -var cmd = "cmd"; +let abilityDelegator; +let cmd = "cmd"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => { @@ -737,8 +703,6 @@ abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => { }); ``` - - ### executeShellCommand executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\): void; @@ -758,9 +722,9 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\ { @@ -768,8 +732,6 @@ abilityDelegator.executeShellCommand(cmd, timeout, (err : any, data : any) => { }); ``` - - ### executeShellCommand executeShellCommand(cmd: string, timeoutSecs?: number): Promise\; @@ -794,9 +756,9 @@ executeShellCommand(cmd: string, timeoutSecs?: number): Promise\ **示例：** ```ts -var abilityDelegator; -var cmd = "cmd"; -var timeout = 100; +let abilityDelegator; +let cmd = "cmd"; +let timeout = 100; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => { @@ -804,8 +766,6 @@ abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => { }); ``` - - ### finishTest9+ finishTest(msg: string, code: number, callback: AsyncCallback\): void; @@ -825,8 +785,8 @@ finishTest(msg: string, code: number, callback: AsyncCallback\): void; **示例：** ```ts -var abilityDelegator; -var msg = "msg"; +let abilityDelegator; +let msg = "msg"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.finishTest(msg, 0, (err : any) => { @@ -834,8 +794,6 @@ abilityDelegator.finishTest(msg, 0, (err : any) => { }); ``` - - ### finishTest9+ finishTest(msg: string, code: number): Promise\; @@ -860,8 +818,8 @@ finishTest(msg: string, code: number): Promise\; **示例：** ```ts -var abilityDelegator; -var msg = "msg"; +let abilityDelegator; +let msg = "msg"; abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); abilityDelegator.finishTest(msg, 0).then(() => { @@ -887,9 +845,9 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ { }); ``` - - ### addAbilityStageMonitor9+ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; @@ -925,9 +881,9 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; **示例：** ```ts -var abilityDelegator; +let abilityDelegator; -var monitor = { +let monitor = { moduleName: "moduleName", srcEntrance: "srcEntrance", } @@ -956,9 +912,9 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ **示例：** ```ts -var abilityDelegator; +let abilityDelegator; -var monitor = { +let monitor = { moduleName: "moduleName", srcEntrance: "srcEntrance", } @@ -969,8 +925,6 @@ abilityDelegator.removeAbilityStageMonitor(monitor, (err : any) => { }); ``` - - ### removeAbilityStageMonitor9+ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; @@ -994,9 +948,9 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\; **示例：** ```ts -var abilityDelegator; +let abilityDelegator; -var monitor = { +let monitor = { moduleName: "moduleName", srcEntrance: "srcEntrance", } @@ -1025,13 +979,13 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ { }); ``` - diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityRunningInfo.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityRunningInfo.md index 79dd323dae..12de812a9c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityRunningInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityRunningInfo.md @@ -28,7 +28,8 @@ AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义 **示例：** ```ts -import abilitymanager from '@ohos.application.abilityManager'; +import abilitymanager from '@ohos.app.ability.abilityManager'; + abilitymanager.getAbilityRunningInfos((err,data) => { console.log("getAbilityRunningInfos err: " + err + " data: " + JSON.stringify(data)); for (let i = 0; i < data.length; i++) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageContext.md index 4664de608f..c5b4aae5a0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageContext.md @@ -14,7 +14,8 @@ AbilityStageContext提供允许访问特定于abilityStage的资源的能力， 通过AbilityStage实例来获取。 ```ts -import AbilityStage from '@ohos.application.AbilityStage'; +import AbilityStage from '@ohos.app.ability.AbilityStage'; + class MyAbilityStage extends AbilityStage { onCreate() { let abilityStageContext = this.context; diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md index 840cc6da4d..68ca3259d2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityStageMonitor.md @@ -11,7 +11,7 @@ **示例：** ```ts -import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' +import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; let monitor = { moduleName: "feature_as1", diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md index 32084be192..9e077460ad 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationStateObserver.md @@ -16,7 +16,7 @@ **示例：** ```ts -import appManager from "@ohos.application.appManager" +import appManager from "@ohos.app.ability.appManager"; let applicationStateObserver = { onForegroundApplicationChanged(appStateData) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md index 8bcef45ca7..f45abf105b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionContext.md @@ -31,8 +31,9 @@ ExtensionContext主要用于查询所属Extension的信息、Module的配置信 三个Module内都定义一个相同名称的ServiceExtension： ```ts -import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility' -import Want from '@ohos.application.Want' +import ServiceExtension from '@ohos.app.ability.ServiceExtensionAbility'; +import Want from '@ohos.app.ability.Want'; + export default class TheServiceExtension extends ServiceExtension { onCreate(want:Want) { console.log('ServiceAbility onCreate, want: ' + want.abilityName); 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 69f0f5d0f9..1b0a054930 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 @@ -17,7 +17,7 @@ **示例：** ```ts -import appManager from '@ohos.application.appManager' +import appManager from '@ohos.app.ability.appManager'; let applicationStateObserver = { onForegroundApplicationChanged(appStateData) { 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 e184f612c1..d28e3d0eb8 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 @@ -23,7 +23,7 @@ **示例：** ```ts -import appManager from '@ohos.application.appManager'; +import appManager from '@ohos.app.ability.appManager'; appManager.getProcessRunningInfos().then((data) => { console.log('success:' + JSON.stringify(data)); diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md index 2b664bda21..aeae1305fb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-shellCmdResult.md @@ -19,7 +19,7 @@ **示例：** ```ts -import AbilityDelegatorRegistry from "@ohos.application.abilityDelegatorRegistry"; +import AbilityDelegatorRegistry from "@ohos.app.ability.abilityDelegatorRegistry"; let abilityDelegator; let cmd = "cmd"; diff --git a/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-backgroundTaskManager.md b/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-backgroundTaskManager.md index 2486de75b8..dbddbcff6b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-backgroundTaskManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-resourceschedule-backgroundTaskManager.md @@ -257,7 +257,7 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want ```js import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; function callback(error, data) { if (error) { @@ -336,7 +336,7 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want ```js import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-notification.md b/zh-cn/application-dev/reference/apis/js-apis-system-notification.md index 56b7b9504f..90e6590261 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-notification.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-notification.md @@ -9,7 +9,7 @@ ## 导入模块 -``` +```ts import notification from '@system.notification'; ``` diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md index 533a958fc0..bc6a54e414 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md @@ -354,9 +354,9 @@ struct ImageExample3 { ### 渲染沙箱路径图片 ```ts -import fileio from '@ohos.fileio' -import fs from '@ohos.file.fs' -import context from '@ohos.application.context' +import fileio from '@ohos.fileio'; +import fs from '@ohos.file.fs'; +import context from '@ohos.app.ability.context'; @Entry @Component diff --git a/zh-cn/application-dev/task-management/continuous-task-dev-guide.md b/zh-cn/application-dev/task-management/continuous-task-dev-guide.md index 83d0275630..f616b8f382 100644 --- a/zh-cn/application-dev/task-management/continuous-task-dev-guide.md +++ b/zh-cn/application-dev/task-management/continuous-task-dev-guide.md @@ -61,7 +61,7 @@ Stage模型的相关信息参考[Stage模型开发概述](../application-models/ 2、在应用内执行长时任务时，由于元能力启动管控规则限制，不支持同应用通过startAbilityByCall的形式在后台创建并运行Ability。可以直接在page中，执行相应的代码。Stage模型的Ability使用参考[Stage模型开发指导-UIAbility组件](../application-models/uiability-overview.md)。 ```ts -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; @Entry @@ -152,7 +152,7 @@ struct Index { ```ts import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; const MSG_SEND_METHOD: string = 'CallSendMsg'; @@ -314,7 +314,7 @@ export default class BgTaskAbility extends UIAbility { ```js import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; import featureAbility from '@ohos.ability.featureAbility'; -import wantAgent from '@ohos.wantAgent'; +import wantAgent from '@ohos.app.ability.wantAgent'; import rpc from "@ohos.rpc"; function startContinuousTask() { diff --git a/zh-cn/application-dev/ui/arkui-overview.md b/zh-cn/application-dev/ui/arkui-overview.md index 7fa89a6eac..f788b416e4 100644 --- a/zh-cn/application-dev/ui/arkui-overview.md +++ b/zh-cn/application-dev/ui/arkui-overview.md @@ -50,11 +50,10 @@ OpenHarmony提供了FA模型与Stage模型两种[应用模型](../application-mo **Stage模型：** -| 类型 | UI开发范式 | 说明 | -| ---- | -------- | ---------------------------------------- | -| 应用 | 类web开发范式 | 当前不支持 | -| | 声明式开发范式 | UI开发语言：ArkTS
业务入口：应用模型基于ohos.application.Ability/ExtensionAbility等派生
业务逻辑语言：ts | -| 服务卡片 | 类web开发范式 | UI开发语言：卡片显示使用hml+css+json(action)
业务入口：从FormExtensionAbility派生
业务逻辑语言：ts | -| | 声明式开发范式 | 当前不支持 | - +| 类型 | UI开发范式 | 说明 | +| -------- | -------------- | ------------------------------------------------------------ | +| 应用 | 类web开发范式 | 当前不支持 | +| | 声明式开发范式 | UI开发语言：ArkTS
业务入口：应用模型基于ohos.app.ability.UIAbility/ExtensionAbility等派生
业务逻辑语言：ts | +| 服务卡片 | 类web开发范式 | UI开发语言：卡片显示使用hml+css+json(action)
业务入口：从FormExtensionAbility派生
业务逻辑语言：ts | +| | 声明式开发范式 | 当前不支持 | diff --git a/zh-cn/application-dev/windowmanager/application-window-stage.md b/zh-cn/application-dev/windowmanager/application-window-stage.md index 8c8a5aae28..47cd5be52f 100644 --- a/zh-cn/application-dev/windowmanager/application-window-stage.md +++ b/zh-cn/application-dev/windowmanager/application-window-stage.md @@ -320,7 +320,7 @@ export default class EntryAbility extends UIAbility { ```ts import UIAbility from '@ohos.app.ability.UIAbility'; - import ExtensionContext from '@ohos.application.ServiceExtensionAbility'; + import ExtensionContext from '@ohos.app.ability.ServiceExtensionAbility'; import window from '@ohos.window'; export default class EntryAbility extends UIAbility { diff --git a/zh-cn/application-dev/windowmanager/system-window-stage.md b/zh-cn/application-dev/windowmanager/system-window-stage.md index 19acc8b34b..58011ceea1 100644 --- a/zh-cn/application-dev/windowmanager/system-window-stage.md +++ b/zh-cn/application-dev/windowmanager/system-window-stage.md @@ -58,7 +58,7 @@ 当不再需要音量条窗口时，可根据具体实现逻辑，使用`hide`接口或`destroyWindow`接口对其进行隐藏或销毁。 ```ts -import ExtensionContext from '@ohos.application.ServiceExtensionAbility'; +import ExtensionContext from '@ohos.app.ability.ServiceExtensionAbility'; import window from '@ohos.window'; export default class ServiceExtensionAbility1 extends ExtensionContext { -- GitLab