HarmonyOS 应用开发之应用上下文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
struct Page_Context {

  private context = getContext(this) as common.UIAbilityContext;

  build() {
    ...
    Button()
      .onClick(() => {
        let applicationContext = this.context.getApplicationContext();
        let cacheDir = applicationContext.cacheDir;
        let tempDir = applicationContext.tempDir;
        let filesDir = applicationContext.filesDir;
        let databaseDir = applicationContext.databaseDir;
        let bundleCodeDir = applicationContext.bundleCodeDir;
        let distributedFilesDir = applicationContext.distributedFilesDir;
        let preferencesDir = applicationContext.preferencesDir;
        // 获取应用文件路径
        let filePath = tempDir + 'test.txt';
        hilog.info(DOMAIN_NUMBER, TAG, `filePath: ${filePath}`);
        if (filePath !== null) {
          promptAction.showToast({
          message: filePath
          });
        }
      })
  }
}

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

属性	路径
bundleCodeDir	<路径前缀>/el1/bundle
cacheDir	<路径前缀>/<加密等级>/base/haps//cache
filesDir	<路径前缀>/<加密等级>/base/haps//files
preferencesDir	<路径前缀>/<加密等级>/base/haps//preferences
tempDir	<路径前缀>/<加密等级>/base/haps//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
struct Page_Context {

  private context = getContext(this) as common.UIAbilityContext;

  build() {
    ...
    Button()
      .onClick(() => {
        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;
        // 获取应用文件路径
        let filePath = tempDir + 'test.txt';
        hilog.info(DOMAIN_NUMBER, TAG, `filePath: ${filePath}`);
        if (filePath !== null) {
          promptAction.showToast({
            message: filePath
          });
        }
      })
  }
}

获取和修改加密分区

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

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

• EL1：对于私有文件，如闹铃、壁纸等，应用可以将这些文件放到设备级加密分区（EL1）中，以保证在用户输入密码前就可以被访问。
• EL2：对于更敏感的文件，如个人隐私信息等，应用可以将这些文件放到更高级别的加密分区（EL2）中，以保证更高的安全性。
• EL3：对于应用中的记录步数、文件下载、音乐播放，需要在锁屏时读写和创建新文件，放在（EL3）的加密分区比较合适。
• EL4：对于用户安全信息相关的文件，锁屏时不需要读写文件、也不能创建文件，放在（EL4）的加密分区更合适。

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

import UIAbility from '@ohos.app.ability.UIAbility';
import contextConstant from '@ohos.app.ability.contextConstant';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    // 存储普通信息前，切换到EL1设备级加密
    this.context.area = contextConstant.AreaMode.EL1; // 切换area
    // 存储普通信息

    // 存储敏感信息前，切换到EL2用户级加密
    this.context.area = contextConstant.AreaMode.EL2; // 切换area
    // 存储敏感信息

    // 存储敏感信息前，切换到EL3用户级加密
    this.context.area = contextConstant.AreaMode.EL3; // 切换area
    // 存储敏感信息

    // 存储敏感信息前，切换到EL4用户级加密
    this.context.area = contextConstant.AreaMode.EL4; // 切换area
    // 存储敏感信息
  }
}

---

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

@Entry
@Component
struct Page_Context {

  private context = getContext(this) as common.UIAbilityContext;

  build() {
    ...
    Button()
      .onClick(() => {
        // 存储普通信息前，切换到EL1设备级加密
        if (this.context.area === contextConstant.AreaMode.EL2) { // 获取area
          this.context.area = contextConstant.AreaMode.EL1; // 修改area
          promptAction.showToast({
            message: $r('app.string.SwitchToEL1')
          });
        }
        // 存储普通信息
      })
    
    ...

    Button()
      .onClick(() => {
        // 存储敏感信息前，切换到EL2用户级加密
        if (this.context.area === contextConstant.AreaMode.EL1) { // 获取area
          this.context.area = contextConstant.AreaMode.EL2; // 修改area
          promptAction.showToast({
            message: $r('app.string.SwitchToEL2')
          });
        }
        // 存储敏感信息
      })
    
    ...
  }
}

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

基类Context提供创建其他应用或其他Module的Context的方法有 createBundleContext(bundleName: string) 、createModuleContext(moduleName: string) 和createModuleContext(bundleName: string, moduleName: string)接口，创建其他应用或者其他Module的Context，从而通过该Context获取相应的资源信息（例如获取其他Module的 获取应用文件路径信息）。

• 调用createBundleContext(bundleName:string)方法，创建其他应用的Context信息。

说明：
当获取的是其他应用的Context时：

• 申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限，配置方式请参见 申请应用权限 。
• 接口为系统接口，三方应用不支持调用。

例如在桌面上显示的应用信息，包括应用名称和应用图标等，桌面应用可以通过调用上述的方法获取相应应用的Context信息从而获取到相应的应用名称、图标等资源信息。

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

let storageEventCall = new LocalStorage();

@Entry(storageEventCall)
@Component
struct Page_ContextAbility {
  private context = getContext(this) as common.UIAbilityContext;
  build() {
    Button()
      .onClick(() => {
        let bundleName2: string = 'com.samples.stagemodelabilityinteraction';
        let bundleContext: Context = this.context.createBundleContext(bundleName2);
        let label2: string = bundleContext.applicationInfo.label;
        if (bundleContext && label2 !== null) {
          promptAction.showToast({
            message: ('成功获取Context')
          });
        }
      })
  }
}

• 调用createModuleContext(bundleName:string, moduleName:string)方法，获取指定应用指定Module的上下文信息。获取到指定应用指定Module的Context之后，即可获取到相应应用Module的资源信息。

说明：
当获取的是其他应用的指定Module的Context时：

• 申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限，配置方式请参见 申请应用权限 。
• 接口为系统接口，三方应用不支持调用。

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

let storageEventCall = new LocalStorage();

@Entry(storageEventCall)
@Component
struct Page_ContextAbility {
  private context = getContext(this) as common.UIAbilityContext;
  build() {
    Button()
      .onClick(() => {
        let bundleName2: string = 'com.samples.stagemodelabilityinteraction';
        let moduleName2: string  = 'entry';
        let moduleContext = this.context.createModuleContext(bundleName2, moduleName2);
        if (moduleContext !== null) {
          promptAction.showToast({
            message: ('成功获取Context')
          });
        }
      })
  }
}

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

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

let storageEventCall = new LocalStorage();

@Entry(storageEventCall)
@Component
struct Page_ContextAbility {
  private context = getContext(this) as common.UIAbilityContext;
  build() {
    Button()
      .onClick(() => {
        let moduleName2: string = 'entry';
        let moduleContext: Context = this.context.createModuleContext(moduleName2);
        if (moduleContext !== null) {
          promptAction.showToast({
            message: ('成功获取Context')
          });
        }
      })
  }
}

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

.(img-vACHGVQP-1712844442134)]
[外链图片转存中…(img-iBwVlKqp-1712844442134)]
[外链图片转存中…(img-ROffHLG4-1712844442134)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）
[外链图片转存中…(img-7Hj9KkbB-1712844442135)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！