管理中心
我的
您当前正在浏览新版开发者文档中心,目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标,可切换文档分类。 了解新版目录
指南与API参考指南应用框架Ability Kit(程序框架服务)应用模型应用组件应用上下文Context

应用上下文Context

概述

Context是应用中对象的上下文,其提供了应用的一些基础信息,例如resourceManager(资源管理)、applicationInfo(当前应用信息)、area(文件分区)等。

不同类型Context的对比

UIAbility组件和各种ExtensionAbility派生类组件都有各自不同的Context类。分别有基类Context、ApplicationContext、AbilityStageContext、UIAbilityContext、ExtensionContext等Context。各类Context的继承和持有关系详见不同类型Context的继承和持有关系。

不同类型Context的获取方式与使用场景说明,如下表所示。

说明

不同类型的Context具有不同的能力,不可相互替代或强行转换。例如,ApplicationContext绑定了setFontSizeScale方法,但UIAbilityContext中没有此方法。因此,即使将UIAbilityContext强行转换为ApplicationContext,也无法调用setFontSizeScale方法。

表1 不同类型Context的说明

展开
Context类型 说明 获取方式 使用场景
ApplicationContext 应用的全局上下文,提供应用级别的信息和能力。

- 从API version 14开始,可以直接使用getApplicationContext获取。

- API version 14以前版本,只能使用其他Context实例的getApplicationContext方法获取。

- 获取当前应用的基本信息。

- 获取应用级别的文件路径。

- 获取和修改加密分区。

- 监听应用前后台变化。

AbilityStageContext 模块级别的上下文,提供模块级别的信息和能力。

- 如果需要获取当前AbilityStage的Context,可以直接通过AbilityStage实例获取context属性。

- 如果需要获取同一应用中其他Module的Context,可以通过createModuleContext方法。

- 获取当前模块的基本信息。

- 获取模块级别的文件路径。

UIAbilityContext UIAbility组件对应的上下文,提供UIAbility对外的信息和能力。

- 通过UIAbility实例直接获取context属性。

- 在UIAbility的窗口中加载的UI组件实例,需要使用@ohos.arkui.UIContext提供的getHostContext方法。

- 获取当前UIAbility的基本信息。

- 启动其他应用或元服务、连接/断连系统应用创建的ServiceExtensionAbility等。

- 销毁自身的UIAbility。

ExtensionContext ExtensionAbility组件对应的上下文,每种类型的ExtensionContext提供不同的信息和能力。 通过ExtensionAbility实例直接获取Context属性。

不同类型的ExtensionAbility对应的Context提供的能力不同。以输入法上下文InputMethodExtensionContext为例,主要提供如下能力:

- 获取InputMethodExtensionAbility的基本信息。

- 销毁当前输入法。

UIContext ArkUI的UI实例上下文,提供UI操作相关的能力。与上述其他类型的Context无直接关系。

- 在UI组件内获取UIContext,直接使用组件内置的getUIContext方法。

- 在存在Window实例的情况下,使用@ohos.window提供的getUIContext方法。

主要用于UI实例中UI相关操作,例如:

- 获取当前UI实例的字体。

- 显示不同类型的弹框。

- 设置软键盘弹出时UI避让模式。

Context的获取方式

开发者如果需要通过Context获取应用资源、应用路径等信息,或者使用Context提供的方法来实现应用跳转、设置环境变量、清理数据、获取权限等操作,需要先获取对应的Context。本节分别介绍不同类型Context的获取方式与使用场景。

获取ApplicationContext(应用的全局上下文)

ApplicationContext在基类Context的基础上提供了监听应用内应用组件的生命周期的变化、监听系统内存变化、监听应用内系统环境变化、设置应用语言、设置应用颜色模式、清除应用自身数据的同时撤销应用向用户申请的权限等能力,在UIAbility、ExtensionAbility、AbilityStage中均可以获取。

收起
自动换行
深色代码主题
复制
  1. import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
  2. export default class EntryAbility extends UIAbility {
  3. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  4. let applicationContext = this.context.getApplicationContext();
  5. }
  6. }

获取AbilityStageContext(模块级别的上下文)

AbilityStageContext和基类Context相比,额外提供HapModuleInfo、Configuration等信息。

收起
自动换行
深色代码主题
复制
  1. import { AbilityStage } from '@kit.AbilityKit';
  2. export default class MyAbilityStage extends AbilityStage {
  3. onCreate(): void {
  4. let abilityStageContext = this.context;
  5. // ...
  6. }
  7. }

