应用的每个HAP的根目录下都存在一个“config.json”配置文件。文件内容主要涵盖以下三个方面:
如下是一个简单的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的官网进行查阅,以下是直达的官网地址:
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 | - | 表示应用的包名,用于标识应用的唯一性。 | 字符串 | 否 |
| vendor | - | 表示对应用开发厂商的描述。字符串长度不超过255字节。 | 字符串 | 可缺省,缺省值为空。 |
| 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字节。 | 字符串 | 否 |
| mainAbility | - | 表示HAP包的入口ability名称。 | 字符串 | page类型的Ability为否 |
| deviceType | - | 表示允许Ability运行的设备类型。系统预定义的设备类型包括:phone(手机)、tablet(平板)、tv(智慧屏)、car(车机)、wearable(智能穿戴)、liteWearable(轻量级智能穿戴)等。 | 字符串数组 | 否 |
| 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学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
在该Ability的“skills”属性中,“actions”的取值包含 “action.system.home”,“entities”取值中包含“entity.system.home”,则该Ability的icon将同时作为应用的icon。如果存在多个符合条件的Ability,则取位置靠前的Ability的icon作为应用的icon。
|
字符串
|
最后
针对于上面的问题,我总结出了互联网公司Android程序员面试涉及到的绝大部分面试题及答案,并整理做成了文档,以及系统的进阶学习视频资料。
(包括Java在Android开发中应用、APP框架知识体系、高级UI、全方位性能调优,NDK开发,音视频技术,人工智能技术,跨平台技术等技术资料),希望能帮助到你面试前的复习,且找到一个好的工作,也节省大家在网上搜索资料的时间来学习。
[外链图片转存中…(img-d8pUlpfT-1714753747781)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!