《HarmonyOS应用开发基础》 课件知识点2-1 认识ArkTS工程

认识ArkTS工程010203应用程序包结构相关的基本概念ArkTS工程目录结构ArkTS工程的配置文件04ArkTS工程的资源管理应用程序包结构相关的基本概念一个应用包含一个或者多个Module;Module分为“Ability”和“Library”两种类型;“Ability”类型的Module对应于编译后的HAP（HarmonyAbilityPackage）；“Library”类型的Module对应于HAR（HarmonyAbilityResources）包，即编译后的.tgz文件。“Ability”类型的Module的HAP包可分为Entry和Feature两种类型。Entry类型的HAP：是应用的主模块;Feature类型的HAP：是应用的动态特性模块每个HarmonyOS应用可以包含多个.hap文件，一个应用中的.hap文件合在一起称为一个Bundle，而bundleName就是应用的唯一标识（请参见app.json5配置文件中的bundleName标签）ArkTS工程目录结构ArkTS工程的配置文件在基于Stage模型开发的应用项目代码下，都存在app.json5及module.json5两个配置文件。app.json5应用的全局配置信息，包含应用的包名、开发厂商、版本号等基本信息。特定设备类型的配置信息。ArkTS工程的配置文件module.json5：Module的基本配置信息，例如Module名称、类型、描述、支持的设备类型等基本信息。应用组件信息，包含Ability组件和ExtensionAbility组件的描述信息。应用访问系统或其他应用受保护部分所需的权限信息。ArkTS工程的资源管理HarmonyOS资源分为两类：应用资源：借助资源文件能力，开发者在应用中自定义资源，自行管理这些资源在不同的设备或配置中的表现。系统资源：开发者直接使用系统预置的资源定义（即分层参数，同一资源ID在设备类型、深浅色等不同配置下有不同的取值）。ArkTS工程的资源管理应用资源目录应用开发中使用的各类资源文件，需要放入特定子目录中存储管理。在stage模型中，多模块module共有的资源文件放到AppScope下的resources目录。模块独有的资源可以放在该模块的resources目录下。resources目录包括三大类目录：base目录限定词目录rawfile目录ArkTS工程的资源管理创建应用资源文件应用已经提供了一些资源文件，例如用来存放字符串的资源文件string.json，若还想创建其他的资源文件，例如布尔资源文件，则需要开发者自己创建。在资源目录的右键菜单选择“New>XXXResourceFile”，即可创建对应资源组目录的资源文件。例如，在element目录下可新建ElementResourceFile。如右图在element目录下创建一个布尔资源文件，一般文件名命名与根元素同名为boolean。ArkTS工程的资源管理访问应用资源在工程中，通过"$r('')"的形式引用应用资源。app代表是应用内resources目录中定义的资源；type代表资源类型（或资源的存放位置），可以取“color”、“float”、“string”、“plural”、“media”；name代表资源命名，由开发者定义资源时确定。例如：$r(‘app.string.string_hello’)表示引用字符串资源string_hello，具体是base还是相应限定词目录下的视当前设备的语言、设备类型等情况。另外：引用rawfile下资源时使用"$rawfile('filename')"的形式，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。例如$rawfile(‘test.png’)表示引用rawfile目录下图片。ArkTS工程的资源管理访问系统资源系统资源包含色彩、圆角、字体、间距、字符串及图片等。通过使用系统资源，不同的开发者可以开发出具有相同视觉风格的应用。开发者可以通过“$r('sys.type.resource_id')”的形式引用系统资源。sys代表是系统资源；type代表资源类型，可以取“c