Flutter中如何将预存文件添加至Android/iOS本地存储？

1. 配置静态资源 #

首先把预存的CSV文件放到Flutter项目的assets目录下（没有则手动创建，比如assets/csv/test.csv），然后在pubspec.yaml中声明该资源，确保编译时被打包进应用：

flutter:
  uses-material-design: true
  assets:
    - assets/csv/test.csv

注意缩进格式要和示例一致，否则资源无法被正确识别。

2. 首次启动时复制资源到本地存储 #

Flutter的assets目录是只读的，无法直接修改，需要在用户首次启动应用时，把CSV文件复制到可读写的设备本地存储目录（比如应用文档目录）。

先导入所需依赖包：

import 'dart:io';
import 'dart:typed_data';
import 'package:flutter/services.dart';
import 'package:path_provider/path_provider.dart';
import 'package:flutter/widgets.dart';

实现复制函数：

Future<void> copyAssetToLocal() async {
  // 获取应用可读写的文档目录
  final appDocDir = await getApplicationDocumentsDirectory();
  final localCsvPath = '${appDocDir.path}/test.csv';
  final localFile = File(localCsvPath);

  // 检查文件是否已存在，避免重复复制
  if (!await localFile.exists()) {
    // 从assets读取文件内容
    final assetData = await rootBundle.load('assets/csv/test.csv');
    final bytes = assetData.buffer.asUint8List();
    // 写入到本地存储
    await localFile.writeAsBytes(bytes);
  }
}

在应用启动时调用该函数（需先初始化Flutter绑定）：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await copyAssetToLocal();
  runApp(const MyApp());
}

3. 访问本地存储中的CSV文件 #

现在可以正常访问本地存储里的CSV文件：

Future<String> loadLocalCsv() async {
  final appDocDir = await getApplicationDocumentsDirectory();
  final csvFile = File('${appDocDir.path}/test.csv');
  return csvFile.readAsString();
}

为什么之前的方法无效 #

你将CSV放在应用根目录，编译后该文件不会被打包进应用的可访问资源中，Flutter仅处理pubspec.yaml中声明的assets资源。同时assets目录是只读的，无法直接作为可读写文件使用，因此必须复制到设备的可读写存储目录才能正常操作。

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