「鸿蒙学习笔记」Stage模型--应用上下文Context

头像
山庄的铁匠
     广东
    阅读 6 分钟

    「鸿蒙学习笔记」Stage模型--应用上下文Context

    Context是应用中对象的上下文，其提供了应用的一些基础信息，例如resourceManager（资源管理）、applicationInfo（当前应用信息）、dir（应用开发路径）、area（文件分区）等，以及应用的一些基本方法，例如createBundleContext()、getApplicationContext()等。

    UIAbility组件和各种ExtensionAbility派生类组件都有各自不同的Context类。分别有基类Context、ApplicationContext、AbilityStageContext、UIAbilityContext、ExtensionContext、ServiceExtensionContext等Context。

    各类Context的继承关系
    image.png

    各类Context的持有关系
    image-1.png

    各类Context的获取方式：

    • 获取UIAbilityContext。每个UIAbility中都包含了一个Context属性，提供操作Ability、获取Ability的配置信息、应用向用户申请授权等能力。

      import UIAbility from '@ohos.app.ability.UIAbility';
export default class EntryAbility extends UIAbility {
  onCreate(want, launchParam) {
      let uiAbilityContext = this.context;
      // ...
  }
}

    • 获取AbilityStageContext。Module级别的Context，和基类Context相比，额外提供HapModuleInfo、Configuration等信息。

      import AbilityStage from "@ohos.app.ability.AbilityStage";
export default class MyAbilityStage extends AbilityStage {
  onCreate() {
      let abilityStageContext = this.context;
      // ...
  }
}

    • 获取ApplicationContext。应用级别的Context。ApplicationContext在基类Context的基础上提供了订阅应用内Ability的生命周期的变化、订阅系统内存变化和订阅应用内系统环境的变化的能力，在UIAbility、ExtensionAbility、AbilityStage中均可以获取。

      import UIAbility from '@ohos.app.ability.UIAbility';
export default class EntryAbility extends UIAbility {
  onCreate(want, launchParam) {
      let applicationContext = this.context.getApplicationContext();
      // ...
  }
}

    Context的典型使用场景

    • 获取应用文件路径
    • 获取和修改加密分区
    • 创建其他应用或其他Module的Context
    • 订阅进程内Ability生命周期变化

    获取应用文件路径

    基类Context提供了获取应用文件路径的能力，ApplicationContext、AbilityStageContext、UIAbilityContext和ExtensionContext均继承该能力。应用文件路径属于应用沙箱路径，具体请参见应用沙箱目录。

    上述各类Context获取的应用文件路径有所不同。

    • 通过ApplicationContext获取 应用级别的应用文件路径 ，此路径是 应用全局信息推荐的存放路径 ，这些文件会跟 随应用的卸载而删除 。
      image-2.png

    • 通过AbilityStageContext、UIAbilityContext、ExtensionContext获取 HAP级别的应用文件路径 。此路径是 HAP相关信息推荐的存放路径 ，这些文件会跟 随HAP的卸载而删除 ，但不会影响应用级别路径的文件，除非该应用的HAP已全部卸载。
      image-3.png
      示例代码：

      import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  onCreate(want, launchParam) {
      let cacheDir = this.context.cacheDir;
      let tempDir = this.context.tempDir;
      let filesDir = this.context.filesDir;
      let databaseDir = this.context.databaseDir;
      let bundleCodeDir = this.context.bundleCodeDir;
      let distributedFilesDir = this.context.distributedFilesDir;
      let preferencesDir = this.context.preferencesDir;
      // ...
  }
}

    获取和修改加密分区

    上一个场景中，引入了加密等级的概念，通过对Context的area属性的读写来实现获取和设置当前加密分区，支持如下两种加密等级：

    • AreaMode.EL1：设备级加密区，设备开机后可访问的数据区。

    • AreaMode.EL2：用户级加密区，设备开机，首次输入密码后才能够访问的数据区。

      import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  onCreate(want, launchParam) {
      // 存储普通信息前，切换到EL1设备级加密
      if (this.context.area === 1) { // 获取area
          this.context.area = 0;     // 修改area
      }
      // 存储普通信息

      // 存储敏感信息前，切换到EL2用户级加密
      if (this.context.area === 0) { // 获取area
          this.context.area = 1;     // 修改area
      }
      // 存储敏感信息
  }
}

    创建其他应用或其他Module的Context

    基类Context提供创建其他应用或其他Module的Context的方法为createModuleContext(moduleName:string)，创建其他应用或者其他Module的Context，从而通过该Context获取相应的资源信息（例如获取其他Module的获取应用开发路径信息）。

    调用createModuleContext(moduleName:string)方法，获取本应用中其他Module的Context。获取到其他Module的Context之后，即可获取到相应Module的资源信息。

    import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
    onCreate(want, launchParam) {
        let moduleName2 = "module1";
        let context2 = this.context.createModuleContext(moduleName2);
        // ...
    }
}

    订阅进程内Ability生命周期变化

    在应用内的DFX统计场景，如需要统计对应页面停留时间和访问频率等信息，可以使用订阅进程内Ability生命周期变化功能。

    在进程内Ability生命周期变化时，如创建、可见/不可见、获焦/失焦、销毁等，会触发进入相应的回调，其中返回的此次注册监听生命周期的ID（每次注册该ID会自增+1，当超过监听上限数量2^63-1时，返回-1），以在UIAbilityContext中使用为例进行说明。

    import UIAbility from '@ohos.app.ability.UIAbility';
