HarmonyOS学习路之开发基础知识——应用配置文件

简介

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

应用的全局配置信息，包含应用的包名、生产厂商、版本号等基本信息。 应用在具体设备上的配置信息，包含应用的备份恢复、网络安全等能力。 HAP包的配置信息，包含每个Ability必须定义的基本属性（如包名、类名、类型以及Ability提供的能力），以及应用访问系统或其他应用受保护部分所需的权限等。

配置文件的组成

配置文件“config.json”采用JSON文件格式，其中包含了一系列配置项，每个配置项由属性和值两部分构成：

属性 属性出现顺序不分先后，且每个属性最多只允许出现一次。 值 每个属性的值为JSON的基本数据类型（数值、字符串、布尔值、数组、对象或者null类型）。如果属性值需要引用资源文件，可参见资源文件。

配置文件的元素

此部分提供配置文件“config.json”中所有属性的详细解释。

DevEco Studio提供了两种编辑“config.json”文件的方式。在“config.json”的编辑窗口中，可在右上角切换代码编辑视图或可视化编辑视图。

图1 config.json文件的可视化编辑视图

配置文件的内部结构

“config.json”由“app”、“deviceConfig”和“module”三个部分组成，缺一不可。

app对象的内部结构

deviceConfig对象的内部结构

module对象的内部结构

name：表示Ability名称。 description：表示对Ability的描述。 icon：表示Ability图标资源文件的索引。 label：表示Ability对用户显示的名称。 uri：表示Ability的统一资源标识符。 launchType：表示Ability的启动模式，支持“standard”和“singleton”两种模式

standard：表示该Ability可以有多实例。“standard”模式适用于大多数应用场。 singleton：表示该Ability只可以有一个实例。例如，具有全局唯一性的呼叫来电界面即采用“singleton”模式。

visible：表示Ability是否可以被其他应用调用。 permissions：表示其他应用的Ability调用此Ability时需要申请的权限。 orientation：表示该Ability的显示模式。