获取本应用中其他Module的Context(模块级别的上下文)

调用createModuleContext方法,获取本应用中其他Module的Context。获取到其他Module的Context之后,即可获取到相应Module的资源信息。

收起
自动换行
深色代码主题
复制
  1. import { common, application } from '@kit.AbilityKit';
  2. import { BusinessError } from '@kit.BasicServicesKit';
  3. import { hilog } from '@kit.PerformanceAnalysisKit';
  4. const TAG = '[CreateModuleContext]';
  5. const DOMAIN = 0xF811;
  6. let storageEventCall = new LocalStorage();
  7. @Entry(storageEventCall)
  8. @Component
  9. struct CreateModuleContext {
  10. private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  11. build() {
  12. Column() {
  13. // ...
  14. List({ initialIndex: 0 }) {
  15. ListItem() {
  16. Row() {
  17. // ...
  18. }
  19. .onClick(() => {
  20. let moduleName2: string = 'entry';
  21. application.createModuleContext(this.context, moduleName2)
  22. .then((data: common.Context) => {
  23. hilog.info(DOMAIN, TAG, `CreateModuleContext success, data: ${JSON.stringify(data)}`);
  24. if (data !== null) {
  25. this.getUIContext().getPromptAction().showToast({
  26. // 请将$r('app.string.success_message')替换为实际资源文件,在本示例中该资源文件的value值为"成功获取Context"
  27. message: $r('app.string.success_message')
  28. });
  29. }
  30. })
  31. .catch((err: BusinessError) => {
  32. hilog.error(DOMAIN, TAG, `CreateModuleContext failed, err code:${err.code}, err msg: ${err.message}`);
  33. });
  34. })
  35. }
  36. // ...
  37. }
  38. // ...
  39. }
  40. // ...
  41. }
  42. }

获取UIAbilityContext(UIAbility组件的上下文)

UIAbilityContext和基类Context相比,额外提供abilityInfo、currentHapModuleInfo等属性。通过UIAbilityContext可以获取UIAbility的相关配置信息,如包代码路径、Bundle名称、Ability名称和应用程序需要的环境状态等属性信息,也可以获取操作UIAbility实例的方法(如startAbility()、connectServiceExtensionAbility()、terminateSelf()等)。

  • 在UIAbility中可以通过this.context获取UIAbility实例的上下文信息。

    收起
    自动换行
    深色代码主题
    复制
    1. import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
    2. export default class EntryAbility extends UIAbility {
    3. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    4. // 获取UIAbility实例的上下文
    5. let context = this.context;
    6. }
    7. }
  • 在页面中获取UIAbility实例的上下文信息。

    收起
    自动换行
    深色代码主题
    复制
    1. import { common, Want } from '@kit.AbilityKit'; // 导入依赖资源context模块
    2. @Entry
    3. @Component
    4. struct EventHub {
    5. // 定义context变量
    6. private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    7. startAbilityTest(): void {
    8. let want: Want = {
    9. // Want参数信息
    10. };
    11. this.context.startAbility(want);
    12. }
    13. // 页面展示
    14. build() {
    15. // ···
    16. }
    17. }

    也可以在导入依赖资源context模块后,在具体使用UIAbilityContext前进行变量定义。

    收起
    自动换行
    深色代码主题
    复制
    1. import { common, Want } from '@kit.AbilityKit';
    2. @Entry
    3. @Component
    4. struct UIAbilityComponentsBasicUsage {
    5. startAbilityTest(): void {
    6. let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    7. let want: Want = {
    8. // Want参数信息
    9. };
    10. context.startAbility(want);
    11. }
    12. // 页面展示
    13. build() {
    14. // ···
    15. }
    16. }
  • 当业务完成后,开发者如果想要终止当前UIAbility实例,可以通过调用terminateSelf()方法实现。

    收起
    自动换行
    深色代码主题
    复制
    1. import { common } from '@kit.AbilityKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. import { hilog } from '@kit.PerformanceAnalysisKit';
    4. const TAG = '[UIAbilityComponentsUsage]';
    5. const DOMAIN = 0xF811;
    6. @Entry
    7. @Component
    8. struct UIAbilityComponentsUsage {
    9. // 页面展示
    10. build() {
    11. Column() {
    12. // ···
    13. Button('FuncAbilityB')
    14. .onClick(() => {
    15. let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    16. try {
    17. context.terminateSelf((err: BusinessError) => {
    18. if (err.code) {
    19. // 处理业务逻辑错误
    20. hilog.error(DOMAIN, TAG, `terminateSelf failed, code is ${err.code}, message is ${err.message}.`);
    21. return;
    22. }
    23. // 执行正常业务
    24. hilog.info(DOMAIN, TAG, `terminateSelf succeed.`);
    25. });
    26. } catch (err) {
    27. // 捕获同步的参数错误
    28. let code = (err as BusinessError).code;
    29. let message = (err as BusinessError).message;
    30. hilog.error(DOMAIN, TAG, `terminateSelf failed, code is ${code}, message is ${message}.`);
    31. }
    32. })
    33. }
    34. }
    35. }

