HarmonyOS 教程

HarmonyOS 开发

HarmonyOS 示例

HarmonyOS 资源文件的分类

resources目录

应用的资源文件（字符串、图片、音频等）统一存放于resources目录下，便于开发者使用和维护。resources目录包括两大类目录，一类为base目录与限定词目录，另一类为rawfile目录，详见表1。

资源目录示例：

例子 (Example)

resources
|---base  // 默认存在的目录
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---en_GB-vertical-car-mdpi // 限定词目录示例，需要开发者自行创建   
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---rawfile  // 默认存在的目录
表1 resources目录分类

分类

base目录与限定词目录

rawfile目录

组织形式

按照两级目录形式来组织，目录命名必须符合规范，以便根据设备状态去匹配相应目录下的资源文件。

一级子目录为base目录和限定词目录。

  • base目录是默认存在的目录。当应用的resources资源目录中没有与设备状态匹配的限定词目录时，会自动引用该目录中的资源文件。

  • 限定词目录需要开发者自行创建。目录名称由一个或多个表征应用场景或设备特征的限定词组合而成，具体要求参见限定词目录。

二级子目录为资源目录，用于存放字符串、颜色、布尔值等基础元素，以及媒体、动画、布局等资源文件，具体要求参见资源组目录。

支持创建多层子目录，目录名称可以自定义，文件夹内可以自由放置各类资源文件。

rawfile目录的文件不会根据设备状态去匹配不同的资源。

编译方式

目录中的资源文件会被编译成二进制文件，并赋予资源文件ID。

目录中的资源文件会被直接打包进应用，不经过编译，也不会被赋予资源文件ID。

引用方式

通过指定资源类型（type）和资源名称（name）来引用，详见资源文件的引用方法。

通过指定文件路径和文件名来引用，详见资源文件的引用方法。

限定词目录

限定词目录可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括移动国家码和移动网络码、语言、文字、国家或地区、横竖屏、设备类型、颜色模式和屏幕密度等维度，限定词之间通过下划线（_）或者中划线（-）连接。开发者在创建限定词目录时，需要掌握限定词目录的命名要求以及与限定词目录与设备状态的匹配规则。

限定词目录的命名要求

  • 限定词的组合顺序：移动国家码_移动网络码-语言_文字_国家或地区-横竖屏-设备类型-深色模式-屏幕密度。开发者可以根据应用的使用场景和设备特征，选择其中的一类或几类限定词组成目录名称。

    限定词的连接方式：语言、文字、国家或地区之间采用下划线（_）连接，移动国家码和移动网络码之间也采用下划线（_）连接，除此之外的其他限定词之间均采用中划线（-）连接。例如：zh_Hant_CN、zh_CN-car-ldpi。

    限定词的取值范围：每类限定词的取值必须符合表2中的条件，否则，将无法匹配目录中的资源文件。

    表2 限定词取值要求

    限定词类型

    含义与取值说明

    移动国家码和移动网络码

    移动国家码（MCC）和移动网络码（MNC）的值取自设备注册的网络。MCC后面可以跟随MNC，使用下划线（_）连接，也可以单独使用。例如：mcc460表示中国，mcc460_mnc00表示中国_中国移动。

    详细取值范围，请查阅ITU-T E.212（国际电联相关标准）。

    语言

    表示设备使用的语言类型，由2~3个小写字母组成。例如：zh表示中文，en表示英语，mai表示迈蒂利语。

    详细取值范围，请查阅ISO 639（ISO制定的语言编码标准）。

    文字

    表示设备使用的文字类型，由1个大写字母（首字母）和3个小写字母组成。例如：Hans表示简体中文，Hant表示繁体中文。

    详细取值范围，请查阅ISO 15924（ISO制定的文字编码标准）。

    国家或地区

    表示用户所在的国家或地区，由2~3个大写字母或者3个数字组成。例如：CN表示中国，GB表示英国。

    详细取值范围，请查阅ISO 3166-1（ISO制定的国家和地区编码标准）。

    横竖屏

    表示设备的屏幕方向，取值如下：

    设备类型

    表示设备的类型，取值如下：

    颜色模式

    表示设备的颜色模式，取值如下：

    屏幕密度

    表示设备的屏幕密度（单位为dpi），取值如下：

    • sdpi：表示小规模的屏幕密度（Small-scale Dots Per Inch），适用于dpi取值为(0, 120]的设备。

    • mdpi：表示中规模的屏幕密度（Medium-scale Dots Per Inch），适用于dpi取值为(120, 160]的设备。

    • ldpi：表示大规模的屏幕密度（Large-scale Dots Per Inch），适用于dpi取值为(160, 240]的设备。

    • xldpi：表示特大规模的屏幕密度（Extra Large-scale Dots Per Inch），适用于dpi取值为(240, 320]的设备。

    • xxldpi：表示超大规模的屏幕密度（Extra Extra Large-scale Dots Per Inch），适用于dpi取值为(320, 480]的设备。

    • xxxldpi：表示超特大规模的屏幕密度（Extra Extra Extra Large-scale Dots Per Inch），适用于dpi取值为(480, 640]的设备。

    • dark：深色模式

    • light：浅色模式

    • phone：手机

    • tablet：平板

    • car：车机

    • tv：智慧屏

    • wearable：智能穿戴

    • vertical：竖屏

    • horizontal：横屏

