简介
应用的每个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的显示模式。