获取ExtensionAbilityContext (ExtensionAbility组件的上下文)

获取特定场景ExtensionContext。以FormExtensionContext为例,表示卡片服务的上下文环境,继承自ExtensionContext,提供卡片服务相关的接口能力。

收起
自动换行
深色代码主题
复制
  1. import { FormExtensionAbility, formBindingData } from '@kit.FormKit';
  2. import { Want } from '@kit.AbilityKit';
  3. export default class MyFormExtensionAbility extends FormExtensionAbility {
  4. onAddForm(want: Want) {
  5. let formExtensionContext = this.context;
  6. let dataObj1: Record<string, string> = {
  7. 'temperature': '11c',
  8. 'time': '11:00'
  9. };
  10. let obj1: formBindingData.FormBindingData = formBindingData.createFormBindingData(dataObj1);
  11. return obj1;
  12. }
  13. }

Context的典型使用场景

本章节通过以下具体场景来介绍Context的用法:

获取基本信息

继承自Context的不同类型Context,默认会继承父类的方法和属性,还会拥有自己独立的方法与属性。

通过Context属性可以获取当前应用、模块、UIAbility或ExtensionAbility的基本信息(例如资源管理对象、应用程序信息等),下面以UIAbility的信息获取为例:

如果需要跨包获取资源对象,可以参考资源访问。

收起
自动换行
深色代码主题
复制
  1. import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
  2. export default class EntryAbility extends UIAbility {
  3. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  4. // 获取ResourceManager(资源管理)
  5. let resourceManager = this.context.getApplicationContext().resourceManager;
  6. // 获取applicationInfo(当前应用信息)
  7. let applicationInfo = this.context.getApplicationContext().applicationInfo;
  8. }
  9. }

获取应用文件路径

Context提供了获取应用文件路径的能力,ApplicationContext、AbilityStageContext、UIAbilityContext和ExtensionContext均继承该能力。不同类型的Context获取的路径可能存在差异。

  • 通过ApplicationContext可以获取应用级的文件路径。该路径用于存放应用全局信息,路径下的文件会跟随应用的卸载而删除。

  • 通过AbilityStageContext、UIAbilityContext、ExtensionContext,可以获取Module级的文件路径。该路径用于存放Module相关信息,路径下的文件会跟随HAP/HSP的卸载而删除。HAP/HSP的卸载不会影响应用级路径下的文件,除非该应用的HAP/HSP已全部卸载。

    • UIAbilityContext:可以获取UIAbility所在Module的文件路径。
    • ExtensionContext:可以获取ExtensionAbility所在Module的文件路径。
    • AbilityStageContext:由于AbilityStageContext创建时机早于UIAbilityContext和ExtensionContext,通常用于在AbilityStage中获取文件路径。
说明

应用文件路径属于应用沙箱路径,具体请参见应用沙箱目录。

表1 不同级别Context获取的应用文件路径说明

展开
属性 说明 ApplicationContext获取的路径 AbilityStageContext、UIAbilityContext、ExtensionContext获取的路径
bundleCodeDir 安装包目录。 <路径前缀>/el1/bundle <路径前缀>/el1/bundle
cacheDir 缓存目录。 <路径前缀>/<加密等级>/base/cache <路径前缀>/<加密等级>/base/haps/<module-name>/cache
filesDir 文件目录。 <路径前缀>/<加密等级>/base/files <路径前缀>/<加密等级>/base/haps/<module-name>/files
preferencesDir preferences目录。 <路径前缀>/<加密等级>/base/preferences <路径前缀>/<加密等级>/base/haps/<module-name>/preferences
tempDir 临时目录。 <路径前缀>/<加密等级>/base/temp <路径前缀>/<加密等级>/base/haps/<module-name>/temp
databaseDir 数据库目录。 <路径前缀>/<加密等级>/database <路径前缀>/<加密等级>/database/<module-name>
distributedFilesDir 分布式文件目录。 <路径前缀>/el2/distributedFiles <路径前缀>/el2/distributedFiles/
resourceDir11+

