鸿蒙OS 资源与访问

在HarmonyOS应用开发中，资源（Resources）是指那些与代码分离的、可复用的元素，例如图片、字符串、颜色、布局文件等。 合理使用资源可以提高开发效率、方便应用国际化和主题切换。 HarmonyOS提供了两种类型的资源：应用资源和系统资源。

一、应用资源：个性化定制你的应用

应用资源是开发者在应用项目中定义的资源，用于构建应用的独特外观和行为。

1.1 访问方式：

• $r('app.type.name'): 用于访问应用资源目录 (resources) 下的资源。
  • app： 固定前缀，表示应用资源。
  • type： 资源类型，例如 color、float、string、plural、media 等。
  • name： 资源名称，由开发者在定义资源时指定。
• $rawfile('filename'): 用于访问 rawfile 目录下的原始文件。
  • filename： 文件路径，相对于 rawfile 目录，需要包含文件扩展名。
• getRawFd(): 用于获取 rawfile 目录下文件的描述符。 需要结合文件偏移量和读取长度使用。

1.2 示例：

// 访问字符串资源
const appTitle = $r('app.string.app_title').getStringValue();

// 访问图片资源
Image($r('app.media.app_icon'));

二、系统资源：统一视觉风格

系统资源是HarmonyOS系统预定义的资源，开发者可以使用它们来保持应用与系统风格一致，提升用户体验。

2.1 访问方式：

• $r('sys.type.resource_id'): 用于访问系统资源。
  • sys： 固定前缀，表示系统资源。
  • type: 资源类型，例如 color、float、string、media 等。
  • resource_id： 系统资源ID，可以在官方文档中查找。

2.2 示例：

// 使用系统定义的颜色
Text('Hello World').fontColor($r('sys.color.id_color_text_primary'));

2.3 注意事项：

• 只有声明式开发范式（ArkTS）支持使用系统资源。
• 系统预置应用建议优先使用系统资源，三方应用可以根据需要选择使用系统资源或自定义应用资源。

三、总结

HarmonyOS的资源访问机制灵活高效，开发者可以方便地使用应用资源和系统资源，为用户打造美观、易用的应用程序。