文档开发者中心
我的
|

ArkUI (方舟UI框架)

资源文件的编译构建

在应用开发中,常需使用字符串、颜色、字体、间距和图标等资源。为了让应用在不同设备(如手机、平板、车机)和配置(如语言、屏幕密度、颜色模式)下都能提供最佳体验,系统支持通过资源动态匹配机制,自动为各类场景选取最合适的资源。

根据来源差异,资源可分为系统资源和应用资源。系统资源是系统提供的资源,开发者可以通过主题图标库、系统色彩全量表、字体获取系统图标、颜色、字体等资源信息。其中symbol图标还可通过SymbolGlyph对图标颜色等进一步设置。应用资源是开发者在应用中自定义的资源,可以利用资源文件管理资源在不同的设备或配置中的表现。

资源分类

应用开发中使用的各类资源文件,需要放入特定子目录中存储管理。目录结构如下所示,base目录、限定词目录、rawfile目录、resfile目录称为资源目录,element、media、profile称为资源组目录。

  1. resources
  2. |---base // 默认存在的目录
  3. | |---element
  4. | | |---string.json // 字符串资源
  5. | |---media
  6. | | |---icon.png // 图片、视频等媒体资源文件
  7. | |---profile
  8. | | |---test_profile.json // 自定义profile文件,文件内容可自定义
  9. |---en_GB-vertical-car-mdpi // 自定义限定词目录示例,由开发者创建
  10. | |---element
  11. | | |---string.json
  12. | |---media
  13. | | |---icon.png
  14. | |---profile
  15. | | |---test_profile.json
  16. |---rawfile // 其他类型文件,原始文件形式保存,不会被集成到resources.index文件中。文件名可自定义。
  17. |---resfile // 其他类型文件,原始文件形式保存,不会被集成到resources.index文件中。文件名可自定义。

说明

  • 资源目录和资源组目录下的文件均被视为资源文件,在应用打包时不会进行混淆。

  • 非resources目录下资源打包策略请参考resOptions下copyCodeResource的描述。

  • Stage模型多工程情况下,共有的资源文件放到AppScope下的resources目录。

  • 在编译构建时,AppScope目录下的资源文件会合入到模块下面的资源文件中,如果两个目录下的相同资源目录和资源组目录下存在重名资源,按照以下优先级进行打包(优先级由高到低):AppScope里面的资源,HAP包自身模块,依赖的HAR模块(依赖的多个HAR之间有资源冲突,会按照工程oh-package.json5中dependencies下的依赖顺序进行覆盖,依赖顺序在前的优先级较高)。

资源目录

表1 资源目录说明

目录类型 说明
base目录

base目录默认存在。二级子目录element用于存放字符串、颜色、布尔值等基础元素,media和profile子目录存放媒体、动画、布局等资源文件。

目录中的资源文件会被编译成二进制文件,并分配资源ID。通过指定资源类型(type)和资源名称(name)来访问。

限定词目录

限定词目录需要开发者根据开发需要自行创建,二级子目录element用于存放字符串、颜色、布尔值等基础元素,media和profile子目录存放媒体、动画、布局等资源文件。

同样,目录中的资源文件会被编译成二进制文件,并分配资源ID。通过指定资源类型(type)和资源名称(name)来访问。限定词的含义和取值范围以及限定词目录的命名规则请参考下方限定词目录中的说明。

rawfile目录

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

目录中的资源文件会被直接打包进应用,不经过编译,也不会分配资源ID。通过指定文件路径和文件名访问。

resfile目录

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

目录中的资源文件会被直接打包进应用,不经过编译,也不会分配资源ID。应用安装后,resfile资源会被解压到应用沙箱路径,通过Context属性resourceDir获取到resfile资源目录后,可通过文件路径访问,且该路径仅能以只读方式访问。

点赞
收藏
回复
1
分享
举报
浏览43 发布于2026-07-27 02:08浙江
全部评论
最多点赞
最新发布
最早发布
资源文件编译构建这块确实容易踩坑,多目标产物定制的时候文件重复问题挺烦的,希望官方能多出些这种实战场景的文档,支持一下!
1楼回复于2026-07-27 02:18 来自天津
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
资源分类
资源目录
了解社区公约,与您携手共创和谐专业的开发者社区。