资源目录。

说明:

需要开发者手动在\<module-name>\resources路径下创建resfile目录。

不涉及 <路径前缀>/el1/bundle/<module-name>/resources/resfile
cloudFileDir12+ 云文件目录。 <路径前缀>/el2/cloud <路径前缀>/el2/cloud/
logFileDir22+ 日志文件目录。 <路径前缀>/el2/log <路径前缀>/el2/log/

本节以使用ApplicationContext获取cacheDir和filesDir为例,分别介绍如何获取应用缓存目录,以及如何获取应用文件目录,并用于新建文件和读写文件。

  • 获取应用缓存目录

    收起
    自动换行
    深色代码主题
    复制
    1. import { common } from '@kit.AbilityKit';
    2. @Entry
    3. @Component
    4. struct ApplicationContextCache {
    5. @State message: string = 'Hello World';
    6. private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    7. build() {
    8. Row() {
    9. Column() {
    10. Text(this.message)
    11. // ···
    12. Button() {
    13. Text('create file')
    14. // ···
    15. .onClick(() => {
    16. let applicationContext = this.context.getApplicationContext();
    17. // 获取应用缓存路径
    18. let cacheDir = applicationContext.cacheDir;
    19. })
    20. }
    21. // ···
    22. }
    23. // ···
    24. }
    25. // ···
    26. }
    27. }
  • 获取应用文件目录

    收起
    自动换行
    深色代码主题
    复制
    1. import { common } from '@kit.AbilityKit';
    2. import { buffer } from '@kit.ArkTS';
    3. import { fileIo, ReadOptions } from '@kit.CoreFileKit';
    4. import { hilog } from '@kit.PerformanceAnalysisKit';
    5. const TAG: string = '[ApplicationContextFile]';
    6. const DOMAIN_NUMBER: number = 0xFF00;
    7. @Entry
    8. @Component
    9. struct ApplicationContextFile {
    10. @State message: string = 'Hello World';
    11. private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    12. build() {
    13. Row() {
    14. Column() {
    15. Text(this.message)
    16. // ···
    17. Button() {
    18. Text('create file')
    19. // ···
    20. .onClick(() => {
    21. let applicationContext = this.context.getApplicationContext();
    22. // 获取应用文件路径
    23. let filesDir = applicationContext.filesDir;
    24. hilog.info(DOMAIN_NUMBER, TAG, `filePath: ${filesDir}`);
    25. // 文件不存在时创建并打开文件,文件存在时打开文件
    26. let file = fileIo.openSync(filesDir + '/test.txt', fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
    27. // 写入一段内容至文件
    28. let writeLen = fileIo.writeSync(file.fd, 'Try to write str.');
    29. hilog.info(DOMAIN_NUMBER, TAG, `The length of str is: ${writeLen}`);
    30. // 创建一个大小为1024字节的ArrayBuffer对象,用于存储从文件中读取的数据
    31. let arrayBuffer = new ArrayBuffer(1024);
    32. // 设置读取的偏移量和长度
    33. let readOptions: ReadOptions = {
    34. offset: 0,
    35. length: arrayBuffer.byteLength
    36. };
    37. // 读取文件内容到ArrayBuffer对象中,并返回实际读取的字节数
    38. let readLen = fileIo.readSync(file.fd, arrayBuffer, readOptions);
    39. // 将ArrayBuffer对象转换为Buffer对象,并转换为字符串输出
    40. let buf = buffer.from(arrayBuffer, 0, readLen);
    41. hilog.info(DOMAIN_NUMBER, TAG, `the content of file: ${buf.toString()}`);
    42. // 关闭文件
    43. fileIo.closeSync(file);
    44. })
    45. }
    46. // ···
    47. }
    48. // ···
    49. }
    50. // ···
    51. }
    52. }

获取和修改加密分区

应用文件加密是一种保护数据安全的方法,可以使得文件在未经授权访问的情况下得到保护。在不同的场景下,应用需要不同程度的文件保护。

在实际应用中,开发者需要根据不同场景的需求选择合适的加密分区,从而保护应用数据的安全。通过合理使用不同级别的加密分区,可以有效提升应用数据的安全性。关于不同分区的权限说明,详见ContextConstant的AreaMode。

  • EL1:对于私有文件,如闹铃、壁纸等,应用可以将这些文件放到设备级加密分区(EL1)中,以保证在用户输入密码前就可以被访问。
  • EL2:对于更敏感的文件,如个人隐私信息等,应用可以将这些文件放到更高级别的加密分区(EL2)中,以保证更高的安全性。
  • EL3:对于应用中的记录步数、文件下载、音乐播放,需要在锁屏时读写和创建新文件,放在(EL3)的加密分区比较合适。
  • EL4:对于用户安全信息相关的文件,锁屏时不需要读写文件、也不能创建文件,放在(EL4)的加密分区更合适。
  • EL5:对于用户隐私敏感数据文件,锁屏后默认不可读写,如果锁屏后需要读写文件,则锁屏前可以调用acquireAccess接口申请继续读写文件,或者锁屏后也需要创建新文件且可读写,放在(EL5)的应用级加密分区更合适。

要实现获取和设置当前加密分区,可以通过读写Context的area属性来实现。

收起
自动换行
深色代码主题
复制
  1. import { UIAbility, contextConstant, AbilityConstant, Want } from '@kit.AbilityKit';
  2. export default class EntryAbility extends UIAbility {
  3. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
  4. // 存储普通信息前,切换到EL1设备级加密
  5. this.context.area = contextConstant.AreaMode.EL1; // 切换area
  6. // 存储普通信息
  7. // 存储敏感信息前,切换到EL2用户级加密
  8. this.context.area = contextConstant.AreaMode.EL2; // 切换area
  9. // 存储敏感信息
  10. // 存储敏感信息前,切换到EL3用户级加密
  11. this.context.area = contextConstant.AreaMode.EL3; // 切换area
  12. // 存储敏感信息
  13. // 存储敏感信息前,切换到EL4用户级加密
  14. this.context.area = contextConstant.AreaMode.EL4; // 切换area
  15. // 存储敏感信息
  16. // 存储敏感信息前,切换到EL5应用级加密
  17. this.context.area = contextConstant.AreaMode.EL5; // 切换area
  18. // 存储敏感信息
  19. }
  20. }
