HarmonyOS6 上下文完全指南：跨 Ability 数据共享与模块化 Context 实战

前言

你有没有遇到过这种情况：同一个 App 里，你在聊天页面点赞了一首歌，收藏记录页立刻就显示了？或者你在登录页输入了账号密码，首页就自动显示了用户名？这种"一个地方改了，其他地方马上知道"的现象，背后就是上下文（Context）机制在起作用。
在 HarmonyOS6 中，Context是一个"应用运行环境的身份证"，它告诉系统你是谁、你能访问什么资源、你应该遵守什么规则。理解 Context 的不同层级，能让你正确地在组件之间共享数据、在不同的 Ability 之间传递信息、在多设备之间协同工作。
本文带你深入理解 HarmonyOS6 的四大 Context 体系，重点讲解ApplicationContext和UIAbilityContext，并通过ApplicationContextDemo源码展示实战技巧。

一、Context 是什么？—— 应用运行的"身份证"

1.1 生活化理解 Context

Context可以理解为一个"工作证"。你拿着工作证，可以进入公司（应用）内部、使用公司资源（文件、网络、数据库）、申请会议室（窗口）、参加公司活动（启动其他 Ability）。

在 HarmonyOS6 中，不同的 Context 相当于不同级别的工作证：

1.2 HarmonyOS6 Context 继承关系

下面用类图展示 Context 的继承关系：

ApplicationContext是最顶层的基类，提供了应用级别的基础能力（如获取资源文件路径、获取应用信息）。UIAbilityContext、ExtensionContext、Device协作Context都继承自它，扩展了各自特有的能力。

二、ApplicationContext：应用全局上下文

2.1 ApplicationContext 是什么？

ApplicationContext是应用层级的上下文对象，它代表了"整个应用"的运行环境。从UIAbility中可以通过this.context.getApplicationContext()获取。

大白话理解：ApplicationContext 就像公司的"总务处"。无论你在公司的哪个部门（Ability），都可以找总务处申请办公用品、查询公司制度、通知全员公告。

2.2 如何获取 ApplicationContext？

// 从 UIAbility 内部获取 import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { // 方式1：通过 this.context 获取 let appContext = this.context.getApplicationContext(); console.info(`应用上下文 ID: ${appContext.toString()}`); // 方式2：直接在 this 上访问（UIAbility 继承自 AbilityContext） console.info(`当前 Ability 上下文 ID: ${this.context.toString()}`); } }

2.3 ApplicationContext 的核心能力

2.3.1 监听所有 Ability 的生命周期

这是 ApplicationContext 最强大的能力之一。你可以在一个 Ability 中监听整个应用内所有 Ability 的生命周期变化。

