diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md index e2cc4c4bbc6d582b4dd42d905f5e71d98209f799..67ce1e966047b552c27793b472f356cea33edbf2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md @@ -17,7 +17,7 @@ import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback ## AbilityLifecycleCallback.onAbilityCreate -onAbilityCreate(ability: Ability): void; +onAbilityCreate(ability: UIAbility): void; 注册监听应用上下文的生命周期后，在ability创建时触发回调。 @@ -27,12 +27,12 @@ onAbilityCreate(ability: Ability): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | ## AbilityLifecycleCallback.onWindowStageCreate -onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void; +onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后，在windowStage创建时触发回调。 @@ -42,13 +42,13 @@ onWindowStageCreate(ability: Ability, windowStage: window.WindowStage): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | ## AbilityLifecycleCallback.onWindowStageActive -onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void; +onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后，在windowStage获焦时触发回调。 @@ -58,13 +58,13 @@ onWindowStageActive(ability: Ability, windowStage: window.WindowStage): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | ## AbilityLifecycleCallback.onWindowStageInactive -onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void; +onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后，在windowStage失焦时触发回调。 @@ -74,13 +74,13 @@ onWindowStageInactive(ability: Ability, windowStage: window.WindowStage): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | ## AbilityLifecycleCallback.onWindowStageDestroy -onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void; +onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后，在windowStage销毁时触发回调。 @@ -90,13 +90,13 @@ onWindowStageDestroy(ability: Ability, windowStage: window.WindowStage): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | ## AbilityLifecycleCallback.onAbilityDestroy -onAbilityDestroy(ability: Ability): void; +onAbilityDestroy(ability: UIAbility): void; 注册监听应用上下文的生命周期后，在ability销毁时触发回调。 @@ -106,12 +106,12 @@ onAbilityDestroy(ability: Ability): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | ## AbilityLifecycleCallback.onAbilityForeground -onAbilityForeground(ability: Ability): void; +onAbilityForeground(ability: UIAbility): void; 注册监听应用上下文的生命周期后，在ability的状态从后台转到前台时触发回调。 @@ -121,12 +121,12 @@ onAbilityForeground(ability: Ability): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | ## AbilityLifecycleCallback.onAbilityBackground -onAbilityBackground(ability: Ability): void; +onAbilityBackground(ability: UIAbility): void; 注册监听应用上下文的生命周期后，在ability的状态从前台转到后台时触发回调。 @@ -136,12 +136,12 @@ onAbilityBackground(ability: Ability): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | ## AbilityLifecycleCallback.onAbilityContinue -onAbilityContinue(ability: Ability): void; +onAbilityContinue(ability: UIAbility): void; 注册监听应用上下文的生命周期后，在ability迁移时触发回调。 @@ -151,15 +151,15 @@ onAbilityContinue(ability: Ability): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | + | ability | [UIAbility](js-apis-application-ability.md#Ability) | 是 | 当前Ability对象 | **示例：** ```js - import Ability from "@ohos.application.Ability"; + import UIAbility from "@ohos.app.ability.UIAbility"; - export default class MyAbility extends Ability { + export default class MyAbility extends UIAbility { onCreate() { console.log("MyAbility onCreate") let AbilityLifecycleCallback = { diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md index f88bb99df81b2d6c7fb0420b51557010dd5c6c49..bc152a69374aec5d81263678c05bf142668f1e80 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md @@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 | | callback | AsyncCallback\ | 是 | 被指定的回调方法。 | @@ -77,7 +77,7 @@ updateConfiguration(config: Configuration): Promise\ **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 | @@ -120,7 +120,7 @@ getAbilityRunningInfos(callback: AsyncCallback\>): vo **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | callback | AsyncCallback\> | 是 | 被指定的回调方法。 | @@ -184,7 +184,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\> | 是 | 被指定的回调方法。 | @@ -218,7 +218,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\): void; **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | callback | AsyncCallback\ | 是 | 被指定的回调方法。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md index 0863a4a46a1e98ca5cddf4fa5adcce74d866fc91..dfdd2b4af0249bf4e595471ae5ad5bf9c04bc485 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-abilitystage.md @@ -66,9 +66,9 @@ onAcceptWant(want: Want): string; ``` -## AbilityStage.onConfigurationUpdated +## AbilityStage.onConfigurationUpdate -onConfigurationUpdated(config: Configuration): void; +onConfigurationUpdate(config: Configuration): void; 环境变化通知接口，发生全局配置变更时回调。 @@ -84,8 +84,8 @@ onConfigurationUpdated(config: Configuration): void; ```js class MyAbilityStage extends AbilityStage { - onConfigurationUpdated(config) { - console.log('onConfigurationUpdated, language:' + config.language); + onConfigurationUpdate(config) { + console.log('onConfigurationUpdate, language:' + config.language); } } ``` @@ -96,7 +96,7 @@ onMemoryLevel(level: AbilityConstant.MemoryLevel): void; 当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。 -**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **参数：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md index 0d7f113e580df601682bf836a141ce668d24a844..2abe7c1e84c37a4be6aa435ce5be316cf3d1420d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appmanager.md @@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<boolean> | 否 | 返回当前是否处于稳定性测试场景。 | + | callback | AsyncCallback<boolean> | 是 | 返回当前是否处于稳定性测试场景。 | **示例：** @@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<boolean> | 否 | 返回当前是否是ram受限设备。 | + | callback | AsyncCallback<boolean> | 是 | 返回当前是否是ram受限设备。 | **示例：** @@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<number> | 否 | 应用程序内存大小。 | + | callback | AsyncCallback<number> | 是 | 应用程序内存大小。 | **示例：** @@ -166,6 +166,8 @@ getProcessRunningInformation(): Promise\>; **系统能力**：SystemCapability.Ability.AbilityRuntime.Core +**系统API**: 此接口为系统接口，三方应用不支持调用。 + **返回值：** | 类型 | 说明 | @@ -192,6 +194,8 @@ getProcessRunningInformation(callback: AsyncCallback\ | 否 | 表示需要注册监听的bundleName数组。最大值128。 | +| observer | [ApplicationStateObserver](#applicationstateobserver) | 是 | 返回观察者的数字代码。 | +| bundleNameList | Array | 是 | 表示需要注册监听的bundleName数组。最大值128。 | **示例：** @@ -321,8 +325,8 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\ | 否 | 表示指定的回调方法。 | +| observerId | number | 是 | 表示观察者的编号代码。 | +| callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -358,7 +362,7 @@ off(type: "applicationState", observerId: number): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 调用接口类型 | -| observerId | number | 否 | 表示观察者的编号代码。 | +| observerId | number | 是 | 表示观察者的编号代码。 | **返回值：** @@ -400,7 +404,7 @@ getForegroundApplications(callback: AsyncCallback\>): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| callback | AsyncCallback\> | 否 | 表示应用的状态数据。 | +| callback | AsyncCallback\> | 否是 | 表示应用的状态数据。 | **示例：** @@ -538,8 +542,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 否 | 表示包名。 | -| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 | +| bundleName | string | 是 | 表示包名。 | +| callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -575,7 +579,7 @@ killProcessesByBundleName(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 否 | 表示包名。 | +| bundleName | string | 是| 表示包名。 | **返回值：** @@ -617,8 +621,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\); | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 否 | 表示包名。 | -| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 | +| bundleName | string | 是 | 表示包名。 | +| callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -655,7 +659,7 @@ clearUpApplicationData(bundleName: string): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| bundleName | string | 否 | 表示包名。 | +| bundleName | string | 是 | 表示包名。 | **返回值：** @@ -681,227 +685,6 @@ clearUpApplicationData(bundleName: string): Promise\; ``` -## ApplicationStateObserver.onForegroundApplicationChanged - -onForegroundApplicationChanged(appStateData: AppStateData): void; - -将在前台或后台应用程序更改时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**系统API**：该接口为系统接口，三方应用不支持调用。 - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| appStateData | [AppStateData](#appstatedata) | 否 | 状态更改的应用程序信息。 | - -**示例：** - -```js - var applicationStateObserver = { - onForegroundApplicationChanged(appStateData) { - console.log('------------ onForegroundApplicationChanged -----------', appStateData); - }, - onAbilityStateChanged(abilityStateData) { - console.log('------------ onAbilityStateChanged -----------', abilityStateData); - }, - onProcessCreated(processData) { - console.log('------------ onProcessCreated -----------', processData); - }, - onProcessDied(processData) { - console.log('------------ onProcessDied -----------', processData); - }, - onProcessStateChanged(processData) { - console.log('------------ onProcessStateChanged -----------', processData); - } - } - try { - const observerCode = app.on("applicationState", applicationStateObserver); - console.log('-------- observerCode: ---------', observerCode); - } catch (paramError) { - console.log('error: ' + paramError.code + ', ' + paramError.message); - } - -``` - -## ApplicationStateObserver.onAbilityStateChanged - -onAbilityStateChanged(abilityStateData: AbilityStateData): void; - -将在能力状态更改时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**系统API**：该接口为系统接口，三方应用不支持调用。 - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| abilityStateData | [AbilityStateData](#abilitystatedata) | 否 | 状态更改的能力信息。 | - -**示例：** - -```js - var applicationStateObserver = { - onForegroundApplicationChanged(appStateData) { - console.log('------------ onForegroundApplicationChanged -----------', appStateData); - }, - onAbilityStateChanged(abilityStateData) { - console.log('------------ onAbilityStateChanged -----------', abilityStateData); - }, - onProcessCreated(processData) { - console.log('------------ onProcessCreated -----------', processData); - }, - onProcessDied(processData) { - console.log('------------ onProcessDied -----------', processData); - }, - onProcessStateChanged(processData) { - console.log('------------ onProcessStateChanged -----------', processData); - } - } - try { - const observerCode = app.on("applicationState", applicationStateObserver); - console.log('-------- observerCode: ---------', observerCode); - } catch (paramError) { - console.log('error: ' + paramError.code + ', ' + paramError.message); - } -``` - -## ApplicationStateObserver.onProcessCreated - -onProcessCreated(processData: ProcessData): void; - -将在创建进程时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**系统API**：该接口为系统接口，三方应用不支持调用。 - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| processData | [ProcessData](#processdata) | 否 | 进程信息。 | - -**示例：** - -```js - var applicationStateObserver = { - onForegroundApplicationChanged(appStateData) { - console.log('------------ onForegroundApplicationChanged -----------', appStateData); - }, - onAbilityStateChanged(abilityStateData) { - console.log('------------ onAbilityStateChanged -----------', abilityStateData); - }, - onProcessCreated(processData) { - console.log('------------ onProcessCreated -----------', processData); - }, - onProcessDied(processData) { - console.log('------------ onProcessDied -----------', processData); - }, - onProcessStateChanged(processData) { - console.log('------------ onProcessStateChanged -----------', processData); - } - } - try { - const observerCode = app.on("applicationState", applicationStateObserver); - console.log('-------- observerCode: ---------', observerCode); - } catch (paramError) { - console.log('error: ' + paramError.code + ', ' + paramError.message); - } -``` - -## ApplicationStateObserver.onProcessDied - -onProcessDied(processData: ProcessData): void; - -将在进程终止时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**系统API**：该接口为系统接口，三方应用不支持调用。 - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| processData | [ProcessData](#processdata) | 否 | 进程信息。 | - -**示例：** - -```js - var applicationStateObserver = { - onForegroundApplicationChanged(appStateData) { - console.log('------------ onForegroundApplicationChanged -----------', appStateData); - }, - onAbilityStateChanged(abilityStateData) { - console.log('------------ onAbilityStateChanged -----------', abilityStateData); - }, - onProcessCreated(processData) { - console.log('------------ onProcessCreated -----------', processData); - }, - onProcessDied(processData) { - console.log('------------ onProcessDied -----------', processData); - }, - onProcessStateChanged(processData) { - console.log('------------ onProcessStateChanged -----------', processData); - } - } - try { - const observerCode = app.on("applicationState", applicationStateObserver); - console.log('-------- observerCode: ---------', observerCode); - } catch (paramError) { - console.log('error: ' + paramError.code + ', ' + paramError.message); - } -``` - -## ApplicationStateObserver.onProcessStateChanged - - onProcessStateChanged(processData: ProcessData): void; - -当进程状态更改时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**系统API**：该接口为系统接口，三方应用不支持调用。 - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| processData | [ProcessData](#processdata) | 否 | 进程信息。 | - -**示例：** - -```js - var applicationStateObserver = { - onForegroundApplicationChanged(appStateData) { - console.log('------------ onForegroundApplicationChanged -----------', appStateData); - }, - onAbilityStateChanged(abilityStateData) { - console.log('------------ onAbilityStateChanged -----------', abilityStateData); - }, - onProcessCreated(processData) { - console.log('------------ onProcessCreated -----------', processData); - }, - onProcessDied(processData) { - console.log('------------ onProcessDied -----------', processData); - }, - onProcessStateChanged(processData) { - console.log('------------ onProcessStateChanged -----------', processData); - } - } - try { - const observerCode = app.on("applicationState", applicationStateObserver); - console.log('-------- observerCode: ---------', observerCode); - } catch (paramError) { - console.log('error: ' + paramError.code + ', ' + paramError.message); - } -``` - ## AppStateData **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md index 14b9d63f228cc09e7ba4e483ab4fe9af6bf87c80..e763c0b4eba21a8def8b12ae777ea69f0220f10f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-errorManager.md @@ -24,7 +24,7 @@ on(type: "error", observer: ErrorObserver): number; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 调用接口类型 | -| observer | [ErrorObserver](#errorobserver) | 否 | 返回观察者的数字代码。 | +| observer | [ErrorObserver](#errorobserver) | 是 | 返回观察者的数字代码。 | **示例：** @@ -54,8 +54,8 @@ off(type: "error", observerId: number, callback: AsyncCallback\): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 调用接口类型 | -| observerId | number | 否 | 返回观察者的数字代码。 | -| callback | AsyncCallback\ | 否 | 表示指定的回调方法。 | +| observerId | number | 是 | 返回观察者的数字代码。 | +| callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -87,7 +87,7 @@ off(type: "error", observerId: number): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 调用接口类型 | -| observerId | number | 否 | 返回观察者的数字代码。 | +| observerId | number | 是 | 返回观察者的数字代码。 | **返回值：** @@ -111,29 +111,4 @@ try { console.log("error: " + paramError.code + ", " + paramError.message); } -``` - -## ErrorObserver - -onUnhandledException(errMsg: string): void; - -将在js运行时引发用户未捕获的异常时调用。 - -**系统能力**：SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------- | -------- | -------- | -| errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 | - -**示例：** - -```js -var observer = { - onUnhandledException(errorMsg) { - console.log('onUnhandledException, errorMsg: ', errorMsg) - } -} -errorManager.on(observer) ``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md index 39d2dc130a026f94d2b6ecc1131d28082dd0304e..24f8bf579b6688ecd1df0496430dac0d96a8eacf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md @@ -59,8 +59,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\, callback: AsyncCallback\ | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | - | callback | AsyncCallback\ | 否 | 表示指定的回调方法。 | + | hapModuleQuickFixFiles | Array\ | 是 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | + | callback | AsyncCallback\ | 是 | 表示指定的回调方法。 | **示例：** @@ -97,7 +97,7 @@ applyQuickFix(hapModuleQuickFixFiles: Array\): Promise\; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | hapModuleQuickFixFiles | Array\ | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | + | hapModuleQuickFixFiles | Array\ | 是 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | **返回值：** @@ -138,8 +138,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\ | 否 | 应用的快速修复信息。 | + | bundleName | string | 是 |应用的包名。 | + | callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 是 | 应用的快速修复信息。 | **示例：** @@ -176,7 +176,7 @@ getApplicationQuickFixInfo(bundleName: string): Promise\): Array\; 转储客户端信息时调用。 -**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统API**: 此接口为系统接口，三方应用不支持调用。 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 a9bb35105043b6c6fbfe533c715750e307b13c29..63e28a3557347f6d343e8ec5675c3983b994b63d 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 @@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\): void **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| -------- | --- | ---- | -------------------------- | ---- | ----------------------- | -| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 创建WantAgent的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------- | ---- | ----------------------- | +| info | WantAgentInfo | 是 | WantAgent信息。 | +| callback | AsyncCallback\ | 是 | 创建WantAgent的回调方法。 | **示例：** @@ -83,9 +83,9 @@ getWantAgent(info: WantAgentInfo): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ---- | --- | ---- | ------------- | ---- | ------------- | -| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---- | ------------- | ---- | ------------- | +| info | WantAgentInfo | 是 | WantAgent信息。 | **返回值：** @@ -148,10 +148,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\): void **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| -------- | --- | ---- | ----------------------- | ---- | --------------------------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 获取WantAgent实例的包名的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------- | ---- | --------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 获取WantAgent实例的包名的回调方法。 | **示例：** @@ -224,9 +224,9 @@ getBundleName(agent: WantAgent): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ----- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | **返回值：** @@ -297,10 +297,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\): void **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| -------- | --- | ---- | ----------------------- | ---- | ----------------------------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 获取WantAgent实例的用户ID的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------- | ---- | ----------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 获取WantAgent实例的用户ID的回调方法。 | **示例：** @@ -373,9 +373,9 @@ getUid(agent: WantAgent): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ----- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | **返回值：** @@ -448,10 +448,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\): void **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| -------- | --- | ---- | --------------------- | ---- | ------------------------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 获取WantAgent对象want的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------- | ---- | ------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 获取WantAgent对象want的回调方法。 | **示例：** @@ -526,9 +526,9 @@ getWant(agent: WantAgent): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ----- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | **返回值：** @@ -599,10 +599,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\): void **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| -------- | --- | ---- | --------------------- | ---- | --------------------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 取消WantAgent实例的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------- | ---- | --------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 取消WantAgent实例的回调方法。 | **示例：** @@ -675,9 +675,9 @@ cancel(agent: WantAgent): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ----- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | **返回值：** @@ -748,11 +748,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\ | 是 | 主动激发WantAgent实例的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ----------------------------- | ---- | ------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| triggerInfo | TriggerInfo | 是 | TriggerInfo对象。 | +| callback | AsyncCallback\ | 是 | 主动激发WantAgent实例的回调方法。 | **示例：** @@ -830,11 +830,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\ | 是 | 判断两个WantAgent实例是否相等的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------ | ---- | --------------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| otherAgent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 判断两个WantAgent实例是否相等的回调方法。 | **示例：** @@ -909,10 +909,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\ **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ---------- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| otherAgent | WantAgent | 是 | WantAgent对象。 | **返回值：** @@ -983,10 +983,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\): void; **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | -| callback | 是 | 否 | AsyncCallback\ | 是 | 获取一个WantAgent的OperationType信息的回调方法。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------------ | ---- | --------------------------------------- | +| agent | WantAgent | 是 | WantAgent对象。 | +| callback | AsyncCallback\ | 是 | 获取一个WantAgent的OperationType信息的回调方法。 | **示例：** @@ -1048,9 +1048,9 @@ getOperationType(agent: WantAgent): Promise\; **参数：** -| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 | -| ---------- | --- | ---- | --------- | ---- | ------------- | -| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | --------- | ---- | ------------- | +| agent | WantAgent | 是 | WantAgent对象。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md index a02593062faa0edc0bde3809ca91f2b172ad93c0..84a3885c2345648b8a8601c9380829a59172770e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formextensionability.md @@ -197,7 +197,7 @@ export default class MyFormExtensionAbility extends FormExtensionAbility { ## onConfigurationUpdate -onConfigurationUpdate(config: Configuration): void; +onConfigurationUpdate(newconfig: Configuration): void; 当系统配置更新时调用。 @@ -207,7 +207,7 @@ onConfigurationUpdate(config: Configuration): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| config | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 | +| newconfig | [Configuration](js-apis-configuration.md) | 是 | 表示需要更新的配置信息。 | **示例：** @@ -231,7 +231,7 @@ onAcquireFormState?(want: Want): formInfo.FormState; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| want | [Want](js-apis-application-Want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 | +| want | [Want](js-apis-application-Want.md) | 是 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md index a47a3dcfb98c1bc4996bf4df835509d1db2f212b..18b7dc9a821522922f0963e6f8228e848ff2485b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formhost.md @@ -32,11 +32,11 @@ deleteForm(formId: string, callback: AsyncCallback<void>): void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -81,11 +81,11 @@ deleteForm(formId: string): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **参数：** @@ -121,11 +121,11 @@ releaseForm(formId: string, callback: AsyncCallback<void>): void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -162,11 +162,11 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback< **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -208,11 +208,11 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -248,11 +248,11 @@ requestForm(formId: string, callback: AsyncCallback<void>): void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -293,11 +293,11 @@ requestForm(formId: string): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -315,9 +315,9 @@ try { ``` -## castTempForm +## castToNormalForm -castTempForm(formId: string, callback: AsyncCallback<void>): void +castToNormalForm(formId: string, callback: AsyncCallback<void>): void 将指定的临时卡片转换为普通卡片。使用callback异步回调。 @@ -334,18 +334,18 @@ castTempForm(formId: string, callback: AsyncCallback<void>): void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** ```js try { var formId = "12400633174999288"; - formHost.castTempForm(formId, (error, data) => { + formHost.castToNormalForm(formId, (error, data) => { if (error) { console.log('formHost castTempForm, error:' + JSON.stringify(error)); } @@ -355,9 +355,9 @@ try { } ``` -## castTempForm +## castToNormalForm -castTempForm(formId: string): Promise<void> +castToNormalForm(formId: string): Promise<void> 将指定的临时卡片转换为普通卡片。使用Promise异步回调。 @@ -379,18 +379,18 @@ castTempForm(formId: string): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** ```js try { var formId = "12400633174999288"; - formHost.castTempForm(formId).then(() => { + formHost.castToNormalForm(formId).then(() => { console.log('formHost castTempForm success'); }).catch((error) => { console.log('formHost castTempForm, error:' + JSON.stringify(error)); @@ -419,10 +419,10 @@ notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -463,10 +463,10 @@ notifyVisibleForms(formIds: Array<string>): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -502,10 +502,10 @@ notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<vo **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -546,10 +546,10 @@ notifyInvisibleForms(formIds: Array<string>): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -585,11 +585,11 @@ enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void& **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -630,11 +630,11 @@ enableFormsUpdate(formIds: Array<string>): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -670,11 +670,11 @@ disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -715,11 +715,11 @@ disableFormsUpdate(formIds: Array<string>): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -875,10 +875,10 @@ getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.Fo **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -916,10 +916,10 @@ getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback< **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -962,10 +962,10 @@ getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formI **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1071,10 +1071,10 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1126,10 +1126,10 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1268,10 +1268,10 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise< **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1308,10 +1308,10 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1353,10 +1353,10 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1378,7 +1378,7 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>) 指定formId和远程设备Id进行卡片分享。使用callback异步回调。 -**需要权限**：ohos.permission.REQUIRE_FORM +**需要权限**：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC **系统能力**：SystemCapability.Ability.Form @@ -1392,11 +1392,11 @@ shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>) **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -1421,7 +1421,7 @@ shareForm(formId: string, deviceId: string): Promise<void> 指定formId和远程设备Id进行卡片分享。使用Promise异步回调。 -**需要权限**：ohos.permission.REQUIRE_FORM +**需要权限**：ohos.permission.REQUIRE_FORM 和 ohos.permission.DISTRIBUTED_DATASYNC **系统能力**：SystemCapability.Ability.Form @@ -1440,11 +1440,11 @@ shareForm(formId: string, deviceId: string): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **参数：** @@ -1464,7 +1464,7 @@ try { ## notifyFormsPrivacyProtected -notifyFormsPrivacyProtected(formIds: Array, isProtected: boolean, callback: AsyncCallback): void +notifyFormsPrivacyProtected(formIds: Array\, isProtected: boolean, callback: AsyncCallback\): void **需要权限**：ohos.permission.REQUIRE_FORM diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md b/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md index 6b07b85c77ccb627edad9ce6957b174e47671a64..fcaeee4d751c1d692cb9e86fdd6c12316b78b9f7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-form-formprovider.md @@ -27,13 +27,13 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l | minute | number | 是 | 指定多久之后更新，单位分钟，大于等于5。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | | 16501001 | The ID of the form to be operated does not exist. | | 16501002 | The number of forms exceeds the upper bound. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -75,13 +75,13 @@ setFormNextRefreshTime(formId: string, minute: number): Promise<void> **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | | 16501001 | The ID of the form to be operated does not exist. | | 16501002 | The number of forms exceeds the upper bound. | | 16501003 | The form can not be operated by the current application. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -111,15 +111,15 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | formId | string | 是 | 请求更新的卡片标识。 | -| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | +| formBindingData.FormBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -153,7 +153,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | formId | string | 是 | 请求更新的卡片标识。 | -| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | +| formBindingData.FormBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 用于更新的数据。 | **返回值：** @@ -163,10 +163,10 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501001 | The ID of the form to be operated does not exist. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -201,10 +201,10 @@ getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): voi **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -239,10 +239,10 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -287,10 +287,10 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For **错误码：** -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16500100 | Failed to obtain configuration information. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -326,7 +326,7 @@ requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------------------------- | ---- | ---------------- | | want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" | -| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 | +| formBindingData.FormBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 | | callback | AsyncCallback<string> | 是 | 回调函数。返回卡片标识。 | 以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 @@ -377,10 +377,10 @@ requestPublishForm(want: Want, callback: AsyncCallback<string>): void | want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" | | callback | AsyncCallback<string> | 是 | 回调函数。返回卡片标识。 | -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** @@ -422,7 +422,7 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData | 参数名 | 类型 | 必填 | 说明 | | --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。
abilityName: 目标卡片ability
parameters:
"ohos.extra.param.key.form_dimension"
"ohos.extra.param.key.form_name"
"ohos.extra.param.key.module_name" | -| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 | +| formBindingData.FormBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 否 | 创建卡片的数据。 | **返回值：** @@ -430,10 +430,10 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData | :------------ | :---------------------------------- | | Promise<string> | Promise对象。返回卡片标识。 | -以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 | 错误码ID | 错误信息 | | -------- | -------- | | 16501000 | A functional error occurred. | +以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)。 **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-ExtensionAbility.md index a574f63255eed103025a977ca2a7a782170bb33c..2817376c881e2032115872dba9ca1a5216bad9e0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-ExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-ExtensionAbility.md @@ -15,7 +15,7 @@ import ExtensionAbility from '@ohos.application.ExtensionAbility'; ## AbilityStage.onConfigurationUpdated -onConfigurationUpdated(config: Configuration): void; +onConfigurationUpdated(newconfig: Configuration): void; 环境变化通知接口，发生全局配置变更时回调。 @@ -25,7 +25,7 @@ onConfigurationUpdated(config: Configuration): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | config | [Configuration](js-apis-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 | + | newconfig | [Configuration](js-apis-configuration.md) | 是 | 发生全局配置变更时触发回调，当前全局配置包括系统语言、深浅色模式。 | **示例：** 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 e704a1b8c31e0bae481cc5446e2dfd2c49d83129..cd684f9de3d17e09e947e864f05f69c27f2c946b 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 @@ -736,23 +736,3 @@ off(method: string): void; } } ``` - -## OnReleaseCallback - -(msg: string): void; - -**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore - -| 名称 | 类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| (msg: string) | function | 是 | 否 | 调用者注册的侦听器函数接口的原型。 | - -## CalleeCallback - -(indata: rpc.MessageParcel): rpc.Sequenceable; - -**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore - -| 名称 | 类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| (indata: rpc.MessageParcel) | rpc.Sequenceable | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md index 34595bc0138a11d854c8646fb8bdb058eb077908..27d00eda16234cb9b4292262b90a995c6f29efcf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md @@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\): void **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 | | callback | AsyncCallback\ | 是 | 被指定的回调方法。 | @@ -72,7 +72,7 @@ updateConfiguration(config: Configuration): Promise\ **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 | @@ -110,7 +110,7 @@ getAbilityRunningInfos(callback: AsyncCallback\>): vo **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | callback | AsyncCallback\> | 是 | 被指定的回调方法。 | @@ -164,7 +164,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\> | 是 | 被指定的回调方法。 | @@ -193,7 +193,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\): void; **参数**： -| 名称 | 类型 | 必填 | 说明 | +| 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------------- | | callback | AsyncCallback\ | 是 | 被指定的回调方法。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md index 80f02e62adf8e1fff65f6141ff35e125f5ebca01..5817602e14985390811d2868759a69b1b15b60a9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md @@ -12,7 +12,7 @@ appManager模块提供App管理的能力，包括查询当前是否处于稳定 import app from '@ohos.application.appManager'; ``` -## appManager.isRunningInStabilityTest +## appManager.isRunningInStabilityTest8 static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void diff --git a/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md b/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md index 000ff5527b70742972ddd9c16243823027f7259c..63097121b43041262e9daf0589ae7fed70bd5fcd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md +++ b/zh-cn/application-dev/reference/apis/js-apis-formbindingdata.md @@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData | 参数名 | 类型 | 必填 | 说明 | | ------ | -------------- | ---- | ------------------------------------------------------------ | -| obj | Object或string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} | +| obj | Object\|string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识，内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} | **返回值：**