1# @ohos.app.ability.contextConstant (ContextConstant) 2 3ContextConstant提供Context相关的枚举，当前仅包含数据加密等级的枚举。 4 5> **说明：** 6> 7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 本模块接口仅可在Stage模型下使用。 10 11## 导入模块 12 13```ts 14import { contextConstant } from '@kit.AbilityKit'; 15``` 16 17## AreaMode 18 19数据加密等级。 20 21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 22 23| 名称 | 值 | 说明 | 24|-----| -------- |----------------------------------------------------------------------------------------------------------------------| 25| EL1 | 0 | 设备级加密区，设备开机后可访问的数据区。<br/>**原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 | 26| EL2 | 1 | 用户级加密区，设备开机，首次输入密码后才能够访问的数据区。<br/>**原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 | 27| EL3<sup>11+<sup> | 2 | 用户级加密区，不同场景的文件权限如下：<br/>已打开文件：锁屏时，可读写；解锁后，可读写。<br/>未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。<br/>创建新文件：锁屏时，可创建、可打开、可写不可读；解锁后，可创建、可打开、可读写。<br/>**原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 | 28| EL4<sup>11+<sup> | 3 | 用户级加密区，不同场景的文件权限如下：<br/>已打开文件：锁屏时，不可读写；解锁后，可读写。<br/>未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。<br/>创建新文件：锁屏时，不可创建；解锁后，可创建、可打开、可读写。<br/>**原子化服务API**：从API version 11开始，该接口支持在原子化服务中使用。 | 29| EL5<sup>12+<sup> | 4 | 应用级加密区，不同场景的文件权限如下：<br/>已打开文件：锁屏时，可读写；解锁后，可读写。<br/>未打开文件：锁屏时，调用[Access](js-apis-screenLockFileManager.md#screenlockfilemanageracquireaccess)接口获取保留密钥后，可打开、可读写，否则不可打开、不可读写；解锁后，可打开、可读写。<br/>创建新文件：锁屏时，可创建、可打开、可读写；解锁后，可创建、可打开、可读写。<br/>**原子化服务API**：从API version 12开始，该接口支持在原子化服务中使用。 | 30 31 32## ProcessMode<sup>12+</sup> 33 34进程模式。该功能仅在平板类设备上生效。 35 36ProcessMode作为[StartOptions](js-apis-app-ability-startOptions.md)的一个属性，仅在[UIAbilityContext.startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1)中生效，用来指定目标Ability的进程模式。 37 38**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 39 40| 名称 | 值 | 说明 | 41|-----| -------- |----------------------------------------------------------------------------------------------------------------------| 42| NEW_PROCESS_ATTACH_TO_PARENT | 1 | 创建一个新进程，并在该进程上启动Ability。该进程会跟随父进程退出。<br>**约束：**<br>使用此模式时，要求目标Ability跟调用方是在同一个应用。 | 43| NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM | 2 | 创建一个新进程，在该进程上启动Ability，并绑定该进程到状态栏图标上。<br>**约束：**<br>使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。 | 44| ATTACH_TO_STATUS_BAR_ITEM | 3 | 启动Ability，并绑定该Ability所在进程到状态栏图标上。<br>**约束：**<br>使用此模式时，要求目标Ability跟调用方是在同一个应用，并且应用要在状态栏中有图标。 | 45 46**示例：** 47 48 ```ts 49 import { UIAbility, Want, StartOptions, contextConstant } from '@kit.AbilityKit'; 50 import { BusinessError } from '@kit.BasicServicesKit'; 51 52 export default class EntryAbility extends UIAbility { 53 onForeground() { 54 let want: Want = { 55 deviceId: '', 56 bundleName: 'com.example.myapplication', 57 abilityName: 'MainAbility2' 58 }; 59 let options: StartOptions = { 60 processMode: contextConstant.ProcessMode.NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM, 61 startupVisibility: contextConstant.StartupVisibility.STARTUP_HIDE 62 }; 63 64 try { 65 this.context.startAbility(want, options, (err: BusinessError) => { 66 if (err.code) { 67 // 处理业务逻辑错误 68 console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); 69 return; 70 } 71 // 执行正常业务 72 console.info('startAbility succeed'); 73 }); 74 } catch (err) { 75 // 处理入参错误异常 76 let code = (err as BusinessError).code; 77 let message = (err as BusinessError).message; 78 console.error(`startAbility failed, code is ${code}, message is ${message}`); 79 } 80 } 81 } 82 ``` 83 84## StartupVisibility<sup>12+</sup> 85 86Ability启动后的可见性。该功能仅在平板类设备上生效。 87 88StartupVisibility作为[StartOptions](js-apis-app-ability-startOptions.md)的一个属性，仅在[UIAbilityContext.startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability-1)中生效，用来指定目标Ability启动后的可见性。 89 90**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 91 92| 名称 | 值 | 说明 | 93|-----| -------- |----------------------------------------------------------------------------------------------------------------------| 94| STARTUP_HIDE | 0 | 目标Ability启动后，进入隐藏状态。不会调用Ability的onForeground生命周期。 | 95| STARTUP_SHOW | 1 | 目标Ability启动后，正常显示。 | 96 97**示例：** 98 99 参见[ContextConstant.ProcessMode](#processmode12)。