鸿蒙OS 应用配置文件解析
鸿蒙OS（HarmonyOS）的应用配置文件是应用开发的核心组成部分，定义了应用的基本信息、权限、能力等。配置文件分为两种类型：config.json（适用于API 8及以下版本）和module.json（适用于API 9及以上版本）。以下内容以module.json为例展开说明。
配置文件结构解析
基本结构
{
"module": {
"name": "entry",
"type": "entry",
"description": "$string:module_desc",
"mainElement": "MainAbility",
"deviceTypes": ["default", "tablet"],
"deliveryWithInstall": true,
"installationFree": false,
"pages": "$profile:main_pages",
"abilities": [
{
"name": "MainAbility",
"type": "page",
"label": "$string:MainAbility_label",
"icon": "$media:icon",
"launchType": "standard"
}
]
}
}
- name: 模块名称，需唯一。
- type: 模块类型（entry表示主模块，feature表示功能模块）。
- pages: 页面路由配置文件路径，使用$profile引用资源。
- abilities: 应用的能力（如页面Ability、服务Ability等）。
关键配置示例
1. 定义Ability
Ability是鸿蒙应用的核心能力单元，支持页面（Page）、服务（Service）、数据（Data）等类型。
"abilities": [
{
"name": "MainAbility",
"type": "page",
"label": "Main",
"icon": "$media:app_icon",
"backgroundModes": ["dataTransfer"], // 后台模式
"permissions": [], // 所需权限
"uri": "scheme://host/path" // Data Ability的URI
}
]
2. 权限声明
应用需在配置文件中声明所需权限：
"requestPermissions": [
{
"name": "ohos.permission.INTERNET",
"reason": "$string:permission_reason"
}
]
3. 多设备适配
通过deviceTypes指定支持的设备类型：
"deviceTypes": ["phone", "tablet", "tv", "wearable"]
资源引用规范
鸿蒙采用资源ID统一管理资源，格式为$type:name：
- $string: 字符串资源（如$string:app_name）。
- $media: 媒体资源（如图片$media:icon）。
- $profile: 配置文件（如页面路由$profile:main_pages）。
示例：
"label": "$string:app_name",
"icon": "$media:app_icon"
页面路由配置
页面路由文件（如resources/base/profile/main_pages.json）定义Ability与页面的映射：
{
"src": [
"pages/index/index",
"pages/detail/detail"
]
}
常见场景代码示例
动态权限申请
在Ability中动态申请权限：
import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
let atManager = abilityAccessCtrl.createAtManager();
atManager.requestPermissionsFromUser(
['ohos.permission.INTERNET'],
(err, data) => {
if (err) {
console.error('Permission request failed');
} else {
console.info('Permission granted');
}
}
);
跨设备启动Ability
通过隐式Want启动其他设备的Ability：
let want = {
deviceId: "123456", // 目标设备ID
bundleName: "com.example.app",
abilityName: "MainAbility"
};
this.context.startAbility(want).catch(err => {
console.error(`Start ability failed: ${err}`);
});
配置文件的校验与调试
使用ohos-validator工具校验配置文件：
ohos-validator –path ./module.json
日志中可通过hilog输出配置加载状态：
import hilog from '@ohos.hilog';
hilog.info(0x0000, 'Config', 'Module config loaded successfully');
总结
鸿蒙OS的应用配置文件是应用行为的蓝图，合理配置可确保多设备兼容性和功能完整性。开发时需注意：
- 资源引用使用$type:name格式。
- 权限声明需与实际使用匹配。
- 多设备适配通过deviceTypes实现。
