AbilityStage
说明:
本模块首批接口从API version 9开始支持。API 9当前为Canary版本,仅供使用,不保证接口可稳定调用。
AbilityStage是HAP包的运行时类。在HAP加载的时候,通知开发者,开发者可以在此进行该HAP的初始化(如资源预加载,线程创建等)。
导入模块
import AbilityStage from '@ohos.application.AbilityStage';
AbilityStage.onCreate
onCreate(): void
当应用创建时调用。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
示例:
class MyAbilityStage extends AbilityStage {
onCreate() {
console.log("MyAbilityStage.onCreate is called")
}
}
AbilityStage.onAcceptWant
onAcceptWant(want: Want): string;
启动一个specified ability时触发的事件。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
want | Want | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
返回值:
类型 | 说明 |
---|---|
string | 用户返回一个ability标识,如果之前启动过次标识的ability,不创建新的实例并拉回栈顶,否则创建新的实例并启动。 |
示例:
class MyAbilityStage extends AbilityStage {
onAcceptWant(want) {
console.log("MyAbilityStage.onAcceptWant called");
return "com.example.test";
}
}
AbilityStage.onConfigurationUpdated
onConfigurationUpdated(config: Configuration): void;
环境变化通知接口,发生全局配置变更时回调。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
config | Configuration | 是 | 发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。 |
示例:
class MyAbilityStage extends AbilityStage {
onConfigurationUpdated(config) {
console.log('onConfigurationUpdated, language:' + config.language);
}
}
AbilityStage.context
指示有关上下文的配置信息。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
属性名 | 类型 | 说明 |
---|---|---|
context | AbilityStageContext | 在启动能力阶段进行初始化时回调。 |