如何在纯Dart包中提供并加载静态SVG资源？

核心思路 #

纯Dart项目中，默认工作目录是运行项目的根目录，而非库的根目录，所以不能直接用相对路径引用库内资源。我们可以通过Platform.script获取库脚本的绝对路径，再拼接资源的相对路径，实现跨环境（调试/发布）的资源定位。

具体步骤 #

1. 配置库的pubspec.yaml #

确保发布库时包含assets资源，在库的pubspec.yaml中添加：

files:
  - assets/**
  - lib/**

这样pub会把assets目录下的所有文件打包进发布的包中，用户安装后能正常访问。

2. 在库代码中获取资源绝对路径 #

假设你的库目录结构如下：

my_pdf_lib/
  lib/
    pdf_generator.dart  # 你的PDF生成逻辑代码
  assets/
    svg/
      logo.svg          # 需要嵌入的SVG资源

在pdf_generator.dart中编写路径获取逻辑：

import 'dart:io';
import 'package:path/path.dart' as path;

// 获取SVG资源的绝对路径
String getSvgAssetPath() {
  // 获取当前脚本的绝对路径（比如lib/pdf_generator.dart的位置）
  final scriptPath = Platform.script.toFilePath();
  // 从脚本路径向上一级到库根目录（lib的父目录）
  final libraryRoot = path.dirname(path.dirname(scriptPath));
  // 拼接assets资源路径
  return path.join(libraryRoot, 'assets', 'svg', 'logo.svg');
}

如果你的脚本在lib/src/子目录下，需要多调用一次path.dirname()来回到库根，比如：

final libraryRoot = path.dirname(path.dirname(path.dirname(scriptPath)));

3. 调试与验证 #

• 本地调试时，无头应用通过相对路径依赖你的库（比如在无头应用的pubspec.yaml中写my_pdf_lib: path: ../my_pdf_lib），Platform.script会指向本地库的脚本路径，拼接后能正确定位到本地的assets目录。
• 发布后，用户安装库时，资源会被放在pub缓存目录中，Platform.script会指向缓存中的库脚本，同样能正确拼接资源路径。

可以在代码中临时打印路径，确认是否指向正确的SVG文件：

print(getSvgAssetPath()); // 输出路径后手动检查是否存在该文件

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