收起
自动换行
深色代码主题
复制
  1. // AreaContext.ets
  2. import { contextConstant, common } from '@kit.AbilityKit';
  3. @Entry
  4. @Component
  5. struct AreaContext {
  6. private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  7. build() {
  8. Column() {
  9. // ···
  10. List({ initialIndex: 0 }) {
  11. // ···
  12. ListItem() {
  13. Row() {
  14. // ···
  15. }
  16. .onClick(() => {
  17. // 存储普通信息前,切换到EL1设备级加密
  18. if (this.context.area === contextConstant.AreaMode.EL2) { // 获取area
  19. this.context.area = contextConstant.AreaMode.EL1; // 修改area
  20. this.getUIContext().getPromptAction().showToast({
  21. message: 'SwitchToEL1'
  22. });
  23. }
  24. // 存储普通信息
  25. })
  26. }
  27. // ···
  28. ListItem() {
  29. Row() {
  30. // ···
  31. }
  32. .onClick(() => {
  33. // 存储敏感信息前,切换到EL2用户级加密
  34. if (this.context.area === contextConstant.AreaMode.EL1) { // 获取area
  35. this.context.area = contextConstant.AreaMode.EL2; // 修改area
  36. this.getUIContext().getPromptAction().showToast({
  37. message: 'SwitchToEL2'
  38. });
  39. }
  40. // 存储敏感信息
  41. })
  42. }
  43. // ···
  44. }
  45. // ···
  46. }
  47. // ···
  48. }
  49. }

监听应用前后台变化

开发者可以使用ApplicationContext的on('applicationStateChange')监听应用的前后台变化,详见监听应用前后台变化中的介绍。

监听UIAbility生命周期变化

开发者可以通过ApplicationContext监听UIAbility生命周期变化。当UIAbility生命周期变化时,如UIAbility创建、切换至前/后台、销毁等情况,UIAbility会收到相应回调函数的通知,从而执行依赖UIAbility生命周期的方法,也可以统计指定页面停留时间和访问频率等信息。

