鸿蒙5.0开发进阶：Stage模型-@ohos.app.ability.contextConstant (ContextConstant)

最新推荐文章于 2025-11-25 07:23:10 发布

原创最新推荐文章于 2025-11-25 07:23:10 发布 · 801 阅读

29 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #android #鸿蒙系统 #前端 #ArkTS #Stage模型

鸿蒙开发同时被 2 个专栏收录

1065 篇文章

订阅专栏

ArkTS

556 篇文章

订阅专栏

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

@ohos.app.ability.contextConstant (ContextConstant)

ContextConstant提供Context相关的枚举，当前仅包含数据加密等级的枚举。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

导入模块

import { contextConstant } from '@kit.AbilityKit';

AreaMode

数据加密等级。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
EL1	0	设备级加密区，设备开机后可访问的数据区。元服务API：从API version 11开始，该接口支持在元服务中使用。
EL2	1	用户级加密区，设备开机，首次输入密码后才能够访问的数据区。元服务API：从API version 11开始，该接口支持在元服务中使用。
EL311+	2	用户级加密区，不同场景的文件权限如下：已打开文件：锁屏时，可读写；解锁后，可读写。未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。创建新文件：锁屏时，可创建、可打开、可写不可读；解锁后，可创建、可打开、可读写。元服务API：从API version 11开始，该接口支持在元服务中使用。
EL411+	3	用户级加密区，不同场景的文件权限如下：已打开文件：锁屏时，不可读写；解锁后，可读写。未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。创建新文件：锁屏时，不可创建；解锁后，可创建、可打开、可读写。元服务API：从API version 11开始，该接口支持在元服务中使用。
EL512+	4	应用级加密区，不同场景的文件权限如下：已打开文件：锁屏时，可读写；解锁后，可读写。未打开文件：锁屏时，调用Access接口获取保留密钥后，可打开、可读写，否则不可打开、不可读写；解锁后，可打开、可读写。创建新文件：锁屏时，可创建、可打开、可读写；解锁后，可创建、可打开、可读写。元服务API：从API version 12开始，该接口支持在元服务中使用。

ProcessMode12+

进程模式。该功能仅在平板类设备上生效。

ProcessMode作为StartOptions的一个属性，仅在UIAbilityContext.startAbility中生效，用来指定目标Ability的进程模式。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
NEW_PROCESS_ATTACH_TO_PARENT	1	创建一个新进程，并在该进程上启动Ability。该进程会跟随父进程退出。约束：使用此模式时，要求目标Ability跟调用方是在同一个应用。
NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM	2	创建一个新进程，在该进程上启动Ability，并绑定该进程到状态栏图标上。约束：使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。
ATTACH_TO_STATUS_BAR_ITEM	3	启动Ability，并绑定该Ability所在进程到状态栏图标上。约束：使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。

名称

值

说明

NEW_PROCESS_ATTACH_TO_PARENT

创建一个新进程，并在该进程上启动Ability。该进程会跟随父进程退出。

约束：

使用此模式时，要求目标Ability跟调用方是在同一个应用。

NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM

创建一个新进程，在该进程上启动Ability，并绑定该进程到状态栏图标上。

约束：

使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。

ATTACH_TO_STATUS_BAR_ITEM

启动Ability，并绑定该Ability所在进程到状态栏图标上。

约束：

使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。

示例：

import { UIAbility, Want, StartOptions, contextConstant } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onForeground() {
    let want: Want = {
      deviceId: '',
      bundleName: 'com.example.myapplication',
      abilityName: 'MainAbility2'
    };
    let options: StartOptions = {
      processMode: contextConstant.ProcessMode.NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM,
      startupVisibility: contextConstant.StartupVisibility.STARTUP_HIDE
    };

    try {
      this.context.startAbility(want, options, (err: BusinessError) => {
        if (err.code) {
          // 处理业务逻辑错误
          console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`);
          return;
        }
        // 执行正常业务
        console.info('startAbility succeed');
      });
    } catch (err) {
      // 处理入参错误异常
      let code = (err as BusinessError).code;
      let message = (err as BusinessError).message;
      console.error(`startAbility failed, code is ${code}, message is ${message}`);
    }
  }
}

StartupVisibility12+

Ability启动后的可见性。该功能仅在平板类设备上生效。

StartupVisibility作为StartOptions的一个属性，仅在UIAbilityContext.startAbility中生效，用来指定目标Ability启动后的可见性。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
STARTUP_HIDE	0	目标Ability启动后，进入隐藏状态。不会调用Ability的onForeground生命周期。
STARTUP_SHOW	1	目标Ability启动后，正常显示。