import Window from '@ohos.window';

const TAG: string = "[Example].[Entry].[EntryAbility]";

export default class EntryAbility extends UIAbility {
    lifecycleId: number;

    onCreate(want, launchParam) {
        let abilityLifecycleCallback = {
            onAbilityCreate(ability) {
                console.info(TAG, "onAbilityCreate ability:" + JSON.stringify(ability));
            },
            onWindowStageCreate(ability, windowStage) {
                console.info(TAG, "onWindowStageCreate ability:" + JSON.stringify(ability));
                console.info(TAG, "onWindowStageCreate windowStage:" + JSON.stringify(windowStage));
            },
            onWindowStageActive(ability, windowStage) {
                console.info(TAG, "onWindowStageActive ability:" + JSON.stringify(ability));
                console.info(TAG, "onWindowStageActive windowStage:" + JSON.stringify(windowStage));
            },
            onWindowStageInactive(ability, windowStage) {
                console.info(TAG, "onWindowStageInactive ability:" + JSON.stringify(ability));
                console.info(TAG, "onWindowStageInactive windowStage:" + JSON.stringify(windowStage));
            },
            onWindowStageDestroy(ability, windowStage) {
                console.info(TAG, "onWindowStageDestroy ability:" + JSON.stringify(ability));
                console.info(TAG, "onWindowStageDestroy windowStage:" + JSON.stringify(windowStage));
            },
            onAbilityDestroy(ability) {
                console.info(TAG, "onAbilityDestroy ability:" + JSON.stringify(ability));
            },
            onAbilityForeground(ability) {
                console.info(TAG, "onAbilityForeground ability:" + JSON.stringify(ability));
            },
            onAbilityBackground(ability) {
                console.info(TAG, "onAbilityBackground ability:" + JSON.stringify(ability));
            },
            onAbilityContinue(ability) {
                console.info(TAG, "onAbilityContinue ability:" + JSON.stringify(ability));
            }
        }
        // 1. 通过context属性获取applicationContext
        let applicationContext = this.context.getApplicationContext();
        // 2. 通过applicationContext注册监听应用内生命周期
        this.lifecycleId = applicationContext.on("abilityLifecycle", abilityLifecycleCallback);
        console.info(TAG, "register callback number: " + JSON.stringify(this.lifecycleId));
    }

    onDestroy() {
        let applicationContext = this.context.getApplicationContext();
        applicationContext.off("abilityLifecycle", this.lifecycleId, (error, data) => {
            console.info(TAG, "unregister callback success, err: " + JSON.stringify(error));
        });
    }
}

    参考

    harmonyos
    山庄的铁匠
    18 声望11 粉丝
    « 上一篇
    「鸿蒙学习笔记」Stage模型--AbilityStage组件容器
    下一篇 »
    「鸿蒙学习笔记」Stage模型--信息传递载体Want

    引用和评论

    推荐阅读
    头像
    「鸿蒙」解决【DevEcoStudio经常出现“Sync files”并且丢失代码提示和代码跳转等功能】问题

    山庄的铁匠阅读 583

    头像
    一图看懂鸿蒙应用上架流程

    鸿蒙百晓生赞 8阅读 2.1k

    头像
    HarmonyOS 第一课：中级课程

    鸿蒙百晓生赞 5阅读 3.3k

    头像
    HarmonyOS 第一课：基础课程

    鸿蒙百晓生赞 7阅读 4.3k

    头像
    RN/H5多设备自适应组件库来了，高效实现鸿蒙原生应用多设备精致体验

    鸿蒙百晓生赞 4阅读 1.5k

    头像
    一图看懂鸿蒙应用上架步骤

    鸿蒙百晓生赞 4阅读 1.3k

    头像
    <HarmonyOS应用开发者认证>HarmonyOS应用开发者高级认证-编程考试

    鸿蒙百晓生赞 4阅读 2k评论 1

    0 条评论
    得票最新