购买
下载掌阅APP,畅读海量书库
立即打开
畅读海量书库
扫码下载掌阅APP

3.2.2 Page常用配置选项

本节介绍Page类型的Ability的常用配置选项,以及如何在程序中获得这些配置信息。在config.json中,module对象的abilities数据包含了各个Ability的配置选项。对于新创建的鸿蒙应用程序工程,典型的abilities配置信息如下:

这个数组仅包含了1个Ability对象,为Page类型。Ability的类型通过type属性定义,包括page、service和data,分别代表Ability的三类模板Page Ability、Service Ability和Data Ability。在上面的Ability中,type属性为page,因此属于Page类型的Ability。

下面分析一下这个Ability对象中各个属性的含义:

(1)name:Ability的名称,通常采用全类名(包名+类名)的方式定义。

(2)description:Ability的描述信息。

(3)icon:Ability的图标。

(4)label:Ability的显示名称,默认会显示在手机、车机等设备应用程序的标题栏中。

(5)formEnabled:是否支持卡片能力。支持卡片的Page可以微缩化显示在其他应用中,例如显示在桌面上。

(6)orientation:Page的屏幕方向,包括unspecified(未指定,由系统决定)、landscape(横向显示)、portrait(纵向显示)和followRecent(跟随最近使用的Ability一致)等选项。如果指定屏幕方向为横向显示或纵向显示,则在运行时,Ability无法随着设备的物理旋转而自动改变屏幕方向。对于可穿戴设备、智慧屏、车机来讲,默认的Page屏幕方向为横向显示。

(7)launchType:Page的启动模式,包括standard(标准模式)和singleton(单例模式)两类。

(8)skills数组:表示能够接收Intent的请求。这里有一个默认的skill对象“{"entities":["entity.system.home"],"actions":["action.system.home"]}”,表示该HAP的入口Ability。

(9)configChanges:表示Ability所关注的系统配置集合。当指定的系统配置发生变化后,则会调用Ability的onConfigurationUpdated回调,方便开发者进行处理。支持的系统配置包括语言区域配置(locate)、屏幕布局配置(layout)、字体显示大小配置(fontSize)、屏幕方向配置(orientation)、显示密度配置(density)。

注意: 应用程序的图标和标题是通过Entry HAP的入口Page的图标(icon)和标题(label)进行定义的。如果存在多个入口Page,则以abilities数组中第一个出现的入口Page为准。另外,应用程序的图标可以被鸿蒙操作系统自动圆角化,不需要开发者主动制作圆角化图标。

以上仅介绍了涉及Page且最为常用的属性。更多的更加全面的属性配置读者可详见官方文档。

在Ability(及AbilitySlice)内部可通过AbilityInfo对象获取上述绝大多数信息,代码如下:

此时,在HiLog工具窗体中可输出以下信息: d7EeDoXLbzjslxuJdyHlh3mJQed7WyT5AQjdMPm/SJR9iO0otU8HxHNMHwBxGPn5

点击中间区域
呼出菜单
上一章
目录
下一章
×