Dart的IO库包含了文件读写的相关类,它属于Dart语法标准的一部分,所以通过Dart IO库,无论是Dart VM下的脚本还是Flutter,都是通过Dart IO库来操作文件的,不过和Dart VM相比,Flutter有一个重要差异是文件系统路径不同,这是因为Dart VM是运行在PC或服务器操作系统下,而Flutter是运行在移动操作系统中,他们的文件系统会有一些差异。

APP目录

Android和iOS的应用存储目录不同,PathProvider 插件提供了一种平台透明的方式来访问设备文件系统上的常用位置。该类当前支持访问两个文件系统位置:

  • 临时目录: 可以使用 **getTemporaryDirectory()**来获取临时目录; 系统可随时清除的临时目录(缓存)
  • 文档目录: 可以使用getApplicationDocumentsDirectory()来获取应用程序的文档目录,该目录用于存储只有自己可以访问的文件。只有当应用程序被卸载时,系统才会清除该目录。
    • 在iOS上,这对应于NSDocumentDirectory
    • 在Android上,这是AppData目录
  • 外部存储目录:可以使用getExternalStorageDirectory()来获取外部存储目录,如SD卡
    • 由于iOS不支持外部目录,所以在iOS下调用该方法会抛出UnsupportedError异常
    • 而在Android下结果是android SDK中getExternalStorageDirectory的返回值。

一旦你的Flutter应用程序有一个文件位置的引用,你可以使用 dart:io API来执行对文件系统的读/写操作。有关使用Dart处理文件和目录的详细内容可以参考Dart语言文档,下面我们看一个简单的例子。

示例

我们还是以计数器为例,实现在应用退出重启后可以恢复点击次数。 这里,我们使用文件来保存数据:

  1. 引入PathProvider插件;在pubspec.yaml文件中添加如下声明:
    1. path_provider: ^0.4.1
    添加后,执行flutter packages get获取一下, 版本号可能随着时间推移会发生变化,读者可以使用最新版。

2.实现:

  1. import 'dart:io';
  2. import 'dart:async';
  3. import 'package:flutter/material.dart';
  4. import 'package:path_provider/path_provider.dart';
  5. void main() => runApp(new MyApp());
  6. class MyApp extends StatelessWidget {
  7. @override
  8. Widget build(BuildContext context) {
  9. return MaterialApp(
  10. debugShowCheckedModeBanner: true,
  11. title: '文件操作',
  12. theme: ThemeData(
  13. primarySwatch: Colors.blue,
  14. ),
  15. home: Scaffold(
  16. appBar: AppBar(title: Text("文件操作")),
  17. body: FileOperationRoute(),
  18. ));
  19. }
  20. }
  21. class FileOperationRoute extends StatefulWidget {
  22. FileOperationRoute({Key key}) : super(key: key);
  23. @override
  24. _FileOperationRouteState createState() => new _FileOperationRouteState();
  25. }
  26. class _FileOperationRouteState extends State<FileOperationRoute> {
  27. int _counter =0;
  28. @override
  29. void initState() {
  30. super.initState();
  31. //从文件读取点击次数
  32. _readCounter().then((int value) {
  33. setState(() {
  34. _counter = value;
  35. });
  36. });
  37. }
  38. Future<File> _getLocalFile() async {
  39. // 获取应用目录
  40. String dir = (await getApplicationDocumentsDirectory()).path;
  41. return new File('$dir/counter.txt');
  42. }
  43. Future<int> _readCounter() async {
  44. try {
  45. File file = await _getLocalFile();
  46. // 读取点击次数(以字符串)
  47. String contents = await file.readAsString();
  48. return int.parse(contents);
  49. } on FileSystemException {
  50. return 0;
  51. }
  52. }
  53. Future<Null> _incrementCounter() async {
  54. setState(() {
  55. _counter++;
  56. });
  57. // 将点击次数以字符串类型写到文件中
  58. await (await _getLocalFile()).writeAsString('$_counter');
  59. }
  60. @override
  61. Widget build(BuildContext context) {
  62. return new Scaffold(
  63. body: new Center(
  64. child: new Text('点击了 $_counter 次'),
  65. ),
  66. floatingActionButton: new FloatingActionButton(
  67. onPressed: _incrementCounter,
  68. tooltip: 'Increment',
  69. child: new Icon(Icons.add),
  70. ),
  71. );
  72. }
  73. }

上面代码比较简单,不再赘述,需要说明的是,本示例只是为了演示文件读写,而在实际开发中,如果要存储一些简单的数据,使用shared_preferences插件会比较简单。

注意,Dart IO库操作文件的API非常丰富,但本书不是介绍Dart语言的,故不详细说明,读者需要的话可以自行学习。