# context_constant.h ## 概述 提供AbilityRuntime模块上下文常量的定义。 **引用文件：** **库：** libability_runtime.so **系统能力：** SystemCapability.Ability.AbilityRuntime.Core **起始版本：** 13 **相关模块：** [AbilityRuntime](capi-abilityruntime.md) ## 汇总 ### 枚举 | 名称 | typedef关键字 | 描述 | | -- | -- | -- | | [AbilityRuntime_AreaMode](#abilityruntime_areamode) | AbilityRuntime_AreaMode | 文件数据加密等级。 | | [AbilityRuntime_StartVisibility](#abilityruntime_startvisibility) | AbilityRuntime_StartVisibility | 启动Ability时的窗口和dock栏图标的显示模式。 | | [AbilityRuntime_WindowMode](#abilityruntime_windowmode) | AbilityRuntime_WindowMode | 窗口模式。 | | [AbilityRuntime_SupportedWindowMode](#abilityruntime_supportedwindowmode) | AbilityRuntime_SupportedWindowMode | 组件所支持的窗口模式。在应用内启动UIAbility时，指定窗口是否显示最大化/窗口化/分屏按键。 | ## 枚举类型说明 ### AbilityRuntime_AreaMode ``` enum AbilityRuntime_AreaMode ``` **描述** 文件数据加密等级。 **起始版本：** 13 | 枚举项 | 描述 | | -- | -- | | ABILITY_RUNTIME_AREA_MODE_EL1 = 0 | 设备级加密区，设备开机后可访问的数据区。
对于私有文件，如闹铃、壁纸等，应用可以将这些文件放到设备级加密分区（EL1）中，以保证在用户输入密码前就可以被访问。 | | ABILITY_RUNTIME_AREA_MODE_EL2 = 1 | 用户级加密区，设备开机，首次输入密码后才能够访问的数据区。
对于私有文件，如闹铃、壁纸等，应用可以将这些文件放到设备级加密分区（EL1）中，以保证在用户输入密码前就可以被访问。 | | ABILITY_RUNTIME_AREA_MODE_EL3 = 2 | 用户级加密区，不同场景的文件权限如下：
已打开文件：锁屏时，可读写；解锁后，可读写。
未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。
创建新文件：锁屏时，可创建、可打开、可写不可读；解锁后，可创建、可打开、可读写。
对于应用中的记录步数、文件下载、音乐播放，需要在锁屏时读写和创建新文件，放在（EL3）的加密分区比较合适。 | | ABILITY_RUNTIME_AREA_MODE_EL4 = 3 | 用户级加密区，不同场景的文件权限如下：
已打开文件：锁屏时，FEB2.0可读写、FEB3.0不可读写；解锁后，可读写。
未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。
创建新文件：锁屏时，不可创建；解锁后，可创建、可打开、可读写。
对于用户安全信息相关的文件，锁屏时不需要读写文件、也不能创建文件，放在（EL4）的加密分区更合适。 | | ABILITY_RUNTIME_AREA_MODE_EL5 = 4 | 应用级加密区，不同场景的文件权限如下：
已打开文件：锁屏时，可读写；解锁后，可读写。
未打开文件：锁屏时，获取DataAccessLock（JS API）下可打开、可读写，否则不可打开、不可读写；解锁后，可打开、可读写。
创建新文件：锁屏时，可创建、可打开、可读写；解锁后，可创建、可打开、可读写。
对于用户隐私敏感数据文件，锁屏后默认不可读写，如果锁屏后需要读写文件，则锁屏前可以调用[Access](js-apis-screenLockFileManager.md#screenlockfilemanageracquireaccess)接口申请继续读写文件，或者锁屏后也需要创建新文件且可读写，放在（EL5）的应用级加密分区更合适。 | ### AbilityRuntime_StartVisibility ``` enum AbilityRuntime_StartVisibility ``` **描述** 启动Ability时的窗口和dock栏图标的显示模式。 **起始版本：** 17 | 枚举项 | 描述 | | -- | -- | | ABILITY_RUNTIME_HIDE_UPON_START = 0 | 隐藏窗口及dock栏图标。仅在2in1设备上生效。 | | ABILITY_RUNTIME_SHOW_UPON_START = 1 | 显示窗口及dock栏图标。仅在2in1设备上生效。 | ### AbilityRuntime_WindowMode ``` enum AbilityRuntime_WindowMode ``` **描述** 窗口模式。 **起始版本：** 17 | 枚举项 | 描述 | | -- | -- | | ABILITY_RUNTIME_WINDOW_MODE_UNDEFINED = 0 | 窗口模式未定义。 | | ABILITY_RUNTIME_WINDOW_MODE_FULL_SCREEN = 1 | 全屏模式。仅在2in1设备上生效。 | ### AbilityRuntime_SupportedWindowMode ``` enum AbilityRuntime_SupportedWindowMode ``` **描述** 在应用内启动UIAbility时，指定窗口是否显示最大化/窗口化/分屏按键。如果未配置该字段，则默认采用该UIAbility对应的[module.json5配置文件](../../quick-start/module-configuration-file.md)中[abilities标签](../../quick-start/module-configuration-file.md#abilities标签)的supportWindowMode字段取值。 **起始版本：** 17 | 枚举项 | 描述 | | -- | -- | | ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN = 0 | 窗口支持全屏显示。 | | ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT = 1 | 窗口支持分屏显示。通常需要配合ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN或ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING一起使用，不建议只配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT。当仅配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT时，2in1设备上的窗口默认为悬浮窗模式，支持进入分屏模式。 | | ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING = 2 | 支持窗口化显示。 |