移除 AssetManifest.json

Flutter 应用曾包含一个名为 AssetManifest.json 的资源文件。该文件实际上包含了一个资源列表。应用程序代码可以使用 AssetBundle API 读取它，以确定运行时有哪些可用的资源。

AssetManifest.json 文件是一个未公开的实现细节。它已不再被框架使用，并且计划在未来的 Flutter 版本中不再生成它。如果你的应用程序代码需要获取可用资源的列表，请改用 AssetManifest API。

之前

dartimport 'dart:convert';
import 'package:flutter/services.dart';

void readAssetList() async {
  final assetManifestContent = await rootBundle.loadString('AssetManifest.json');
  final decodedAssetManifest =
      json.decode(assetManifestContent) as Map<String, Object?>;
  final assets = decodedAssetManifest.keys.toList().cast<String>();
}

之后

dartimport 'package:flutter/services.dart';

void readAssetList() async {
  final assetManifest = await AssetManifest.loadFromAssetBundle(rootBundle);
  final assets = assetManifest.listAssets();
}

flutter CLI 工具会生成一个新文件 AssetManifest.bin。它取代了 AssetManifest.json。该文件包含与 AssetManifest.json 相同的信息，但格式不同。如果你需要从不属于 Flutter 应用的代码中读取此文件，因此无法使用 AssetManifest API，你仍然可以自己解析该文件。

可以使用 standard_message_codec 包来解析其内容。

dartimport 'dart:io';
import 'dart:typed_data';

import 'package:standard_message_codec/standard_message_codec.dart';

void main() {
  // The path to AssetManifest.bin depends on the target platform.
  final pathToAssetManifest = './build/web/assets/AssetManifest.bin';
  final manifest = File(pathToAssetManifest).readAsBytesSync();
  final decoded = const StandardMessageCodec()
      .decodeMessage(ByteData.sublistView(manifest));
  final assets = decoded.keys.cast<String>().toList();
}

请注意，AssetManifest.bin 是 Flutter 的一个实现细节。读取此文件不是官方支持的工作流程。该文件的内容或格式可能会在未来的 Flutter 版本中更改，恕不另行通知。

AssetManifest.json 将从 3.19 之后的第四个稳定版本，或者自 3.19 发布之日起一年后（以较晚者为准）开始不再生成。

概述

迁移指南

从 Flutter 应用程序代码读取资源清单

从 Flutter 应用外部的 Dart 代码读取资源清单信息

时间线

参考资料