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的显示模式。