未验证 提交 19793baa 编写于 作者: O openharmony_ci 提交者: Gitee

!15061 翻译完成:13668【元能力】示例代码整改

Merge pull request !15061 from wusongqing/TR13668
...@@ -48,7 +48,7 @@ import UIAbility from '@ohos.app.ability.UIAbility'; ...@@ -48,7 +48,7 @@ import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want, launchParam) {
if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) { if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
console.log("The ability has been started by the way of startAbility."); console.log('The ability has been started by the way of startAbility.');
} }
} }
} }
...@@ -74,7 +74,7 @@ import UIAbility from '@ohos.app.ability.UIAbility'; ...@@ -74,7 +74,7 @@ import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want, launchParam) {
if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) { if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) {
console.log("The ability has exit last because the ability was not responding."); console.log('The ability has exit last because the ability was not responding.');
} }
} }
} }
...@@ -110,20 +110,22 @@ Enumerates the window modes in which an ability can be displayed at startup. It ...@@ -110,20 +110,22 @@ Enumerates the window modes in which an ability can be displayed at startup. It
**System capability**: SystemCapability.Ability.AbilityRuntime.Core **System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
| Name | Value| Description | | Name | Value| Description |
| --- | --- | --- | | --- | --- | --- |
| WINDOW_MODE_UNDEFINED | 0 | Undefined window mode. | | WINDOW_MODE_UNDEFINED | 0 | Undefined window mode. |
| WINDOW_MODE_FULLSCREEN | 1 | The ability is displayed in full screen. | | WINDOW_MODE_FULLSCREEN | 1 | The ability is displayed in full screen. |
| WINDOW_MODE_SPLIT_PRIMARY | 100 | The ability is displayed in the primary window in split-screen mode. | | WINDOW_MODE_SPLIT_PRIMARY | 100 | The left screen in horizontal direction or the upper screen in vertical direction is the primary window. |
| WINDOW_MODE_SPLIT_SECONDARY | 101 | The ability is displayed in the secondary window in split-screen mode. | | WINDOW_MODE_SPLIT_SECONDARY | 101 | The right screen in horizontal direction or the lower screen in vertical direction is the secondary window. |
| WINDOW_MODE_FLOATING | 102 | The ability is displayed in a floating window.| | WINDOW_MODE_FLOATING | 102 | The ability is displayed in a floating window.|
**Example** **Example**
```ts ```ts
let want = { let want = {
bundleName: "com.example.myapplication", bundleName: 'com.example.myapplication',
abilityName: "EntryAbility" abilityName: 'EntryAbility'
}; };
let option = { let option = {
windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FULLSCREEN
...@@ -131,9 +133,9 @@ let option = { ...@@ -131,9 +133,9 @@ let option = {
// Ensure that the context is obtained. // Ensure that the context is obtained.
this.context.startAbility(want, option).then(()={ this.context.startAbility(want, option).then(()={
console.log("Succeed to start ability."); console.log('Succeed to start ability.');
}).catch((error)=>{ }).catch((error)=>{
console.log("Failed to start ability with error: " + JSON.stringify(error)); console.log('Failed to start ability with error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -157,7 +159,7 @@ import UIAbility from '@ohos.app.ability.UIAbility'; ...@@ -157,7 +159,7 @@ import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level) {
if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) { if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
console.log("The memory of device is critical, please release some memory."); console.log('The memory of device is critical, please release some memory.');
} }
} }
} }
...@@ -209,7 +211,7 @@ import UIAbility from '@ohos.app.ability.UIAbility'; ...@@ -209,7 +211,7 @@ import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason, wantParam) {
if (reason === AbilityConstant.StateType.CONTINUATION) { if (reason === AbilityConstant.StateType.CONTINUATION) {
console.log("Save the ability data when the ability continuation."); console.log('Save the ability data when the ability continuation.');
} }
return AbilityConstant.OnSaveResult.ALL_AGREE; return AbilityConstant.OnSaveResult.ALL_AGREE;
} }
......
...@@ -49,16 +49,16 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry ...@@ -49,16 +49,16 @@ import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry
let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
let want = { let want = {
bundleName: "com.example.myapplication", bundleName: 'com.example.myapplication',
abilityName: "EntryAbility" abilityName: 'EntryAbility'
}; };
abilityDelegator.startAbility(want, (err) => { abilityDelegator.startAbility(want, (err) => {
if (err.code !== 0) { if (!err || err.code === 0) {
console.log("Success start ability."); console.log('Success start ability.');
} else { } else {
console.log("Failed start ability, error: " + JSON.stringify(err)); console.log('Failed start ability, error: ${JSON.stringify(err)}');
} }
}) });
``` ```
## AbilityDelegatorRegistry.getArguments ## AbilityDelegatorRegistry.getArguments
...@@ -81,8 +81,8 @@ Obtains an [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs ...@@ -81,8 +81,8 @@ Obtains an [AbilityDelegatorArgs](js-apis-inner-application-abilityDelegatorArgs
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
let args = AbilityDelegatorRegistry.getArguments(); let args = AbilityDelegatorRegistry.getArguments();
console.info("getArguments bundleName:" + args.bundleName); console.info('getArguments bundleName: ${args.bundleName}');
console.info("getArguments parameters:" + JSON.stringify(args.parameters)); console.info('getArguments parameters: ${JSON.stringify(args.parameters)}');
console.info("getArguments testCaseNames:" + args.testCaseNames); console.info('getArguments testCaseNames: ${args.testCaseNames}');
console.info("getArguments testRunnerClassName:" + args.testRunnerClassName); console.info('getArguments testRunnerClassName: ${args.testRunnerClassName}');
``` ```
...@@ -11,7 +11,7 @@ The **AbilityLifecycleCallback** module defines the callbacks to receive lifecyc ...@@ -11,7 +11,7 @@ The **AbilityLifecycleCallback** module defines the callbacks to receive lifecyc
## Modules to Import ## Modules to Import
```ts ```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback"; import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
``` ```
...@@ -25,15 +25,15 @@ Called when an ability is created. ...@@ -25,15 +25,15 @@ Called when an ability is created.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log("AbilityLifecycleCallback onAbilityCreate."); console.log('AbilityLifecycleCallback onAbilityCreate.');
} }
}; };
``` ```
...@@ -48,16 +48,16 @@ Called when the window stage of an ability is created. ...@@ -48,16 +48,16 @@ Called when the window stage of an ability is created.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.| | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onWindowStageCreate(ability, windowStage){ onWindowStageCreate(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageCreate."); console.log('AbilityLifecycleCallback onWindowStageCreate.');
} }
}; };
``` ```
...@@ -72,16 +72,16 @@ Called when the window stage of an ability gains focus. ...@@ -72,16 +72,16 @@ Called when the window stage of an ability gains focus.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.| | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onWindowStageActive(ability, windowStage){ onWindowStageActive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageActive."); console.log('AbilityLifecycleCallback onWindowStageActive.');
} }
}; };
``` ```
...@@ -96,16 +96,16 @@ Called when the window stage of an ability loses focus. ...@@ -96,16 +96,16 @@ Called when the window stage of an ability loses focus.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.| | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onWindowStageInactive(ability, windowStage){ onWindowStageInactive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageInactive."); console.log('AbilityLifecycleCallback onWindowStageInactive.');
} }
}; };
``` ```
...@@ -120,16 +120,16 @@ Called when the window stage of an ability is destroyed. ...@@ -120,16 +120,16 @@ Called when the window stage of an ability is destroyed.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.| | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | Yes| **WindowStage** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onWindowStageDestroy(ability, windowStage){ onWindowStageDestroy(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageDestroy."); console.log('AbilityLifecycleCallback onWindowStageDestroy.');
} }
}; };
``` ```
...@@ -144,15 +144,15 @@ Called when an ability is destroyed. ...@@ -144,15 +144,15 @@ Called when an ability is destroyed.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityDestroy(ability){ onAbilityDestroy(ability){
console.log("AbilityLifecycleCallback onAbilityDestroy."); console.log('AbilityLifecycleCallback onAbilityDestroy.');
} }
}; };
``` ```
...@@ -167,15 +167,15 @@ Called when an ability is switched from the background to the foreground. ...@@ -167,15 +167,15 @@ Called when an ability is switched from the background to the foreground.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityForeground(ability){ onAbilityForeground(ability){
console.log("AbilityLifecycleCallback onAbilityForeground."); console.log('AbilityLifecycleCallback onAbilityForeground.');
} }
}; };
``` ```
...@@ -190,15 +190,15 @@ Called when an ability is switched from the foreground to the background. ...@@ -190,15 +190,15 @@ Called when an ability is switched from the foreground to the background.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityBackground(ability){ onAbilityBackground(ability){
console.log("AbilityLifecycleCallback onAbilityBackground."); console.log('AbilityLifecycleCallback onAbilityBackground.');
} }
}; };
``` ```
...@@ -213,15 +213,15 @@ Called when an ability is continued on another device. ...@@ -213,15 +213,15 @@ Called when an ability is continued on another device.
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.| | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | Yes| **Ability** object.|
**Example** **Example**
```ts ```ts
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityContinue(ability){ onAbilityContinue(ability){
console.log("AbilityLifecycleCallback onAbilityContinue."); console.log('AbilityLifecycleCallback onAbilityContinue.');
} }
}; };
``` ```
...@@ -232,52 +232,52 @@ let abilityLifecycleCallback = { ...@@ -232,52 +232,52 @@ let abilityLifecycleCallback = {
MyFirstAbility.ts MyFirstAbility.ts
```ts ```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback"; import AbilityLifecycleCallback from '@ohos.app.ability.AbilityLifecycleCallback';
import AbilityStage from "@ohos.app.ability.AbilityStage"; import AbilityStage from '@ohos.app.ability.AbilityStage';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
// Declare the ability lifecycle callbacks. A listener can be registered in applicationContext only after all the callbacks are configured. // Declare the ability lifecycle callbacks. A listener can be registered in applicationContext only after all the callbacks are configured.
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log("AbilityLifecycleCallback onAbilityCreate."); console.log('AbilityLifecycleCallback onAbilityCreate.');
}, },
onWindowStageCreate(ability, windowStage){ onWindowStageCreate(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageCreate."); console.log('AbilityLifecycleCallback onWindowStageCreate.');
}, },
onWindowStageActive(ability, windowStage){ onWindowStageActive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageActive."); console.log('AbilityLifecycleCallback onWindowStageActive.');
}, },
onWindowStageInactive(ability, windowStage){ onWindowStageInactive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageInactive."); console.log('AbilityLifecycleCallback onWindowStageInactive.');
}, },
onWindowStageDestroy(ability, windowStage){ onWindowStageDestroy(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageDestroy."); console.log('AbilityLifecycleCallback onWindowStageDestroy.');
}, },
onAbilityDestroy(ability){ onAbilityDestroy(ability){
console.log("AbilityLifecycleCallback onAbilityDestroy."); console.log('AbilityLifecycleCallback onAbilityDestroy.');
}, },
onAbilityForeground(ability){ onAbilityForeground(ability){
console.log("AbilityLifecycleCallback onAbilityForeground."); console.log('AbilityLifecycleCallback onAbilityForeground.');
}, },
onAbilityBackground(ability){ onAbilityBackground(ability){
console.log("AbilityLifecycleCallback onAbilityBackground."); console.log('AbilityLifecycleCallback onAbilityBackground.');
}, },
onAbilityContinue(ability){ onAbilityContinue(ability){
console.log("AbilityLifecycleCallback onAbilityContinue."); console.log('AbilityLifecycleCallback onAbilityContinue.');
} }
}; };
export default class MyFirstAbility extends UIAbility { export default class MyFirstAbility extends UIAbility {
onCreate() { onCreate() {
console.log("MyAbilityStage onCreate"); console.log('MyAbilityStage onCreate');
// 1. Obtain applicationContext through the context attribute. // 1. Obtain applicationContext through the context attribute.
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
// 2. Register the listener for the ability lifecycle changes through the applicationContext object. // 2. Register the listener for the ability lifecycle changes through the applicationContext object.
try { try {
globalThis.lifecycleId = applicationContext.on("abilityLifecycle", abilityLifecycleCallback); globalThis.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
console.log("registerAbilityLifecycleCallback number: " + JSON.stringify(lifecycleId)); console.log('registerAbilityLifecycleCallback number: ${JSON.stringify(lifecycleId)}');
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + " ," + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
} }
} }
...@@ -285,17 +285,17 @@ export default class MyFirstAbility extends UIAbility { ...@@ -285,17 +285,17 @@ export default class MyFirstAbility extends UIAbility {
MySecondAbility.ts MySecondAbility.ts
```ts ```ts
import UIAbility from "ohos.app.ability.UIAbility"; import UIAbility from 'ohos.app.ability.UIAbility';
export default class MySecondAbility extends UIAbility { export default class MySecondAbility extends UIAbility {
onDestroy() { onDestroy() {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
// 3. Deregister the listener for the environment changes through the applicationContext object. // 3. Deregister the listener for the ability lifecycle changes through the applicationContext object.
applicationContext.off("abilityLifecycle", globalThis.lifecycleId, (error) => { applicationContext.off('abilityLifecycle', globalThis.lifecycleId, (error) => {
if (error.code != 0) { if (error && error.code !== 0) {
console.log("unregisterAbilityLifecycleCallback failed, error: " + JSON.stringify(error)); console.log('unregisterAbilityLifecycleCallback fail, error: ${JSON.stringify(error)}');
} else { } else {
console.log("unregisterAbilityLifecycleCallback success."); console.log('unregisterAbilityLifecycleCallback success.');
} }
}); });
} }
......
...@@ -24,6 +24,7 @@ Enumerates the ability states. This enum can be used together with [AbilityRunni ...@@ -24,6 +24,7 @@ Enumerates the ability states. This enum can be used together with [AbilityRunni
| Name| Value| Description| | Name| Value| Description|
| -------- | -------- | -------- | | -------- | -------- | -------- |
| INITIAL | 0 | The ability is in the initial state.| | INITIAL | 0 | The ability is in the initial state.|
| FOCUS | 2 | The ability has the focus.|
| FOREGROUND | 9 | The ability is in the foreground state. | | FOREGROUND | 9 | The ability is in the foreground state. |
| BACKGROUND | 10 | The ability is in the background state. | | BACKGROUND | 10 | The ability is in the background state. |
| FOREGROUNDING | 11 | The ability is in the state of being switched to the foreground. | | FOREGROUNDING | 11 | The ability is in the state of being switched to the foreground. |
...@@ -70,15 +71,14 @@ const config = { ...@@ -70,15 +71,14 @@ const config = {
try { try {
abilityManager.updateConfiguration(config, (err) => { abilityManager.updateConfiguration(config, (err) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("updateConfiguration fail, err: " + JSON.stringify(err)); console.log('updateConfiguration fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("updateConfiguration success."); console.log('updateConfiguration success.');
} }
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -130,11 +130,10 @@ try { ...@@ -130,11 +130,10 @@ try {
abilityManager.updateConfiguration(config).then(() => { abilityManager.updateConfiguration(config).then(() => {
console.log('updateConfiguration success.'); console.log('updateConfiguration success.');
}).catch((err) => { }).catch((err) => {
console.log('updateConfiguration fail, err: ' + JSON.stringify(err)); console.log('updateConfiguration fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -169,15 +168,14 @@ import abilityManager from '@ohos.app.ability.abilityManager'; ...@@ -169,15 +168,14 @@ import abilityManager from '@ohos.app.ability.abilityManager';
try { try {
abilityManager.getAbilityRunningInfos((err, data) => { abilityManager.getAbilityRunningInfos((err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getAbilityRunningInfos fail, error: " + JSON.stringify(err)); console.log('getAbilityRunningInfos fail, error: ${JSON.stringify(err)}');
} else { } else {
console.log("getAbilityRunningInfos success, data: " + JSON.stringify(data)); console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
} }
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -185,7 +183,7 @@ try { ...@@ -185,7 +183,7 @@ try {
getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
Obtains the ability running information. This API uses a promise to return the result. Obtains the UIAbility running information. This API uses a promise to return the result.
**Required permissions**: ohos.permission.GET_RUNNING_INFO **Required permissions**: ohos.permission.GET_RUNNING_INFO
...@@ -195,7 +193,7 @@ Obtains the ability running information. This API uses a promise to return the r ...@@ -195,7 +193,7 @@ Obtains the ability running information. This API uses a promise to return the r
| Type | Description | | Type | Description |
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | Callback used to return the API call result and the ability running information. You can perform error handling or custom processing in this callback.| | Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | Promise used to return the API call result and the UIAbility running information. You can perform error handling or custom processing in this callback.|
**Error codes** **Error codes**
...@@ -212,13 +210,12 @@ import abilityManager from '@ohos.app.ability.abilityManager'; ...@@ -212,13 +210,12 @@ import abilityManager from '@ohos.app.ability.abilityManager';
try { try {
abilityManager.getAbilityRunningInfos().then((data) => { abilityManager.getAbilityRunningInfos().then((data) => {
console.log("getAbilityRunningInfos success, data: " + JSON.stringify(data)) console.log('getAbilityRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err) => {
console.log("getAbilityRunningInfos fail, err: " + JSON.stringify(err)); console.log('getAbilityRunningInfos fail, err: ${JSON.stringify(err)}');
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -256,15 +253,14 @@ let upperLimit = 10; ...@@ -256,15 +253,14 @@ let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit, (err, data) => { abilityManager.getExtensionRunningInfos(upperLimit, (err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err)); console.log('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("getExtensionRunningInfos success, data: " + JSON.stringify(data)); console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}');
} }
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -307,13 +303,12 @@ let upperLimit = 10; ...@@ -307,13 +303,12 @@ let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => { abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
console.log("getExtensionRunningInfos success, data: " + JSON.stringify(data)); console.log('getExtensionRunningInfos success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err) => {
console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err)); console.log('getExtensionRunningInfos fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) console.log('error.code: ${JSON.stringify(paramError.code)}, error.message: ${JSON.stringify(paramError.message)}');
+ ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -345,10 +340,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -345,10 +340,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
abilityManager.getTopAbility((err, data) => { abilityManager.getTopAbility((err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getTopAbility fail, err: " + JSON.stringify(err)); console.log('getTopAbility fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("getTopAbility success, data: " + JSON.stringify(data)); console.log('getTopAbility success, data: ${JSON.stringify(data)}');
} }
}); });
``` ```
...@@ -381,8 +376,8 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -381,8 +376,8 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import abilityManager from '@ohos.app.ability.abilityManager'; import abilityManager from '@ohos.app.ability.abilityManager';
abilityManager.getTopAbility().then((data) => { abilityManager.getTopAbility().then((data) => {
console.log("getTopAbility success, data: " + JSON.stringify(data)); console.log('getTopAbility success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err) => {
console.log("getTopAbility fail, err: " + JSON.stringify(err)); console.log('getTopAbility fail, err: ${JSON.stringify(err)}');
}) })
``` ```
...@@ -30,7 +30,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage'; ...@@ -30,7 +30,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onCreate() { onCreate() {
console.log("MyAbilityStage.onCreate is called"); console.log('MyAbilityStage.onCreate is called');
} }
} }
``` ```
...@@ -63,8 +63,8 @@ import AbilityStage from '@ohos.app.ability.AbilityStage'; ...@@ -63,8 +63,8 @@ import AbilityStage from '@ohos.app.ability.AbilityStage';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onAcceptWant(want) { onAcceptWant(want) {
console.log("MyAbilityStage.onAcceptWant called"); console.log('MyAbilityStage.onAcceptWant called');
return "com.example.test"; return 'com.example.test';
} }
} }
``` ```
...@@ -91,7 +91,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage'; ...@@ -91,7 +91,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onConfigurationUpdate(config) { onConfigurationUpdate(config) {
console.log('onConfigurationUpdate, language:' + config.language); console.log('onConfigurationUpdate, language: ${config.language}');
} }
} }
``` ```
...@@ -117,7 +117,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage'; ...@@ -117,7 +117,7 @@ import AbilityStage from '@ohos.app.ability.AbilityStage';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
onMemoryLevel(level) { onMemoryLevel(level) {
console.log('onMemoryLevel, level:' + JSON.stringify(level)); console.log('onMemoryLevel, level: ${JSON.stringify(level)}');
} }
} }
``` ```
......
...@@ -40,10 +40,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -40,10 +40,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.isRunningInStabilityTest((err, flag) => { appManager.isRunningInStabilityTest((err, flag) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("isRunningInStabilityTest faile, err: " + JSON.stringify(err)); console.log('isRunningInStabilityTest fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("The result of isRunningInStabilityTest is:" + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
} }
}) })
``` ```
...@@ -77,9 +77,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -77,9 +77,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log("The result of isRunningInStabilityTest is:" + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}).catch((error) => { }).catch((error) => {
console.log("error:" + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -112,9 +112,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -112,9 +112,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log("The result of isRamConstrainedDevice is:" + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log("error:" + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -146,10 +146,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -146,10 +146,10 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.isRamConstrainedDevice((err, data) => { appManager.isRamConstrainedDevice((err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("isRamConstrainedDevice faile, err: " + JSON.stringify(err)); console.log('isRamConstrainedDevice fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("The result of isRamConstrainedDevice is:" + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
} }
}) })
``` ```
...@@ -182,9 +182,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -182,9 +182,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log("The size of app memory is:" + JSON.stringify(data)); console.log('The size of app memory is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log("error:" + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -216,17 +216,17 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -216,17 +216,17 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getAppMemorySize((err, data) => { appManager.getAppMemorySize((err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getAppMemorySize faile, err: " + JSON.stringify(err)); console.log('getAppMemorySize fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("The size of app memory is:" + JSON.stringify(data)); console.log('The size of app memory is: ${JSON.stringify(data)}');
} }
}) })
``` ```
## appManager.getProcessRunningInformation ## appManager.getRunningProcessInformation
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
Obtains information about the running processes. This API uses a promise to return the result. Obtains information about the running processes. This API uses a promise to return the result.
...@@ -234,13 +234,11 @@ Obtains information about the running processes. This API uses a promise to retu ...@@ -234,13 +234,11 @@ Obtains information about the running processes. This API uses a promise to retu
**System capability**: SystemCapability.Ability.AbilityRuntime.Core **System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | Promise used to return the API call result and the process running information. You can perform error handling or custom processing in this callback.| | Promise\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | Promise used to return the API call result and the process running information. You can perform error handling or custom processing in this callback.|
**Error codes** **Error codes**
...@@ -255,16 +253,16 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -255,16 +253,16 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getProcessRunningInformation().then((data) => { appManager.getRunningProcessInformation().then((data) => {
console.log("The process running information is:" + JSON.stringify(data)); console.log('The running process information is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log("error:" + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup> ## appManager.getRunningProcessInformation<sup>9+</sup>
getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void; getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>>): void;
Obtains information about the running processes. This API uses an asynchronous callback to return the result. Obtains information about the running processes. This API uses an asynchronous callback to return the result.
...@@ -272,13 +270,11 @@ Obtains information about the running processes. This API uses an asynchronous c ...@@ -272,13 +270,11 @@ Obtains information about the running processes. This API uses an asynchronous c
**System capability**: SystemCapability.Ability.AbilityRuntime.Core **System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
**Parameters** **Parameters**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
|AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | Callback used to return the API call result and the process running information. You can perform error handling or custom processing in this callback.| |AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | Callback used to return the API call result and the process running information. You can perform error handling or custom processing in this callback.|
**Error codes** **Error codes**
...@@ -293,18 +289,18 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -293,18 +289,18 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
```ts ```ts
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getProcessRunningInformation((err, data) => { appManager.getRunningProcessInformation((err, data) => {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getProcessRunningInformation faile, err: " + JSON.stringify(err)); console.log('getRunningProcessInformation fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("The process running information is:" + JSON.stringify(data)); console.log('The process running information is: ${JSON.stringify(data)}');
} }
}) })
``` ```
## appManager.on ## appManager.on
on(type: "applicationState", observer: ApplicationStateObserver): number; on(type: 'applicationState', observer: ApplicationStateObserver): number;
Registers an observer to listen for the state changes of all applications. Registers an observer to listen for the state changes of all applications.
...@@ -318,7 +314,7 @@ Registers an observer to listen for the state changes of all applications. ...@@ -318,7 +314,7 @@ Registers an observer to listen for the state changes of all applications.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the API to call. It is fixed at **"applicationState"**.| | type | string | Yes| Type of the API to call. It is fixed at **'applicationState'**.|
| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | Yes| Application state observer, which is used to observe the lifecycle change of an application.| | observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | Yes| Application state observer, which is used to observe the lifecycle change of an application.|
**Return value** **Return value**
...@@ -367,7 +363,7 @@ try { ...@@ -367,7 +363,7 @@ try {
## appManager.on ## appManager.on
on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: Array\<string>): number; on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList: Array\<string>): number;
Registers an observer to listen for the state changes of a specified application. Registers an observer to listen for the state changes of a specified application.
...@@ -381,7 +377,7 @@ Registers an observer to listen for the state changes of a specified application ...@@ -381,7 +377,7 @@ Registers an observer to listen for the state changes of a specified application
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the API to call. It is fixed at **"applicationState"**.| | type | string | Yes| Type of the API to call. It is fixed at **'applicationState'**.|
| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | Yes| Application state observer, which is used to observe the lifecycle change of an application.| | observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | Yes| Application state observer, which is used to observe the lifecycle change of an application.|
| bundleNameList | `Array<string>` | Yes| **bundleName** array of the application. A maximum of 128 bundle names can be passed.| | bundleNameList | `Array<string>` | Yes| **bundleName** array of the application. A maximum of 128 bundle names can be passed.|
...@@ -423,7 +419,7 @@ let applicationStateObserver = { ...@@ -423,7 +419,7 @@ let applicationStateObserver = {
} }
let bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
const observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList); const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `); console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
...@@ -432,7 +428,7 @@ try { ...@@ -432,7 +428,7 @@ try {
## appManager.off ## appManager.off
off(type: "applicationState", observerId: number, callback: AsyncCallback\<void>): void; off(type: 'applicationState', observerId: number, callback: AsyncCallback\<void>): void;
Deregisters the application state observer. This API uses an asynchronous callback to return the result. Deregisters the application state observer. This API uses an asynchronous callback to return the result.
...@@ -446,7 +442,7 @@ Deregisters the application state observer. This API uses an asynchronous callba ...@@ -446,7 +442,7 @@ Deregisters the application state observer. This API uses an asynchronous callba
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the API to call. It is fixed at **"applicationState"**.| | type | string | Yes| Type of the API to call. It is fixed at **'applicationState'**.|
| observerId | number | Yes| Digital code of the observer.| | observerId | number | Yes| Digital code of the observer.|
| callback | AsyncCallback\<void> | Yes| Callback used to return the API call result. You can perform error handling or custom processing in this callback.| | callback | AsyncCallback\<void> | Yes| Callback used to return the API call result. You can perform error handling or custom processing in this callback.|
...@@ -485,7 +481,7 @@ let applicationStateObserver = { ...@@ -485,7 +481,7 @@ let applicationStateObserver = {
} }
let bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList); observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `); console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
...@@ -493,22 +489,22 @@ try { ...@@ -493,22 +489,22 @@ try {
// 2. Deregister the application state observer. // 2. Deregister the application state observer.
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err) {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("unregisterApplicationStateObserverCallback faile, err: " + JSON.stringify(err)); console.log('unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("unregisterApplicationStateObserverCallback success."); console.log('unregisterApplicationStateObserverCallback success.');
} }
} }
try { try {
appManager.off("applicationState", observerId, unregisterApplicationStateObserverCallback); appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) { } catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
## appManager.off ## appManager.off
off(type: "applicationState", observerId: number): Promise\<void>; off(type: 'applicationState', observerId: number): Promise\<void>;
Deregisters the application state observer. This API uses an asynchronous callback to return the result. Deregisters the application state observer. This API uses an asynchronous callback to return the result.
...@@ -522,7 +518,7 @@ Deregisters the application state observer. This API uses an asynchronous callba ...@@ -522,7 +518,7 @@ Deregisters the application state observer. This API uses an asynchronous callba
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | Yes| Type of the API to call. It is fixed at **"applicationState"**.| | type | string | Yes| Type of the API to call. It is fixed at **'applicationState'**.|
| observerId | number | Yes| Digital code of the observer.| | observerId | number | Yes| Digital code of the observer.|
**Return value** **Return value**
...@@ -566,7 +562,7 @@ let applicationStateObserver = { ...@@ -566,7 +562,7 @@ let applicationStateObserver = {
} }
let bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList); observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `); console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
...@@ -574,13 +570,13 @@ try { ...@@ -574,13 +570,13 @@ try {
// 2. Deregister the application state observer. // 2. Deregister the application state observer.
try { try {
appManager.off("applicationState", observerId).then((data) => { appManager.off('applicationState', observerId).then((data) => {
console.log("unregisterApplicationStateObserver success, data: " + JSON.stringify(data)); console.log('unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err) => {
console.log("unregisterApplicationStateObserver faile, err: " + JSON.stringify(err)); console.log('unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -616,16 +612,16 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -616,16 +612,16 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
function getForegroundApplicationsCallback(err, data) { function getForegroundApplicationsCallback(err, data) {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("getForegroundApplicationsCallback fail, err: " + JSON.stringify(err)); console.log('getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("getForegroundApplicationsCallback success, data: " + JSON.stringify(data)); console.log('getForegroundApplicationsCallback success, data: ${JSON.stringify(data)}');
} }
} }
try { try {
appManager.getForegroundApplications(getForegroundApplicationsCallback); appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -661,9 +657,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error ...@@ -661,9 +657,9 @@ For details about the error codes, see [Ability Error Codes](../errorcodes/error
import appManager from '@ohos.app.ability.appManager'; import appManager from '@ohos.app.ability.appManager';
appManager.getForegroundApplications().then((data) => { appManager.getForegroundApplications().then((data) => {
console.log("getForegroundApplications success, data: " + JSON.stringify(data)); console.log('getForegroundApplications success, data: ${JSON.stringify(data)}');
}).catch((err) => { }).catch((err) => {
console.log("getForegroundApplications fail, err: " + JSON.stringify(err)); console.log('getForegroundApplications fail, err: ${JSON.stringify(err)}');
}) })
``` ```
...@@ -703,12 +699,12 @@ let bundleName = 'bundleName'; ...@@ -703,12 +699,12 @@ let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
try { try {
appManager.killProcessWithAccount(bundleName, accountId).then(() => { appManager.killProcessWithAccount(bundleName, accountId).then(() => {
console.log("killProcessWithAccount success"); console.log('killProcessWithAccount success');
}).catch((err) => { }).catch((err) => {
console.log("killProcessWithAccount fail, err: " + JSON.stringify(err)); console.error('killProcessWithAccount fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.error('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -749,10 +745,10 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -749,10 +745,10 @@ import appManager from '@ohos.app.ability.appManager';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
let accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err, data) {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("killProcessWithAccountCallback fail, err: " + JSON.stringify(err)); console.log('killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("killProcessWithAccountCallback success."); console.log('killProcessWithAccountCallback success.');
} }
} }
appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback); appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback);
...@@ -792,16 +788,16 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -792,16 +788,16 @@ import appManager from '@ohos.app.ability.appManager';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err, data) {
if (err.code !== 0) { if (err && err.code !== 0) {
console.log("killProcessesByBundleNameCallback fail, err: " + JSON.stringify(err)); console.log('killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("killProcessesByBundleNameCallback success."); console.log('killProcessesByBundleNameCallback success.');
} }
} }
try { try {
appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback); appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -845,12 +841,12 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -845,12 +841,12 @@ import appManager from '@ohos.app.ability.appManager';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
try { try {
appManager.killProcessesByBundleName(bundleName).then((data) => { appManager.killProcessesByBundleName(bundleName).then((data) => {
console.log("killProcessesByBundleName success."); console.log('killProcessesByBundleName success.');
}).catch((err) => { }).catch((err) => {
console.log("killProcessesByBundleName fail, err: " + JSON.stringify(err)); console.log('killProcessesByBundleName fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -888,16 +884,16 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -888,16 +884,16 @@ import appManager from '@ohos.app.ability.appManager';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err, data) {
if (err) { if (err && err.code !== 0) {
console.log("clearUpApplicationDataCallback fail, err: " + JSON.stringify(err)); console.log('clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}');
} else { } else {
console.log("clearUpApplicationDataCallback success."); console.log('clearUpApplicationDataCallback success.');
} }
} }
try { try {
appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback); appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -941,12 +937,12 @@ import appManager from '@ohos.app.ability.appManager'; ...@@ -941,12 +937,12 @@ import appManager from '@ohos.app.ability.appManager';
let bundleName = 'bundleName'; let bundleName = 'bundleName';
try { try {
appManager.clearUpApplicationData(bundleName).then((data) => { appManager.clearUpApplicationData(bundleName).then((data) => {
console.log("clearUpApplicationData success."); console.log('clearUpApplicationData success.');
}).catch((err) => { }).catch((err) => {
console.log("clearUpApplicationData fail, err: " + JSON.stringify(err)); console.log('clearUpApplicationData fail, err: ${JSON.stringify(err)}');
}) })
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
......
...@@ -18,13 +18,12 @@ Enumerates the application restart flags. This enum is used as an input paramete ...@@ -18,13 +18,12 @@ Enumerates the application restart flags. This enum is used as an input paramete
**System capability**: SystemCapability.Ability.AbilityRuntime.Core **System capability**: SystemCapability.Ability.AbilityRuntime.Core
| Name | Value | Description | | Name | Value | Description |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ---------- | ---- | ---------- |
| ALWAYS_RESTART | 0 | The application is restarted in all cases.| | ALWAYS_RESTART | 0 | The application is restarted in all cases.|
| CPP_CRASH_NO_RESTART | 0x0001 | The application is not restarted in the case of CPP_CRASH.| | RESTART_WHEN_JS_CRASH | 0x0001 | The application is restarted in the case of JS_CRASH.|
| JS_CRASH_NO_RESTART | 0x0002 | The application is not restarted in the case of JS_CRASH.| | RESTART_WHEN_APP_FREEZE | 0x0002 | The application is restarted in the case of APP_FREEZE.|
| APP_FREEZE_NO_RESTART | 0x0004 | The application is not restarted in the case of APP_FREEZE.| | NO_RESTART | 0xFFFF | The application is not restarted in any case.|
| NO_RESTART | 0xFFFF | The application is not restarted in any case.|
## appRecovery.SaveOccasionFlag ## appRecovery.SaveOccasionFlag
...@@ -69,9 +68,8 @@ Enables application recovery. ...@@ -69,9 +68,8 @@ Enables application recovery.
```ts ```ts
import appRecovery from '@ohos.app.ability.appRecovery'; import appRecovery from '@ohos.app.ability.appRecovery';
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
import UIAbility from '@ohos.app.ability.UIAbility';
export default class MyAbility extends UIAbility { export default class MyAbilityStage extends AbilityStage {
onCreate() { onCreate() {
appRecovery.enableAppRecovery( appRecovery.enableAppRecovery(
appRecovery.RestartFlag::ALWAYS_RESTART, appRecovery.RestartFlag::ALWAYS_RESTART,
...@@ -99,15 +97,15 @@ import errorManager from '@ohos.app.ability.errorManager'; ...@@ -99,15 +97,15 @@ import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg) console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.restartApp(); appRecovery.restartApp();
} }
}; };
try { try {
errorManager.on("error", observer); errorManager.on('error', observer);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -133,14 +131,14 @@ import errorManager from '@ohos.app.ability.errorManager'; ...@@ -133,14 +131,14 @@ import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg) console.log('onUnhandledException, errorMsg: ', errorMsg);
appRecovery.saveAppState(); appRecovery.saveAppState();
} }
}; };
try { try {
errorManager.on("error", observer); errorManager.on('error', observer);
} catch (paramError) { } catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message); console.log('error: ${paramError.code}, ${paramError.message}');
} }
``` ```
...@@ -18,7 +18,37 @@ import StartOptions from '@ohos.app.ability.StartOptions'; ...@@ -18,7 +18,37 @@ import StartOptions from '@ohos.app.ability.StartOptions';
**System capability**: SystemCapability.Ability.AbilityRuntime.Core **System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [windowMode](js-apis-application-abilityConstant.md#abilityconstantwindowmode) | number | No| Window mode.| | [windowMode](js-apis-app-ability-abilityConstant.md#abilityconstantwindowmode) | number | No| Window mode.|
| displayId | number | No| Display ID. The default value is **0**, indicating the current display.| | displayId | number | No| Display ID. The default value is **0**, indicating the current display.|
**Example**
```ts
import missionManager from '@ohos.app.ability.missionManager';
try {
missionManager.getMissionInfos('', 10, (error, missions) => {
if (error.code) {
console.log('getMissionInfos failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
return;
}
console.log('size = ${missions.length}');
console.log('missions = ${JSON.stringify(missions)}');
let id = missions[0].missionId;
let startOptions = {
windowMode : 101,
displayId: 0
};
missionManager.moveMissionToFront(id, startOptions).then(() => {
console.log('moveMissionToFront is called ');
});
});
} catch (paramError) {
console.log('error: ${paramError.code}, ${paramError.message}');
}
```
...@@ -22,16 +22,16 @@ Checks whether this application is undergoing a stability test. This API uses an ...@@ -22,16 +22,16 @@ Checks whether this application is undergoing a stability test. This API uses an
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result. If the application is undergoing a stability test, **true** will be returned; otherwise, **false** will be returned.| | callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result. If the application is undergoing a stability test, **true** will be returned; otherwise, **false** will be returned.|
**Example** **Example**
```ts ```ts
appManager.isRunningInStabilityTest((err, flag) => { appManager.isRunningInStabilityTest((err, flag) => {
console.log('error:' + JSON.stringfy(err)); console.log('error: ${JSON.stringify(err)}');
console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}) })
``` ```
...@@ -46,17 +46,17 @@ Checks whether this application is undergoing a stability test. This API uses a ...@@ -46,17 +46,17 @@ Checks whether this application is undergoing a stability test. This API uses a
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | Promise used to return the result. If the application is undergoing a stability test, **true** will be returned; otherwise, **false** will be returned.| | Promise&lt;boolean&gt; | Promise used to return the result. If the application is undergoing a stability test, **true** will be returned; otherwise, **false** will be returned.|
**Example** **Example**
```ts ```ts
appManager.isRunningInStabilityTest().then((flag) => { appManager.isRunningInStabilityTest().then((flag) => {
console.log('The result of isRunningInStabilityTest is:' + JSON.stringify(flag)); console.log('The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}');
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -71,17 +71,17 @@ Checks whether this application is running on a RAM constrained device. This API ...@@ -71,17 +71,17 @@ Checks whether this application is running on a RAM constrained device. This API
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | Promise used to return whether the application is running on a RAM constrained device. If the application is running on a RAM constrained device, **true** will be returned; otherwise, **false** will be returned.| | Promise&lt;boolean&gt; | Promise used to return whether the application is running on a RAM constrained device. If the application is running on a RAM constrained device, **true** will be returned; otherwise, **false** will be returned.|
**Example** **Example**
```ts ```ts
appManager.isRamConstrainedDevice().then((data) => { appManager.isRamConstrainedDevice().then((data) => {
console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -95,16 +95,16 @@ Checks whether this application is running on a RAM constrained device. This API ...@@ -95,16 +95,16 @@ Checks whether this application is running on a RAM constrained device. This API
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return whether the application is running on a RAM constrained device. If the application is running on a RAM constrained device, **true** will be returned; otherwise, **false** will be returned.| | callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return whether the application is running on a RAM constrained device. If the application is running on a RAM constrained device, **true** will be returned; otherwise, **false** will be returned.|
**Example** **Example**
```ts ```ts
appManager.isRamConstrainedDevice((err, data) => { appManager.isRamConstrainedDevice((err, data) => {
console.log('error:' + JSON.stringify(err)); console.log('error: ${JSON.stringify(err)}');
console.log('The result of isRamConstrainedDevice is:' + JSON.stringify(data)); console.log('The result of isRamConstrainedDevice is: ${JSON.stringify(data)}');
}) })
``` ```
...@@ -118,17 +118,17 @@ Obtains the memory size of this application. This API uses a promise to return t ...@@ -118,17 +118,17 @@ Obtains the memory size of this application. This API uses a promise to return t
**Return value** **Return value**
| Type| Description| | Type| Description|
| -------- | -------- | | -------- | -------- |
| Promise&lt;number&gt; | Size of the application memory.| | Promise&lt;number&gt; | Promise used to return the memory size, in MB.|
**Example** **Example**
```ts ```ts
appManager.getAppMemorySize().then((data) => { appManager.getAppMemorySize().then((data) => {
console.log('The size of app memory is:' + JSON.stringify(data)); console.log('The size of app memory is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -142,17 +142,17 @@ Obtains the memory size of this application. This API uses an asynchronous callb ...@@ -142,17 +142,17 @@ Obtains the memory size of this application. This API uses an asynchronous callb
**Parameters** **Parameters**
| Name| Type| Mandatory| Description| | Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;number&gt; | Yes| Size of the application memory.| | callback | AsyncCallback&lt;number&gt; | Yes| Callback used to return the memory size, in MB.|
**Example** **Example**
```ts ```ts
appManager.getAppMemorySize((err, data) => { appManager.getAppMemorySize((err, data) => {
console.log('error:' + JSON.stringify(err)); console.log('error: ${JSON.stringify(err)}');
console.log('The size of app memory is:' + JSON.stringify(data)); console.log('The size of app memory is: ${JSON.stringify(data)}');
}) });
``` ```
## appManager.getProcessRunningInfos<sup>(deprecated)</sup> ## appManager.getProcessRunningInfos<sup>(deprecated)</sup>
...@@ -160,7 +160,7 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>; ...@@ -160,7 +160,7 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
Obtains information about the running processes. This API uses a promise to return the result. Obtains information about the running processes. This API uses a promise to return the result.
> This API is deprecated since API version 9. You are advised to use [appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9) instead. > This API is deprecated since API version 9. You are advised to use [appManager.getRunningProcessInformation<sup>9+</sup>](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation) instead.
**Required permissions**: ohos.permission.GET_RUNNING_INFO **Required permissions**: ohos.permission.GET_RUNNING_INFO
...@@ -176,9 +176,9 @@ Obtains information about the running processes. This API uses a promise to retu ...@@ -176,9 +176,9 @@ Obtains information about the running processes. This API uses a promise to retu
```ts ```ts
appManager.getProcessRunningInfos().then((data) => { appManager.getProcessRunningInfos().then((data) => {
console.log('The process running infos is:' + JSON.stringify(data)); console.log('The process running infos is: ${JSON.stringify(data)}');
}).catch((error) => { }).catch((error) => {
console.log('error:' + JSON.stringify(error)); console.log('error: ${JSON.stringify(error)}');
}); });
``` ```
...@@ -188,7 +188,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo ...@@ -188,7 +188,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
Obtains information about the running processes. This API uses an asynchronous callback to return the result. Obtains information about the running processes. This API uses an asynchronous callback to return the result.
> This API is deprecated since API version 9. You are advised to use [appManager.getProcessRunningInformation<sup>9+</sup>](#appmanagergetprocessrunninginformation9-1) instead. > This API is deprecated since API version 9. You are advised to use [appManager.getRunningProcessInformation<sup>9+</sup>](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation9) instead.
**Required permissions**: ohos.permission.GET_RUNNING_INFO **Required permissions**: ohos.permission.GET_RUNNING_INFO
...@@ -204,62 +204,11 @@ Obtains information about the running processes. This API uses an asynchronous c ...@@ -204,62 +204,11 @@ Obtains information about the running processes. This API uses an asynchronous c
```ts ```ts
appManager.getProcessRunningInfos((err, data) => { appManager.getProcessRunningInfos((err, data) => {
console.log('error:' + JSON.stringify(err)); console.log('error: ${JSON.stringify(err)}');
console.log('The process running infos is:' + JSON.stringify(data)); console.log('The process running infos is: ${JSON.stringify(data)}');
})
```
## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
Obtains information about the running processes. This API uses a promise to return the result.
**Required permissions**: ohos.permission.GET_RUNNING_INFO
**System capability**: SystemCapability.Ability.AbilityRuntime.Core
**Return value**
| Type| Description|
| -------- | -------- |
| Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | Obtains information about the running processes. This API uses a promise to return the result.|
**Example**
```ts
appManager.getProcessRunningInformation().then((data) => {
console.log('The process running info is:' + JSON.stringify(data));
}).catch((error) => {
console.log('error:' + JSON.stringify(error));
}); });
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup>
getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInformation>>): void;
Obtains information about the running processes. This API uses an asynchronous callback to return the result.
**Required permissions**: ohos.permission.GET_RUNNING_INFO
**System capability**: SystemCapability.Ability.AbilityRuntime.Core
**Parameters**
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | Yes| Obtains information about the running processes. This API uses a promise to return the result.|
**Example**
```ts
appManager.getProcessRunningInformation((err, data) => {
console.log('error:' + JSON.stringify(err));
console.log('The process running info is:' + JSON.stringify(data));
})
```
## appManager.registerApplicationStateObserver<sup>8+</sup> ## appManager.registerApplicationStateObserver<sup>8+</sup>
registerApplicationStateObserver(observer: ApplicationStateObserver): number; registerApplicationStateObserver(observer: ApplicationStateObserver): number;
...@@ -281,7 +230,7 @@ Registers an observer to listen for the state changes of all applications. ...@@ -281,7 +230,7 @@ Registers an observer to listen for the state changes of all applications.
**Example** **Example**
```ts ```ts
var applicationStateObserver = { let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
}, },
...@@ -297,7 +246,7 @@ Registers an observer to listen for the state changes of all applications. ...@@ -297,7 +246,7 @@ Registers an observer to listen for the state changes of all applications.
onProcessStateChanged(processData) { onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
} };
const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver); const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);
console.log('-------- observerCode: ---------', observerCode); console.log('-------- observerCode: ---------', observerCode);
``` ```
...@@ -324,7 +273,7 @@ Registers an observer to listen for the state changes of a specified application ...@@ -324,7 +273,7 @@ Registers an observer to listen for the state changes of a specified application
**Example** **Example**
```ts ```ts
var applicationStateObserver = { let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log('------------ onForegroundApplicationChanged -----------', appStateData); console.log('------------ onForegroundApplicationChanged -----------', appStateData);
}, },
...@@ -340,8 +289,8 @@ Registers an observer to listen for the state changes of a specified application ...@@ -340,8 +289,8 @@ Registers an observer to listen for the state changes of a specified application
onProcessStateChanged(processData) { onProcessStateChanged(processData) {
console.log('------------ onProcessStateChanged -----------', processData); console.log('------------ onProcessStateChanged -----------', processData);
} }
} };
var bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver, bundleNameList); const observerCode = appManager.registerApplicationStateObserver(applicationStateObserver, bundleNameList);
console.log('-------- observerCode: ---------', observerCode); console.log('-------- observerCode: ---------', observerCode);
``` ```
...@@ -367,7 +316,7 @@ Deregisters the application state observer. This API uses an asynchronous callba ...@@ -367,7 +316,7 @@ Deregisters the application state observer. This API uses an asynchronous callba
**Example** **Example**
```ts ```ts
var observerId = 100; let observerId = 100;
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err) {
if (err) { if (err) {
...@@ -404,7 +353,7 @@ Deregisters the application state observer. This API uses a promise to return th ...@@ -404,7 +353,7 @@ Deregisters the application state observer. This API uses a promise to return th
**Example** **Example**
```ts ```ts
var observerId = 100; let observerId = 100;
appManager.unregisterApplicationStateObserver(observerId) appManager.unregisterApplicationStateObserver(observerId)
.then((data) => { .then((data) => {
...@@ -412,7 +361,7 @@ Deregisters the application state observer. This API uses a promise to return th ...@@ -412,7 +361,7 @@ Deregisters the application state observer. This API uses a promise to return th
}) })
.catch((err) => { .catch((err) => {
console.log('----------- unregisterApplicationStateObserver fail ----------', err); console.log('----------- unregisterApplicationStateObserver fail ----------', err);
}) });
``` ```
## appManager.getForegroundApplications<sup>8+</sup> ## appManager.getForegroundApplications<sup>8+</sup>
...@@ -440,7 +389,7 @@ Obtains information about the applications that are running in the foreground. T ...@@ -440,7 +389,7 @@ Obtains information about the applications that are running in the foreground. T
if (err) { if (err) {
console.log('--------- getForegroundApplicationsCallback fail ---------', err); console.log('--------- getForegroundApplicationsCallback fail ---------', err);
} else { } else {
console.log('--------- getForegroundApplicationsCallback success ---------', data) console.log('--------- getForegroundApplicationsCallback success ---------', data);
} }
} }
appManager.getForegroundApplications(getForegroundApplicationsCallback); appManager.getForegroundApplications(getForegroundApplicationsCallback);
...@@ -473,7 +422,7 @@ Obtains information about the applications that are running in the foreground. T ...@@ -473,7 +422,7 @@ Obtains information about the applications that are running in the foreground. T
}) })
.catch((err) => { .catch((err) => {
console.log('--------- getForegroundApplications fail -------', err); console.log('--------- getForegroundApplications fail -------', err);
}) });
``` ```
## appManager.killProcessWithAccount<sup>8+</sup> ## appManager.killProcessWithAccount<sup>8+</sup>
...@@ -498,15 +447,15 @@ Kills a process by bundle name and account ID. This API uses a promise to return ...@@ -498,15 +447,15 @@ Kills a process by bundle name and account ID. This API uses a promise to return
**Example** **Example**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
var accountId = 0; let accountId = 0;
appManager.killProcessWithAccount(bundleName, accountId) appManager.killProcessWithAccount(bundleName, accountId)
.then((data) => { .then((data) => {
console.log('------------ killProcessWithAccount success ------------', data); console.log('------------ killProcessWithAccount success ------------', data);
}) })
.catch((err) => { .catch((err) => {
console.log('------------ killProcessWithAccount fail ------------', err); console.log('------------ killProcessWithAccount fail ------------', err);
}) });
``` ```
...@@ -533,8 +482,8 @@ Kills a process by bundle name and account ID. This API uses an asynchronous cal ...@@ -533,8 +482,8 @@ Kills a process by bundle name and account ID. This API uses an asynchronous cal
**Example** **Example**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
var accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err, data) {
if (err) { if (err) {
console.log('------------- killProcessWithAccountCallback fail, err: --------------', err); console.log('------------- killProcessWithAccountCallback fail, err: --------------', err);
...@@ -567,7 +516,7 @@ Kills a process by bundle name. This API uses an asynchronous callback to return ...@@ -567,7 +516,7 @@ Kills a process by bundle name. This API uses an asynchronous callback to return
**Example** **Example**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err, data) {
if (err) { if (err) {
console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err); console.log('------------- killProcessesByBundleNameCallback fail, err: --------------', err);
...@@ -605,14 +554,14 @@ Kills a process by bundle name. This API uses a promise to return the result. ...@@ -605,14 +554,14 @@ Kills a process by bundle name. This API uses a promise to return the result.
**Example** **Example**
```ts ```ts
var bundleName = 'com.example.myapplication'; let bundleName = 'com.example.myapplication';
appManager.killProcessesByBundleName(bundleName) appManager.killProcessesByBundleName(bundleName)
.then((data) => { .then((data) => {
console.log('------------ killProcessesByBundleName success ------------', data); console.log('------------ killProcessesByBundleName success ------------', data);
}) })
.catch((err) => { .catch((err) => {
console.log('------------ killProcessesByBundleName fail ------------', err); console.log('------------ killProcessesByBundleName fail ------------', err);
}) });
``` ```
## appManager.clearUpApplicationData<sup>8+</sup> ## appManager.clearUpApplicationData<sup>8+</sup>
...@@ -637,7 +586,7 @@ Clears application data by bundle name. This API uses an asynchronous callback t ...@@ -637,7 +586,7 @@ Clears application data by bundle name. This API uses an asynchronous callback t
**Example** **Example**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
function clearUpApplicationDataCallback(err, data) { function clearUpApplicationDataCallback(err, data) {
if (err) { if (err) {
console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err); console.log('------------- clearUpApplicationDataCallback fail, err: --------------', err);
...@@ -675,40 +624,12 @@ Clears application data by bundle name. This API uses a promise to return the re ...@@ -675,40 +624,12 @@ Clears application data by bundle name. This API uses a promise to return the re
**Example** **Example**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
appManager.clearUpApplicationData(bundleName) appManager.clearUpApplicationData(bundleName)
.then((data) => { .then((data) => {
console.log('------------ clearUpApplicationData success ------------', data); console.log('------------ clearUpApplicationData success ------------', data);
}) })
.catch((err) => { .catch((err) => {
console.log('------------ clearUpApplicationData fail ------------', err); console.log('------------ clearUpApplicationData fail ------------', err);
}) });
``` ```
## ApplicationState<sup>9+</sup>
**System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
| Name | Value | Description |
| -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | State indicating that the application is being created. |
| STATE_FOREGROUND | 2 | State indicating that the application is running in the foreground. |
| STATE_ACTIVE | 3 | State indicating that the application is active. |
| STATE_BACKGROUND | 4 | State indicating that the application is running in the background. |
| STATE_DESTROY | 5 | State indicating that the application is destroyed. |
## ProcessState<sup>9+</sup>
**System capability**: SystemCapability.Ability.AbilityRuntime.Core
**System API**: This is a system API and cannot be called by third-party applications.
| Name | Value | Description |
| -------------------- | --- | --------------------------------- |
| STATE_CREATE | 1 | State indicating that the process is being created. |
| STATE_FOREGROUND | 2 | State indicating that the process is running in the foreground. |
| STATE_ACTIVE | 3 | State indicating that the process is active. |
| STATE_BACKGROUND | 4 | State indicating that the process is running in the background. |
| STATE_DESTROY | 5 | State indicating that the process is destroyed. |
...@@ -19,18 +19,17 @@ Called when an unhandled exception occurs in the JS runtime. ...@@ -19,18 +19,17 @@ Called when an unhandled exception occurs in the JS runtime.
**Example** **Example**
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager' import errorManager from '@ohos.app.ability.errorManager';
let observer = { let observer = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('HXW onUnhandledException, errorMsg: ', errorMsg); console.log('onUnhandledException, errorMsg: ', errorMsg);
} }
} };
try { try {
errorManager.on("error", observer); errorManager.on('error', observer);
} catch (error) { } catch (error) {
console.log('registerErrorObserver' + ' failed, error.code: ' + JSON.stringify(error.code) + console.log('registerErrorObserver failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
' error.message: ' + JSON.stringify(error.message));
} }
``` ```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册