HarmonyOS（鸿蒙）——config

最新推荐文章于 2025-02-14 00:45:00 发布

2401_84895812

最新推荐文章于 2025-02-14 00:45:00 发布

阅读量733

点赞数 15

分类专栏：程序员文章标签： harmonyos 华为

本文链接：https://blog.csdn.net/2401_84895812/article/details/138659864

版权

程序员专栏收录该内容

78 篇文章

订阅专栏

应用的每个HAP的根目录下都存在一个“config.json”配置文件。文件内容主要涵盖以下三个方面：

config.json.png

如下是一个简单的HarmonyOS应用程序创建后所看到的应用代码结构，entry -> src -> main -> config.json文件。其中三个模块分别为app、deviceConfig、module（我这里展示的三块是缩放后的内容。）

1.2 编辑视图

config.json文件采用JSON文件格式，其每一项都包含都由一个属性和值组成。其中属性值不分先后顺序，但是不能重复出现，必须唯一。值为JSON的基本数据类型。HarmonyOS的DevEco Studio支持两种编辑config.json的方式，分别是代码编辑视图和可视化编辑视图。

代码编辑视图：

可视化编辑视图：

二、配置文件详细介绍

配置文件由app、deviceConfig、module三部分组成，三者均必须存在。以下会根据上面的HarmonyOS的基础HelloWorld程序分析一个最基础的config.json配置文件，如果需要十分详细的介绍，请直接去HarmonyOS的官网进行查阅，以下是直达的官网地址：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/basic-config-file-elements-0000000000034463

2.1 app

app对象包含应用的全局配置信息，HarmonyOS的基础HelloWorld程序的config.json配置文件中的app部分如下所示：

1 “app”: {

2 “bundleName”: “com.example.demo”,

3 “vendor”: “example”,

4 “version”: {

5 “code”: 1000000,

6 “name”: “1.0.0”

7 }

8 }

| — | — | — | — | — |

| bundleName | - | 表示应用的包名，用于标识应用的唯一性。 | 字符串 | 否 |

| version | - | 表示应用的版本信息。 | 对象 | 否 |

| | code | 表示应用的版本号，仅用于HarmonyOS管理该应用，不对应用的终端用户呈现。 | 数值 | 否 | 数值 | 否 |

| | name | 表示应用的版本号，用于向应用的终端用户呈现。小于127个字节。 | 字符串 | 否 |

2.2 deviceConfig

deviceConfig包含在具体设备上的应用配置信息，可以包含default、phone、tablet、tv、car、wearable、liteWearable和smartVision等属性。default标签内的配置是适用于所有设备通用，其他设备类型如果有特殊的需求，则需要在该设备类型的标签下进行配置。HarmonyOS的基础HelloWorld程序的config.json配置文件中的deviceConfig部分如下所示：

1"deviceConfig": {}

2.3 module

module对象包含HAP包的配置信息，包含每个Ability必须定义的基本属性（如包名、类名、类型以及Ability提供的能力），以及应用访问系统或其他应用受保护部分所需的权限等。HarmonyOS的基础HelloWorld程序的config.json配置文件中的module部分如下所示：

1"module": {

2 “package”: “com.example.demo”,

3 “name”: “.MyApplication”,

4 “mainAbility”: “com.example.demo.MainAbility”,

5 “deviceType”: [

6 “phone”

7 ],

8 “distro”: {

9 “deliveryWithInstall”: true,

10 “moduleName”: “entry”,

11 “moduleType”: “entry”,

12 “installationFree”: true

13 },

14 “abilities”: [

15 {

16 “skills”: [

17 {

18 “entities”: [

19 “entity.system.home”

20 ],

21 “actions”: [

22 “action.system.home”

23 ]

24 }

25 ],

26 “orientation”: “unspecified”,

27 “name”: “com.example.demo.MainAbility”,

28 “icon”: “$media:icon”,

29 “description”: “$string:mainability_description”,

30 “label”: “$string:entry_MainAbility”,

31 “type”: “page”,

32 “launchType”: “standard”

33 }

34 ]

35 }

| — | — | — | — | — |

| package | - | 表示HAP的包结构名称，在应用内应保证唯一性。采用反向域名格式（建议与HAP的工程目录保持一致）。字符串长度不超过127字节。 | 字符串 | 否 |

| name | - | 表示HAP的类名。采用反向域名方式表示，前缀需要与同级的package标签指定的包名一致，也可采用“.”开头的命名方式。字符串长度不超过255字节。 | 字符串 | 否 |

| distro | - | 表示HAP发布的具体描述 | 对象 | 否 |

| |

deliveryWithInstall

表示当前HAP是否支持随应用安装。

true：支持随应用安装。
false：不支持随应用安装

布尔类型

否

| |

moduleName

HAP的名称

字符串

否

| |

moduleType

表示当前HAP的类型，包括两种类型：entry和feature

字符串

否

| |

installationFree

表示当前该FA是否支持免安装特性。

true：表示支持免安装特性，且符合免安装约束。
false：表示不支持免安装特性。

布尔类型

entry.hap可缺省，feature.hap不可缺省。

abilities

表示当前模块内的所有Ability。采用对象数组格式，其中每个元素表示一个Ability对象。

对象数组

是

| |

skills

表示Ability能够接收的Intent的特征。

对象数组

是

| |

orientation

表示该Ability的显示模式。该标签仅适用于page类型的Ability。取值范围如下：

unspecified：由系统自动判断显示方向。
landscape：横屏模式。
portrait：竖屏模式。
followRecent：跟随栈中最近的应用。

字符串

是

| |

name

表示Ability名称。取值可采用反向域名方式表示，由包名和类名组成，如“com.example.myapplication.MainAbility”；也可采用“.”开头的类名方式表示，如“.MainAbility”。该标签仅适用于手机、平板、智慧屏、车机、智能穿戴。

字符串

否

| |

icon

表示Ability图标资源文件的索引。取值示例：$media:ability_icon。如果在该Ability的“skills”属性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability，则取位置靠前的Ability的icon作为应用的icon。

字符串

最后

针对于上面的问题，我总结出了互联网公司Android程序员面试涉及到的绝大部分面试题及答案，并整理做成了文档，以及系统的进阶学习视频资料。
（包括Java在Android开发中应用、APP框架知识体系、高级UI、全方位性能调优，NDK开发，音视频技术，人工智能技术，跨平台技术等技术资料），希望能帮助到你面试前的复习，且找到一个好的工作，也节省大家在网上搜索资料的时间来学习。
Android进阶视频+面试资料部分截图

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！
在该Ability的“skills”属性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability，则取位置靠前的Ability的icon作为应用的icon。

字符串