HarmonyOS 应用开发之应用上下文Context

概述

Context 是应用中对象的上下文，其提供了应用的一些基础信息，例如resourceManager（资源管理）、applicationInfo（当前应用信息）、dir（应用文件路径）、area（文件分区）等，以及应用的一些基本方法，例如createBundleContext()、getApplicationContext()等。UIAbility组件和各种ExtensionAbility派生类组件都有各自不同的Context类。分别有基类Context、ApplicationContext、AbilityStageContext、UIAbilityContext、ExtensionContext、ServiceExtensionContext等Context。

• 各类Context的继承关系

• 各类Context的持有关系

• 各类Context的获取方式

  • 获取 UIAbilityContext 。每个UIAbility中都包含了一个Context属性，提供操作应用组件、获取应用组件的配置信息等能力。

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

说明：
页面中获取UIAbility实例的上下文信息请参见 获取UIAbility的上下文信息。

*   获取特定场景 ExtensionContext 。以ServiceExtensionContext为例，表示后台服务的上下文环境，继承自ExtensionContext，提供后台服务相关的接口能力。

import ServiceExtensionAbility from '@ohos.app.ability.ServiceExtensionAbility';
import Want from '@ohos.app.ability.Want';
export default class MyService extends ServiceExtensionAbility {
  onCreate(want: Want) {
    let serviceExtensionContext = this.context;
    ...
  }
}

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

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

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

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

Context的典型使用场景

本章节通过如下典型场景来介绍Context的用法：

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

获取应用文件路径

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

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

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

  属性	路径
  bundleCodeDir	<路径前缀>/el1/bundle
  cacheDir	<路径前缀>/<加密等级>/base/cache
  filesDir	<路径前缀>/<加密等级>/base/files
  preferencesDir	<路径前缀>/<加密等级>/base/preferences
  tempDir	<路径前缀>/<加密等级>/base/temp
  databaseDir	<路径前缀>/<加密等级>/database
  distributedFilesDir	<路径前缀>/el2/distributedFiles

  示例代码如下所示。

import common from '@ohos.app.ability.common';
import hilog from '@ohos.hilog';
import promptAction from '@ohos.promptAction';

const TAG: string = '[Page_Context]';
const DOMAIN_NUMBER: number = 0xFF00;
@Entry
@Component