智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
高级筛选
元服务API集不筛选
API参考概述
Archived
应用框架
Archived
系统
Archived
媒体
Archived
图形
Archived
应用服务
Archived
AI
Archived
公共基础能力
Archived
标准库
Archived
本文导读
概述
提供元能力基础框架的相关能力。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
起始版本：13
汇总
文件
展开
| 名称 | 描述 |
|---|---|
| ability_runtime_common.h | 声明元能力子系统的相关错误码。 引用文件：<AbilityKit/ability_runtime/ability_runtime_common.h> 库：libability_runtime.so |
| application_context.h | 声明应用级别的上下文能力。 引用文件：<AbilityKit/ability_runtime/application_context.h> 库：libability_runtime.so |
| context_constant.h | 声明上下文相关的枚举。 引用文件：<AbilityKit/ability_runtime/context_constant.h> 库：libability_runtime.so |
枚举
展开
| 名称 | 描述 |
|---|---|
| ABILITY_RUNTIME_ERROR_CODE_NO_ERROR = 0, ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID = 401, ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST = 16000011, } | 定义元能力模块错误码。 |
| ABILITY_RUNTIME_AREA_MODE_EL1 = 0, ABILITY_RUNTIME_AREA_MODE_EL2 = 1, ABILITY_RUNTIME_AREA_MODE_EL3 = 2, ABILITY_RUNTIME_AREA_MODE_EL4 = 3, ABILITY_RUNTIME_AREA_MODE_EL5 = 4 } | 定义数据加密等级。 |
函数
展开
| 名称 | 描述 |
|---|---|
| AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetCacheDir(char* buffer, int32_t bufferSize, int32_t* writeLength) | 获取应用级别的缓存目录。 |
| AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetAreaMode(AbilityRuntime_AreaMode* areaMode) | 获取应用级别的数据加密等级。 |
| AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetBundleName(char* buffer, int32_t bufferSize, int32_t* writeLength) | 获取应用包名。 |
枚举类型说明
AbilityRuntime_ErrorCode
收起
自动换行
深色代码主题
复制
- enum AbilityRuntime_ErrorCode
描述
定义元能力模块错误码。
起始版本：13
展开
| 枚举值 | 描述 |
|---|---|
| ABILITY_RUNTIME_ERROR_CODE_NO_ERROR | 操作成功。 |
| ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID ARAM | 无效参数。 |
| ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST | 上下文不存在。 |
AbilityRuntime_AreaMode
收起
自动换行
深色代码主题
复制
- enum AbilityRuntime_AreaMode
描述
定义数据加密等级。
起始版本：13
展开
| 枚举值 | 描述 |
|---|---|
| ABILITY_RUNTIME_AREA_MODE_EL1 | 对于私有文件，如闹铃、壁纸等，应用可以将这些文件放到设备级加密分区（EL1）中，以保证在用户输入密码前就可以被访问。 |
| ABILITY_RUNTIME_AREA_MODE_EL2 | 对于更敏感的文件，如个人隐私信息等，应用可以将这些文件放到更高级别的加密分区（EL2）中，以保证更高的安全性。 |
| ABILITY_RUNTIME_AREA_MODE_EL3 | 对于应用中的记录步数、文件下载、音乐播放，需要在锁屏时读写和创建新文件，放在（EL3）的加密分区比较合适。 |
| ABILITY_RUNTIME_AREA_MODE_EL4 | 对于用户安全信息相关的文件，锁屏时不需要读写文件、也不能创建文件，放在（EL4）的加密分区更合适。 |
| ABILITY_RUNTIME_AREA_MODE_EL5 | 对于用户隐私敏感数据文件，锁屏后默认不可读写，如果锁屏后需要读写文件，则锁屏前可以调用Access接口申请继续读写文件，或者锁屏后也需要创建新文件且可读写，放在（EL5）的应用级加密分区更合适。 |
函数说明
OH_AbilityRuntime_ApplicationContextGetCacheDir
收起
自动换行
深色代码主题
复制
- AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetCacheDir(char* buffer, int32_t bufferSize, int32_t* writeLength)
描述
获取应用级别的缓存目录。
起始版本：13
参数:
展开
| 名称 | 描述 |
|---|---|
| buffer | 缓冲区，缓存目录字符串写入该区域。 |
| bufferSize | 缓冲区大小。 |
| writeLength | 在返回ABILITY_RUNTIME_ERROR_CODE_NO_ERROR时，表示实际写入到缓冲区的字符串长度。 |
返回：
ABILITY_RUNTIME_ERROR_CODE_NO_ERROR - 查询成功。
ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID - 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。
ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST - 当前环境的上下文不存在，如在应用创建的子进程中应用级别上下文不存在。
OH_AbilityRuntime_ApplicationContextGetAreaMode
收起
自动换行
深色代码主题
复制
- AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetAreaMode(AbilityRuntime_AreaMode* areaMode)
描述
获取应用级别的数据加密等级。
起始版本：13
参数:
展开
| 名称 | 描述 |
|---|---|
| areaMode | 用于接受加密等级的指针。 |
返回：
ABILITY_RUNTIME_ERROR_CODE_NO_ERROR - 查询成功。
ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID - 入参areaMode为空。
ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST - 当前环境的上下文不存在，如在应用创建的子进程中应用级别上下文不存在。
OH_AbilityRuntime_ApplicationContextGetBundleName
收起
自动换行
深色代码主题
复制
- AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetBundleName(char* buffer, int32_t bufferSize, int32_t* writeLength)
描述
获取应用包名。
起始版本：13
参数:
展开
| 名称 | 描述 |
|---|---|
| buffer | 缓冲区，应用包名字符串写入该区域。 |
| bufferSize | 缓冲区大小。 |
| writeLength | 在返回ABILITY_RUNTIME_ERROR_CODE_NO_ERROR时，表示实际写入到缓冲区的字符串长度。 |
返回：
ABILITY_RUNTIME_ERROR_CODE_NO_ERROR - 查询成功。
ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID - 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。
ABILITY_RUNTIME_ERROR_CODE_CONTEXT_NOT_EXIST - 当前环境的上下文不存在，如在应用创建的子进程中应用级别上下文不存在。
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词