限定词目录与设备状态的匹配规则

  • 在为设备匹配对应的资源文件时，限定词目录匹配的优先级从高到低依次为：移动国家码和移动网络码 > 区域（可选组合：语言、语言_文字、语言_国家或地区、语言_文字_国家或地区）> 横竖屏 > 设备类型 > 颜色模式 > 屏幕密度。

  • 如果限定词目录中包含移动国家码和移动网络码、语言、文字、横竖屏、设备类型、颜色模式限定词，则对应限定词的取值必须与当前的设备状态完全一致，该目录才能够参与设备的资源匹配。例如，限定词目录“zh_CN-car-ldpi”不能参与“en_US”设备的资源匹配。

资源组目录

base目录与限定词目录下面可以创建资源组目录（包括element、media、animation、layout、graphic、profile），用于存放特定类型的资源文件，详见表3。

表3 资源组目录说明

资源组目录

目录说明

资源文件

element

表示元素资源，以下每一类数据都采用相应的JSON文件来表征。

  • boolean，布尔型

  • color，颜色

  • float，浮点型

  • intarray，整型数组

  • integer，整型

  • pattern，样式

  • plural，复数形式

  • strarray，字符串数组

  • string，字符串

element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。

  • boolean.json

  • color.json

  • float.json

  • intarray.json

  • integer.json

  • pattern.json

  • plural.json

  • strarray.json

  • string.json

media

表示媒体资源，包括图片、音频、视频等非文本格式的文件。

文件名可自定义，例如：icon.png。

animation

表示动画资源，采用XML文件格式。

文件名可自定义，例如：zoom_in.xml。

layout

表示布局资源，采用XML文件格式。

文件名可自定义，例如：home_layout.xml。

graphic

表示可绘制资源，采用XML文件格式。

文件名可自定义，例如：notifications_dark.xml。

profile

表示其他类型文件，以原始文件形式保存。

文件名可自定义。

创建资源文件

在resources目录下，可按照限定词目录和资源组目录的说明创建子目录和目录内的文件。

同时，DevEco Studio也提供了创建资源目录和资源文件的界面。

  • 创建资源目录及资源文件

    在resources目录右键菜单选择“New > Harmony Resource File”，此时可同时创建目录和文件。

    文件默认创建在base目录的对应资源组下。如果选择了限定词，则会按照命名规范自动生成限定词+资源组目录，并将文件创建在目录中。

    目录名自动生成，格式固定为“限定词.资源组”，例如创建一个限定词为横竖屏类别下的竖屏，资源组为绘制资源的目录，自动生成的目录名称为“vertical.graphic”。

  • 创建资源目录

    在resources目录右键菜单选择“New > Harmony Resource Directory”，此时可创建资源目录。

    选择资源组类型，设置限定词，创建后自动生成目录名称。目录名称格式固定为“限定词.资源组”，例如创建一个限定词为横竖屏类别下的竖屏，资源组为绘制资源的目录，自动生成的目录名称为“vertical.graphic”。

  • 创建资源文件

    在资源目录的右键菜单选择“New > XXX Resource File”，即可创建对应资源组目录的资源文件。

    例如，在element目录下可新建Element Resource File。


上一主题 HarmonyOS 应用配置文件示例 下一主题 HarmonyOS 资源文件的使用
  • 使用社交账号登录,本站支持
全部评论(0)

便捷工具