diff --git a/zh-cn/application-dev/ability-deprecated/context-userguide.md b/zh-cn/application-dev/ability-deprecated/context-userguide.md index 4b0cf6267e87890beef84d37288d950c56386641..52303aa9e40b37ec05fc906f9bd260ca026baef9 100644 --- a/zh-cn/application-dev/ability-deprecated/context-userguide.md +++ b/zh-cn/application-dev/ability-deprecated/context-userguide.md @@ -94,13 +94,13 @@ export default { **示例** ```javascript -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var lifecycleid; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate() { - console.log("MainAbility onCreate") + console.log("EntryAbility onCreate") let AbilityLifecycleCallback = { onAbilityCreate(ability){ console.log("AbilityLifecycleCallback onAbilityCreate ability:" + JSON.stringify(ability)); @@ -189,25 +189,25 @@ export default class MyAbilityStage extends AbilityStage { **示例** ```javascript -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") globalThis.abilityWant = want; } onDestroy() { - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") } onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") // 在这里获取AbilityContext,打印ability的信息 let context = this.context; - console.log("[Demo] MainAbility bundleName " + context.abilityInfo.bundleName) + console.log("[Demo] EntryAbility bundleName " + context.abilityInfo.bundleName) windowStage.loadContent("pages/index", (err, data) => { if (err.code) { @@ -220,17 +220,17 @@ export default class MainAbility extends Ability { onWindowStageDestroy() { // Main window is destroyed, release UI related resources - console.log("[Demo] MainAbility onWindowStageDestroy") + console.log("[Demo] EntryAbility onWindowStageDestroy") } onForeground() { // Ability has brought to foreground - console.log("[Demo] MainAbility onForeground") + console.log("[Demo] EntryAbility onForeground") } onBackground() { // Ability has back to background - console.log("[Demo] MainAbility onBackground") + console.log("[Demo] EntryAbility onBackground") } }; ``` @@ -256,16 +256,16 @@ Stage模型下,在Ability的`onWindowStageCreate`生命周期中,可以通 **示例** ```ts -// MainAbility.ts -import Ability from '@ohos.application.Ability' +// EntryAbility.ts +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") } onDestroy() { - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") } onWindowStageCreate(windowStage) { diff --git a/zh-cn/application-dev/ability-deprecated/continuationmanager.md b/zh-cn/application-dev/ability-deprecated/continuationmanager.md index 0e61264ea0eae71d45d209e4ed172a9ebf4a0082..6e11cccf8e7ef6c8e2f07125101934d1c5bd913c 100644 --- a/zh-cn/application-dev/ability-deprecated/continuationmanager.md +++ b/zh-cn/application-dev/ability-deprecated/continuationmanager.md @@ -173,7 +173,7 @@ continuationManager作为流转能力的入口,主要用于拉起系统中的 let want = { deviceId: remoteDeviceId, bundleName: 'ohos.samples.continuationmanager', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }; globalThis.abilityContext.startAbility(want).then((data) => { console.info('StartRemoteAbility finished, ' + JSON.stringify(data)); diff --git a/zh-cn/application-dev/ability-deprecated/fa-formability.md b/zh-cn/application-dev/ability-deprecated/fa-formability.md index 379e504eee64a09fb2a950f7d832203fb8113eae..aa9ed5685453f37aa341fd507f30848f1c3eed91 100644 --- a/zh-cn/application-dev/ability-deprecated/fa-formability.md +++ b/zh-cn/application-dev/ability-deprecated/fa-formability.md @@ -333,7 +333,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "com.example.entry.MainAbility", + "abilityName": "com.example.entry.EntryAbility", "params": { "message": "add detail" } @@ -353,8 +353,8 @@ onUpdate(formId) { 1. 在hml中为组件设置onclick属性,其值对应到json文件的actions字段中。 2. 若设置router事件,则 - action属性值为"router"; - - abilityName为跳转目标的Ability名,如目前DevEco创建的FA模型的MainAbility默认名为com.example.entry.MainAbility; - - params为跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如FA模型MainAbility的onCreate生命周期里可以通过featureAbility.getWant()获取到want,然后在其parameters字段下获取到配置的参数; + - abilityName为跳转目标的Ability名,如目前DevEco创建的FA模型的UIAbility默认名为com.example.entry.EntryAbility; + - params为跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如FA模型EntryAbility的onCreate生命周期里可以通过featureAbility.getWant()获取到want,然后在其parameters字段下获取到配置的参数; 3. 若设置message事件,则 - action属性值为"message"; - params为message事件的用户自定义参数,可以按需填写。其值可以在卡片生命周期函数onEvent中的message里获取; @@ -386,7 +386,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "com.example.entry.MainAbility", + "abilityName": "com.example.entry.EntryAbility", "params": { "message": "add detail" } diff --git a/zh-cn/application-dev/ability-deprecated/fa-pageability.md b/zh-cn/application-dev/ability-deprecated/fa-pageability.md index abab9903310c167f82cdb8dbe8cb80d4243686cb..0d81c76437ef82ffdbdfe1c5d9e92ece1266c9dd 100644 --- a/zh-cn/application-dev/ability-deprecated/fa-pageability.md +++ b/zh-cn/application-dev/ability-deprecated/fa-pageability.md @@ -134,13 +134,13 @@ ability支持单实例和多实例两种启动模式。 if (typeof dmClass === 'object' && dmClass != null) { let list = dmClass.getTrustedDeviceListSync(); if (typeof (list) == 'undefined' || typeof (list.length) == 'undefined') { - console.log("MainAbility onButtonClick getRemoteDeviceId err: list is null"); + console.log("EntryAbility onButtonClick getRemoteDeviceId err: list is null"); return; } - console.log("MainAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); + console.log("EntryAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); return list[0].deviceId; } else { - console.log("MainAbility onButtonClick getRemoteDeviceId err: dmClass is null"); + console.log("EntryAbility onButtonClick getRemoteDeviceId err: dmClass is null"); } } ``` 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 d11004835e70789bb491e9ddb734acd6b120d310..456df515077e11d703a80a0186d52bbf214187d8 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md +++ b/zh-cn/application-dev/ability-deprecated/stage-ability-continuation.md @@ -147,7 +147,7 @@ 导入模块 ```javascript - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; import AbilityConstant from '@ohos.application.AbilityConstant'; ``` @@ -185,14 +185,14 @@ 示例 ```javascript - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; import distributedObject from '@ohos.data.distributedDataObject'; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { storage : LocalStorag; onCreate(want, launchParam) { - Logger.info(`MainAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`) + Logger.info(`EntryAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`) if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { // get user data from want params let workInput = want.parameters.work @@ -207,8 +207,6 @@ ``` 如果是单实例应用,则同样的代码实现onNewWant接口即可。 - - ### 迁移数据 使用分布式对象 @@ -220,12 +218,12 @@ - 发起端在onContinue()中,将待迁移的数据存入分布式对象中,并调用save接口将数据保存并同步到远端,然后设置好session id,并通过wantParam将session id传到远端设备。 ```javascript - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; import distributedObject from '@ohos.data.distributedDataObject'; var g_object = distributedObject.createDistributedObject({data:undefined}); - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { sessionId : string; onContinue(wantParam : {[key: string]: any}) { @@ -256,34 +254,33 @@ - 目标设备在onCreate()中,取出发起端传过来的session id,建立分布式对象并关联该session id,这样就能实现分布式对象的同步。需要注意的是,在调用restoreWindowStage之前,迁移需要的分布式对象必须全部关联完,保证能够获取到正确的数据。 ```javascript - import Ability from '@ohos.application.Ability'; - import distributedObject from '@ohos.data.distributedDataObject'; + import UIAbility from '@ohos.app.ability.UIAbility'; + import distributedObject from '@ohos.data.distributedDataObject'; - var g_object = distributedObject.createDistributedObject({data:undefined}); + var g_object = distributedObject.createDistributedObject({data:undefined}); - export default class MainAbility extends Ability { - storage : LocalStorag; + export default class EntryAbility extends UIAbility { + storage : LocalStorag; + onCreate(want, launchParam) { + Logger.info(`EntryAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`) + if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { + // get distributed data object session id from want params + this.sessionId = want.parameters.session + Logger.info(`onCreate for continuation sessionId: ${this.sessionId}`) - onCreate(want, launchParam) { - Logger.info(`MainAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`) - if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { - // get distributed data object session id from want params - this.sessionId = want.parameters.session - Logger.info(`onCreate for continuation sessionId: ${this.sessionId}`) + // in order to fetch from remote, reset g_object.data to undefined first + g_object.data = undefined; + // set session id, so it will fetch data from remote + g_object.setSessionId(this.sessionId); - // in order to fetch from remote, reset g_object.data to undefined first - g_object.data = undefined; - // set session id, so it will fetch data from remote - g_object.setSessionId(this.sessionId); + AppStorage.SetOrCreate('ContinueStudy', g_object.data) + this.storage = new LocalStorage(); + this.context.restoreWindowStage(this.storage); + } - AppStorage.SetOrCreate('ContinueStudy', g_object.data) - this.storage = new LocalStorage(); - this.context.restoreWindowStage(this.storage); - } - - } - } + } + } ``` diff --git a/zh-cn/application-dev/ability-deprecated/stage-ability.md b/zh-cn/application-dev/ability-deprecated/stage-ability.md index c9e85aa3ddc7643d6e566e5fdf2f8eaec462691e..d3c241ee0a98cfb51e90e463edbeb9b7b66d30b6 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-ability.md +++ b/zh-cn/application-dev/ability-deprecated/stage-ability.md @@ -69,41 +69,41 @@ Ability功能如下(Ability类,具体的API详见[接口文档](../reference ``` 3. 导入Ability模块。 ```js - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; ``` -4. 实现Ability生命周期接口,接口默认生成的相对路径:entry\src\main\ets\MainAbility\MainAbility.ts。 +4. 实现UIAbility生命周期接口,接口默认生成的相对路径:entry\src\main\ets\entryability\EntryAbility.ts。 在`onWindowStageCreate(windowStage)`中通过loadContent接口设置应用要加载的页面,window接口的使用详见[窗口开发指导](../windowmanager/application-window-stage.md)。 ```ts - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("MainAbility onCreate") + console.log("EntryAbility onCreate") } onDestroy() { - console.log("MainAbility onDestroy") + console.log("EntryAbility onDestroy") } onWindowStageCreate(windowStage) { - console.log("MainAbility onWindowStageCreate") + console.log("EntryAbility onWindowStageCreate") windowStage.loadContent("pages/index").then(() => { - console.log("MainAbility load content succeed") + console.log("EntryAbility load content succeed") }).catch((error) => { - console.error("MainAbility load content failed with error: " + JSON.stringify(error)) + console.error("EntryAbility load content failed with error: " + JSON.stringify(error)) }) } onWindowStageDestroy() { - console.log("MainAbility onWindowStageDestroy") + console.log("EntryAbility onWindowStageDestroy") } onForeground() { - console.log("MainAbility onForeground") + console.log("EntryAbility onForeground") } onBackground() { - console.log("MainAbility onBackground") + console.log("EntryAbility onBackground") } } ``` @@ -132,19 +132,20 @@ export default class MyAbilityStage extends AbilityStage { 如下示例展示了Ability通过context属性获取包代码路径、HAP名称、Ability名称以及系统语言的方法。具体示例代码如下: ```ts -import Ability from '@ohos.application.Ability' -export default class MainAbility extends Ability { +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("MainAbility onCreate") + console.log("EntryAbility onCreate") let context = this.context - console.log("MainAbility bundleCodeDir" + context.bundleCodeDir) + console.log("EntryAbility bundleCodeDir" + context.bundleCodeDir) let abilityInfo = this.context.abilityInfo; - console.log("MainAbility ability bundleName" + abilityInfo.bundleName) - console.log("MainAbility ability name" + abilityInfo.name) + console.log("EntryAbility ability bundleName" + abilityInfo.bundleName) + console.log("EntryAbility ability name" + abilityInfo.name) let config = this.context.config - console.log("MainAbility config language" + config.language) + console.log("EntryAbility config language" + config.language) } } ``` @@ -169,10 +170,10 @@ export default class MyAbilityStage extends AbilityStage { 如下示例展示了Ability的`onConfigurationUpdated`回调实现,系统语言、颜色模式以及Display相关的参数,比如方向、Density,发生变化时触发该回调。具体示例代码如下: ```ts -import Ability from '@ohos.application.Ability' -import ConfigurationConstant from '@ohos.application.ConfigurationConstant' +import UIAbility from '@ohos.app.ability.UIAbility'; +import ConfigurationConstant from '@ohos.application.ConfigurationConstant'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { direction : number; onCreate(want, launchParam) { @@ -208,7 +209,7 @@ let context = this.context var want = { "deviceId": "", "bundleName": "com.example.MyApplication", - "abilityName": "MainAbility" + "abilityName": "EntryAbility" }; context.startAbility(want).then(() => { console.log("Succeed to start ability") @@ -225,7 +226,7 @@ let context = this.context var want = { "deviceId": getRemoteDeviceId(), "bundleName": "com.example.MyApplication", - "abilityName": "MainAbility" + "abilityName": "EntryAbility" }; context.startAbility(want).then(() => { console.log("Succeed to start remote ability") @@ -240,13 +241,13 @@ function getRemoteDeviceId() { if (typeof dmClass === 'object' && dmClass != null) { var list = dmClass.getTrustedDeviceListSync(); if (typeof (list) == 'undefined' || typeof (list.length) == 'undefined') { - console.log("MainAbility onButtonClick getRemoteDeviceId err: list is null"); + console.log("EntryAbility onButtonClick getRemoteDeviceId err: list is null"); return; } - console.log("MainAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); + console.log("EntryAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); return list[0].deviceId; } else { - console.log("MainAbility onButtonClick getRemoteDeviceId err: dmClass is null"); + console.log("EntryAbility onButtonClick getRemoteDeviceId err: dmClass is null"); } } ``` @@ -260,7 +261,7 @@ async function reStartAbility() { try { await this.context.startAbility({ bundleName: "com.sample.MyApplication", - abilityName: "MainAbility", + abilityName: "EntryAbility", uri: "pages/second" }) console.log('start ability succeed') @@ -272,9 +273,9 @@ async function reStartAbility() { 在Ability的onNewWant回调中获取包含页面信息的want参数: ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onNewWant(want, launchParams) { globalThis.newWant = want } diff --git a/zh-cn/application-dev/ability-deprecated/stage-call.md b/zh-cn/application-dev/ability-deprecated/stage-call.md index 336b9099786be229104202119d3f84a38e5aac97..e068bd7e99db223dc9cdf862e8a3f2f51e197b57 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-call.md +++ b/zh-cn/application-dev/ability-deprecated/stage-call.md @@ -209,13 +209,13 @@ function getRemoteDeviceId() { if (typeof dmClass === 'object' && dmClass != null) { var list = dmClass.getTrustedDeviceListSync() if (typeof (list) == 'undefined' || typeof (list.length) == 'undefined') { - console.log("MainAbility onButtonClick getRemoteDeviceId err: list is null") + console.log("EntryAbility onButtonClick getRemoteDeviceId err: list is null") return } - console.log("MainAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId) + console.log("EntryAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId) return list[0].deviceId } else { - console.log("MainAbility onButtonClick getRemoteDeviceId err: dmClass is null") + console.log("EntryAbility onButtonClick getRemoteDeviceId err: dmClass is null") } } ``` diff --git a/zh-cn/application-dev/ability-deprecated/stage-formextension.md b/zh-cn/application-dev/ability-deprecated/stage-formextension.md index cd08291627c8b09aeb6d47db1e6b36a968ac4fa1..9559978c2f7a45648e3ebb4dbfac7beea31dfbac 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-formextension.md +++ b/zh-cn/application-dev/ability-deprecated/stage-formextension.md @@ -199,7 +199,7 @@ FormProvider类具体的API介绍详见[接口文档](../reference/apis/js-apis- "defaultDimension": "2*2", "updateEnabled": true, "scheduledUpdateTime": "10:30", - "formConfigAbility": "ability://ohos.samples.FormApplication.MainAbility" + "formConfigAbility": "ability://ohos.samples.FormApplication.EntryAbility" }] } ``` @@ -344,7 +344,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "MainAbility", + "abilityName": "EntryAbility", "params": { "message": "add detail" } @@ -364,8 +364,8 @@ onUpdate(formId) { 1. 在hml中为组件设置onclick属性,其值对应到json文件的actions字段中。 2. 若设置router事件,则 - action属性值为"router"; - - abilityName为跳转目标的Ability名,如目前DevEco创建的Stage模型的MainAbility默认名为MainAbility; - - params为跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如Stage模型MainAbility的onCreate生命周期里的入参want的parameters字段下获取到配置的参数; + - abilityName为跳转目标的Ability名,如目前DevEco创建的Stage模型的UIAbility默认名为EntryAbility; + - params为跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如Stage模型EntryAbility的onCreate生命周期里的入参want的parameters字段下获取到配置的参数; 3. 若设置message事件,则 - action属性值为"message"; - params为message事件的用户自定义参数,可以按需填写。其值可以在卡片生命周期函数onEvent中的message里获取; @@ -397,7 +397,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "MainAbility", + "abilityName": "EntryAbility", "params": { "message": "add detail" } diff --git a/zh-cn/application-dev/ability-deprecated/wantagent.md b/zh-cn/application-dev/ability-deprecated/wantagent.md index 9e293023a2ac8f8dbfb233fea3a227abcada41f8..1d3609f8193b90ccef6c028200321bdacb035229 100644 --- a/zh-cn/application-dev/ability-deprecated/wantagent.md +++ b/zh-cn/application-dev/ability-deprecated/wantagent.md @@ -29,7 +29,7 @@ WantAgent封装了一个行为意图信息,可以通过WantAgent.trigger接口 { deviceId: "", bundleName: "com.example.test", - abilityName: "com.example.test.MainAbility", + abilityName: "com.example.test.EntryAbility", action: "", entities: [], uri: "", diff --git a/zh-cn/application-dev/application-models/api-switch-overview.md b/zh-cn/application-dev/application-models/api-switch-overview.md index 80bdd32faba26f9e0f73c6fe21daab2d1a859c25..ce86d59ceb4c130155ce5834d8b1a02451da615d 100644 --- a/zh-cn/application-dev/application-models/api-switch-overview.md +++ b/zh-cn/application-dev/application-models/api-switch-overview.md @@ -13,8 +13,8 @@ startAbility接口由FA模型切换到Stage模型的示例: import fa from '@ohos.ability.featureAbility'; let parameter = { "want": { - bundleName: "ohos.samples.demo", - abilityName: "ohos.samples.demo.MainAbility" + bundleName: "com.example.myapplication", + abilityName: "com.example.myapplication.EntryAbility" } } fa.startAbility(parameter).then((data) => { @@ -30,8 +30,8 @@ startAbility接口由FA模型切换到Stage模型的示例: // context为Ability对象的成员,在非Ability对象内部调用需要 // 将Context对象传递过去 let wantInfo = { - bundleName: "ohos.samples.demo", - abilityName: "ohos.samples.demo.MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; this.context.startAbility(wantInfo).then((data) => { console.info('startAbility success.'); diff --git a/zh-cn/application-dev/application-models/bind-serviceability-from-stage.md b/zh-cn/application-dev/application-models/bind-serviceability-from-stage.md index 7b78405c42678b9823822093efabf666da23c2c6..f505b8bc443ae1530378f9f380422c682e8e5c18 100644 --- a/zh-cn/application-dev/application-models/bind-serviceability-from-stage.md +++ b/zh-cn/application-dev/application-models/bind-serviceability-from-stage.md @@ -12,15 +12,15 @@ UIAbility关联访问ServiceAbility和UIAbility关联访问ServiceExtensionAbili ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.info("MainAbility onCreate"); + console.info("EntryAbility onCreate"); } onDestroy() { - console.info("MainAbility onDestroy") + console.info("EntryAbility onDestroy") } onWindowStageCreate(windowStage) { - console.info("MainAbility onWindowStageCreate") + console.info("EntryAbility onWindowStageCreate") let want = { bundleName: "com.ohos.fa", abilityName: "ServiceAbility", @@ -40,13 +40,13 @@ export default class MainAbility extends UIAbility { let connectionId = this.context.connectServiceExtensionAbility(want, options); } onWindowStageDestroy() { - console.info("MainAbility onWindowStageDestroy") + console.info("EntryAbility onWindowStageDestroy") } onForeground() { - console.info("MainAbility onForeground") + console.info("EntryAbility onForeground") } onBackground() { - console.info("MainAbility onBackground") + console.info("EntryAbility onBackground") } } ``` diff --git a/zh-cn/application-dev/application-models/create-pageability.md b/zh-cn/application-dev/application-models/create-pageability.md index e502fc2be29ef3d09e58aa416cf5bdcbc731c035..75ab7e6cac005796a2156e48db577400b2e61ed6 100644 --- a/zh-cn/application-dev/application-models/create-pageability.md +++ b/zh-cn/application-dev/application-models/create-pageability.md @@ -30,7 +30,7 @@ export default { ``` -PageAbility创建成功后,其abilities相关的配置项在config.json中体现,一个名字为MainAbility的config.json配置文件示例如下: +PageAbility创建成功后,其abilities相关的配置项在config.json中体现,一个名字为EntryAbility的config.json配置文件示例如下: ```json { @@ -48,13 +48,13 @@ PageAbility创建成功后,其abilities相关的配置项在config.json中体 ], "orientation": "unspecified", "visible": true, - "srcPath": "MainAbility", - "name": ".MainAbility", + "srcPath": "EntryAbility", + "name": ".EntryAbility", "srcLanguage": "ets", "icon": "$media:icon", - "description": "$string:MainAbility_desc", + "description": "$string:EntryAbility_desc", "formsEnabled": false, - "label": "$string:MainAbility_label", + "label": "$string:EntryAbility_label", "type": "page", "launchType": "singleton" } diff --git a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md index 5cba63d0d4d07151c226feca88fabff0ebc8eb73..7708ceff9d8511cce98c3451c28b84e12cd0b807 100644 --- a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md +++ b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md @@ -1,40 +1,41 @@ # 显式Want与隐式Want匹配规则 - -在启动目标Ability时,会通过显式Want和隐式Want进行目标Ability的匹配,这里说的匹配规则就是调用方Want中设置的参数如何与目标Ability声明的配置文件进行匹配。 - - -- **显式Want匹配原理** - | 名称 | 类型 | 匹配项 | 必选 | 规则 | - | -------- | -------- | -------- | -------- | -------- | - | deviceId | string | 是 | 否 | 留空将仅匹配本设备内Ability。 | - | bundleName | string | 是 | 是 | 如果指定abilityName,而不指定bundleName,则匹配失败。 | - | moduleName | string | 是 | 否 | 留空时当同一个应用内存在多个模块且模块间存在重名Ability,将默认匹配第一个。 | - | abilityName | string | 是 | 是 | 该字段必须设置表示显式匹配。 | - | uri | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | - | type | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | - | action | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | - | entities | Array<string> | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | - | flags | number | 否 | 否 | 不参与匹配,直接传递给系统处理,一般用来设置运行态信息,例如URI数据授权等。 | - | parameters | {[key: string]: any} | 否 | 否 | 不参与匹配,应用自定义数据将直接传递给目标Ability。 | - -- **隐式Want匹配原理** - | 名称 | 类型 | 匹配项 | 必选 | 规则 | - | -------- | -------- | -------- | -------- | -------- | - | deviceId | string | 是 | 否 | 跨设备目前不支持隐式调用。 | - | abilityName | string | 否 | 否 | 该字段必须留空表示隐式匹配。 | - | bundleName | string | 是 | 否 | - 声明bundleName时,隐式搜索将仅限于对应应用包内。
- 声明bundleName与moduleName时,隐式搜索将仅限于对应应用的对应Module内。
- 单独声明moduleName时,该字段无效。
- 同时声明bundleName与moduleName时,隐式搜索将仅限于对应应用包内的对应模块内。
这些字段将用来隐式匹配,具体规则可参考[隐式Want匹配原理详解](#隐式want匹配原理详解)。 | - | moduleName | string | 是 | 否 | - | uri | string | 是 | 否 | - | type | string | 是 | 否 | - | action | string | 是 | 否 | - | entities | Array<string> | 是 | 否 | - | flags | number | 否 | 否 | 不参与匹配,直接传递给系统处理,一般用来设置运行态信息,例如URI数据授权等。 | - | parameters | {[key: string]: any} | 否 | 否 | 不参与匹配,应用自定义数据将直接传递给目标Ability。 | - - -## 隐式Want匹配原理详解 - +在启动目标Ability时,会通过显式Want或者隐式Want进行目标Ability的匹配,这里说的匹配规则就是调用方Want中设置的参数如何与目标Ability声明的配置文件进行匹配。 + +## 显式Want匹配原理 + + +显式Want匹配原理如下表所示。 + +| 名称 | 类型 | 匹配项 | 必选 | 规则 | +| -------- | -------- | -------- | -------- | -------- | +| deviceId | string | 是 | 否 | 留空将仅匹配本设备内Ability。 | +| bundleName | string | 是 | 是 | 如果指定abilityName,而不指定bundleName,则匹配失败。 | +| moduleName | string | 是 | 否 | 留空时当同一个应用内存在多个模块且模块间存在重名Ability,将默认匹配第一个。 | +| abilityName | string | 是 | 是 | 该字段必须设置表示显式匹配。 | +| uri | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | +| type | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | +| action | string | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | +| entities | Array<string> | 否 | 否 | 系统匹配时将忽略该参数,但仍可作为参数传递给目标Ability。 | +| flags | number | 否 | 否 | 不参与匹配,直接传递给系统处理,一般用来设置运行态信息,例如URI数据授权等。 | +| parameters | {[key: string]: any} | 否 | 否 | 不参与匹配,应用自定义数据将直接传递给目标Ability。 | + +## 隐式Want匹配原理 + +隐式Want匹配原理如下表所示。 + +| 名称 | 类型 | 匹配项 | 必选 | 规则 | +| ----------- | ------------------------------ | ------ | ---- | ------------------------------------------------------------ | +| deviceId | string | 是 | 否 | 跨设备目前不支持隐式调用。 | +| abilityName | string | 否 | 否 | 该字段必须留空表示隐式匹配。 | +| bundleName | string | 是 | 否 | - 声明bundleName时,隐式搜索将仅限于对应应用包内。
- 声明bundleName与moduleName时,隐式搜索将仅限于对应应用的对应Module内。
- 单独声明moduleName时,该字段无效。
- 同时声明bundleName与moduleName时,隐式搜索将仅限于对应应用包内的对应模块内。
这些字段将用来隐式匹配。 | +| moduleName | string | 是 | 否 | | +| uri | string | 是 | 否 | | +| type | string | 是 | 否 | | +| action | string | 是 | 否 | | +| entities | Array<string> | 是 | 否 | | +| flags | number | 否 | 否 | 不参与匹配,直接传递给系统处理,一般用来设置运行态信息,例如URI数据授权等。 | +| parameters | {[key: string]: any} | 否 | 否 | 不参与匹配,应用自定义数据将直接传递给目标Ability。 | 从隐式Want的定义,可得知: @@ -59,7 +60,8 @@ - 调用方传入的want参数的action不为空,待匹配Ability的skills配置中的actions不为空且不包含调用方传入的want参数的action,则action匹配失败。 - **图1** want参数的action匹配规则  want-action + **图1** want参数的action匹配规则 + want-action ### want参数的entities匹配规则 diff --git a/zh-cn/application-dev/application-models/start-local-pageability.md b/zh-cn/application-dev/application-models/start-local-pageability.md index 78c46ba3e22b0c0e9df2af3b26f9e7af2406767f..13596b3b575c458ec5f0089b85dd4c515e6b5a5f 100644 --- a/zh-cn/application-dev/application-models/start-local-pageability.md +++ b/zh-cn/application-dev/application-models/start-local-pageability.md @@ -23,7 +23,7 @@ import featureAbility from '@ohos.ability.featureAbility' want: { bundleName: "com.example.myapplication", moduleName: "entry", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "com.example.myapplication.EntryAbility" } } await featureAbility.startAbility(param) diff --git a/zh-cn/application-dev/application-models/start-page.md b/zh-cn/application-dev/application-models/start-page.md index ff276bf674c61d8af9cf1c8170e5f3f9dad258fe..82a42cd354e8cb7b72310eec14994a3c86b4bfc7 100644 --- a/zh-cn/application-dev/application-models/start-page.md +++ b/zh-cn/application-dev/application-models/start-page.md @@ -12,7 +12,7 @@ import featureAbility from '@ohos.ability.featureAbility'; async function restartAbility() { let wantInfo = { bundleName: "com.sample.MyApplication", - abilityName: "MainAbility", + abilityName: "EntryAbility", parameters: { page: "pages/second" } @@ -89,7 +89,7 @@ struct Index { featureAbility.startAbility({ want: { bundleName: "com.exm.myapplication", - abilityName: "com.exm.myapplication.MainAbility", + abilityName: "com.exm.myapplication.EntryAbility", parameters: { page: "pages/page1" } } }).then((data) => { @@ -104,7 +104,7 @@ struct Index { featureAbility.startAbility({ want: { bundleName: "com.exm.myapplication", - abilityName: "com.exm.myapplication.MainAbility", + abilityName: "com.exm.myapplication.EntryAbility", parameters: { page: "pages/page2" } } }).then((data) => { diff --git a/zh-cn/application-dev/application-models/start-pageability-from-stage.md b/zh-cn/application-dev/application-models/start-pageability-from-stage.md index b277fb076b5d815ae5889d43bf6b5f559abf8c72..e5f56c933042ef6a6c8aba5d000e5dde177a20f8 100644 --- a/zh-cn/application-dev/application-models/start-pageability-from-stage.md +++ b/zh-cn/application-dev/application-models/start-pageability-from-stage.md @@ -9,23 +9,23 @@ UIAbility启动PageAbility和UIAbility启动UIAbility的方式完全相同。 ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.info("MainAbility onCreate") + console.info("EntryAbility onCreate") } onDestroy() { - console.info("MainAbility onDestroy") + console.info("EntryAbility onDestroy") } onWindowStageCreate(windowStage) { - console.info("MainAbility onWindowStageCreate") + console.info("EntryAbility onWindowStageCreate") windowStage.loadContent('pages/Index', (err, data) => { // ... }); let want = { bundleName: "com.ohos.fa", - abilityName: "MainAbility", + abilityName: "EntryAbility", }; this.context.startAbility(want).then(() => { console.info('Start Ability successfully.'); @@ -34,13 +34,13 @@ export default class MainAbility extends UIAbility { }); } onWindowStageDestroy() { - console.info("MainAbility onWindowStageDestroy") + console.info("EntryAbility onWindowStageDestroy") } onForeground() { - console.info("MainAbility onForeground") + console.info("EntryAbility onForeground") } onBackground() { - console.info("MainAbility onBackground") + console.info("EntryAbility onBackground") } } ``` @@ -54,23 +54,23 @@ UIAbility通过startAbilityForResult启动PageABility和UIAbility通过startAbil ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.info("MainAbility onCreate") + console.info("EntryAbility onCreate") } onDestroy() { - console.info("MainAbility onDestroy") + console.info("EntryAbility onDestroy") } onWindowStageCreate(windowStage) { - console.info("MainAbility onWindowStageCreate") + console.info("EntryAbility onWindowStageCreate") windowStage.loadContent('pages/Index', (err, data) => { // ... }); let want = { bundleName: "com.ohos.fa", - abilityName: "MainAbility", + abilityName: "EntryAbility", }; this.context.startAbilityForResult(want).then((result) => { console.info('Ability verify result: ' + JSON.stringify(result)); @@ -79,13 +79,13 @@ export default class MainAbility extends UIAbility { }); } onWindowStageDestroy() { - console.info("MainAbility onWindowStageDestroy") + console.info("EntryAbility onWindowStageDestroy") } onForeground() { - console.info("MainAbility onForeground") + console.info("EntryAbility onForeground") } onBackground() { - console.info("MainAbility onBackground") + console.info("EntryAbility onBackground") } } ``` @@ -110,7 +110,7 @@ export default class ServiceExtension extends Extension { console.info("ServiceExtension onRequest") let wantFA = { bundleName: "com.ohos.fa", - abilityName: "MainAbility", + abilityName: "EntryAbility", }; this.context.startAbility(wantFA).then(() => { console.info('Start Ability successfully.'); diff --git a/zh-cn/application-dev/application-models/start-remote-pageability.md b/zh-cn/application-dev/application-models/start-remote-pageability.md index ff06ab31576189bf0630d67fc92a161a546cb7cf..b18afb91464676705d92b1844c53260a45e63a99 100644 --- a/zh-cn/application-dev/application-models/start-remote-pageability.md +++ b/zh-cn/application-dev/application-models/start-remote-pageability.md @@ -101,13 +101,13 @@ function getRemoteDeviceId() { if (typeof dmClass === 'object' && dmClass != null) { let list = dmClass.getTrustedDeviceListSync(); if (typeof (list) == 'undefined' || typeof (list.length) == 'undefined') { - console.info("MainAbility onButtonClick getRemoteDeviceId err: list is null"); + console.info("EntryAbility onButtonClick getRemoteDeviceId err: list is null"); return; } - console.info("MainAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); + console.info("EntryAbility onButtonClick getRemoteDeviceId success:" + list[0].deviceId); return list[0].deviceId; } else { - console.info("MainAbility onButtonClick getRemoteDeviceId err: dmClass is null"); + console.info("EntryAbility onButtonClick getRemoteDeviceId err: dmClass is null"); } } ``` diff --git a/zh-cn/application-dev/application-models/start-uiability-from-fa.md b/zh-cn/application-dev/application-models/start-uiability-from-fa.md index 23c19ae3f0ad2d13d65c1871821633e2897b5cfa..c0c70139d675f8f231ec30d3a18ac3482609949b 100644 --- a/zh-cn/application-dev/application-models/start-uiability-from-fa.md +++ b/zh-cn/application-dev/application-models/start-uiability-from-fa.md @@ -14,7 +14,7 @@ import featureAbility from '@ohos.ability.featureAbility'; let parameter = { "want": { bundleName: "com.ohos.stage", - abilityName: "com.ohos.stage.MainAbility" + abilityName: "com.ohos.stage.EntryAbility" } }; featureAbility.startAbility(parameter).then((code) => { @@ -38,7 +38,7 @@ import featureAbility from '@ohos.ability.featureAbility'; let parameter = { "want": { bundleName: "com.ohos.stage", - abilityName: "com.ohos.stage.MainAbility" + abilityName: "com.ohos.stage.EntryAbility" } }; featureAbility.startAbilityForResult(parameter).then((result) => { @@ -60,7 +60,7 @@ import particleAbility from '@ohos.ability.particleAbility'; let parameter = { "want": { bundleName: "com.ohos.stage", - abilityName: "com.ohos.stage.MainAbility" + abilityName: "com.ohos.stage.EntryAbility" } }; particleAbility.startAbility(parameter).then(() => { diff --git a/zh-cn/application-dev/application-models/widget-development-fa.md b/zh-cn/application-dev/application-models/widget-development-fa.md index d07ae553e7c22972e5decf194786205d4683ee4c..ac15d7988fe28058fc20fa88c384b1570cf589d6 100644 --- a/zh-cn/application-dev/application-models/widget-development-fa.md +++ b/zh-cn/application-dev/application-models/widget-development-fa.md @@ -230,7 +230,7 @@ FA卡片开发,即基于[FA模型](fa-model-development-overview.md)的卡片 "type": "service", "srcLanguage": "ets", "formsEnabled": true, - "formConfigAbility": "ability://com.example.entry.MainAbility", + "formConfigAbility": "ability://com.example.entry.EntryAbility", "forms": [{ "colorMode": "auto", "defaultDimension": "2*2", @@ -431,7 +431,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "com.example.entry.MainAbility", + "abilityName": "com.example.entry.EntryAbility", "params": { "message": "add detail" } @@ -449,8 +449,8 @@ onUpdate(formId) { 2. 如何设置router事件: - action属性值为"router"; - - abilityName为跳转目标的Ability名(支持跳转FA模型的PageAbility组件和Stage模型的UIAbility组件),如目前DevEco创建的FA模型的MainAbility默认名为com.example.entry.MainAbility; - - params为传递给跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如FA模型MainAbility的onCreate生命周期里可以通过featureAbility.getWant()获取到want,然后在其parameters字段下获取到配置的参数; + - abilityName为跳转目标的Ability名(支持跳转FA模型的PageAbility组件和Stage模型的UIAbility组件),如目前DevEco创建的FA模型的UIAbility默认名为com.example.entry.EntryAbility; + - params为传递给跳转目标Ability的自定义参数,可以按需填写。其值可以在目标Ability启动时的want中的parameters里获取。如FA模型EntryAbility的onCreate生命周期里可以通过featureAbility.getWant()获取到want,然后在其parameters字段下获取到配置的参数; 3. 如何设置message事件: - action属性值为"message"; @@ -526,7 +526,7 @@ onUpdate(formId) { "actions": { "routerEvent": { "action": "router", - "abilityName": "com.example.entry.MainAbility", + "abilityName": "com.example.entry.EntryAbility", "params": { "message": "add detail" } diff --git a/zh-cn/application-dev/application-test/arkxtest-guidelines.md b/zh-cn/application-dev/application-test/arkxtest-guidelines.md index f68c9bf5743ec6e5687c372963e2864d653ee4bb..9fc6e8864a31802bb31b0e7a71c39a6aee27d931 100644 --- a/zh-cn/application-dev/application-test/arkxtest-guidelines.md +++ b/zh-cn/application-dev/application-test/arkxtest-guidelines.md @@ -72,7 +72,7 @@ export default function abilityTest() { it('testUiExample',0, async function (done) { console.info("uitest: TestUiExample begin"); //start tested ability - await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{ + await delegator.executeShellCommand('aa start -b com.ohos.uitest -a EntryAbility').then(result =>{ console.info('Uitest, start ability finished:' + result) }).catch(err => { console.info('Uitest, start ability failed: ' + err) @@ -81,7 +81,7 @@ export default function abilityTest() { //check top display ability await delegator.getCurrentTopAbility().then((Ability)=>{ console.info("get top ability"); - expect(Ability.context.abilityInfo.name).assertEqual('MainAbility'); + expect(Ability.context.abilityInfo.name).assertEqual('EntryAbility'); }) done(); }) @@ -119,7 +119,7 @@ export default function abilityTest() { it('testUiExample',0, async function (done) { console.info("uitest: TestUiExample begin"); //start tested ability - await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{ + await delegator.executeShellCommand('aa start -b com.ohos.uitest -a EntryAbility').then(result =>{ console.info('Uitest, start ability finished:' + result) }).catch(err => { console.info('Uitest, start ability failed: ' + err) @@ -128,7 +128,7 @@ export default function abilityTest() { //check top display ability await delegator.getCurrentTopAbility().then((Ability)=>{ console.info("get top ability"); - expect(Ability.context.abilityInfo.name).assertEqual('MainAbility'); + expect(Ability.context.abilityInfo.name).assertEqual('EntryAbility'); }) //ui test code //init uidriver diff --git a/zh-cn/application-dev/connectivity/subscribe-remote-state.md b/zh-cn/application-dev/connectivity/subscribe-remote-state.md index 7ce385d8e16ec68f5eaaef0bad7ca81770f2595f..a0d062634fde09442e14dbdcb351ab58c7656633 100755 --- a/zh-cn/application-dev/connectivity/subscribe-remote-state.md +++ b/zh-cn/application-dev/connectivity/subscribe-remote-state.md @@ -111,7 +111,7 @@ let connect = { }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); class MyDeathRecipient { diff --git a/zh-cn/application-dev/database/database-datashare-guidelines.md b/zh-cn/application-dev/database/database-datashare-guidelines.md index 0e90f11538832fc8e9f046aefa4fa6c29109fac9..b089b78b35a563a822060ce9f0b9acb73e624542 100644 --- a/zh-cn/application-dev/database/database-datashare-guidelines.md +++ b/zh-cn/application-dev/database/database-datashare-guidelines.md @@ -132,7 +132,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其 1. 导入基础依赖包。 ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; import dataShare from '@ohos.data.dataShare'; import dataSharePredicates from '@ohos.data.dataSharePredicates'; ``` @@ -150,7 +150,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其 let dsHelper; let abilityContext; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { abilityContext = this.context; dataShare.createDataShareHelper(abilityContext, dseUri, (err, data)=>{ @@ -185,4 +185,3 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其 console.log("dsHelper delete result: " + data); }); ``` - diff --git a/zh-cn/application-dev/database/database-mdds-guidelines.md b/zh-cn/application-dev/database/database-mdds-guidelines.md index e7fc4461858e6cbe4490ae2bdb131bc99e18533e..fd675ecb1116f6a0259f1e840047e606e30d1654 100644 --- a/zh-cn/application-dev/database/database-mdds-guidelines.md +++ b/zh-cn/application-dev/database/database-mdds-guidelines.md @@ -68,12 +68,12 @@ grantPermission(); // Stage模型 - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; let context = null; function grantPermission() { - class MainAbility extends Ability { + class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { let context = this.context; } @@ -103,9 +103,9 @@ let context = featureAbility.getContext(); // Stage模型获取context - import AbilityStage from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; let context = null; - class MainAbility extends AbilityStage{ + class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } diff --git a/zh-cn/application-dev/database/database-preference-guidelines.md b/zh-cn/application-dev/database/database-preference-guidelines.md index 005155f3ef55643f3fddc9f4b5e7d9921742755f..95d59ac6e21e7c54136e72da7e091bfcff1df1df 100644 --- a/zh-cn/application-dev/database/database-preference-guidelines.md +++ b/zh-cn/application-dev/database/database-preference-guidelines.md @@ -113,10 +113,10 @@ ```ts // 获取context - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; let context = null; let preferences = null; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } diff --git a/zh-cn/application-dev/database/database-relational-guidelines.md b/zh-cn/application-dev/database/database-relational-guidelines.md index a4b72ddf0306ce59332ac78754cf1d493fcb9452..a4fdb811b66e7f370208c7f5c169b25256bbcc13 100644 --- a/zh-cn/application-dev/database/database-relational-guidelines.md +++ b/zh-cn/application-dev/database/database-relational-guidelines.md @@ -219,9 +219,9 @@ ```ts import data_rdb from '@ohos.data.relationalStore' // 获取context - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; let context = null - class MainAbility extends Ability { + class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { context = this.context } @@ -250,7 +250,7 @@ const valueBucket = { "name": "Tom", "age": 18, "salary": 100.5, "blobType": u8 } let insertPromise = rdbStore.insert("test", valueBucket) ``` - + ```js //使用事务插入数据 beginTransaction() @@ -361,7 +361,7 @@ console.log('device=' + device[i] + 'data changed') } } - + try { rdbStore.on('dataChange', data_rdb.SubscribeType.SUBSCRIBE_TYPE_REMOTE, storeObserver) } catch (err) { diff --git a/zh-cn/application-dev/dfx/apprecovery-guidelines.md b/zh-cn/application-dev/dfx/apprecovery-guidelines.md index 515bb3e23c3fcf646e6fe3de63f00509460ae3f8..314c81ca94a34e3e10a0171a99fe08a5815b6960 100644 --- a/zh-cn/application-dev/dfx/apprecovery-guidelines.md +++ b/zh-cn/application-dev/dfx/apprecovery-guidelines.md @@ -82,7 +82,7 @@ export default class MyAbilityStage extends AbilityStage { ### 数据保存和恢复 在使能appRecovery功能后,开发者可以在Ability中采用主动保存状态,主动恢复或者选择被动恢复的方式使用appRecovery功能。 -下面为示例的MainAbility。 +下面为示例的EntryAbility。 #### 导包 @@ -108,7 +108,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant' onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") globalThis.registerObserver = (() => { registerId = errorManager.registerErrorObserver(callback); @@ -120,12 +120,12 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant' - 数据保存 -callback触发appRecovery.saveAppState()调用后,会触发MainAbility的onSaveState(state, wantParams)函数回调。 +callback触发appRecovery.saveAppState()调用后,会触发EntryAbility的onSaveState(state, wantParams)函数回调。 ```ts onSaveState(state, wantParams) { // Ability has called to save app data - console.log("[Demo] MainAbility onSaveState") + console.log("[Demo] EntryAbility onSaveState") wantParams["myData"] = "my1234567"; return AbilityConstant.onSaveResult.ALL_AGREE; } @@ -133,12 +133,12 @@ callback触发appRecovery.saveAppState()调用后,会触发MainAbility的onSav - 数据恢复 -callback触发后appRecovery.restartApp()调用后,应用会重启,重启后会走到MainAbility的onSaveState(state, wantParams)函数,保存的数据会在want参数的parameters里。 +callback触发后appRecovery.restartApp()调用后,应用会重启,重启后会走到EntryAbility的onSaveState(state, wantParams)函数,保存的数据会在want参数的parameters里。 ```ts storage: LocalStorage onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") globalThis.abilityWant = want; if (launchParam.launchReason == AbilityConstant.LaunchReason.APP_RECOVERY) { this.storage = new LocalStorage(); @@ -154,7 +154,7 @@ onCreate(want, launchParam) { ```ts onWindowStageDestroy() { // Main window is destroyed, release UI related resources - console.log("[Demo] MainAbility onWindowStageDestroy") + console.log("[Demo] EntryAbility onWindowStageDestroy") globalThis.unRegisterObserver = (() => { errorManager.unregisterErrorObserver(registerId, (result) => { @@ -169,10 +169,10 @@ onWindowStageDestroy() { 被动保存和恢复依赖恢复框架底层触发,无需注册监听ErrorObserver callback,只需实现Ability的onSaveState接口数据保存和onCreate接口数据恢复流程即可。 ```ts -export default class MainAbility extends Ability { +export default class EntryAbility extends Ability { storage: LocalStorage onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") globalThis.abilityWant = want; if (launchParam.launchReason == AbilityConstant.LaunchReason.APP_RECOVERY) { this.storage = new LocalStorage(); @@ -184,7 +184,7 @@ export default class MainAbility extends Ability { onSaveState(state, wantParams) { // Ability has called to save app data - console.log("[Demo] MainAbility onSaveState") + console.log("[Demo] EntryAbility onSaveState") wantParams["myData"] = "my1234567"; return AbilityConstant.onSaveResult.ALL_AGREE; } diff --git a/zh-cn/application-dev/dfx/errormanager-guidelines.md b/zh-cn/application-dev/dfx/errormanager-guidelines.md index c93a73b14c35d9cfdab8b0081d6890f6889705c3..8baf36b4d1b79e2925e9f6a6e0646abfd762469d 100644 --- a/zh-cn/application-dev/dfx/errormanager-guidelines.md +++ b/zh-cn/application-dev/dfx/errormanager-guidelines.md @@ -36,8 +36,8 @@ ## 开发示例 ```ts -import Ability from '@ohos.application.Ability' -import errorManager from '@ohos.application.errorManager' +import UIAbility from '@ohos.app.ability.UIAbility'; +import errorManager from '@ohos.application.errorManager'; var registerId = -1; var callback = { @@ -46,15 +46,15 @@ var callback = { } } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") registerId = errorManager.registerErrorObserver(callback); globalThis.abilityWant = want; } onDestroy() { - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") errorManager.unregisterErrorObserver(registerId, (result) => { console.log("[Demo] result " + result.code + ";" + result.message) }); @@ -62,7 +62,7 @@ export default class MainAbility extends Ability { onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") windowStage.loadContent("pages/index", (err, data) => { if (err.code) { @@ -75,17 +75,17 @@ export default class MainAbility extends Ability { onWindowStageDestroy() { // Main window is destroyed, release UI related resources - console.log("[Demo] MainAbility onWindowStageDestroy") + console.log("[Demo] EntryAbility onWindowStageDestroy") } onForeground() { // Ability has brought to foreground - console.log("[Demo] MainAbility onForeground") + console.log("[Demo] EntryAbility onForeground") } onBackground() { // Ability has back to background - console.log("[Demo] MainAbility onBackground") + console.log("[Demo] EntryAbility onBackground") } }; ``` \ No newline at end of file diff --git a/zh-cn/application-dev/dfx/hiappevent-guidelines.md b/zh-cn/application-dev/dfx/hiappevent-guidelines.md index fca17846696575ac301b95333524c168a3a3f61e..fb7e0167890edb3be85f44ae3c591b8858f4110c 100644 --- a/zh-cn/application-dev/dfx/hiappevent-guidelines.md +++ b/zh-cn/application-dev/dfx/hiappevent-guidelines.md @@ -49,11 +49,11 @@ HiAppEvent是在系统层面为应用开发者提供的一种事件打点机制 ```js import hilog from '@ohos.hilog'; - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; import Window from '@ohos.window' import hiAppEvent from '@ohos.hiviewdfx.hiAppEvent' - export default class EntryAbility extends Ability { + export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { hilog.isLoggable(0x0000, 'testTag', hilog.LogLevel.INFO); hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate'); diff --git a/zh-cn/application-dev/faqs/faqs-event-notification.md b/zh-cn/application-dev/faqs/faqs-event-notification.md index 8fb2332c1856b23489045e0b087afd1d1708b693..9d9bfe04eb6b10b09d4618c26c4af5d40a7018b5 100644 --- a/zh-cn/application-dev/faqs/faqs-event-notification.md +++ b/zh-cn/application-dev/faqs/faqs-event-notification.md @@ -16,15 +16,15 @@ emitter数据大小限制不超过10240。 示例: -``` +```ts import WantAgent from '@ohos.wantAgent'; async function publishNotification() { let wantAgentInfo = { wants: [ { - bundleName: "com.example.notification", - abilityName: "MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", } ], operationType: WantAgent.OperationType.START_ABILITIES, diff --git a/zh-cn/application-dev/faqs/faqs-graphics.md b/zh-cn/application-dev/faqs/faqs-graphics.md index 61d9981d2befa6ee795700da926e13a84cdec0a6..229d88e8eaee62dc6f72957a982dc06427e8438c 100644 --- a/zh-cn/application-dev/faqs/faqs-graphics.md +++ b/zh-cn/application-dev/faqs/faqs-graphics.md @@ -17,11 +17,11 @@ 适用于:OpenHarmony SDK 3.2.6.3版本,API9 Stage模型 1. 可以在onWindowStageCreate方法获取windowClass对象。 - - ``` + + ```ts onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") windowStage.getMainWindow((err, data) => { if (err.code) { console.error('Failed to obtain the main window.') @@ -34,8 +34,8 @@ ``` 2. 设置窗口全屏,隐藏状态栏。 - - ``` + + ```ts globalThis.windowClass.setFullScreen(isFullScreen, (err, data) => { if (err.code) { console.error('Failed to enable the full-screen mode. Cause:' + JSON.stringify(err)); @@ -53,8 +53,8 @@ 示例: - -``` + +```ts let promise = windowClass.getProperties(); promise.then((data)=> { console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data.windowRect)); @@ -69,8 +69,8 @@ promise.then((data)=> { 参考如下方式实现,示例: - -``` + +```ts window.getTopWindow(globalThis.mainContext).then(win => { var systemBarProperties = { statusBarColor: '#19B6FF', // 状态栏背景颜色 diff --git a/zh-cn/application-dev/faqs/faqs-ui-ets.md b/zh-cn/application-dev/faqs/faqs-ui-ets.md index 9afce454ada67004dc31ec1fb4abc3271c3e1ae8..65d9f47c91cdc8bb2d9c680c03c55723ef4ce133 100644 --- a/zh-cn/application-dev/faqs/faqs-ui-ets.md +++ b/zh-cn/application-dev/faqs/faqs-ui-ets.md @@ -23,7 +23,7 @@ 可以使用Stack堆叠容器,设置子组件在容器内的最底部。 示例: - + ``` build() { Stack({alignContent : Alignment.Bottom}) { @@ -59,7 +59,7 @@ build() { 示例: - + ``` // 弹窗组件 @CustomDialog @@ -144,7 +144,7 @@ GridContainer内子组件默认水平左对齐,居中显示可以参考以下 内部嵌套布局组件Row,设置Row属性justifyContent(FlexAlign.Center),内部嵌套子组件可保持居中显示,参考[栅格布局](../reference/arkui-ts/ts-container-gridcontainer.md)文档。 示例: - + ``` GridContainer({ sizeType: SizeType.SM, columns: 12 }) { Row() { @@ -164,10 +164,10 @@ GridContainer({ sizeType: SizeType.SM, columns: 12 }) { 在加载窗口内容之前,采用systemAvoidAreaChange事件监听。 示例: - -``` -// MainAbility.ts -import window from '@ohos.window'; + +```ts +import Window from '@ohos.window'; +import UIAbility from '@ohos.app.ability.UIAbility'; /** * 设置沉浸式窗口,并获取状态栏和导航栏高度 @@ -187,7 +187,7 @@ async function enterImmersion(mainWindow: window.Window) { statusBarContentColor: "#FF0000" }) } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { // do something async onWindowStageCreate(windowStage: window.WindowStage) { let mainWindow = await windowStage.getMainWindow() @@ -212,8 +212,8 @@ gesture的属性distance默认值是5,把gesture的属性distance设成1就可 示例: - -``` + +```ts Column() { Text(this.value) .backgroundColor(Color.Green).margin(30).fontSize(20) @@ -234,8 +234,8 @@ List组件绑定Scoller控制器,通过currentOffset方式获取当前的滚 示例: - -``` + +```ts Column() { List({ space: 20, initialIndex: 0,scroller: this.scroller}) { ForEach(this.arr, (item) => { @@ -258,8 +258,8 @@ Column() { 适用于:OpenHarmony SDK 3.2.5.5版本,API9 Stage模型 - -``` + +```ts // 3.1.5.5版本之前,取值方式为:router.getParams().key private value: string = router.getParams().value; // 从3.1.6.5版本起,取值方式为:router.getParams()['key'] @@ -296,8 +296,8 @@ lpx相当于百分比视图,按比例扩大或者缩小。 颜色可以使用两种格式,例如 0x7F000000 或者 '\#7F000000' ,其中前两位是透明度,后六位是RGB。 - -``` + +```ts fontColor(0x7F000000) fontColor( '#7F000000' ) ``` @@ -400,7 +400,7 @@ input 组件的 type 设置为 date,只是会有相关格式提示,本质上 示例: - + ``` @Component struct FoodImageDisplay { @@ -504,7 +504,7 @@ Scroll支持单个子组件,子组件高度应由内容高度决定,当内 可以参考如下实现: - + ``` struct Index { @State text: string = 'Hello World' @@ -565,7 +565,7 @@ id添加为唯一值,成为关键字。 代码示例 - + ``` beautySub(str,len) { var reg = /[\u4e00-\u9fa5]/g; @@ -627,7 +627,7 @@ RichText底层是web,可以参考html的语法,在div上加上的overflow: 示例: - + ``` AppStorage.Link('varA') PersistentStorage.PersistProp("varA", "111"); diff --git a/zh-cn/application-dev/file-management/filepicker-guidelines.md b/zh-cn/application-dev/file-management/filepicker-guidelines.md index bdec4e17294d26049beb8d057cbe1eef490cb357..f1ca4197edd1d5690a9ce2d53e1b333321bdade0 100644 --- a/zh-cn/application-dev/file-management/filepicker-guidelines.md +++ b/zh-cn/application-dev/file-management/filepicker-guidelines.md @@ -32,7 +32,7 @@ ArkTS语言示例代码如下: globalThis.context.startAbilityForResult( { bundleName: "com.ohos.filepicker", - abilityName: "MainAbility", + abilityName: "EntryAbility", parameters: { 'startMode': 'choose', //choose or save } @@ -44,7 +44,7 @@ globalThis.context.startAbilityForResult( globalThis.context.startAbilityForResult( { bundleName: "com.ohos.filepicker", - abilityName: "MainAbility", + abilityName: "EntryAbility", parameters: { 'startMode': 'save', //choose or save 'saveFile': 'test.jpg', diff --git a/zh-cn/application-dev/file-management/medialibrary-overview.md b/zh-cn/application-dev/file-management/medialibrary-overview.md index 8bcd3a6a026de2694ee9d62aa64c785c9d299c08..674d3909fccb21c961f9c36a01eca04c099c0f89 100644 --- a/zh-cn/application-dev/file-management/medialibrary-overview.md +++ b/zh-cn/application-dev/file-management/medialibrary-overview.md @@ -72,7 +72,7 @@ var media = mediaLibrary.getMediaLibrary(context); "reason": "$string:reason", "usedScene": { "abilities": [ - "MainAbility" + "EntryAbility" ], "when": "always" } @@ -82,7 +82,7 @@ var media = mediaLibrary.getMediaLibrary(context); "reason": "$string:reason", "usedScene": { "abilities": [ - "MainAbility" + "EntryAbility" ], "when": "always" } @@ -92,7 +92,7 @@ var media = mediaLibrary.getMediaLibrary(context); "reason": "$string:reason", "usedScene": { "abilities": [ - "MainAbility" + "EntryAbility" ], "when": "always" } @@ -105,10 +105,10 @@ var media = mediaLibrary.getMediaLibrary(context); 2. 调用requestPermissionsFromUser进行权限校验,可以选择需要动态申请获取的权限。 ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; import abilityAccessCtrl from '@ohos.abilityAccessCtrl.d.ts'; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { var permissions=['ohos.permission.READ_MEDIA','ohos.permission.WRITE_MEDIA'] var permissionRequestResult; diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md index 9f7df6a329a9c265a255b9bbdd0256b6a5a8e14b..3e3beb9373545f350855ca53f32e68b5e6e97c1d 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md @@ -47,24 +47,25 @@ OpenHarmony提供了多种方法,判断应用当前处于何种断点,进而 1. 在Ability的[onWindowStageCreate](../../application-models/uiability-lifecycle.md)生命周期回调中,获取并记录[窗口](../../reference/apis/js-apis-window.md)对象。 - ``` - // MainAbility.ts - import window from '@ohos.window' + ```ts + // EntryAbility.ts + import Window from '@ohos.window'; + import UIAbility from '@ohos.app.ability.UIAbility'; - export default class MainAbility extends Ability { - ... + export default class EntryAbility extends UIAbility { + // ... onWindowStageCreate(windowStage) { window.getTopWindow(this.context).then((windowObj) => { AppStorage.SetOrCreate('windowObj', windowObj) }) } - ... + // ... } ``` - + 2. 在页面中,通过窗口对象获取启动时的应用窗口宽度,同时注册回调函数监听窗口尺寸变化。 - ``` + ```ts @Entry @Component struct Index { @@ -145,7 +146,7 @@ OpenHarmony提供了多种方法,判断应用当前处于何种断点,进而 -``` +```ts // common/breakpointsystem.ets // 对通过媒体查询监听断点的功能做简单的封装,方便后续使用 import mediaquery from '@ohos.mediaquery'; @@ -303,7 +304,7 @@ struct MediaQuerySample { ![window3](figures/window3.gif) -``` +```ts @Entry @Component struct GridRowSample1 { @@ -337,7 +338,7 @@ struct GridRowSample1 { ![component](figures/component.gif) -``` +```ts @Entry @Component struct GridRowSample2 { @@ -403,7 +404,7 @@ struct GridRowSample2 { -``` +```ts @Entry @Component struct GridRowSample3 { @@ -440,7 +441,7 @@ struct GridRowSample3 { -``` +```ts @Entry @Component struct GridRowSample4 { @@ -515,7 +516,7 @@ struct GridRowSample4 { -``` +```ts @Entry @Component struct GridRowSample5 { @@ -557,7 +558,7 @@ struct GridRowSample5 { -``` +```ts @Entry @Component struct GridRowSample6 { @@ -599,7 +600,7 @@ struct GridRowSample6 { -``` +```ts @Entry @Component struct GridRowSample7 { @@ -641,7 +642,7 @@ struct GridRowSample7 { -``` +```ts @Entry @Component struct GridRowSample8 { @@ -684,7 +685,7 @@ struct GridRowSample8 { | ![zh-cn_image_0000001336338670](figures/zh-cn_image_0000001336338670.jpg) | ![zh-cn_image_0000001336019094](figures/zh-cn_image_0000001336019094.jpg) | ![zh-cn_image_0000001336498646](figures/zh-cn_image_0000001336498646.jpg) | -``` +```ts @Entry @Component struct GridRowSample9 { diff --git a/zh-cn/application-dev/media/avsession-guidelines.md b/zh-cn/application-dev/media/avsession-guidelines.md index 033df56f572263677db7fb6e71b1736d881c093f..96e7ce8701a43e4d4b31abbdf63c608d06344b8f 100644 --- a/zh-cn/application-dev/media/avsession-guidelines.md +++ b/zh-cn/application-dev/media/avsession-guidelines.md @@ -87,7 +87,7 @@ let wantAgentInfo = { wants: [ { bundleName: "com.neu.setResultOnAbilityResultTest1", - abilityName: "com.example.test.MainAbility", + abilityName: "com.example.test.EntryAbility", } ], operationType: wantAgent.OperationType.START_ABILITIES, diff --git a/zh-cn/application-dev/notification/notification-enable.md b/zh-cn/application-dev/notification/notification-enable.md index 2e1e5d21ae4bc64b81911195a38501dc50ef2676..9546e460debbb166224d8c2994e785e90f26c6e4 100644 --- a/zh-cn/application-dev/notification/notification-enable.md +++ b/zh-cn/application-dev/notification/notification-enable.md @@ -3,7 +3,7 @@ 应用需要开启通知开关才能发送通知。开发者可以在通知发布前调用[requestEnableNotification()](../reference/apis/js-apis-notificationManager.md#notificationrequestenablenotification)方法,弹窗让用户选择是否开启使能开关,仅弹窗一次,后续调用该接口不再弹窗。 - **图1** 使能通知开关示意图 + **图1** 使能通知开关示意图 ![zh-cn_image_0000001416585590](figures/zh-cn_image_0000001416585590.png) diff --git a/zh-cn/application-dev/notification/notification-subscription.md b/zh-cn/application-dev/notification/notification-subscription.md index 9b4e787b50dc5033357959a5cf4f965327171bc1..e8200f3e3f42163ca3bbe6c0268a461818977d42 100644 --- a/zh-cn/application-dev/notification/notification-subscription.md +++ b/zh-cn/application-dev/notification/notification-subscription.md @@ -20,17 +20,16 @@ **表2** 通知订阅回调接口介绍 -| | | -| -------- | -------- | | **接口名** | **描述** | -| onConsume?:(data: SubscribeCallbackData) => void | 通知回调。 | -| onCancel?:(data: SubscribeCallbackData) => void | 通知取消回调。 | -| onUpdate?:(data: NotificationSortingMap) => void | 通知排序更新回调。 | -| onConnect?:() => void; | 订阅成功回调。 | -| onDisconnect?:() => void; | 取消订阅回调。 | -| onDestroy?:() => void | 与通知子系统断开回调。 | +| -------- | -------- | +| onConsume?:(data: SubscribeCallbackData) => void | 通知回调。 | +| onCancel?:(data: SubscribeCallbackData) => void | 通知取消回调。 | +| onUpdate?:(data: NotificationSortingMap) => void | 通知排序更新回调。 | +| onConnect?:() => void; | 订阅成功回调。 | +| onDisconnect?:() => void; | 取消订阅回调。 | +| onDestroy?:() => void | 与通知子系统断开回调。 | | onDoNotDisturbDateChange?:(mode: notification.DoNotDisturbDate) => void | 免打扰时间选项变更回调。 | -| onEnabledNotificationChanged?:(callbackData: EnabledNotificationCallbackData) => void | 通知开关变更回调。 | +| onEnabledNotificationChanged?:(callbackData: EnabledNotificationCallbackData) => void | 通知开关变更回调。 | ## 开发步骤 @@ -40,7 +39,7 @@ 2. 导入通知订阅模块。 ```ts - import NotificationSubscribe from '@ohos.notificationSubscribe'; + import notificationSubscribe from '@ohos.notificationSubscribe'; ``` 3. 创建订阅者对象。 @@ -73,7 +72,7 @@ 4. 发起通知订阅。 ```ts - NotificationSubscribe.subscribe(subscriber, (err, data) => { // callback形式调用异步接口 + notificationSubscribe.subscribe(subscriber, (err, data) => { // callback形式调用异步接口 if (err) { console.error(`[ANS] failed to subscribe, error[${err}]`); return; diff --git a/zh-cn/application-dev/notification/progress-bar-notification.md b/zh-cn/application-dev/notification/progress-bar-notification.md index 961753fc84383ab679aa679194e47a59d6a30a84..01eedfb58f824baa69782d3f04767b44221a7c8b 100644 --- a/zh-cn/application-dev/notification/progress-bar-notification.md +++ b/zh-cn/application-dev/notification/progress-bar-notification.md @@ -12,9 +12,8 @@ [isSupportTemplate()](../reference/apis/js-apis-notificationManager.md#notificationissupporttemplate)是查询模板是否支持接口,目前仅支持进度条模板。 -| | | -| -------- | -------- | | **接口名** | **描述** | +| -------- | -------- | | isSupportTemplate(templateName: string, callback: AsyncCallback<boolean>): void | 查询模板是否存在。 | diff --git a/zh-cn/application-dev/notification/text-notification.md b/zh-cn/application-dev/notification/text-notification.md index e1f8e3f6b8ca8e2d1fa913d0cb4bccc5375d467f..be0bf2f4ecad5043119fd6a8ab79f860eae5499d 100644 --- a/zh-cn/application-dev/notification/text-notification.md +++ b/zh-cn/application-dev/notification/text-notification.md @@ -16,8 +16,8 @@ 目前系统仅通知栏订阅了通知,将通知显示在通知栏里。基础类型通知呈现效果示意图如下所示。 - - **图1** 基础类型通知呈现效果示意图  ![zh-cn_image_0000001466462305](figures/zh-cn_image_0000001466462305.png) +**图1** 基础类型通知呈现效果示意图 +![zh-cn_image_0000001466462305](figures/zh-cn_image_0000001466462305.png) ## 接口说明 @@ -66,8 +66,7 @@ }); ``` - 运行效果如下图所示。 - + 运行效果如下图所示。 ![zh-cn_image_0000001466782033](figures/zh-cn_image_0000001466782033.png) - 长文本类型通知继承了普通文本类型的字段,同时新增了长文本内容、内容概要和通知展开时的标题,其中长文本内容不超过1024字节,其他字段小于200字节。通知默认显示与普通文本相同,展开后,标题显示为展开后标题内容,内容为长文本内容。 @@ -97,7 +96,7 @@ }); ``` - 运行效果如下图所示。 + 运行效果如下图所示。 ![zh-cn_image_0000001416745530](figures/zh-cn_image_0000001416745530.png) - 多行文本类型通知继承了普通文本类型的字段,同时新增了多行文本内容、内容概要和通知展开时的标题,其字段均小于200字节。通知默认显示与普通文本相同,展开后,标题显示为展开后标题内容,多行文本内容多行显示。 @@ -126,7 +125,7 @@ }); ``` - 运行效果如下图所示。 + 运行效果如下图所示。 ![zh-cn_image_0000001417062446](figures/zh-cn_image_0000001417062446.png) - 图片类型通知继承了普通文本类型的字段,同时新增了图片内容、内容概要和通知展开时的标题,图片内容为PixelMap型对象,其大小不能超过2M。 @@ -136,14 +135,14 @@ id: 1, content: { contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_PICTURE, - picture: { - title: 'test_title', - text: 'test_text', - additionalText: 'test_additionalText', - briefText: 'test_briefText', - expandedTitle: 'test_expandedTitle', - picture: notificationPicture - } + picture: { + title: 'test_title', + text: 'test_text', + additionalText: 'test_additionalText', + briefText: 'test_briefText', + expandedTitle: 'test_expandedTitle', + picture: notificationPicture + } } } @@ -157,5 +156,5 @@ }); ``` - 运行效果如下图所示。 + 运行效果如下图所示。 ![zh-cn_image_0000001466582045](figures/zh-cn_image_0000001466582045.png) 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 7db321a4cfce86759db2e2fca0218fa735c5aefc..449b54e6ed40176171c1eba58da09524a2e86099 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 @@ -49,7 +49,7 @@ config.json示例: ], "commonEvents": [ { - "name": ".MainAbility", + "name": ".EntryAbility", "permission": "ohos.permission.GET_BUNDLE_INFO", "data": [ "com.example.demo", diff --git a/zh-cn/application-dev/quick-start/arkts-state-mgmt-application-level.md b/zh-cn/application-dev/quick-start/arkts-state-mgmt-application-level.md index 3a08b7c244d07db9ce87bfb28fef11600067da38..5858c2bf275f2dd2c2907328ffec91b418d6a26b 100644 --- a/zh-cn/application-dev/quick-start/arkts-state-mgmt-application-level.md +++ b/zh-cn/application-dev/quick-start/arkts-state-mgmt-application-level.md @@ -102,20 +102,19 @@ Ability:一个应用程序可以拥有多个Ability,一个Ability中的所 LocalStorage通过loadContent接口加载,接口说明详见[loadContent](../reference/apis/js-apis-window.md#loadcontent9-1)。 ```ts -// MainAbility.ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { storage: LocalStorage onCreate() { this.storage = new LocalStorage() this.storage.setOrCreate('storageSimpleProp', 121) - console.info('[Demo MainAbility onCreate]') + console.info('[Demo EntryAbility onCreate]') } onDestroy() { - console.info('[Demo MainAbility onDestroy]') + console.info('[Demo EntryAbility onDestroy]') } onWindowStageCreate(windowStage) { @@ -124,15 +123,15 @@ export default class MainAbility extends Ability { } onWindowStageDestroy() { - console.info('[Demo] MainAbility onWindowStageDestroy') + console.info('[Demo] EntryAbility onWindowStageDestroy') } onForeground() { - console.info('[Demo] MainAbility onForeground') + console.info('[Demo] EntryAbility onForeground') } onBackground() { - console.info('[Demo] MainAbility onBackground') + console.info('[Demo] EntryAbility onBackground') } } ``` diff --git a/zh-cn/application-dev/quick-start/module-structure.md b/zh-cn/application-dev/quick-start/module-structure.md index ad3e2a44550c343fcb2068e996cd31d6f26f26c0..a47a7d713b20b99d305987c3a40edf169d053337 100644 --- a/zh-cn/application-dev/quick-start/module-structure.md +++ b/zh-cn/application-dev/quick-start/module-structure.md @@ -30,7 +30,7 @@ module示例: ```json { "module": { - "mainAbility": ".MainAbility", + "mainAbility": ".EntryAbility", "deviceType": [ "default", "tablet" @@ -49,8 +49,8 @@ module示例: ], "orientation": "unspecified", "visible": true, - "srcPath": "MainAbility", - "name": ".MainAbility", + "srcPath": "EntryAbility", + "name": ".EntryAbility", "srcLanguage": "ets", "icon": "$media:icon", "description": "$string:MainAbility_desc", @@ -78,7 +78,7 @@ module示例: "pages": [ "pages/Index" ], - "name": ".MainAbility", + "name": ".EntryAbility", "window": { "designWidth": 720, "autoDesignWidth": false @@ -181,7 +181,7 @@ metadata对象示例: | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | | process | 运行应用程序或Ability的进程名称。如果在deviceConfig标记中配置了进程,则应用程序的所有能力都在此进程中运行。您还可以为特定能力设置流程属性,以便该能力可以在此流程中运行。如果此属性设置为与其他应用程序相同的进程名称,则所有这些应用程序可以在同一进程中运行,前提是他们具有相同的联合用户ID和相同的签名。该标签最大字节数为31个字节。 | 字符串 | 可缺省,缺省值为空。 | -| name | 标识Ability名称。取值可采用反向域名方式表示,由包名和类名组成,如"com.example.myapplication.MainAbility";也可采用"."开头的类名方式表示,如".MainAbility"。
Ability的名称,需在一个应用的范围内保证唯一。说明:在使用DevEco Studio新建项目时,默认生成首个Ability的配置,即"config.json"中"MainAbility"的配置。如使用其他IDE工具,可自定义名称。该标签最大长度为127个字节。 | 字符串 | 不可缺省 | +| name | 标识Ability名称。取值可采用反向域名方式表示,由包名和类名组成,如"com.example.myapplication.EntryAbility";也可采用"."开头的类名方式表示,如".EntryAbility"。
Ability的名称,需在一个应用的范围内保证唯一。说明:在使用DevEco Studio新建项目时,默认生成首个Ability的配置,即"config.json"中"EntryAbility"的配置。如使用其他IDE工具,可自定义名称。该标签最大长度为127个字节。 | 字符串 | 不可缺省 | | description | 标识对Ability的描述。取值可以是描述性内容,也可以是对描述性内容的资源索引,以支持多语言。该标签最大长度为255个字节。 | 字符串 | 可缺省,缺省值为空。 | | icon | 标识Ability图标资源文件的索引。取值示例:$media:ability_icon。如果在该Ability的skills属性中,actions的取值包含 "action.system.home",entities取值中包含"entity.system.home",则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability,则取位置靠前的Ability的icon作为应用的icon。
说明:应用的"icon"和"label"是用户可感知配置项,需要区别于当前所有已有的应用"icon"或"label"(至少有一个不同)。 | 字符串 | 可缺省,缺省值为空。 | | label | 标识Ability对用户显示的名称。取值可以是Ability名称,也可以是对该名称的资源索引,以支持多语言。如果在该Ability的skills属性中,actions的取值包含 "action.system.home",entities取值中包含"entity.system.home",则该Ability的label将同时作为应用的label。如果存在多个符合条件的Ability,则取位置靠前的Ability的label作为应用的label。
说明: 应用的"icon"和"label"是用户可感知配置项,需要区别于当前所有已有的应用"icon"或"label"(至少有一个不同)。该标签为资源文件中定义的字符串的引用,或以"{}"包括的字符串。该标签最大长度为255个字节。 | 字符串 | 可缺省,缺省值为空。 | @@ -223,7 +223,7 @@ abilities示例: ```json "abilities": [ { - "name": ".MainAbility", + "name": ".EntryAbility", "description": "test main ability", // $media:ic_launcher 为媒体类资源 "icon": "$media:ic_launcher", @@ -419,7 +419,7 @@ shortcuts示例: "intents": [ { "targetBundle": "com.example.world.test", - "targetClass": "com.example.world.test.entry.MainAbility" + "targetClass": "com.example.world.test.entry.EntryAbility" } ] } @@ -494,7 +494,7 @@ forms示例: "portraitLayouts": [ "$layout:ability_form" ], - "formConfigAbility": "ability://com.example.myapplication.fa/.MainAbility", + "formConfigAbility": "ability://com.example.myapplication.fa/.EntryAbility", "metaData": { "customizeData": [ { @@ -596,7 +596,7 @@ commonEvents示例: ```json "commonEvents": [ { - "name": ".MainAbility", + "name": ".EntryAbility", "permission": "ohos.permission.GET_BUNDLE_INFO", "data": [ "com.example.demo", 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 a5b4fafbe11ee2f2e2aed694e5b26bc8f45d151f..4b9d2ab5077ce660f7240f245c8512ba2d11e24f 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-Bundle.md +++ b/zh-cn/application-dev/reference/apis/js-apis-Bundle.md @@ -721,7 +721,7 @@ let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => { @@ -1042,7 +1042,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityInfo(bundleName, abilityName) .then((data) => { console.info('Operation successful. Data: ' + JSON.stringify(data)); @@ -1081,7 +1081,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityInfo(bundleName, abilityName, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); @@ -1126,7 +1126,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityLabel(bundleName, abilityName) .then((data) => { console.info('Operation successful. Data: ' + JSON.stringify(data)); @@ -1165,7 +1165,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityLabel(bundleName, abilityName, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); @@ -1203,7 +1203,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{ bundle.isAbilityEnabled(abilityInfo).then((data) => { console.info('Operation successful. Data: ' + JSON.stringify(data)); @@ -1236,7 +1236,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{ bundle.isAbilityEnabled(abilityInfo, (err, data) => { if (err) { @@ -1355,7 +1355,7 @@ let bundleFlags = 0; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; bundle.queryAbilityByWant(want, bundleFlags, userId) .then((data) => { @@ -1401,7 +1401,7 @@ let bundleFlags = 0; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) => { if (err) { @@ -1444,7 +1444,7 @@ SystemCapability.BundleManager.BundleFramework let bundleFlags = 0; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; bundle.queryAbilityByWant(want, bundleFlags, (err, data) => { if (err) { @@ -1635,7 +1635,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityIcon(bundleName, abilityName) .then((data) => { console.info('Operation successful. Data: ' + JSON.stringify(data)); @@ -1675,7 +1675,7 @@ SystemCapability.BundleManager.BundleFramework ```ts let bundleName = "com.example.myapplication"; -let abilityName = "com.example.myapplication.MainAbility"; +let abilityName = "EntryAbility"; bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md index e3420b6481596dcbd0db3ad2e7cc22cf2c68225e..ac466f330f74b1a43c047e7cb92fe8fc713704fa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-context.md @@ -14,10 +14,10 @@ AbilityContext模块提供允许访问特定Ability的资源的能力,包括 在使用AbilityContext的功能前,需要通过Ability子类实例获取。 ```ts -import Ability from '@ohos.app.ability.UIAbility'; +import UIAbility from '@ohos.app.ability.UIAbility'; - let context = undefined; -class MainAbility extends Ability { +let context = undefined; +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { context = this.context; } @@ -66,7 +66,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void; ```ts var want = { - bundleName: "com.example.myapp", + bundleName: "com.example.myapplication", abilityName: "MyAbility" }; @@ -123,8 +123,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var options = { windowMode: 0 @@ -186,7 +186,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; ```ts var want = { - bundleName: "com.example.myapp", + bundleName: "com.example.myapplication", abilityName: "MyAbility" }; var options = { @@ -245,8 +245,8 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -302,8 +302,8 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var options = { windowMode: 0, @@ -368,7 +368,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes ```ts var want = { - bundleName: "com.example.myapp", + bundleName: "com.example.myapplication", abilityName: "MyAbility" }; var options = { @@ -431,8 +431,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -495,8 +495,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -567,8 +567,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -623,8 +623,8 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -674,8 +674,8 @@ startServiceExtensionAbility(want: Want): Promise\; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -729,8 +729,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -784,8 +784,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -836,8 +836,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -893,8 +893,8 @@ stopServiceExtensionAbility(want: Want): Promise\; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -954,8 +954,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -1015,8 +1015,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -1272,8 +1272,8 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var options = { onConnect(elementName, remote) { console.log('----------- onConnect -----------') }, @@ -1331,8 +1331,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -1488,7 +1488,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantBackground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }; @@ -1519,7 +1519,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantForeground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "", parameters: { "ohos.aafwk.param.callAbilityToForeground": true @@ -1582,8 +1582,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -1645,8 +1645,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -1710,8 +1710,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { 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 b72f6811ec3023592cccd4eabb0ea5f08cf599a9..c78473d692056a2925c7f9221ba313e29c25cd5b 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 @@ -53,7 +53,7 @@ particleAbility.startAbility( flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, deviceId: "", bundleName: "com.example.Data", - abilityName: "com.example.Data.MainAbility", + abilityName: "EntryAbility", uri: "" }, }, @@ -104,7 +104,7 @@ particleAbility.startAbility( flags: wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, deviceId: "", bundleName: "com.example.Data", - abilityName: "com.example. Data.MainAbility", + abilityName: "EntryAbility", uri: "" }, }, @@ -238,7 +238,7 @@ let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -299,7 +299,7 @@ let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md index a32e9767651e5819fd88ef07e2f8da056a904a08..b42b6ac2f0a5b7303dc9143c1f4741b0310a33a0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md @@ -122,8 +122,8 @@ class MyAbility extends UIAbility { ```ts let want = { - bundleName: "com.test.example", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; let option = { windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md index 3fb88dfc5eba562d52fa0ed6da2435ef42961d95..a55ac9b04c8f52056aecb80caec6534b2958ecba 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md @@ -49,8 +49,8 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let want = { - bundleName: "com.ohos.example", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; abilityDelegator.startAbility(want, (err) => { if (err.code !== 0) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md index e9a72a8ded6a66c493007249dd66dd7073ed7f48..8eb3864949618b18eca6178966ebe0e91862fcce 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md @@ -58,9 +58,9 @@ var listener = { var listenerId = -1; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate"); + console.log("[Demo] EntryAbility onCreate"); globalThis.abilityWant = want; globalThis.context = this.context; } @@ -75,12 +75,12 @@ export default class MainAbility extends UIAbility { } catch (paramError) { console.log("error: " + paramError.code + ", " + paramError.message); } - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") } onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") try { listenerId = missionManager.on("mission", listener); } catch (paramError) { @@ -140,9 +140,9 @@ var listener = { var listenerId = -1; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") globalThis.abilityWant = want; globalThis.context = this.context; } @@ -157,12 +157,12 @@ export default class MainAbility extends UIAbility { } catch (paramError) { console.log("error: " + paramError.code + ", " + paramError.message); } - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") } onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") try { listenerId = missionManager.on("mission", listener); } catch (paramError) { @@ -227,9 +227,9 @@ var listener = { var listenerId = -1; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate") + console.log("[Demo] EntryAbility onCreate") globalThis.abilityWant = want; globalThis.context = this.context; } @@ -244,12 +244,12 @@ export default class MainAbility extends UIAbility { } catch (paramError) { console.log("error: " + paramError.code + ", " + paramError.message); } - console.log("[Demo] MainAbility onDestroy") + console.log("[Demo] EntryAbility onDestroy") } onWindowStageCreate(windowStage) { // Main window is created, set main page for this ability - console.log("[Demo] MainAbility onWindowStageCreate") + console.log("[Demo] EntryAbility onWindowStageCreate") try { listenerId = missionManager.on("mission", listener); } catch (paramError) { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md index 5f345d559ef34c5f33f55f2b7f103db8a45a6136..cf1636ce99912c031e86fdfb0b9e627f9f069388 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md @@ -64,8 +64,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -159,8 +159,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -247,8 +247,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -357,8 +357,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -459,8 +459,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -569,8 +569,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -671,8 +671,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -783,8 +783,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -884,8 +884,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -994,8 +994,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -1098,8 +1098,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -1205,8 +1205,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -1318,8 +1318,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -1418,8 +1418,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -1526,8 +1526,8 @@ let wantAgentInfo = { wants: [ { deviceId: 'deviceId', - bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', 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 14eeb6d2468387d894fdf7d6974265b8e0ba3278..7da6408723c082cb55b1ac93762a3b548df0e311 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 @@ -15,7 +15,7 @@ Ability模块提供对Ability生命周期、上下文环境等调用管理的能 ## 导入模块 ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; ``` ## 属性 @@ -47,7 +47,7 @@ Ability创建时回调,执行初始化业务逻辑操作。 **示例:** ```ts - class myAbility extends Ability { + export default class EntryAbility extends UIAbility { onCreate(want, param) { console.log('onCreate, want:' + want.abilityName); } @@ -389,8 +389,9 @@ call(method: string, data: rpc.Sequenceable): Promise<void>; **示例:** ```ts - import Ability from '@ohos.application.Ability'; - class MyMessageAble{ // 自定义的Sequenceable数据结构 + import UIAbility from '@ohos.app.ability.UIAbility'; + + class MyMessageAble { // 自定义的Sequenceable数据结构 name:"" str:"" num: 1 @@ -413,11 +414,11 @@ call(method: string, data: rpc.Sequenceable): Promise<void>; }; var method = 'call_Function'; // 约定的通知消息字符串 var caller; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { this.context.startAbilityByCall({ bundleName: "com.example.myservice", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }).then((obj) => { caller = obj; @@ -473,7 +474,8 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessagePa **示例:** ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; + class MyMessageAble{ name:"" str:"" @@ -497,11 +499,11 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessagePa }; var method = 'call_Function'; var caller; - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { this.context.startAbilityByCall({ bundleName: "com.example.myservice", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }).then((obj) => { caller = obj; @@ -544,14 +546,17 @@ release(): void; **示例:** + ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; + var caller; - export default class MainAbility extends Ability { + + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { this.context.startAbilityByCall({ bundleName: "com.example.myservice", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }).then((obj) => { caller = obj; @@ -586,13 +591,15 @@ release(): void; **示例:** ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; + var caller; - export default class MainAbility extends Ability { + + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { this.context.startAbilityByCall({ bundleName: "com.example.myservice", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }).then((obj) => { caller = obj; @@ -643,7 +650,7 @@ on(method: string, callback: CalleeCallBack): void; **示例:** ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; class MyMessageAble{ name:"" str:"" @@ -672,7 +679,7 @@ on(method: string, callback: CalleeCallBack): void; pdata.readSequenceable(msg); return new MyMessageAble("test1", "Callee test"); } - export default class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { console.log('Callee onCreate is called'); try { @@ -711,9 +718,11 @@ off(method: string): void; **示例:** ```ts - import Ability from '@ohos.application.Ability'; + import UIAbility from '@ohos.app.ability.UIAbility'; + var method = 'call_Function'; - export default class MainAbility extends Ability { + + export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { console.log('Callee onCreate is called'); try { 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 9ce0e705dc901490a240cd23e44e79c1b56a5e24..0af24476df9124f9eb096738e48ef51172eb8af5 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 @@ -29,10 +29,10 @@ import Configuration from '@ohos.application.Configuration' ```ts import hilog from '@ohos.hilog'; -import Ability from '@ohos.application.Ability' -import Window from '@ohos.window' +import UIAbility from '@ohos.app.ability.UIAbility'; +import Window from '@ohos.window'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { } diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-environmentCallback.md b/zh-cn/application-dev/reference/apis/js-apis-application-environmentCallback.md index 10d9df8fce75d0821ccf125c0e34a3559f45d1db..d64165b09cd34581f2caed1e833b5aba949e99e5 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-application-environmentCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-environmentCallback.md @@ -46,11 +46,11 @@ onMemoryLevel(level: number): void; **示例:** ```ts -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var callbackId; -export default class MyAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate() { console.log("MyAbility onCreate") globalThis.applicationContext = this.context.getApplicationContext(); 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 79e7c66ecdf85f36bc9d039cd78bea02188481bc..8ad2d331ceba9d768ccb249ce1f44b043e69b72e 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 @@ -36,8 +36,8 @@ import Want from '@ohos.application.Want'; ```ts let want = { "deviceId": "", // deviceId为空表示本设备 - "bundleName": "com.extreme.test", - "abilityName": "MainAbility", + "bundleName": "com.example.myapplication", + "abilityName": "EntryAbility", "moduleName": "entry" // moduleName非必选 }; this.context.startAbility(want, (error) => { @@ -51,8 +51,8 @@ import Want from '@ohos.application.Want'; * 字符串(String) ```ts let want = { - bundleName: "com.example.demo", - abilityName: "com.example.demo.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", parameters: { keyForString: "str", }, @@ -61,8 +61,8 @@ import Want from '@ohos.application.Want'; * 数字(Number) ```ts let want = { - bundleName: "com.example.demo", - abilityName: "com.example.demo.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", parameters: { keyForInt: 100, keyForDouble: 99.99, @@ -72,8 +72,8 @@ import Want from '@ohos.application.Want'; * 布尔(Boolean) ```ts let want = { - bundleName: "com.example.demo", - abilityName: "com.example.demo.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", parameters: { keyForBool: true, }, @@ -82,8 +82,8 @@ import Want from '@ohos.application.Want'; * 对象(Object) ```ts let want = { - bundleName: "com.example.demo", - abilityName: "com.example.demo.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", parameters: { keyForObject: { keyForObjectString: "str", @@ -97,8 +97,8 @@ import Want from '@ohos.application.Want'; * 数组(Array) ```ts let want = { - bundleName: "com.example.demo", - abilityName: "com.example.demo.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", parameters: { keyForArrayString: ["str1", "str2", "str3"], keyForArrayInt: [100, 200, 300, 400], @@ -118,8 +118,8 @@ import Want from '@ohos.application.Want'; } let want = { "deviceId": "", // deviceId为空表示本设备 - "bundleName": "com.extreme.test", - "abilityName": "MainAbility", + "bundleName": "com.example.myapplication", + "abilityName": "EntryAbility", "moduleName": "entry", // moduleName非必选 "parameters": { "keyFd":{"type":"FD", "value":fd} 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 8638970758f2703100c3db6a9a7d33fd7974361b..3e9151bbabc6961cfd85f93a4605ec6cfa7a544d 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-avsession.md +++ b/zh-cn/application-dev/reference/apis/js-apis-avsession.md @@ -1008,8 +1008,8 @@ let wantAgentInfo = { wants: [ { deviceId: "deviceId", - bundleName: "com.neu.setResultOnAbilityResultTest1", - abilityName: "com.example.test.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", action: "action1", entities: ["entity1"], type: "MIMETYPE", @@ -1073,8 +1073,8 @@ let wantAgentInfo = { wants: [ { deviceId: "deviceId", - bundleName: "com.neu.setResultOnAbilityResultTest1", - abilityName: "com.example.test.MainAbility", + bundleName: "com.example.myapplication", + abilityName: "EntryAbility", action: "action1", entities: ["entity1"], type: "MIMETYPE", 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 b89e4400faec9c90601181d933e120a1a094e638..19b83a579091657f576b373ee1ecc3d75dccea02 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md @@ -187,7 +187,7 @@ let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -205,7 +205,7 @@ wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { Stage模型示例: ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; import wantAgent from '@ohos.wantAgent'; @@ -217,13 +217,13 @@ function callback(err, data) { } } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -276,7 +276,7 @@ let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -297,17 +297,17 @@ wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { Stage模型示例: ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; import wantAgent from '@ohos.wantAgent'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -365,7 +365,7 @@ backgroundTaskManager.stopBackgroundRunning(featureAbility.getContext(), callbac Stage模型示例: ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; function callback(err, data) { @@ -376,7 +376,7 @@ function callback(err, data) { } } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { backgroundTaskManager.stopBackgroundRunning(this.context, callback); } @@ -422,10 +422,10 @@ backgroundTaskManager.stopBackgroundRunning(featureAbility.getContext()).then(() Stage模型示例: ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.backgroundTaskManager'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { backgroundTaskManager.stopBackgroundRunning(this.context).then(() => { console.info("Operation stopBackgroundRunning succeeded"); 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 c0d953dfd155000f859be1ad24b5d2fc1ecf1a5b..15103ae6cd763d2b54bb4c11955df34ad1be5325 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 @@ -188,8 +188,8 @@ bundle.getBundleInstaller().then(installer => { **示例:** ``` ts // Stage模型 -import Ability from '@ohos.application.Ability'; -class MainAbility extends Ability { +import UIAbility from '@ohos.app.ability.UIAbility'; +export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { let context = this.context; let pathDir = context.filesDir; 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 5cc77964eadf4180637d6f63318de3fe67cdc9cb..c081abf4770f1c3edbaa3283bbd722fd49d48c1a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -970,7 +970,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1026,7 +1026,7 @@ import hilog from '@ohos.hilog'; let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1089,7 +1089,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1109,7 +1109,7 @@ import hilog from '@ohos.hilog'; let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1166,7 +1166,7 @@ let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_IN let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1223,7 +1223,7 @@ let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1288,7 +1288,7 @@ let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_IN let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1309,7 +1309,7 @@ let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM; let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; try { @@ -1755,7 +1755,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; let info; @@ -1822,7 +1822,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; let info; @@ -1972,7 +1972,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; let info; @@ -2036,7 +2036,7 @@ let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT; let userId = 100; let want = { bundleName : "com.example.myapplication", - abilityName : "com.example.myapplication.MainAbility" + abilityName : "EntryAbility" }; let info; @@ -2247,7 +2247,7 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName: strin import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; let metadataName = 'com.example.myapplication.metadata'; try { @@ -2303,7 +2303,7 @@ getProfileByAbility(moduleName: string, abilityName: string, metadataName?: stri import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; try { bundleManager.getProfileByAbility(moduleName, abilityName).then((data) => { @@ -2320,7 +2320,7 @@ try { import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; let metadataName = 'com.example.myapplication.metadata'; try { bundleManager.getProfileByAbility(moduleName, abilityName, metadataName).then((data) => { @@ -2581,7 +2581,7 @@ import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let bundleName = 'com.example.myapplication'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; try { bundleManager.getAbilityLabel(bundleName, moduleName, abilityName, (err, data) => { @@ -2641,7 +2641,7 @@ import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let bundleName = 'com.example.myapplication'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; try { bundleManager.getAbilityLabel(bundleName, moduleName, abilityName).then((data) => { @@ -2694,7 +2694,7 @@ import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let bundleName = 'com.example.myapplication'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; try { bundleManager.getAbilityIcon(bundleName, moduleName, abilityName, (err, data) => { @@ -2754,7 +2754,7 @@ import bundleManager from '@ohos.bundle.bundleManager'; import hilog from '@ohos.hilog'; let bundleName = 'com.example.myapplication'; let moduleName = 'entry'; -let abilityName = 'MainAbility'; +let abilityName = 'EntryAbility'; try { bundleManager.getAbilityIcon(bundleName, moduleName, abilityName).then((data) => { 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 e6f45e0b61932ac8decda26b0537c33b5f8724b4..78eecf1cfc72b63539e7dcdf7864d324898a1164 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md @@ -118,8 +118,8 @@ if (!hasHceCap) { } var elementName = { - "bundleName": "com.test.cardemulation", - "abilityName": "com.test.cardemulation.MainAbility", + "bundleName": "com.example.myapplication", + "abilityName": "EntryAbility", }; var isDefaultService = cardEmulation.isDefaultService(elementName, cardEmulation.CardType.PAYMENT); console.log('is the app is default service for this card type: ' + isDefaultService); diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md b/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md index ca27b35f75eead694c2696b3cbe2411ed58305e9..f9056a384f9f30f4799bda5989e48ae7d331dc16 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md @@ -70,7 +70,7 @@ createDataShareHelper(context: Context, uri: string, callback: AsyncCallback< **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let dataShareHelper; @@ -125,7 +125,7 @@ createDataShareHelper(context: Context, uri: string): Promise<DataShareHelper **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let dataShareHelper; @@ -164,7 +164,8 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback<void>): void **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + function onCallback() { console.info("**** Observer on callback ****"); } @@ -191,7 +192,8 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback<void>): void **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + function offCallback() { console.info("**** Observer off callback ****"); } @@ -218,7 +220,8 @@ insert(uri: string, value: ValuesBucket, callback: AsyncCallback<number>): **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); const valueBucket = { "name": "rose", @@ -262,7 +265,8 @@ insert(uri: string, value: ValuesBucket): Promise<number> **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); const valueBucket = { "name": "rose1", @@ -299,8 +303,8 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callbac **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let da = new dataSharePredicates.DataSharePredicates(); @@ -342,8 +346,8 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates): Promis **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let da = new dataSharePredicates.DataSharePredicates(); @@ -379,8 +383,8 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let columns = ["*"]; @@ -424,8 +428,8 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let columns = ["*"]; @@ -462,8 +466,8 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let da = new dataSharePredicates.DataSharePredicates(); @@ -512,8 +516,8 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: **示例:** ```ts -import Ability from '@ohos.application.Ability' -import dataSharePredicates from '@ohos.data.dataSharePredicates' +import UIAbility from '@ohos.app.ability.UIAbility'; +import dataSharePredicates from '@ohos.data.dataSharePredicates'; let uri = ("datashare:///com.samples.datasharetest.DataShare"); let da = new dataSharePredicates.DataSharePredicates(); @@ -554,7 +558,8 @@ batchInsert(uri: string, values: Array<ValuesBucket>, callback: AsyncCallb **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,}, {"name": "roe12", "age": 21, "salary": 20.5,}, @@ -596,7 +601,8 @@ batchInsert(uri: string, values: Array<ValuesBucket>): Promise<number&g **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,}, {"name": "roe12", "age": 21, "salary": 20.5,}, @@ -630,7 +636,8 @@ normalizeUri(uri: string, callback: AsyncCallback<string>): void **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.normalizeUri(uri, (err, data) => { if (err != undefined) { @@ -664,7 +671,8 @@ normalizeUri(uri: string): Promise<string> **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.normalizeUri(uri).then((data) => { console.log("normalizeUri = " + data); @@ -691,7 +699,8 @@ denormalizeUri(uri: string, callback: AsyncCallback<string>): void **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.denormalizeUri(uri, (err, data) => { if (err != undefined) { @@ -725,7 +734,8 @@ denormalizeUri(uri: string): Promise<string> **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.denormalizeUri(uri).then((data) => { console.log("denormalizeUri = " + data); @@ -752,7 +762,8 @@ notifyChange(uri: string, callback: AsyncCallback<void>): void **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.notifyChange(uri, () => { console.log("***** notifyChange *****"); @@ -782,7 +793,8 @@ notifyChange(uri: string): Promise<void> **示例:** ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; + let uri = ("datashare:///com.samples.datasharetest.DataShare"); dataShareHelper.notifyChange(uri); ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md b/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md index a62b3e2d0f7970d72b8f660585911a4b0bb226e0..e7a6f1413b2bd9983151e4bee9b324499fbe832f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md @@ -27,7 +27,7 @@ create(context: Context, source: object): DistributedObjectV9 | -------- | -------- | -------- | -------- | | context | Context | 是 | 应用的上下文。
FA模型的应用Context定义见[Context](js-apis-inner-app-context.md)。
Stage模型的应用Context定义见[Context](js-apis-ability-context.md)。 | | source | object | 是 | 设置分布式数据对象的属性。 | - + **返回值:** | 类型 | 说明 | @@ -53,10 +53,11 @@ Stage模型示例: ```ts // 导入模块 import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -156,10 +157,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -218,10 +220,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -294,10 +297,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -357,10 +361,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -413,10 +418,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -463,10 +469,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -517,10 +524,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -579,10 +587,11 @@ g_object.save("local", (result) => { Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -646,10 +655,11 @@ g_object.save("local").then((result) => { ```js import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -712,10 +722,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability { +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { context = this.context } @@ -786,10 +797,11 @@ Stage模型示例 ```ts import distributedObject from '@ohos.data.distributedDataObject'; -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + // 获取context let context; -class MainAbility extends Ability { +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { context = this.context } diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-preferences.md b/zh-cn/application-dev/reference/apis/js-apis-data-preferences.md index 94a29db19d58c1470573338889d8da8c6d1a0430..b4b9fcf9505809908638d14865765a8eb316fe68 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-preferences.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-preferences.md @@ -69,9 +69,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let context = null; -class MainAbility extends Ability{ + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -139,9 +141,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let context = null; -class MainAbility extends Ability{ + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -215,9 +219,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let context = null; -class MainAbility extends Ability{ + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -294,9 +300,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let context = null; -class MainAbility extends Ability{ + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -358,9 +366,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + let context = null; -class MainAbility extends Ability{ + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -428,9 +438,9 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; let context = null; -class MainAbility extends Ability{ +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context; } @@ -497,7 +507,7 @@ get(key: string, defValue: ValueType): Promise<ValueType> **系统能力:** SystemCapability.DistributedDataManager.Preferences.Core **参数:** - + | 参数名 | 类型 | 必填 | 说明 | | -------- | ----------------------- | ---- | ------------------------------------------------------------ | | key | string | 是 | 要获取的存储Key名称,不能为空。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md b/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md index 05d2227d309e82ee2c0091d5b0ac7a403bc5c9e4..28ab08ee63ca43fe7e34fce781ee3ba8282241b3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md @@ -60,9 +60,10 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -124,9 +125,10 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -181,9 +183,10 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -242,9 +245,10 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md b/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md index 13995ff9dae2f33fb6228b41b3b18647c0fba075..1030a3c51dc24654c45295003ad803203f76c0ed 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md @@ -77,9 +77,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -169,9 +171,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -244,9 +248,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } @@ -313,9 +319,11 @@ Stage模型示例: ```ts // 获取context -import Ability from '@ohos.application.Ability' -let context -class MainAbility extends Ability{ +import UIAbility from '@ohos.app.ability.UIAbility'; + +let context; + +class EntryAbility extends UIAbility { onWindowStageCreate(windowStage){ context = this.context } diff --git a/zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md b/zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md index 3440cd7ae3dbeee8fc612844e9dafe6b53957a57..71a3d4ec9aae0e71dc30a4ef9c7eb7f8912a0784 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md @@ -297,9 +297,9 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number): ```ts import defaultAppMgr from '@ohos.bundle.defaultAppManager'; defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }).then((data) => { console.info('Operation successful.'); }).catch((error) => { @@ -308,9 +308,9 @@ defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { let userId = 100; defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, userId).then((data) => { console.info('Operation successful.'); }).catch((error) => { @@ -318,9 +318,9 @@ defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { }); defaultAppMgr.setDefaultApplication("image/png", { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, userId).then((data) => { console.info('Operation successful.'); }).catch((error) => { @@ -365,9 +365,9 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca import defaultAppMgr from '@ohos.bundle.defaultAppManager'; let userId = 100; defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, userId, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); @@ -377,9 +377,9 @@ defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { }); defaultAppMgr.setDefaultApplication("image/png", { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, userId, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); @@ -424,9 +424,9 @@ setDefaultApplication(type: string, elementName: ElementName, callback: AsyncCal ```ts import defaultAppMgr from '@ohos.bundle.defaultAppManager'; defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); @@ -436,9 +436,9 @@ defaultAppMgr.setDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, { }); defaultAppMgr.setDefaultApplication("image/png", { - bundleName: "com.test.app", + bundleName: "com.example.myapplication", moduleName: "module01", - abilityName: "MainAbility" + abilityName: "EntryAbility" }, (err, data) => { if (err) { console.error('Operation failed. Cause: ' + JSON.stringify(err)); diff --git a/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md b/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md index 8cc6ff1dc468ddbc6c31b4af9f15f6e6dbacce22..b08c0c05a061dd344ca5f3a83fa6a55c7329ec3f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md +++ b/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md @@ -64,7 +64,7 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }, (err, data) => { if (err) { console.log(`Operation failed: error code is ${err.code} and error message is ${err.message}`); @@ -120,7 +120,7 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }).then(data => { console.info('Operation succeed:' + JSON.stringify(data)); }).catch(err => { @@ -170,12 +170,12 @@ try { { deviceId: '1', bundleName: 'com.example.application1', - abilityName: 'MainAbility1' + abilityName: 'EntryAbility1' }, { deviceId: '1', bundleName: 'com.example.application2', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' } ], (err, data) => { if (err) { @@ -233,12 +233,12 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }, { deviceId: '1', bundleName: 'com.example.application2', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' } ]).then(data => { console.info('Operation succeed:' + JSON.stringify(data)); @@ -289,7 +289,7 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }, 'zh-Hans-CN', (err, data) => { if (err) { console.log(`Operation failed: error code is ${err.code} and error message is ${err.message}`); @@ -346,7 +346,7 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }, 'zh-Hans-CN').then(data => { console.info('Operation succeed:' + JSON.stringify(data)); }).catch(err => { @@ -397,12 +397,12 @@ try { { deviceId: '1', bundleName: 'com.example.application1', - abilityName: 'MainAbility1' + abilityName: 'EntryAbility1' }, { deviceId: '1', bundleName: 'com.example.application2', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' } ], 'zh-Hans-CN', (err, data) => { if (err) { @@ -461,12 +461,12 @@ try { { deviceId: '1', bundleName: 'com.example.application', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' }, { deviceId: '1', bundleName: 'com.example.application2', - abilityName: 'MainAbility' + abilityName: 'EntryAbility' } ], 'zh-Hans-CN').then(data => { console.info('Operation succeed:' + JSON.stringify(data)); diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md index 95277ddbcabcd37583ac4e6ac7e375bea329848a..e4677cc7082e366654b91f579a518dfeee60079d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md @@ -48,7 +48,7 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callba ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; let enterpriseInfo = { name: "enterprise name", @@ -100,7 +100,7 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; let enterpriseInfo = { name: "enterprise name", @@ -157,7 +157,7 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; let enterpriseInfo = { name: "enterprise name", @@ -582,7 +582,7 @@ setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCa ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; let enterpriseInfo = { name: "enterprise name", @@ -635,7 +635,7 @@ setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise\; ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; let enterpriseInfo = { name: "enterprise name", @@ -676,7 +676,7 @@ getEnterpriseInfo(admin: Want, callback: AsyncCallback<EnterpriseInfo>): v ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; adminManager.getEnterpriseInfo(wantTemp, (error, result) => { if (error != null) { @@ -723,7 +723,7 @@ getEnterpriseInfo(admin: Want): Promise<EnterpriseInfo> ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; adminManager.getEnterpriseInfo(wantTemp).then((result) => { console.log(result.name); diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md index 7f8922818130aa2bfb127f9c4fd7462901f79405..0fc0db10c4ceca845a55eda4d93d6ea54f4cbc66 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md @@ -45,7 +45,7 @@ getDeviceSerial(admin: Want, callback: AsyncCallback<string>): void ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDeviceSerial(wantTemp, (error, result) => { if (error != null) { @@ -94,7 +94,7 @@ getDeviceSerial(admin: Want): Promise<string> ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDeviceSerial(wantTemp).then((result) => { console.log(result); @@ -136,7 +136,7 @@ getDisplayVersion(admin: Want, callback: AsyncCallback<string>): void; ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDisplayVersion(wantTemp, (error, result) => { if (error != null) { @@ -185,7 +185,7 @@ getDisplayVersion(admin: Want): Promise<string> ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDisplayVersion(wantTemp).then((result) => { console.log(result); @@ -227,7 +227,7 @@ getDeviceName(admin: Want, callback: AsyncCallback<string>): void ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDeviceName(wantTemp, (error, result) => { if (error != null) { @@ -276,7 +276,7 @@ getDeviceName(admin: Want): Promise<string> ```js let wantTemp = { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", }; deviceInfo.getDeviceName(wantTemp).then((result) => { console.log(result); diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileio.md b/zh-cn/application-dev/reference/apis/js-apis-fileio.md index fad6393cf4358e4fee97f2ab9d1ee996e5d11dc9..b725bae9ecb4408e78c8c2ccd302898937ae22fe 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md @@ -20,8 +20,9 @@ import fileio from '@ohos.fileio'; **Stage模型** ```js -import Ability from '@ohos.application.Ability'; -class MainAbility extends Ability { +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { let context = this.context; let pathDir = context.filesDir; @@ -35,6 +36,7 @@ class MainAbility extends Ability { ```js import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); context.getFilesDir().then((data) => { let pathDir = data; 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 ebd83ea63a87ed9bfc00b730421b48aa1c9722a0..3458b6d5d211bb3d3b313a7a92dfe657b76a28ce 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md @@ -71,7 +71,7 @@ on(type: 'locationChange', request: LocationRequest, callback: Callback<Locat |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; @@ -115,7 +115,7 @@ off(type: 'locationChange', callback?: Callback<Location>): void |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; @@ -155,7 +155,7 @@ on(type: 'locationEnabledChange', callback: Callback<boolean>): void |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var locationEnabledChange = (state) => { @@ -193,7 +193,7 @@ off(type: 'locationEnabledChange', callback?: Callback<boolean>): void; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var locationEnabledChange = (state) => { @@ -237,7 +237,7 @@ on(type: 'cachedGnssLocationsChange', request: CachedGnssLocationsRequest, callb |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var cachedLocationsCb = (locations) => { @@ -280,7 +280,7 @@ off(type: 'cachedGnssLocationsChange', callback?: Callback<Array<Location& |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var cachedLocationsCb = (locations) => { @@ -323,7 +323,7 @@ on(type: 'satelliteStatusChange', callback: Callback<SatelliteStatusInfo>) |3301100 | The location switch is off. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var gnssStatusCb = (satelliteStatusInfo) => { @@ -366,7 +366,7 @@ off(type: 'satelliteStatusChange', callback?: Callback<SatelliteStatusInfo> **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var gnssStatusCb = (satelliteStatusInfo) => { @@ -409,7 +409,7 @@ on(type: 'nmeaMessage', callback: Callback<string>): void; **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var nmeaCb = (str) => { @@ -452,7 +452,7 @@ off(type: 'nmeaMessage', callback?: Callback<string>): void; **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var nmeaCb = (str) => { @@ -497,7 +497,7 @@ on(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): vo |3301600 | Failed to operate the geofence. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; import wantAgent from '@ohos.wantAgent'; @@ -506,7 +506,7 @@ on(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): vo wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", action: "action1", } ], @@ -555,7 +555,7 @@ off(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): v |3301600 | Failed to operate the geofence. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; import wantAgent from '@ohos.wantAgent'; @@ -564,7 +564,7 @@ off(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): v wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", action: "action1", } ], @@ -612,7 +612,7 @@ on(type: 'countryCodeChange', callback: Callback<CountryCode>): void; **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var callback = (code) => { @@ -653,7 +653,7 @@ off(type: 'countryCodeChange', callback?: Callback<CountryCode>): void; |3301500 | Failed to query the area information. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var callback = (code) => { @@ -698,7 +698,7 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0}; @@ -745,7 +745,7 @@ getCurrentLocation(callback: AsyncCallback<Location>): void; |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var locationChange = (err, location) => { @@ -797,7 +797,7 @@ getCurrentLocation(request?: CurrentLocationRequest): Promise<Location> |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0}; @@ -841,7 +841,7 @@ getLastLocation(): Location |3301200 |Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -875,7 +875,7 @@ isLocationEnabled(): boolean |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -912,7 +912,7 @@ requestEnableLocation(callback: AsyncCallback<boolean>): void |3301700 | No response to the request. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -956,7 +956,7 @@ requestEnableLocation(): Promise<boolean> |3301700 | No response to the request. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -999,7 +999,7 @@ enableLocation(callback: AsyncCallback<void>): void; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1041,7 +1041,7 @@ enableLocation(): Promise<void> |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1077,7 +1077,7 @@ disableLocation(): void; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1114,7 +1114,7 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback |3301300 | Reverse geocoding query failed. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1}; @@ -1163,7 +1163,7 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise<Array<Ge |3301300 | Reverse geocoding query failed. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1}; @@ -1205,7 +1205,7 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback< |3301400 | Geocoding query failed. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1}; @@ -1254,7 +1254,7 @@ getAddressesFromLocationName(request: GeoCodeRequest): Promise<Array<GeoAd |3301400 | Geocoding query failed. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1}; @@ -1293,7 +1293,7 @@ isGeocoderAvailable(): boolean; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1330,7 +1330,7 @@ getCachedGnssLocationsSize(callback: AsyncCallback<number>): void; |3301100 | The location switch is off. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1374,7 +1374,7 @@ getCachedGnssLocationsSize(): Promise<number>; |3301100 | The location switch is off. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1417,7 +1417,7 @@ flushCachedGnssLocations(callback: AsyncCallback<void>): void; |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1459,7 +1459,7 @@ flushCachedGnssLocations(): Promise<void>; |3301200 | Failed to obtain the geographical location. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1499,7 +1499,7 @@ sendCommand(command: LocationCommand, callback: AsyncCallback<void>): void |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'scenario': 0x301, 'command': "command_1"}; @@ -1544,7 +1544,7 @@ sendCommand(command: LocationCommand): Promise<void>; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var requestInfo = {'scenario': 0x301, 'command': "command_1"}; @@ -1585,7 +1585,7 @@ getCountryCode(callback: AsyncCallback<CountryCode>): void; |3301500 | Failed to query the area information.| **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1627,7 +1627,7 @@ getCountryCode(): Promise<CountryCode>; |3301500 | Failed to query the area information.| **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1664,7 +1664,7 @@ enableLocationMock(): void; |3301100 | The location switch is off.| **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1695,7 +1695,7 @@ disableLocationMock(): void; |3301100 | The location switch is off.| **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1732,7 +1732,7 @@ setMockedLocations(config: LocationMockConfig): void; |3301100 | The location switch is off.| **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var locations = [ @@ -1770,7 +1770,7 @@ enableReverseGeocodingMock(): void; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1800,7 +1800,7 @@ disableReverseGeocodingMock(): void; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1836,7 +1836,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): v |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; var mockInfos = [ @@ -1885,7 +1885,7 @@ isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean; |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -1924,7 +1924,7 @@ setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean) |3301000 | Location service is unavailable. | **示例** - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { 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 6ee361d755f192c2df7c34a569dfb4fd3f9f4b3f..7681678b46c71cfb9d900163f7ef3067598fec78 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md @@ -411,7 +411,7 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", action: "action1", } ], @@ -459,7 +459,7 @@ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", action: "action1", } ], diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md index 90d0b9569aa8260e884ce7aaad9480aa1099a92e..fd6640111961194f4543b1da7242f3bccbb341fd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-ability-startAbilityParameter.md @@ -20,7 +20,7 @@ import featureAbility from '@ohos.ability.featureAbility' let Want = { bundleName: "com.example.abilityStartSettingApp2", - abilityName: "com.example.abilityStartSettingApp.MainAbility", + abilityName: "com.example.abilityStartSettingApp.EntryAbility", } let abilityStartSetting ={ 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 1d9c28233486316814e156f257f9aed89b87b04c..25fe8e84f6dc5cea8341a80a3ed85717d431b101 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 @@ -28,8 +28,8 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传 ```ts let want = { "deviceId": "", // deviceId为空表示本设备 - "bundleName": "com.extreme.test", - "abilityName": "MainAbility", + "bundleName": "com.example.myapplication", + "abilityName": "EntryAbility", "moduleName": "entry" // moduleName非必选 }; this.context.startAbility(want, (error) => { @@ -52,8 +52,8 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传 } let want = { "deviceId": "", // deviceId为空表示本设备 - "bundleName": "com.extreme.test", - "abilityName": "MainAbility", + "bundleName": "com.example.myapplication", + "abilityName": "EntryAbility", "moduleName": "entry", // moduleName非必选 "parameters": { "keyFd":{"type":"FD", "value":fd} diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md index f9cb9db254c41c529d36892a28c7a21495e1bf5b..0f4099d4939d1d851c5bbcdfad73901d3ffeb19d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md @@ -17,7 +17,7 @@ AccessibilityExtensionContext是AccessibilityExtensionAbility上下文环境, ```ts import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtensionAbility' let axContext; -class MainAbility extends AccessibilityExtensionAbility { +class EntryAbility extends AccessibilityExtensionAbility { onConnect(): void { console.log('AxExtensionAbility onConnect'); axContext = this.context; diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md index 0030a1c5eb112a12b08a0845a0f5817203c1fabd..d4042cd5ebc208bed0b8e5c44fe702f4ebab469d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md @@ -38,11 +38,11 @@ registerAbilityLifecycleCallback(callback: AbilityLifecycleCallback): **number** **示例:** ```ts -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var lifecycleId; -export default class MyAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate() { console.log("MyAbility onCreate") let AbilityLifecycleCallback = { @@ -105,11 +105,11 @@ unregisterAbilityLifecycleCallback(callbackId: **number**, callback: AsyncCallb **示例:** ```ts -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var lifecycleId; -export default class MyAbility extends Ability { +export default class EntryAbility extends UIAbility { onDestroy() { let applicationContext = this.context.getApplicationContext(); console.log("stage applicationContext: " + JSON.stringify(applicationContext)); @@ -143,11 +143,11 @@ registerEnvironmentCallback(callback: EnvironmentCallback): **number**; **示例:** ```ts -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var callbackId; -export default class MyAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate() { console.log("MyAbility onCreate") globalThis.applicationContext = this.context.getApplicationContext(); @@ -186,11 +186,11 @@ unregisterEnvironmentCallback(callbackId: **number**, callback: AsyncCallback<* **示例:** ```ts -import Ability from "@ohos.application.Ability"; +import UIAbility from '@ohos.app.ability.UIAbility'; var callbackId; -export default class MyAbility extends Ability { +export default class EntryAbility extends UIAbility { onDestroy() { let applicationContext = this.context.getApplicationContext(); applicationContext.unregisterEnvironmentCallback(callbackId, (error, data) => { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md index 0757ed4304af9d61f032dac076a736be4994d3b9..ffa005b6b0fb3c33622940f63fe0ad7a2cdbcf04 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-baseContext.md @@ -19,10 +19,10 @@ BaseContext抽象类用于表示继承的子类Context是Stage模型还是FA模 ```ts import UIAbility from '@ohos.app.ability.UIAbility'; -class MainAbility extends UIAbility { +class EntryAbility extends UIAbility { onCreate(want, launchParam) { - // MainAbility onCreate, isStageMode: true - console.log("MainAbility onCreate, isStageMode: " + this.context.stageMode); + // EntryAbility onCreate, isStageMode: true + console.log("EntryAbility onCreate, isStageMode: " + this.context.stageMode); } } ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md index 26b3685915afad94d76499246c05896074218180..14e6dd2a3aa4dfb947737ab4f8d6938aa054c87f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md @@ -12,9 +12,9 @@ EventHub模块提供了事件中心,提供订阅、取消订阅、触发事件 在使用eventHub的功能前,需要通过UIAbility实例的成员变量context获取。 ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { eventFunc(){ console.log("eventFunc is called"); } @@ -43,9 +43,9 @@ on(event: string, callback: Function): void; **示例:** ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onForeground() { this.context.eventHub.on("myEvent", this.eventFunc); // 支持使用匿名函数订阅事件 @@ -84,9 +84,9 @@ off(event: string, callback?: Function): void; **示例:** ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onForeground() { this.context.eventHub.on("myEvent", this.eventFunc1); this.context.eventHub.off("myEvent", this.eventFunc1); // 取消eventFunc1对myEvent事件的订阅 @@ -123,9 +123,9 @@ emit(event: string, ...args: Object[]): void; **示例:** ```ts -import UIAbility from '@ohos.app.ability.UIAbility' +import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MainAbility extends UIAbility { +export default class EntryAbility extends UIAbility { onForeground() { this.context.eventHub.on("myEvent", this.eventFunc); // 结果: 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 411b5d8a48b2536b596900603c4683bd079f80f1..8bcef45ca75f01221cecee54b083b55ec719ff38 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 @@ -61,10 +61,11 @@ export default class TheServiceExtension extends ServiceExtension { 在entry的MainAbility的onCreate回调内启动ServiceExtension ```ts -import Ability from '@ohos.app.ability.Ability' -export default class MainAbility extends Ability { +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("[Demo] MainAbility onCreate"); + console.log("[Demo] EntryAbility onCreate"); let wantExt = { deviceId: "", bundleName: "com.example.TheServiceExtension", diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-formExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-formExtensionContext.md index 17779dc827bbfde193ca2cc19e5c33bf9ff629f7..eb469590505063915704df921158ecb55597fc88 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-formExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-formExtensionContext.md @@ -60,7 +60,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility { let want = { deviceId: "", bundleName: "com.example.formstartability", - abilityName: "MainAbility", + abilityName: "EntryAbility", parameters: { "message": message } @@ -110,7 +110,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility { let want = { deviceId: "", bundleName: "com.example.formstartability", - abilityName: "MainAbility", + abilityName: "EntryAbility", parameters: { "message": message } 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 5d21c8efaefa35f13ec53f227c107b9423e99a87..7a6ca307c663546ec71690b09ccdb5da1c454115 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 @@ -17,7 +17,7 @@ ServiceExtensionContext模块提供ServiceExtensionAbility具有的能力,包 import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility'; let context = undefined; - class MainAbility extends ServiceExtensionAbility { + class EntryAbility extends ServiceExtensionAbility { onCreate() { context = this.context; // 获取ServiceExtensionContext } @@ -214,8 +214,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var options = { windowMode: 0 @@ -292,8 +292,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -369,8 +369,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -455,8 +455,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -520,8 +520,8 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -586,8 +586,8 @@ startServiceExtensionAbility(want: Want): Promise\; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -652,8 +652,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -723,8 +723,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -782,8 +782,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\): void; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -845,8 +845,8 @@ stopServiceExtensionAbility(want: Want): Promise\; ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; try { @@ -907,8 +907,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -975,8 +975,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; @@ -1180,8 +1180,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ```ts var want = { deviceId: "", - bundleName: "com.extreme.test", - abilityName: "MainAbility" + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -1361,7 +1361,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantBackground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }; @@ -1392,7 +1392,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantForeground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "", parameters: { "ohos.aafwk.param.callAbilityToForeground": true 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 022abd4251a9d90b9bf0eb4db37a5b5658099686..0740e38c53b57a3aa2dbadb5dedfa487422b511f 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 @@ -129,7 +129,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var options = { windowMode: 0 @@ -270,7 +270,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; try { @@ -336,7 +336,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var options = { windowMode: 0, @@ -409,30 +409,30 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes **示例:** ```ts - var want = { +var want = { bundleName: "com.example.myapplication", - abilityName: "MainAbility" - }; - var options = { + abilityName: "EntryAbility" +}; +var options = { windowMode: 0, - }; +}; - try { +try { this.context.startAbilityForResult(want, options) - .then((result) => { + .then((result) => { // 执行正常业务 console.log("startAbilityForResult succeed, result.resultCode = " + result.resultCode); - }) - .catch((error) => { + }) + .catch((error) => { // 处理业务逻辑错误 console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(error.code) + - ' error.message: ' + JSON.stringify(error.message)); - }); - } catch (paramError) { + ' error.message: ' + JSON.stringify(error.message)); + }); +} catch (paramError) { // 处理入参错误异常 console.log('startAbilityForResult failed, error.code: ' + JSON.stringify(paramError.code) + - ' error.message: ' + JSON.stringify(paramError.message)); - } + ' error.message: ' + JSON.stringify(paramError.message)); +} ``` ## UIAbilityContext.startAbilityForResultWithAccount @@ -484,7 +484,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; @@ -558,7 +558,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -639,7 +639,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -1252,7 +1252,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi ```ts var want = { bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" } var resultCode = 100; // 返回给接口调用方AbilityResult信息 @@ -1316,7 +1316,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise<void>; ```ts var want = { bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" } var resultCode = 100; // 返回给接口调用方AbilityResult信息 @@ -1629,7 +1629,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantBackground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "" }; @@ -1660,7 +1660,7 @@ startAbilityByCall(want: Want): Promise<Caller>; var wantForeground = { bundleName: "com.example.myservice", moduleName: "entry", - abilityName: "MainAbility", + abilityName: "EntryAbility", deviceId: "", parameters: { "ohos.aafwk.param.callAbilityToForeground": true @@ -1734,7 +1734,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; @@ -1807,7 +1807,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; var options = { @@ -1882,7 +1882,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): var want = { deviceId: "", bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" }; var accountId = 100; var options = { diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md index 646be644ca57e8108f13423d633b3976cb1c3bba..f3338dc2403789a8c53128c3760a151eba22949a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md @@ -20,7 +20,7 @@ import InputMethodExtensionContext from '@ohos.inputmethodextensioncontext'; ```js import InputMethodExtensionAbility from '@ohos.inputmethodextensionability'; -class MainAbility extends InputMethodExtensionAbility { +class EntryAbility extends InputMethodExtensionAbility { onCreate() { let context = this.context; } diff --git a/zh-cn/application-dev/reference/apis/js-apis-notificationSubscribe.md b/zh-cn/application-dev/reference/apis/js-apis-notificationSubscribe.md index cc3438f5a42df3976a7f472312d4c67310715b4d..241039f3132fe2dfb9fe4554011303a3ec7d324f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-notificationSubscribe.md +++ b/zh-cn/application-dev/reference/apis/js-apis-notificationSubscribe.md @@ -9,7 +9,7 @@ ## 导入模块 ```js -import NotificationSubscribe from '@ohos.notificationSubscribe'; +import notificationSubscribe from '@ohos.notificationSubscribe'; ``` @@ -62,11 +62,9 @@ let subscriber = { let info = { bundleNames: ["bundleName1","bundleName2"] }; -NotificationSubscribe.subscribe(subscriber, info, subscribeCallback); +notificationSubscribe.subscribe(subscriber, info, subscribeCallback); ``` - - ## NotificationSubscribe.subscribe subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\): void @@ -110,7 +108,7 @@ function onConsumeCallback(data) { let subscriber = { onConsume: onConsumeCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` @@ -151,7 +149,7 @@ function onConsumeCallback(data) { let subscriber = { onConsume: onConsumeCallback }; -NotificationSubscribe.subscribe(subscriber).then(() => { +notificationSubscribe.subscribe(subscriber).then(() => { console.info("subscribe success"); }); ``` @@ -201,11 +199,9 @@ function onDisconnectCallback(data) { let subscriber = { onDisconnect: onDisconnectCallback }; -NotificationSubscribe.unsubscribe(subscriber, unsubscribeCallback); +notificationSubscribe.unsubscribe(subscriber, unsubscribeCallback); ``` - - ## NotificationSubscribe.unsubscribe unsubscribe(subscriber: NotificationSubscriber): Promise\ @@ -241,13 +237,11 @@ function onDisconnectCallback(data) { let subscriber = { onDisconnect: onDisconnectCallback }; -NotificationSubscribe.unsubscribe(subscriber).then(() => { +notificationSubscribe.unsubscribe(subscriber).then(() => { console.info("unsubscribe success"); }); ``` - - ## NotificationSubscribe.remove remove(bundle: BundleOption, notificationKey: NotificationKey, reason: RemoveReason, callback: AsyncCallback\): void @@ -296,8 +290,8 @@ let notificationKey = { id: 0, label: "label", }; -let reason = NotificationSubscribe.RemoveReason.CLICK_REASON_REMOVE; -NotificationSubscribe.remove(bundle, notificationKey, reason, removeCallback); +let reason = notificationSubscribe.RemoveReason.CLICK_REASON_REMOVE; +notificationSubscribe.remove(bundle, notificationKey, reason, removeCallback); ``` @@ -343,13 +337,11 @@ let notificationKey = { label: "label", }; let reason = NotificationSubscribe.RemoveReason.CLICK_REASON_REMOVE; -NotificationSubscribe.remove(bundle, notificationKey, reason).then(() => { +notificationSubscribe.remove(bundle, notificationKey, reason).then(() => { console.info("remove success"); }); ``` - - ## NotificationSubscribe.remove remove(hashCode: string, reason: RemoveReason, callback: AsyncCallback\): void @@ -392,11 +384,9 @@ function removeCallback(err) { } } let reason = NotificationSubscribe.RemoveReason.CANCEL_REASON_REMOVE; -NotificationSubscribe.remove(hashCode, reason, removeCallback); +notificationSubscribe.remove(hashCode, reason, removeCallback); ``` - - ## NotificationSubscribe.remove remove(hashCode: string, reason: RemoveReason): Promise\ @@ -429,14 +419,12 @@ remove(hashCode: string, reason: RemoveReason): Promise\ ```js let hashCode = 'hashCode'; -let reason = NotificationSubscribe.RemoveReason.CLICK_REASON_REMOVE; -NotificationSubscribe.remove(hashCode, reason).then(() => { +let reason = notificationSubscribe.RemoveReason.CLICK_REASON_REMOVE; +notificationSubscribe.remove(hashCode, reason).then(() => { console.info("remove success"); }); ``` - - ## NotificationSubscribe.removeAll removeAll(bundle: BundleOption, callback: AsyncCallback\): void @@ -481,8 +469,6 @@ let bundle = { NotificationSubscribe.removeAll(bundle, removeAllCallback); ``` - - ## NotificationSubscribe.removeAll removeAll(callback: AsyncCallback\): void @@ -520,11 +506,9 @@ function removeAllCallback(err) { } } -NotificationSubscribe.removeAll(removeAllCallback); +notificationSubscribe.removeAll(removeAllCallback); ``` - - ## NotificationSubscribe.removeAll removeAll(bundle?: BundleOption): Promise\ @@ -556,7 +540,7 @@ removeAll(bundle?: BundleOption): Promise\ ```js // 不指定应用时,删除所有通知 -NotificationSubscribe.removeAll().then(() => { +notificationSubscribe.removeAll().then(() => { console.info("removeAll success"); }); ``` @@ -602,7 +586,7 @@ function removeAllCallback(err) { let userId = 1; -NotificationSubscribe.removeAll(userId, removeAllCallback); +notificationSubscribe.removeAll(userId, removeAllCallback); ``` ## Notification.removeAll @@ -645,11 +629,9 @@ function removeAllCallback(err) { let userId = 1; -NotificationSubscribe.removeAll(userId, removeAllCallback); +notificationSubscribe.removeAll(userId, removeAllCallback); ``` - - ## NotificationSubscriber 作为订阅通知接口[subscribe](#notificationsubscribe)的入参,提供订阅者接收到新通知、取消通知等的回调方法。 @@ -693,7 +675,7 @@ let subscriber = { onConsume: onConsumeCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ### onCancel @@ -733,7 +715,7 @@ let subscriber = { onCancel: onCancelCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ### onUpdate @@ -771,7 +753,7 @@ let subscriber = { onUpdate: onUpdateCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ### onConnect @@ -803,7 +785,7 @@ let subscriber = { onConnect: onConnectCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ### onDisconnect @@ -847,9 +829,9 @@ let subscriber = { }; // 订阅通知后会收到onConnect回调 -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); // 取消订阅后会收到onDisconnect回调 -NotificationSubscribe.unsubscribe(subscriber, unsubscribeCallback); +notificationSubscribe.unsubscribe(subscriber, unsubscribeCallback); ``` ### onDestroy @@ -881,7 +863,7 @@ let subscriber = { onDestroy: onDestroyCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ### onDoNotDisturbDateChange @@ -919,7 +901,7 @@ let subscriber = { onDoNotDisturbDateChange: onDoNotDisturbDateChangeCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` @@ -960,7 +942,7 @@ let subscriber = { onEnabledNotificationChanged: onEnabledNotificationChangedCallback }; -NotificationSubscribe.subscribe(subscriber, subscribeCallback); +notificationSubscribe.subscribe(subscriber, subscribeCallback); ``` ## BundleOption 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 266497bac93f50fe51651ab7d9576e2967de20e5..2486de75b87b73fe47e0a3f9dba4dc9cb2632fc3 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 @@ -255,7 +255,7 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want **示例**: ```js -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; import wantAgent from '@ohos.wantAgent'; @@ -267,13 +267,13 @@ function callback(error, data) { } } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -334,17 +334,17 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want **示例**: ```js -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; import wantAgent from '@ohos.wantAgent'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { let wantAgentInfo = { wants: [ { bundleName: "com.example.myapplication", - abilityName: "MainAbility" + abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, @@ -400,7 +400,7 @@ stopBackgroundRunning(context: Context, callback: AsyncCallback<void>): vo **示例**: ```js -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; function callback(error, data) { @@ -411,7 +411,7 @@ function callback(error, data) { } } -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { try { backgroundTaskManager.stopBackgroundRunning(this.context, callback); @@ -461,10 +461,10 @@ stopBackgroundRunning(context: Context): Promise<void> **示例**: ```js -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { try { backgroundTaskManager.stopBackgroundRunning(this.context).then(() => { diff --git a/zh-cn/application-dev/reference/apis/js-apis-rpc.md b/zh-cn/application-dev/reference/apis/js-apis-rpc.md index 8f0c38fc5710505d39524bd4e380ee4ea218b322..e6683dd673247346780a300625e06cb221ec1c4f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-rpc.md +++ b/zh-cn/application-dev/reference/apis/js-apis-rpc.md @@ -232,7 +232,7 @@ class Stub extends rpc.RemoteObject { return true; } } - ``` +``` ### getSize @@ -364,7 +364,7 @@ class Stub extends rpc.RemoteObject { return true; } } - ``` +``` ### getReadableBytes @@ -2408,7 +2408,7 @@ readException(): void }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let option = new rpc.MessageOption(); @@ -4857,7 +4857,7 @@ readException(): void }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let option = new rpc.MessageOption(); @@ -5657,7 +5657,7 @@ asObject(): IRemoteObject }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); @@ -6090,7 +6090,7 @@ sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: Me }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let option = new rpc.MessageOption(); @@ -6153,7 +6153,7 @@ sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let option = new rpc.MessageOption(); @@ -6224,7 +6224,7 @@ sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: Me }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let option = new rpc.MessageOption(); @@ -6288,7 +6288,7 @@ sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; function sendRequestCallback(result) { if (result.errCode === 0) { @@ -6356,7 +6356,7 @@ sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: Me }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; function sendRequestCallback(result) { if (result.errCode === 0) { @@ -6427,7 +6427,7 @@ getLocalInterface(interface: string): IRemoteBroker }; let want = { "bundleName":"com.ohos.server", - "abilityName":"com.ohos.server.MainAbility", + "abilityName":"com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); try { @@ -6480,7 +6480,7 @@ queryLocalInterface(interface: string): IRemoteBroker }; let want = { "bundleName":"com.ohos.server", - "abilityName":"com.ohos.server.MainAbility", + "abilityName":"com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let broker = proxy.queryLocalInterface("testObject"); @@ -6529,7 +6529,7 @@ registerDeathRecipient(recipient: DeathRecipient, flags: number): void }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); class MyDeathRecipient { @@ -6588,7 +6588,7 @@ addDeathRecipient(recipient: DeathRecipient, flags: number): boolean }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); class MyDeathRecipient { @@ -6642,7 +6642,7 @@ unregisterDeathRecipient(recipient: DeathRecipient, flags: number): boolean }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); class MyDeathRecipient { @@ -6702,7 +6702,7 @@ removeDeathRecipient(recipient: DeathRecipient, flags: number): boolean }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); class MyDeathRecipient { @@ -6757,7 +6757,7 @@ getDescriptor(): string }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); try { @@ -6804,7 +6804,7 @@ getInterfaceDescriptor(): string }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let descriptor = proxy.getInterfaceDescriptor(); @@ -6844,7 +6844,7 @@ isObjectDead(): boolean }; let want = { "bundleName": "com.ohos.server", - "abilityName": "com.ohos.server.MainAbility", + "abilityName": "com.ohos.server.EntryAbility", }; FA.connectAbility(want, connect); let isDead = proxy.isObjectDead(); @@ -6981,7 +6981,7 @@ getFlags(): number console.info("error " + error); } ``` - + ### setFlags setFlags(flags: number): void @@ -7152,11 +7152,11 @@ static getCallingTokenId(): number; **系统能力**:SystemCapability.Communication.IPC.Core **返回值:** - + | 类型 | 说明 | | ------ | --------------------- | | number | 返回调用者的TokenId。 | - + **示例:** ```ts @@ -8861,4 +8861,4 @@ readFromAshmem(size: number, offset: number): number[] console.log("RpcTest: write to Ashmem result is : " + writeResult); let readResult = ashmem.readFromAshmem(5, 0); console.log("RpcTest: read to Ashmem result is : " + readResult); - ``` \ No newline at end of file + ``` \ No newline at end of file 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 0ffb8c8275efcce862ca1ae1054d9233bf26a697..bf2fe339f78f70f38c7159f457981ebbeaf56e8e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wantAgent.md @@ -46,7 +46,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -71,8 +71,6 @@ let wantAgentInfo = { WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback); ``` - - ## WantAgent.getWantAgent getWantAgent(info: WantAgentInfo): Promise\ @@ -105,7 +103,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -132,8 +130,6 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => { }); ``` - - ## WantAgent.getBundleName getBundleName(agent: WantAgent, callback: AsyncCallback\): void @@ -173,7 +169,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -240,7 +236,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -313,7 +309,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -381,7 +377,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -453,7 +449,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -521,7 +517,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -595,7 +591,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -674,7 +670,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -744,7 +740,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -806,7 +802,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', @@ -872,7 +868,7 @@ let wantAgentInfo = { { deviceId: 'deviceId', bundleName: 'com.neu.setResultOnAbilityResultTest1', - abilityName: 'com.example.test.MainAbility', + abilityName: 'com.example.test.EntryAbility', action: 'action1', entities: ['entity1'], type: 'MIMETYPE', diff --git a/zh-cn/application-dev/reference/apis/js-apis-webview.md b/zh-cn/application-dev/reference/apis/js-apis-webview.md index 83c76ef9c38493422b948990548913fe01e4bcc4..608c862247e52c62b27885d0e62b0f0c9abc1c45 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webview.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md @@ -228,19 +228,19 @@ static initializeWebEngine(): void **示例:** -本示例以 MainAbility 为例,描述了在 Ability 创建阶段完成 Web 组件动态库加载的功能。 +本示例以EntryAbility为例,描述了在 Ability 创建阶段完成 Web 组件动态库加载的功能。 ```ts // xxx.ts -import Ability from '@ohos.application.Ability' -import web_webview from '@ohos.web.webview' +import UIAbility from '@ohos.app.ability.UIAbility'; +import web_webview from '@ohos.web.webview'; -export default class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onCreate(want, launchParam) { - console.log("MainAbility onCreate") + console.log("EntryAbility onCreate") web_webview.WebviewController.initializeWebEngine() globalThis.abilityWant = want - console.log("MainAbility onCreate done") + console.log("EntryAbility onCreate done") } } ``` @@ -249,7 +249,7 @@ export default class MainAbility extends Ability { ```ts // xxx.ets -import web_webview from '@ohos.web.webview' +import web_webview from '@ohos.web.webview'; @Entry @Component 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 6fb39162efe913ac2f65843264619acd47f5838e..fece8591420ed5a252dafd7d08e1704dd87f4eaf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-window.md +++ b/zh-cn/application-dev/reference/apis/js-apis-window.md @@ -5907,9 +5907,11 @@ getMainWindow(callback: AsyncCallback<Window>): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -5953,9 +5955,11 @@ getMainWindow(): Promise<Window> **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -5998,9 +6002,11 @@ getMainWindowSync(): Window **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); try { @@ -6041,9 +6047,11 @@ createSubWindow(name: string, callback: AsyncCallback<Window>): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -6097,9 +6105,11 @@ createSubWindow(name: string): Promise<Window> **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -6145,9 +6155,11 @@ getSubWindow(callback: AsyncCallback<Array<Window>>): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -6189,9 +6201,11 @@ getSubWindow(): Promise<Array<Window>> **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); let windowClass = null; @@ -6235,9 +6249,11 @@ loadContent(path: string, storage: LocalStorage, callback: AsyncCallback<void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { storage : LocalStorage onWindowStageCreate(windowStage) { this.storage = new LocalStorage(); @@ -6293,9 +6309,11 @@ loadContent(path: string, storage?: LocalStorage): Promise<void> **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { storage : LocalStorage onWindowStageCreate(windowStage) { this.storage = new LocalStorage(); @@ -6344,9 +6362,11 @@ loadContent(path: string, callback: AsyncCallback<void>): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); try { @@ -6393,9 +6413,11 @@ on(eventType: 'windowStageEvent', callback: Callback<WindowStageEventType> **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); try { @@ -6440,9 +6462,11 @@ off(eventType: 'windowStageEvent', callback?: Callback<WindowStageEventType&g **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); try { @@ -6479,9 +6503,11 @@ disableWindowDecor(): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('disableWindowDecor'); windowStage.disableWindowDecor(); @@ -6519,9 +6545,11 @@ setShowOnLockScreen(showOnLockScreen: boolean): void **示例:** ```ts -import Ability from '@ohos.application.Ability'; +import UIAbility from '@ohos.app.ability.UIAbility'; + +export default class EntryAbility extends UIAbility { + // ... -class myAbility extends Ability { onWindowStageCreate(windowStage) { console.log('onWindowStageCreate'); try { diff --git a/zh-cn/application-dev/reference/apis/js-apis-worker.md b/zh-cn/application-dev/reference/apis/js-apis-worker.md index 9e98a5244869cf5fd48b55ee677f6b6a860e9949..54ed6379ecb5f3a8005bb049ca2ca3d133af7e22 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-worker.md +++ b/zh-cn/application-dev/reference/apis/js-apis-worker.md @@ -106,7 +106,7 @@ FA模型: "buildOption": { "sourceOption": { "workers": [ - "./src/main/ets/MainAbility/workers/worker.ts" + "./src/main/ets/entryability/workers/worker.ts" ] } } @@ -1191,7 +1191,7 @@ FA模型: "buildOption": { "sourceOption": { "workers": [ - "./src/main/ets/MainAbility/workers/worker.ts" + "./src/main/ets/entryability/workers/worker.ts" ] } } @@ -2113,7 +2113,7 @@ build-profile.json5 配置 : "buildOption": { "sourceOption": { "workers": [ - "./src/main/ets/MainAbility/workers/worker.ts" + "./src/main/ets/entryability/workers/worker.ts" ] } } diff --git a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md index a297543b93d4eab90d9af410d8888fafb2411aaf..72211cf4af22f41bb4fb545081dd46ee5658737f 100644 --- a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md +++ b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-basic-calendar.md @@ -173,7 +173,7 @@ calendardata示例: "clickOneDay": { "action": "router", "bundleName": "com.example.calendar", - "abilityName": "com.example.calendar.MainAbility", + "abilityName": "EntryAbility", "params": { "action": "click_month_view_event", "day": "$event.day", 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 3cafcb4415cdd3b4ab806b077fc6e4537489da7d..064758811a255d6c69f41a060319a409be3f7d94 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 @@ -112,7 +112,7 @@ HML(OpenHarmony Markup Language)是一套类HTML的标记语言,通过组 "action": "router", "want": { "bundleName": "com.example.myapplication", - "abilityName": "com.example.entry.MainAbility" + "abilityName": "EntryAbility" } }, "routerEventName2": { 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 632cacbce5f90b7cdfceeff4efb10076d7086b1d..83d0275630f667542d71fb46ecce0655369ce7f8 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 @@ -34,149 +34,6 @@ ## 开发步骤 -### 基于FA模型 - -基于FA的Service Ability使用,参考[ServiceAbility开发指导](../application-models/serviceability-overview.md)。 - -当不需要与后台执行的长时任务交互时,可以采用startAbility()方法启动Service Ability。并在Service Ability的onStart回调方法中,调用长时任务的申请接口,声明此服务需要在后台长时运行。当任务执行完,再调用长时任务取消接口,及时释放资源。 - -当需要与后台执行的长时任务交互时(如播放音乐等)。可以采用connectAbility()方法启动并连接Service Ability。在获取到服务的代理对象后,与服务进行通信,控制长时任务的申请和取消。 - -1、新建Api Version 8的工程后,在工程目录中右键选择“new” -> “Ability” -> “Service Ability” 快速创建Service Ability组件。并在config.json文件中配置长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING、后台模式类型,其中Ability类型为“service”。 - -``` -"module": { - "package": "com.example.myapplication", - "abilities": [ - { - "backgroundModes": [ - "dataTransfer", - "location" - ], // 后台模式类型 - "type": "service" // ability类型为service - } - ], - "reqPermissions": [ - { - "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" // 长时任务权限 - } - ] -} -``` - -2、在Service Ability调用长时任务的申请和取消接口。 - -```js -import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; -import featureAbility from '@ohos.ability.featureAbility'; -import wantAgent from '@ohos.wantAgent'; -import rpc from "@ohos.rpc"; - -function startContinuousTask() { - let wantAgentInfo = { - // 点击通知后,将要执行的动作列表 - wants: [ - { - bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility" - } - ], - // 点击通知后,动作类型 - operationType: wantAgent.OperationType.START_ABILITY, - // 使用者自定义的一个私有值 - requestCode: 0, - // 点击通知后,动作执行属性 - wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] - }; - - // 通过wantAgent模块的getWantAgent方法获取WantAgent对象 - wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { - try { - backgroundTaskManager.startBackgroundRunning(featureAbility.getContext(), - backgroundTaskManager.BackgroundMode.DATA_TRANSFER, wantAgentObj).then(() => { - console.info("Operation startBackgroundRunning succeeded"); - }).catch((err) => { - console.error("Operation startBackgroundRunning failed Cause: " + err); - }); - } catch (error) { - console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`); - } - }); -} - -function stopContinuousTask() { - try { - backgroundTaskManager.stopBackgroundRunning(featureAbility.getContext()).then(() => { - console.info("Operation stopBackgroundRunning succeeded"); - }).catch((err) => { - console.error("Operation stopBackgroundRunning failed Cause: " + err); - }); - } catch (error) { - console.error(`Operation stopBackgroundRunning failed. code is ${error.code} message is ${error.message}`); - } -} - -async function processAsyncJobs() { - // 此处执行具体的长时任务。 - - // 长时任务执行完,调用取消接口,释放资源。 - stopContinuousTask(); -} - -let mMyStub; - -class MyStub extends rpc.RemoteObject { - constructor(des) { - if (typeof des === 'string') { - super(des); - } else { - return null; - } - } - onRemoteRequest(code, data, reply, option) { - console.log('ServiceAbility onRemoteRequest called'); - // code 的具体含义用户自定义 - if (code === 1) { - // 接收到申请长时任务的请求码 - startContinuousTask(); - // 此处执行具体长时任务 - } else if (code === 2) { - // 接收到取消长时任务的请求码 - stopContinuousTask(); - } else { - console.log('ServiceAbility unknown request code'); - } - return true; - } -} - -export default { - onStart(want) { - console.info('ServiceAbility onStart'); - mMyStub = new MyStub("ServiceAbility-test"); - // 在执行后台长时任前,调用申请接口。 - startContinuousTask(); - processAsyncJobs(); - }, - onStop() { - console.info('ServiceAbility onStop'); - }, - onConnect(want) { - console.info('ServiceAbility onConnect'); - return mMyStub; - }, - onReconnect(want) { - console.info('ServiceAbility onReconnect'); - }, - onDisconnect() { - console.info('ServiceAbility onDisconnect'); - }, - onCommand(want, restart, startId) { - console.info('ServiceAbility onCommand'); - } -}; -``` - ### 基于Stage模型 Stage模型的相关信息参考[Stage模型开发概述](../application-models/stage-model-development-overview.md)。 @@ -220,7 +77,7 @@ struct Index { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", } ], // 点击通知后,动作类型 @@ -293,11 +150,11 @@ struct Index { 3、当需要跨设备或者跨应用在后台执行长时任务时,可以通过Call的方式在后台创建并运行Ability。使用方式参考[Call调用开发指南(同设备)](../application-models/uiability-intra-device-interaction.md#通过call调用实现uiability交互仅对系统应用开放),[Call调用开发指南(跨设备)](../application-models/hop-multi-device-collaboration.md#通过跨设备call调用实现多端协同)。 ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; import wantAgent from '@ohos.wantAgent'; -const MSG_SEND_METHOD: string = 'CallSendMsg' +const MSG_SEND_METHOD: string = 'CallSendMsg'; let mContext = null; @@ -307,7 +164,7 @@ function startContinuousTask() { wants: [ { bundleName: "com.example.myapplication", - abilityName: "com.example.myapplication.MainAbility", + abilityName: "EntryAbility", } ], // 点击通知后,动作类型 @@ -381,7 +238,7 @@ function sendMsgCallback(data) { return new MySequenceable(10, "Callee test"); } -export default class BgTaskAbility extends Ability { +export default class BgTaskAbility extends UIAbility { onCreate(want, launchParam) { console.info("[Demo] BgTaskAbility onCreate") this.callee.on("test", sendMsgCallback); @@ -422,6 +279,149 @@ export default class BgTaskAbility extends Ability { }; ``` +### 基于FA模型 + +基于FA的Service Ability使用,参考[ServiceAbility开发指导](../application-models/serviceability-overview.md)。 + +当不需要与后台执行的长时任务交互时,可以采用startAbility()方法启动Service Ability。并在Service Ability的onStart回调方法中,调用长时任务的申请接口,声明此服务需要在后台长时运行。当任务执行完,再调用长时任务取消接口,及时释放资源。 + +当需要与后台执行的长时任务交互时(如播放音乐等)。可以采用connectAbility()方法启动并连接Service Ability。在获取到服务的代理对象后,与服务进行通信,控制长时任务的申请和取消。 + +1、新建Api Version 8的工程后,在工程目录中右键选择“new” -> “Ability” -> “Service Ability” 快速创建Service Ability组件。并在config.json文件中配置长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING、后台模式类型,其中Ability类型为“service”。 + +```json +"module": { + "package": "com.example.myapplication", + "abilities": [ + { + "backgroundModes": [ + "dataTransfer", + "location" + ], // 后台模式类型 + "type": "service" // ability类型为service + } + ], + "reqPermissions": [ + { + "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" // 长时任务权限 + } + ] +} +``` + +2、在Service Ability调用长时任务的申请和取消接口。 + +```js +import backgroundTaskManager from '@ohos.resourceschedule.backgroundTaskManager'; +import featureAbility from '@ohos.ability.featureAbility'; +import wantAgent from '@ohos.wantAgent'; +import rpc from "@ohos.rpc"; + +function startContinuousTask() { + let wantAgentInfo = { + // 点击通知后,将要执行的动作列表 + wants: [ + { + bundleName: "com.example.myapplication", + abilityName: "EntryAbility" + } + ], + // 点击通知后,动作类型 + operationType: wantAgent.OperationType.START_ABILITY, + // 使用者自定义的一个私有值 + requestCode: 0, + // 点击通知后,动作执行属性 + wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] + }; + + // 通过wantAgent模块的getWantAgent方法获取WantAgent对象 + wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => { + try { + backgroundTaskManager.startBackgroundRunning(featureAbility.getContext(), + backgroundTaskManager.BackgroundMode.DATA_TRANSFER, wantAgentObj).then(() => { + console.info("Operation startBackgroundRunning succeeded"); + }).catch((err) => { + console.error("Operation startBackgroundRunning failed Cause: " + err); + }); + } catch (error) { + console.error(`Operation startBackgroundRunning failed. code is ${error.code} message is ${error.message}`); + } + }); +} + +function stopContinuousTask() { + try { + backgroundTaskManager.stopBackgroundRunning(featureAbility.getContext()).then(() => { + console.info("Operation stopBackgroundRunning succeeded"); + }).catch((err) => { + console.error("Operation stopBackgroundRunning failed Cause: " + err); + }); + } catch (error) { + console.error(`Operation stopBackgroundRunning failed. code is ${error.code} message is ${error.message}`); + } +} + +async function processAsyncJobs() { + // 此处执行具体的长时任务。 + + // 长时任务执行完,调用取消接口,释放资源。 + stopContinuousTask(); +} + +let mMyStub; + +class MyStub extends rpc.RemoteObject { + constructor(des) { + if (typeof des === 'string') { + super(des); + } else { + return null; + } + } + onRemoteRequest(code, data, reply, option) { + console.log('ServiceAbility onRemoteRequest called'); + // code 的具体含义用户自定义 + if (code === 1) { + // 接收到申请长时任务的请求码 + startContinuousTask(); + // 此处执行具体长时任务 + } else if (code === 2) { + // 接收到取消长时任务的请求码 + stopContinuousTask(); + } else { + console.log('ServiceAbility unknown request code'); + } + return true; + } +} + +export default { + onStart(want) { + console.info('ServiceAbility onStart'); + mMyStub = new MyStub("ServiceAbility-test"); + // 在执行后台长时任前,调用申请接口。 + startContinuousTask(); + processAsyncJobs(); + }, + onStop() { + console.info('ServiceAbility onStop'); + }, + onConnect(want) { + console.info('ServiceAbility onConnect'); + return mMyStub; + }, + onReconnect(want) { + console.info('ServiceAbility onReconnect'); + }, + onDisconnect() { + console.info('ServiceAbility onDisconnect'); + }, + onCommand(want, restart, startId) { + console.info('ServiceAbility onCommand'); + } +}; +``` + ## 相关实例 基于后台任务管理,有以下相关实例可供参考: diff --git a/zh-cn/application-dev/tools/bm-tool.md b/zh-cn/application-dev/tools/bm-tool.md index bd45b86df9b7723fbc4d78a4190d0d73f15f1f90..521292fea9f24be59586d7915566ae6aef54fea3 100644 --- a/zh-cn/application-dev/tools/bm-tool.md +++ b/zh-cn/application-dev/tools/bm-tool.md @@ -84,7 +84,7 @@ bm uninstall [-h help] [-n bundleName] [-m moduleName] [-u userId] [-k] 示例: ```bash -bm uninstall -n com.ohos.app -m com.ohos.app.MainAbility -u 100 -k +bm uninstall -n com.ohos.app -m com.ohos.app.EntryAbility -u 100 -k // 执行结果 uninstall bundle successfully. ``` @@ -184,7 +184,7 @@ bm enable [-h] [-n bundleName] [-a abilityName] [-u userId] ```bash # 使能该应用 -bm enable -n com.ohos.app -a com.ohos.app.MainAbility -u 100 +bm enable -n com.ohos.app -a com.ohos.app.EntryAbility -u 100 // 执行结果 enable bundle successfully. ``` @@ -213,7 +213,7 @@ bm disable [-h] [-n bundleName] [-a abilityName] [-u userId] ```bash # 禁用该应用 -bm disable -n com.ohos.app -a com.ohos.app.MainAbility -u 100 +bm disable -n com.ohos.app -a com.ohos.app.EntryAbility -u 100 // 执行结果 disable bundle successfully. ``` diff --git a/zh-cn/application-dev/ui/ui-ts-components-web.md b/zh-cn/application-dev/ui/ui-ts-components-web.md index 9a913bd2d0914de37b3157bc38aae4c4c4dcbbe1..046c192db4ce6dd17655981a8b8502e13e8e9b95 100644 --- a/zh-cn/application-dev/ui/ui-ts-components-web.md +++ b/zh-cn/application-dev/ui/ui-ts-components-web.md @@ -4,7 +4,7 @@ Web是提供网页显示能力的组件,具体用法请参考 [Web API](../ref ## 创建组件 -在main/ets/MainAbility/pages目录下的ets文件中创建一个Web组件。在web组件中通过src指定引用的网页路径,controller为组件的控制器,通过controller绑定Web组件,用于调用Web组件的方法。 +在main/ets/entryability/pages目录下的ets文件中创建一个Web组件。在web组件中通过src指定引用的网页路径,controller为组件的控制器,通过controller绑定Web组件,用于调用Web组件的方法。 ```ts // xxx.ets diff --git a/zh-cn/application-dev/windowmanager/application-window-stage.md b/zh-cn/application-dev/windowmanager/application-window-stage.md index 004083abdf467635599af9510b44bba54a6a0dc1..8c8a5aae28c6ab7ea0af2676909cf8d454865d70 100644 --- a/zh-cn/application-dev/windowmanager/application-window-stage.md +++ b/zh-cn/application-dev/windowmanager/application-window-stage.md @@ -66,9 +66,9 @@ 通过`loadContent`接口加载主窗口的目标页面。 ```ts -import Ability from '@ohos.application.Ability' +import UIAbility from '@ohos.app.ability.UIAbility'; -class MainAbility extends Ability { +export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { // 1.获取应用主窗口。 let windowClass = null; @@ -122,11 +122,11 @@ class MainAbility extends Ability { 当不再需要某些子窗口时,可根据具体实现逻辑,使用`destroyWindow`接口销毁子窗口。 ```ts - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; let windowStage_ = null; let sub_windowClass = null; - class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { showSubWindow() { // 1.创建应用子窗口。 windowStage_.createSubWindow("mySubWindow", (err, data) => { @@ -213,9 +213,9 @@ class MainAbility extends Ability { 通过`loadContent`接口加载沉浸式窗口的具体内容。 ```ts - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; - class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { // 1.获取应用主窗口。 let windowClass = null; @@ -295,7 +295,7 @@ class MainAbility extends Ability { "name" : "ohos.permission.SYSTEM_FLOAT_WINDOW", "usedScene": { "abilities": [ - "MainAbility" + "EntryAbility" ], "when":"inuse" } @@ -319,11 +319,11 @@ class MainAbility extends Ability { 当不再需要悬浮窗时,可根据具体实现逻辑,使用`destroyWindow`接口销毁悬浮窗。 ```ts - import Ability from '@ohos.application.Ability' + import UIAbility from '@ohos.app.ability.UIAbility'; import ExtensionContext from '@ohos.application.ServiceExtensionAbility'; import window from '@ohos.window'; - class MainAbility extends Ability { + export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage) { // 2. 创建悬浮窗。 let windowClass = null; diff --git a/zh-cn/application-dev/windowmanager/system-window-stage.md b/zh-cn/application-dev/windowmanager/system-window-stage.md index c665a537fd281fac2205334f5711cfbbc41003c2..19acc8b34b35f8e77cb5b7fdf857f85154955d65 100644 --- a/zh-cn/application-dev/windowmanager/system-window-stage.md +++ b/zh-cn/application-dev/windowmanager/system-window-stage.md @@ -63,7 +63,6 @@ import window from '@ohos.window'; export default class ServiceExtensionAbility1 extends ExtensionContext { onCreate(want) { - console.log("[Demo] MainAbility onCreate") globalThis.abilityWant = want; // 1.创建音量条窗口。 let windowClass = null; @@ -151,7 +150,6 @@ import window from '@ohos.window'; export default class ServiceExtensionAbility1 extends ExtensionContext { onCreate(want) { - console.log("[Demo] MainAbility onCreate") globalThis.abilityWant = want; // 创建音量条窗口。 let windowClass = null;