欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net

前言

在 OpenHarmony 应用中，为了保证在不同分辨率屏幕（手机、折叠屏、平板）下图标都能保持绝对清晰，且为了减小 HAP 包体积，使用“字体图标”取代“位图图片”是业界公认的标准方案。

icon_font_generator 是一个强大的命令行工具。它能将一整组 SVG 图标自动打包成一个 .ttf 字体文件，并同步生成 Dart 类。开发者只需关注 SVG 文件的增删，剩余的同步工作全部自动化。

一、全自动构建链路

在鸿蒙开发中，我们绝不推荐手写 IconData 的内存地址。通过以下流程，可以实现资产的自动化转换：

1. 准备 SVG 素材

将设计师导出的 .svg 图标文件统一放入工程资产目录：

• 存储路径：assets/ohos_icons/*.svg

2. 执行自动化构建指令

在项目根目录运行以下命令，工具会自动扫描 SVG、生成字体文件并创建 Dart 调用类：

# 💡 核心指令：一键生成鸿蒙图标资产
flutter pub run icon_font_generator \
  --from=assets/ohos_icons \
  --to=assets/fonts/OhosIcons.ttf \
  --out=lib/generated/ohos_icons.dart \
  --class-name=OhosIcons

3. 在 pubspec.yaml 中注册

生成的 .ttf 必须在配置文件中声明方可生效：

flutter:
  fonts:
    - family: OhosIcons
      fonts:
        - asset: assets/fonts/OhosIcons.ttf

二、核心 API 实战

2.1 字体图标基础加载

通过工具生成的静态变量，你可以像使用 Icons.home 一样访问自定义图标，无需记忆十六进制代码。

// 💡 核心 API: 访问生成的自定义图标 (OhosIcons 为自动生成的类)
Icon(OhosIcons.home, size: 24, color: Colors.blue)

2.2 自定义图标样式

字体图标本质上是文本。它们可以完美支持颜色叠加、阴影、渐变以及混合模式。

// 💡 核心 API: 为字体图标添加特定的阴影效果
Icon(
  OhosIcons.scanner,
  shadows: [
    Shadow(color: Colors.black26, offset: Offset(0, 4), blurRadius: 10)
  ],
)

2.3 动态映射图标

当图标选择来自后端（如后台配置的任务列表）时，配合 Map 映射表，可以极大地简化业务逻辑。

// 💡 核心 API: 建立 API 响应与字体图标的动态映射
static const Map<String, IconData> iconMapping = {
  'home': OhosIcons.home,
  'user': OhosIcons.person,
};

三、OpenHarmony 平台适配

3.1 资产注册注意

在鸿蒙工程中，生成的 .ttf 文件必须在 pubspec.yaml 的 fonts 节点下正确声明，且 family 名称必须与生成的 Dart 代码中 fontFamily 固定值完全匹配，否则会出现显示为“方块（乱码）”的问题。

3.2 高刷性能优势

💡 提示：相比于加载大量的 .png 图片导致鸿蒙设备主线程解码压力过大，字体图标加载极为迅速。在滑动长列表（如金刚区菜单）时，字体图标几乎不会造成任何掉帧（Jank）。

四、完整实战示例：鸿蒙风格图标资产中心

本示例演示如何通过模拟生成的 OhosIcons 类构建一套标准的鸿蒙金刚区菜单系统。

class OhosIconMenu extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return GridView.count(
      crossAxisCount: 4,
      children: [
        _buildItem(OhosIcons.scanner, "扫一扫"),
        _buildItem(OhosIcons.payment, "钱包"),
        _buildItem(OhosIcons.message, "行程"),
        _buildItem(OhosIcons.settings, "更多"),
      ],
    );
  }

  Widget _buildItem(IconData icon, String label) {
    return Column(
      children: [
        // 💡 字体图标加载性能极佳
        Icon(icon, color: Colors.blueAccent, size: 30),
        Text(label, style: TextStyle(fontSize: 12)),
      ],
    );
  }
}

五、总结

icon_font_generator 将 OpenHarmony 应用的资源管理提升到了自动化水平。它通过单一字体文件解决了碎片化图片的管理难题，不仅极大地优化了应用的运行性能，还统一了 UI 层的调用标准。对于任何追求极致轻量化和视觉一致性的鸿蒙项目，这都是一套必选的基本建设。