• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.Ability (Ability基类)
2
3[UIAbility](js-apis-app-ability-uiAbility.md)和[ExtensionAbility](js-apis-app-ability-extensionAbility.md)的基类,提供系统配置更新回调和系统内存调整回调。不支持开发者直接继承该基类。
4
5> **说明:**
6>
7> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9
10## 导入模块
11
12```ts
13import Ability from '@ohos.app.ability.Ability';
14```
15
16## Ability.onConfigurationUpdate
17
18onConfigurationUpdate(newConfig: Configuration): void;
19
20当系统配置更新时调用。
21
22**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
23
24**参数:**
25
26| 参数名 | 类型 | 必填 | 说明 |
27| -------- | -------- | -------- | -------- |
28| newConfig | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 |
29
30**示例:**
31  ```ts
32// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
33import UIAbility from '@ohos.app.ability.UIAbility';
34import { Configuration } from '@ohos.app.ability.Configuration';
35
36class MyUIAbility extends UIAbility {
37    onConfigurationUpdate(config: Configuration) {
38        console.log(`onConfigurationUpdate, config: ${JSON.stringify(config)}`);
39    }
40}
41  ```
42
43## Ability.onMemoryLevel
44
45onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
46
47当内存到达不同级别时系统回调该方法。
48
49**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
50
51**参数:**
52
53| 参数名 | 类型 | 必填 | 说明 |
54| -------- | -------- | -------- | -------- |
55| level | [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel) | 是 | 当前内存使用级别。|
56
57**示例:**
58
59  ```ts
60// Ability是顶层基类,不支持开发者直接继承。故以派生类UIAbility举例说明。
61import UIAbility from '@ohos.app.ability.UIAbility';
62import AbilityConstant from '@ohos.app.ability.AbilityConstant';
63
64class MyUIAbility extends UIAbility {
65    onMemoryLevel(level: AbilityConstant.MemoryLevel) {
66        console.log(`onMemoryLevel, level: ${JSON.stringify(level)}`);
67    }
68}
69  ```
70