Flutter包内Assets资源无法在应用中显示如何解决

1. Package 端 pubspec 资源声明 #

在你的package根目录的pubspec.yaml中按实际路径声明内部资源，无需额外添加包名前缀：

flutter:
  # 普通资源声明
  assets:
    - assets/sf2/example.sf2
  # 字体资源声明
  fonts:
    - family: CustomPackageFont
      fonts:
        - asset: assets/fonts/custom_font.ttf

资源文件建议统一放在package根目录的assets文件夹下分类存放。

2. Package 内部加载资源的正确写法 #

所有资源加载操作都需要显式指定当前package的名称，假设你的package名为custom_media_package：

• 加载二进制类资源（如sf2文件）

import 'package:flutter/services.dart';

// 路径固定格式为 packages/[你的包名]/[资源在package内的完整路径]
final sf2Data = await rootBundle.load('packages/custom_media_package/assets/sf2/example.sf2');

• 加载字体资源

// 声明文本样式时传入package参数即可，无需修改字体名称
final customTextStyle = TextStyle(
  fontFamily: 'CustomPackageFont',
  package: 'custom_media_package',
);

• 加载图片等资源使用对应组件时直接传package参数

Image.asset(
  'assets/images/icon.png',
  package: 'custom_media_package',
);

3. 主项目侧配置 #

主项目无需将package的资源复制到自身assets目录，仅需正常依赖该package即可，也不要在主项目的pubspec.yaml中重复声明该package的内部资源，避免重复打包。

4. Web端冗余文件夹问题规避 #

按上述规则加载资源后，Web构建时不会生成额外的冗余资源文件夹，所有package资源会被统一打包到规范路径下，无需额外配置。

内容的提问来源于stack exchange，提问作者user7849416