代码示例：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { hilog.info(DOMAIN, 'testTag', 'Ability onCreate'); // 通过 ApplicationContext 获取应用上下文 let appContext = this.context.getApplicationContext(); // 注册应用级别生命周期监听器 appContext.on('abilityLifecycle', (innerLifecycleId, event, param) => { hilog.info(DOMAIN, 'testTag', `Lifecycle event: id=${innerLifecycleId}, event=${event}, param=${param}`); // event 的取值： // 'ABILITY_LIFE_CYCLE_CREATE' - Ability 创建 // 'ABILITY_LIFE_CYCLE_WINDOW_STAGE_CREATE' - 窗口创建 // 'ABILITY_LIFE_CYCLE_WINDOW_STAGE_DESTROY' - 窗口销毁 // 'ABILITY_LIFE_CYCLE_DESTROY' - Ability 销毁 // 'ABILITY_LIFE_CYCLE_FOREGROUND' - Ability 进入前台 // 'ABILITY_LIFE_CYCLE_BACKGROUND' - Ability 进入后台 // 'ABILITY_LIFE_CYCLE_NEW_WANT' - Ability 被新 Want 唤起 }); } onDestroy(): void { hilog.info(DOMAIN, 'testTag', 'Ability onDestroy'); // 销毁时一定要注销监听器，避免内存泄漏 let appContext = this.context.getApplicationContext(); appContext.off('abilityLifecycle'); }

• appContext.on('abilityLifecycle', callback)：注册监听器，参数是回调函数。
• 回调参数innerLifecycleId：是触发事件的 Ability 的内部 ID。
• 回调参数event：是生命周期事件的名称字符串。
• 回调参数param：是系统传递的额外参数。
• appContext.off('abilityLifecycle')：注销监听器，必须在 onDestroy 中执行，否则会导致内存泄漏。

注意：通过 ApplicationContext 监听的是所有 Ability的生命周期，包括其他 Ability（如果有多个 Ability）。如果你只想监听某一个 Ability 的生命周期，可以直接在该 Ability 内部重写对应的生命周期方法。

2.3.2 设置颜色模式

import { ConfigurationConstant } from '@kit.AbilityKit'; onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { let appContext = this.context.getApplicationContext(); // 设置颜色模式为跟随系统 try { appContext.setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET); hilog.info(DOMAIN, 'testTag', '设置颜色模式跟随系统成功'); } catch (err) { hilog.error(DOMAIN, 'testTag', '设置颜色模式失败: %{public}s', JSON.stringify(err)); } }

2.3.3 退出应用进程

// 退出整个应用（慎用！） onDestroy(): void { let appContext = this.context.getApplicationContext(); // 这会让整个应用进程退出 // 如果有其他 Ability 正在运行，也会一并退出 appContext.terminateSelf(); }

注意：terminateSelf()会直接终止整个应用进程。只有在"确实需要退出应用"的场景下才使用，比如用户主动点击"退出登录并退出 App"时。滥用此方法会导致用户体验很差。

三、UIAbilityContext：界面级别的上下文

3.1 UIAbilityContext 是什么？

UIAbilityContext是 Ability 级别的上下文，它代表了"当前 Ability"的运行环境。从this.context（在 UIAbility 内部）直接获取。

生活化比喻：UIAbilityContext 就像"部门主管"。部门主管只能管理自己部门的事务（当前 Ability 的窗口、启动/停止其他 Ability），但管不了其他部门（其他 Ability）。

3.2 UIAbilityContext 的核心能力

3.2.1 启动其他 Ability

import { common, Want } from '@kit.AbilityKit'; async startOtherAbility(): Promise<void> { // this.context 就是 UIAbilityContext let context = this.context as common.UIAbilityContext; let want: Want = { deviceId: '', // 空字符串表示本设备 bundleName: 'com.example.myapp', abilityName: 'DetailAbility', // 目标 Ability 名称 parameters: { productId: 'PROD_001', from: 'home' } }; try { // 启动 DetailAbility await context.startAbility(want); hilog.info(DOMAIN, 'testTag', '启动成功'); } catch (err) { hilog.error(DOMAIN, 'testTag', '启动失败: code=%{public}d, message=%{public}s', err.code, err.message); } }

3.2.2 获取当前 Ability 信息

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { // 获取当前 Ability 的信息 let abilityName = this.context.abilityInfo?.abilityName; let bundleName = this.context.abilityInfo?.bundleName; let moduleName = this.context.abilityInfo?.moduleName; hilog.info(DOMAIN, 'testTag', `Ability: ${abilityName}, Bundle: ${bundleName}, Module: ${moduleName}`); // 获取启动参数 hilog.info(DOMAIN, 'testTag', `LaunchReason: ${launchParam.launchReason}`); hilog.info(DOMAIN, 'testTag', `LastExitReason: ${launchParam.lastExitReason}`); }

3.2.3 窗口管理

onWindowStageCreate(windowStage: window.WindowStage): void { // UIAbilityContext 的 currentWindowStage 属性 // 可以在其他地方访问当前 Ability 的窗口 // （但更推荐在 AbilityStage 或模块化代码中使用） // 获取窗口信息 let windowClass = windowStage.getWindowOptions(); hilog.info(DOMAIN, 'testTag', '窗口创建: ' + JSON.stringify(windowClass)); }

四、模块级 ApplicationContext：跨 HAP 共享

4.1 什么是模块级 Context？

在多 HAP（HarmonyOS Ability Package）架构中，每个 HAP 都有自己的模块上下文。如果你想在不同 HAP 之间共享数据，可以使用模块级的ApplicationContext。

4.2 如何创建模块级 Context？

import { application, contextConstant } from '@kit.AbilityKit'; import { relationalStore } from '@kit.ArkData'; async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> { // 创建跨 HAP 的加密存储上下文 // 使用 AreaMode.EL5 可以将数据存储在加密目录下 let moduleContext = await application.createModuleContext( this.context, // 当前上下文 'entry' // 目标模块名（另一个 HAP 的模块名） ); // 设置存储区域为 EL5（加密区域） moduleContext.area = contextConstant.AreaMode.EL5; hilog.info(DOMAIN, 'testTag', '模块上下文创建成功，存储区域: EL5'); // 使用该上下文创建加密数据库 // 详细代码见 relationalStore 相关示例 }

• application.createModuleContext(this.context, 'entry')：从当前模块创建一个指向另一个模块（名为 ‘entry’）的上下文。
• moduleContext.area = contextConstant.AreaMode.EL5：将存储区域设置为 EL5（增强加密区域），数据会以加密形式存储，即使设备被 root 也难以读取。
• 这个上下文可以用来在 entry 模块中操作另一个 HAP 的加密存储。

注意：createModuleContext是异步方法，必须await。同时，只有在 entry 模块和其他 HAP 都声明了相互依赖关系时才能正常使用。

五、实战综合示例

5.1 场景：实现全局应用状态监听

下面通过一个完整示例，展示如何在应用启动时注册全局生命周期监听，在所有 Ability 切换时自动记录日志：

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; import { window } from '@kit.ArkUI'; const DOMAIN = 0x0000; export default class EntryAbility extends UIAbility { private appContext: ApplicationContext | undefined = undefined; onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onCreate'); // 获取 ApplicationContext this.appContext = this.context.getApplicationContext(); // 打印启动信息 hilog.info(DOMAIN, 'testTag', '启动原因: %{public}s', launchParam.launchReason.toString()); // 注册应用全局生命周期监听 this.registerGlobalLifecycleListener(); } private registerGlobalLifecycleListener(): void { if (!this.appContext) { return; } // 监听所有 Ability 的生命周期变化 this.appContext.on('abilityLifecycle', (lifecycleId: number, event: string, param: Record<string, Object>) => { // 获取当前 Ability 的内部 ID let currentAbilityId = this.context.abilityInfo?.abilityId; switch (event) { case 'ABILITY_LIFE_CYCLE_CREATE': hilog.info(DOMAIN, 'testTag', `[全局监听] Ability 创建: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_WINDOW_STAGE_CREATE': hilog.info(DOMAIN, 'testTag', `[全局监听] 窗口创建: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_WINDOW_STAGE_DESTROY': hilog.info(DOMAIN, 'testTag', `[全局监听] 窗口销毁: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_FOREGROUND': hilog.info(DOMAIN, 'testTag', `[全局监听] Ability 进入前台: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_BACKGROUND': hilog.info(DOMAIN, 'testTag', `[全局监听] Ability 进入后台: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_DESTROY': hilog.info(DOMAIN, 'testTag', `[全局监听] Ability 销毁: id=${lifecycleId}`); break; case 'ABILITY_LIFE_CYCLE_NEW_WANT': hilog.info(DOMAIN, 'testTag', `[全局监听] Ability 被新 Want 唤起: id=${lifecycleId}`); break; default: hilog.info(DOMAIN, 'testTag', `[全局监听] 未知事件: ${event}`); } } ); hilog.info(DOMAIN, 'testTag', '全局生命周期监听注册完成'); } onDestroy(): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onDestroy'); // 销毁时必须注销监听 if (this.appContext) { this.appContext.off('abilityLifecycle'); hilog.info(DOMAIN, 'testTag', '全局生命周期监听已注销'); } } onWindowStageCreate(windowStage: window.WindowStage): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onWindowStageCreate'); windowStage.loadContent('pages/Index', (err) => { if (err.code) { hilog.error(DOMAIN, 'testTag', '加载页面失败'); } }); } onWindowStageDestroy(): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onWindowStageDestroy'); } onForeground(): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onForeground'); } onBackground(): void { hilog.info(DOMAIN, 'testTag', 'EntryAbility onBackground'); } }

通过 ApplicationContext 注册的 abilityLifecycle 监听器，可以捕获整个应用中所有 Ability 的生命周期事件，实现集中化的日志记录或状态管理。

总结

ApplicationContext 的核心能力：

• on/off('abilityLifecycle')：监听所有 Ability 的生命周期事件（创建、前后台切换、销毁等）。
• setColorMode()：设置应用级别的颜色模式（跟随系统、深色、浅色）。
• terminateSelf()：退出整个应用进程（慎用）。
• getApplicationContext()：从任何 Ability 获取应用级上下文。

UIAbilityContext 的核心能力：

• startAbility(want)：启动其他 Ability。
• terminateSelf()：退出当前 Ability。
• connectServiceExtensionAbility()：连接 ServiceExtension Ability。
• abilityInfo：获取当前 Ability 的信息（名称、包名、模块名等）。

模块级 ApplicationContext：

• 通过application.createModuleContext()创建跨 HAP 的上下文。
• 用于在多 HAP 架构中共享数据或访问其他模块的加密存储。