开始

环境

• Dart SDK 3.12+
• 普通 Flutter / Dart 包（根目录有 pubspec.yaml）

安装

只写在 dev_dependencies。没有运行时 API。

dart pub add --dev fast_dev
dart pub add --dev build_runner   # 只用 CLI 可以不加

或手写：

dev_dependencies:
  fast_dev: ^0.0.1-beta.1
  build_runner: ^2.7.2

只用 dart run fast_dev gen 时不必写 build_runner。已经在用 build_runner 时加上 fast_dev 就会一起生成。

资源清单还是写在 pubspec.yaml。目录会递归展开，一般写一层就够：

flutter:
  assets:
    - assets/

单文件也可以：

flutter:
  assets:
    - assets/images/logo.svg
    - assets/data/hello.json

建配置文件

建议在项目根（和 pubspec.yaml 同级）自己建一份 fast_dev_config.yaml。

没有这份文件也能跑，会用内置默认值，CLI 会提一句。自己写一份更清楚：类名、风格、输出目录都在仓库里，别人不用猜。

最小可以先这样：

version: 1

generate:
  output: lib/gen/fast_dev/
  line_length: 80
  assets:
    class_name: Assets
    style: nested

有 light / dark 或语言目录时，把变体打开。目录结构和 example/ 类似的话：

version: 1

generate:
  output: lib/gen/fast_dev/
  line_length: 80
  assets:
    class_name: Assets
    style: nested
    variants:
      theme:
        enabled: true
      locale:
        enabled: true
        folders:
          - zh
          - en
        fallback: file

怎么建文件、怎么加载见 配置。每个字段的含义、默认值和限制见 Assets。建完可以用下面这条核对解析结果：

dart run fast_dev config

生成

dart run fast_dev gen

默认写出 lib/gen/fast_dev/assets.gen.dart。

已经在用 build_runner 时，一条 watch 就够，和其它生成器一起跑：

dart run build_runner watch

怎么并列、build.yaml 怎么写，见 build_runner。

用

import 'package:your_app/gen/fast_dev/assets.gen.dart';

Image.asset(Assets.images.logo);
rootBundle.loadString(Assets.data.hello);

// 开了 theme / locale 之后
Image.asset(Assets.images.logo.of(context));

AssetPath 本身是 String，Image.asset、rootBundle、自己拼的 API 都能直接接。

可跑的例子在 example/。生成 API 的细节见 Assets。