每次注册回调函数时,都会返回一个监听生命周期的ID,此ID会自增1。以UIAbilityContext中的使用为例进行说明。

收起
自动换行
深色代码主题
复制
  1. import { AbilityConstant, AbilityLifecycleCallback, UIAbility, Want } from '@kit.AbilityKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. import { window } from '@kit.ArkUI';
  4. import { BusinessError } from '@kit.BasicServicesKit';
  5. const TAG: string = '[EntryLifecycleAbility]';
  6. const DOMAIN_NUMBER: number = 0xFF00;
  7. export default class EntryLifecycleAbility extends UIAbility {
  8. // 定义生命周期ID
  9. private lifecycleId: number = -1;
  10. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  11. // 定义生命周期回调对象
  12. let abilityLifecycleCallback: AbilityLifecycleCallback = {
  13. // 当UIAbility创建时被调用
  14. onAbilityCreate(uiAbility) {
  15. hilog.info(DOMAIN_NUMBER, TAG, `onAbilityCreate uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  16. },
  17. // 当窗口创建时被调用
  18. onWindowStageCreate(uiAbility, windowStage: window.WindowStage) {
  19. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageCreate uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  20. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageCreate windowStage: ${JSON.stringify(windowStage)}`);
  21. },
  22. // 当窗口处于活动状态时被调用
  23. onWindowStageActive(uiAbility, windowStage: window.WindowStage) {
  24. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageActive uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  25. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageActive windowStage: ${JSON.stringify(windowStage)}`);
  26. },
  27. // 当窗口处于非活动状态时被调用
  28. onWindowStageInactive(uiAbility, windowStage: window.WindowStage) {
  29. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageInactive uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  30. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageInactive windowStage: ${JSON.stringify(windowStage)}`);
  31. },
  32. // 当窗口被销毁时被调用
  33. onWindowStageDestroy(uiAbility, windowStage: window.WindowStage) {
  34. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageDestroy uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  35. hilog.info(DOMAIN_NUMBER, TAG, `onWindowStageDestroy windowStage: ${JSON.stringify(windowStage)}`);
  36. },
  37. // 当UIAbility被销毁时被调用
  38. onAbilityDestroy(uiAbility) {
  39. hilog.info(DOMAIN_NUMBER, TAG, `onAbilityDestroy uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  40. },
  41. // 当UIAbility从后台转到前台时触发回调
  42. onAbilityForeground(uiAbility) {
  43. hilog.info(DOMAIN_NUMBER, TAG, `onAbilityForeground uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  44. },
  45. // 当UIAbility从前台转到后台时触发回调
  46. onAbilityBackground(uiAbility) {
  47. hilog.info(DOMAIN_NUMBER, TAG, `onAbilityBackground uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  48. },
  49. // 当UIAbility迁移时被调用
  50. onAbilityContinue(uiAbility) {
  51. hilog.info(DOMAIN_NUMBER, TAG, `onAbilityContinue uiAbility.launchWant: ${JSON.stringify(uiAbility.launchWant)}`);
  52. }
  53. };
  54. // 获取应用上下文
  55. let applicationContext = this.context.getApplicationContext();
  56. try {
  57. // 注册应用内生命周期回调
  58. this.lifecycleId = applicationContext.on('abilityLifecycle', abilityLifecycleCallback);
  59. } catch (err) {
  60. let code = (err as BusinessError).code;
  61. let message = (err as BusinessError).message;
  62. hilog.error(DOMAIN_NUMBER, TAG, `Failed to register applicationContext. Code is ${code}, message is ${message}`);
  63. }
  64. hilog.info(DOMAIN_NUMBER, TAG, `register callback number: ${this.lifecycleId}`);
  65. }
  66. onDestroy(): void {
  67. // 获取应用上下文
  68. let applicationContext = this.context.getApplicationContext();
  69. try {
  70. // 取消应用内生命周期回调
  71. applicationContext.off('abilityLifecycle', this.lifecycleId);
  72. } catch (err) {
  73. let code = (err as BusinessError).code;
  74. let message = (err as BusinessError).message;
  75. hilog.error(DOMAIN_NUMBER, TAG, `Failed to unregister applicationContext. Code is ${code}, message is ${message}`);
  76. }
  77. }
  78. }