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

认识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，若还想创建其他的资源文件，例如布尔资源文件，则需要开发者自己创建。在资源目录的右键菜单选择“NewXXXResourceFile”，即可创建对应资源组目录的资源文件。例如，在element目录下可新建ElementResourceFile。如右图在element目录下创建一个布尔资源文件，一般文件名命名与根元素同名为boolean。

ArkTS工程的资源管理访问应用资源在工程中，通过$r(app.type.name)的形式引用应用资源。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代表资源类型，可以取“color”、“float”、“string”、“media”；resource_id代表资源id。例如：$r(sys.color.ohos_id_color_emphasize)