HarmonyOS(鸿蒙)——config

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

config.json.png

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

image.png

1.2 编辑视图

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

代码编辑视图:

image.png

可视化编辑视图:

image.png

二、配置文件详细介绍


配置文件由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 | - | 表示应用的包名,用于标识应用的唯一性。 | 字符串 | 否 |

| 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。

|

字符串

|

最后

自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。

深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助

因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
,自己不成体系的自学效果低效漫长且无助**。

因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。

[外链图片转存中…(img-nN1RZucn-1715623458081)]

[外链图片转存中…(img-QHMX4zXv-1715623458082)]

[外链图片转存中…(img-w6uskRNd-1715623458083)]

[外链图片转存中…(img-DWaDMFwL-1715623458084)]

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!

由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!

  • 5
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值