提交 96adf1a7 编写于 作者: D donglin

fix

Signed-off-by: Ndonglin <donglin9@huawei.com>
Change-Id: Ib26fa4fc16853fc3be21562a57948f00ce46bb17
上级 c0fbeea5
......@@ -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 = {
......
......@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 |
| callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 |
......@@ -77,7 +77,7 @@ updateConfiguration(config: Configuration): Promise\<void>
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项。 |
......@@ -120,7 +120,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
......@@ -184,7 +184,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
......@@ -218,7 +218,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
......@@ -257,7 +257,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 |
......
......@@ -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
**参数:**
......
......@@ -24,7 +24,7 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | | 返回当前是否处于稳定性测试场景。 |
| callback | AsyncCallback&lt;boolean&gt; | | 返回当前是否处于稳定性测试场景。 |
**示例:**
......@@ -98,7 +98,7 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | | 返回当前是否是ram受限设备。 |
| callback | AsyncCallback&lt;boolean&gt; | | 返回当前是否是ram受限设备。 |
**示例:**
......@@ -145,7 +145,7 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;number&gt; | | 应用程序内存大小。 |
| callback | AsyncCallback&lt;number&gt; | | 应用程序内存大小。 |
**示例:**
......@@ -166,6 +166,8 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
**返回值:**
| 类型 | 说明 |
......@@ -192,6 +194,8 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -224,7 +228,7 @@ on(type: "applicationState", observer: ApplicationStateObserver): number;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observer | [ApplicationStateObserver](#applicationstateobserver) | | 返回观察者的数字代码。 |
| observer | [ApplicationStateObserver](#applicationstateobserver) | | 返回观察者的数字代码。 |
**示例:**
......@@ -272,8 +276,8 @@ on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observer | [ApplicationStateObserver](#applicationstateobserver) | | 返回观察者的数字代码。 |
| bundleNameList | Array<string> | | 表示需要注册监听的bundleName数组。最大值128。 |
| observer | [ApplicationStateObserver](#applicationstateobserver) | | 返回观察者的数字代码。 |
| bundleNameList | Array<string> | | 表示需要注册监听的bundleName数组。最大值128。 |
**示例:**
......@@ -321,8 +325,8 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observerId | number | | 表示观察者的编号代码。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
| observerId | number | | 表示观察者的编号代码。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
**示例:**
......@@ -358,7 +362,7 @@ off(type: "applicationState", observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observerId | number | | 表示观察者的编号代码。 |
| observerId | number | | 表示观察者的编号代码。 |
**返回值:**
......@@ -400,7 +404,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<AppStateData>> | 否 | 表示应用的状态数据。 |
| callback | AsyncCallback\<Array\<AppStateData>> | 否 | 表示应用的状态数据。 |
**示例:**
......@@ -538,8 +542,8 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | | 表示包名。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
| bundleName | string | | 表示包名。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
**示例:**
......@@ -575,7 +579,7 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | | 表示包名。 |
| bundleName | string | | 表示包名。 |
**返回值:**
......@@ -617,8 +621,8 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | | 表示包名。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
| bundleName | string | | 表示包名。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
**示例:**
......@@ -655,7 +659,7 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | | 表示包名。 |
| bundleName | string | | 表示包名。 |
**返回值:**
......@@ -681,227 +685,6 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
```
## 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
......
......@@ -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>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 调用接口类型 |
| observerId | number | | 返回观察者的数字代码。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
| observerId | number | | 返回观察者的数字代码。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
**示例:**
......@@ -87,7 +87,7 @@ off(type: "error", observerId: number): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 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
......@@ -59,8 +59,8 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>, callback: AsyncCallback\<v
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| hapModuleQuickFixFiles | Array\<string> | | 快速修复补丁文件(补丁文件需包含有效的文件路径)。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
| hapModuleQuickFixFiles | Array\<string> | | 快速修复补丁文件(补丁文件需包含有效的文件路径)。 |
| callback | AsyncCallback\<void> | | 表示指定的回调方法。 |
**示例:**
......@@ -97,7 +97,7 @@ applyQuickFix(hapModuleQuickFixFiles: Array\<string>): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| hapModuleQuickFixFiles | Array\<string> | | 快速修复补丁文件(补丁文件需包含有效的文件路径)。 |
| hapModuleQuickFixFiles | Array\<string> | | 快速修复补丁文件(补丁文件需包含有效的文件路径)。 |
**返回值:**
......@@ -138,8 +138,8 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\<Applicat
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | |应用的包名。 |
| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | | 应用的快速修复信息。 |
| bundleName | string | |应用的包名。 |
| callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | | 应用的快速修复信息。 |
**示例:**
......@@ -176,7 +176,7 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | | 应用的包名。 |
| bundleName | string | | 应用的包名。 |
**返回值:**
......
......@@ -198,9 +198,9 @@ onReconnect(want: Want): void;
}
```
## ServiceExtensionAbility.onConfigurationUpdated
## ServiceExtensionAbility.onConfigurationUpdate
onConfigurationUpdated(config: Configuration): void;
onConfigurationUpdate(config: Configuration): void;
当Extension更新配置信息时调用。
......@@ -218,8 +218,8 @@ onConfigurationUpdated(config: Configuration): void;
```js
class ServiceExt extends ServiceExtension {
onConfigurationUpdated(config) {
console.log('onConfigurationUpdated, config:' + JSON.stringify(config));
onConfigurationUpdate(config) {
console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
}
}
```
......@@ -230,7 +230,7 @@ onDump(params: Array\<string>): Array\<string>;
转储客户端信息时调用。
**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口,三方应用不支持调用。
......
......@@ -22,10 +22,10 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| -------- | --- | ---- | -------------------------- | ---- | ----------------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
| callback | 是 | 否 | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ----------------------- |
| info | WantAgentInfo | 是 | WantAgent信息。 |
| callback | AsyncCallback\<WantAgent\> | 是 | 创建WantAgent的回调方法。 |
**示例:**
......@@ -83,9 +83,9 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ---- | --- | ---- | ------------- | ---- | ------------- |
| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------------- | ---- | ------------- |
| info | WantAgentInfo | 是 | WantAgent信息。 |
**返回值:**
......@@ -148,10 +148,10 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| -------- | --- | ---- | ----------------------- | ---- | --------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | --------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<string\> | 是 | 获取WantAgent实例的包名的回调方法。 |
**示例:**
......@@ -224,9 +224,9 @@ getBundleName(agent: WantAgent): Promise\<string\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ----- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......@@ -297,10 +297,10 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| -------- | --- | ---- | ----------------------- | ---- | ----------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ----------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<number\> | 是 | 获取WantAgent实例的用户ID的回调方法。 |
**示例:**
......@@ -373,9 +373,9 @@ getUid(agent: WantAgent): Promise\<number\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ----- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......@@ -448,10 +448,10 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| -------- | --- | ---- | --------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<Want\> | 是 | 获取WantAgent对象want的回调方法。 |
**示例:**
......@@ -526,9 +526,9 @@ getWant(agent: WantAgent): Promise\<Want\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ----- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......@@ -599,10 +599,10 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| -------- | --- | ---- | --------------------- | ---- | --------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | --------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<void\> | 是 | 取消WantAgent实例的回调方法。 |
**示例:**
......@@ -675,9 +675,9 @@ cancel(agent: WantAgent): Promise\<void\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ----- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......@@ -748,11 +748,11 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\<Complet
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ----------- | --- | ---- | ----------------------------- | ---- | ------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| triggerInfo | 是 | 否 | TriggerInfo | 是 | TriggerInfo对象。 |
| callback | 是 | 否 | AsyncCallback\<CompleteData\> | 是 | 主动激发WantAgent实例的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------- | ---- | ------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| triggerInfo | TriggerInfo | 是 | TriggerInfo对象。 |
| callback | AsyncCallback\<CompleteData\> | 是 | 主动激发WantAgent实例的回调方法。 |
**示例:**
......@@ -830,11 +830,11 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<boolean\> | 是 | 判断两个WantAgent实例是否相等的回调方法。 |
**示例:**
......@@ -909,10 +909,10 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ---------- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| otherAgent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| otherAgent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......@@ -983,10 +983,10 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ---------- | --- | ---- | ------------------------ | ---- | --------------------------------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| callback | 是 | 否 | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------ | ---- | --------------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback\<number> | 是 | 获取一个WantAgent的OperationType信息的回调方法。 |
**示例:**
......@@ -1048,9 +1048,9 @@ getOperationType(agent: WantAgent): Promise\<number>;
**参数:**
| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
| ---------- | --- | ---- | --------- | ---- | ------------- |
| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------- | ---- | ------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
**返回值:**
......
......@@ -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表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例:**
......
......@@ -32,11 +32,11 @@ deleteForm(formId: string, callback: AsyncCallback&lt;void&gt;): 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&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;): 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&lt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;): 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&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;): void
castToNormalForm(formId: string, callback: AsyncCallback&lt;void&gt;): void
将指定的临时卡片转换为普通卡片。使用callback异步回调。
......@@ -334,18 +334,18 @@ castTempForm(formId: string, callback: AsyncCallback&lt;void&gt;): 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&lt;void&gt;
castToNormalForm(formId: string): Promise&lt;void&gt;
将指定的临时卡片转换为普通卡片。使用Promise异步回调。
......@@ -379,18 +379,18 @@ castTempForm(formId: string): Promise&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;string&gt;, callback: AsyncCallback&lt;void
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
**示例:**
......@@ -463,10 +463,10 @@ notifyVisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
**示例:**
......@@ -502,10 +502,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;vo
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
**示例:**
......@@ -546,10 +546,10 @@ notifyInvisibleForms(formIds: Array&lt;string&gt;): Promise&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
**示例:**
......@@ -585,11 +585,11 @@ enableFormsUpdate(formIds: Array&lt;string&gt;, callback: AsyncCallback&lt;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&lt;string&gt;): Promise&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;string&gt;, callback: AsyncCallback&lt;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&lt;string&gt;): Promise&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;Array&lt;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&lt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;Array&lt;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&lt;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&lt;formInfo.FormStateInfo&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
**示例:**
......@@ -1268,10 +1268,10 @@ notifyFormsVisible(formIds: Array&lt;string&gt;, isVisible: boolean): Promise&lt
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;string&gt;, 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&lt;string&gt;, 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&lt;void&gt;)
指定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&lt;void&gt;)
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;
指定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&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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<string>, isProtected: boolean, callback: AsyncCallback<void>): void
notifyFormsPrivacyProtected(formIds: Array\<string>, isProtected: boolean, callback: AsyncCallback\<void>): void
**需要权限**:ohos.permission.REQUIRE_FORM
......
......@@ -27,13 +27,13 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
| minute | number | 是 | 指定多久之后更新,单位分钟,大于等于5。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt;
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;void&gt; | 是 | 回调函数。 |
**错误码:**
以下错误码的详细介绍请参见[卡片错误码](../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&lt;Array&lt;formInfo.FormInfo&gt;&gt;): 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&lt;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&lt;Array&lt;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) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 |
| formBindingData.FormBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | 是 | 创建卡片的数据。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
......@@ -377,10 +377,10 @@ requestPublishForm(want: Want, callback: AsyncCallback&lt;string&gt;): void
| want | [Want](js-apis-application-Want.md) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../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) | 是 | 发布请求。需包含以下字段。<br>abilityName: 目标卡片ability<br>parameters:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"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&lt;string&gt; | Promise对象。返回卡片标识。 |
以下错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 16501000 | A functional error occurred. |
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errcode-form.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) | 是 | 发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。 |
**示例:**
......
......@@ -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 | 是 | 否 | 被调用方注册的消息侦听器函数接口的原型。 |
......@@ -41,7 +41,7 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 |
| callback | AsyncCallback\<void> | 是 | 被指定的回调方法。 |
......@@ -72,7 +72,7 @@ updateConfiguration(config: Configuration): Promise\<void>
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| config | [Configuration](js-apis-configuration.md) | 是 | 新的配置项。 |
......@@ -110,7 +110,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
......@@ -164,7 +164,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback\<Array\<AbilityRunningInfo>> | 是 | 被指定的回调方法。 |
......@@ -193,7 +193,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
......@@ -227,7 +227,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
**参数**
| 名称 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<ElementName> | 是 | 被指定的回调方法。 |
......
......@@ -12,7 +12,7 @@ appManager模块提供App管理的能力,包括查询当前是否处于稳定
import app from '@ohos.application.appManager';
```
## appManager.isRunningInStabilityTest
## appManager.isRunningInStabilityTest<sup>8</sup>
static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
......
......@@ -35,7 +35,7 @@ createFormBindingData(obj?: Object | string): FormBindingData
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | ------------------------------------------------------------ |
| obj | Objectstring | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识,内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} |
| obj | Object\|string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以"formImages"作为标识,内容为图片标识与图片文件描述符的键值对{"formImages": {"key1": fd1, "key2": fd2}} |
**返回值:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册