【Flutter 实战】文件系统目录

时间  2020-10-01
标签 Flutter 实战 文件 系统 目录 繁體版
原文   原文链接

老孟导读：Flutter 中获取文件路径，咱们都知道使用 path_provider，但对其目录对含义不是很清楚，此文介绍 Android、iOS 系统的文件目录，不一样场景下建议使用的目录。android

不一样的平台对应的文件系统是不一样的，好比文件路径，所以 Flutter 中获取文件路径须要原生支持，原生端经过 MethodChannel 传递文件路径到 Flutter，若是没有特殊的需求，推荐你们使用 Google 官方维护的插件 path_provider。ios

pub 地址：https://pub.flutter-io.cn/packages/path_providergit

Github 地址：https://github.com/flutter/plugins/tree/master/packages/path_provider/path_providergithub

添加依赖

在项目的 pubspec.yaml 文件中添加依赖：sql

dependencies:
  path_provider: ^1.6.14

执行命令：缓存

flutter pub get

文件路径

path_provider（版本：1.6.14）提供了8个方法获取不一样的文件路径，目前 Flutter（Flutter 1.20.1 • channel stable ）只发布了正式版本的 Android 和 iOS，所以下面仅介绍 Android 和 iOS 平台的文件路径。安全

  • getTemporaryDirectory微信

    临时目录，适用于下载的缓存文件，此目录随时能够清除，此目录为应用程序私有目录，其余应用程序没法访问此目录。app

    Android 上对应getCacheDir。ide

    iOS上对应NSCachesDirectory。

  • getApplicationSupportDirectory

    应用程序能够在其中放置应用程序支持文件的目录的路径。

    将此文件用于您不想向用户公开的文件。 您的应用不该将此目录用于存放用户数据文件。

    在iOS上，对应NSApplicationSupportDirectory ，若是此目录不存在，则会自动建立。
    在Android上，对应getFilesDir。

  • getLibraryDirectory

    应用程序能够在其中存储持久性文件，备份文件以及对用户不可见的文件的目录路径，例如storage.sqlite.db。

    在Android上，此函数抛出[UnsupportedError]异常，没有等效项路径存在。

  • getApplicationDocumentsDirectory

    应用程序可能在其中放置用户生成的数据或应用程序没法从新建立的数据的目录路径。

    在iOS上，对应NSDocumentDirectory API。 若是数据不是用户生成的，考虑使用[getApplicationSupportDirectory]。

    在Android上，对应getDataDirectory API。 若是要让用户看到数据，请考虑改用[getExternalStorageDirectory]。

  • getExternalStorageDirectory

    应用程序能够访问顶级存储的目录的路径。因为此功能仅在Android上可用，所以应在发出此函数调用以前肯定当前操做系统。

    在iOS上，此功能会引起[UnsupportedError]异常，由于没法在应用程序的沙箱外部访问。

    在Android上，对应getExternalFilesDir（null）。

  • getExternalCacheDirectories

    存储特定于应用程序的外部缓存数据的目录的路径。 这些路径一般位于外部存储（如单独的分区或SD卡）上。 电话可能具备多个可用的存储目录。
    因为此功能仅在Android上可用，所以应在发出此函数调用以前肯定当前操做系统。
    在iOS上，此功能会抛出UnsupportedError，由于这是不可能的在应用程序的沙箱外部访问。

    在Android上，对应Context.getExternalCacheDirs（）或API Level 低于19的Context.getExternalCacheDir（）。

  • getExternalStorageDirectories

    能够存储应用程序特定数据的目录的路径。 这些路径一般位于外部存储（如单独的分区或SD卡）上。
    因为此功能仅在Android上可用，所以应在发出此函数调用以前肯定当前操做系统。
    在iOS上，此功能会抛出UnsupportedError，由于这是不可能的在应用程序的沙箱外部访问。
    在Android上，对应Context.getExternalFilesDirs（String type）或API Level 低于19的Context.getExternalFilesDir（String type）。

  • getDownloadsDirectory

    存储下载文件的目录的路径，这一般仅与台式机操做系统有关。
    在Android和iOS上，此函数将引起[UnsupportedError]异常。

若是没有 Android 或者 iOS开发经验，看完上面的说明应该是一脸懵逼的，这么多路径到底用哪一个？有什么区别？下面从 Android 和 iOS 平台的角度介绍其文件路径，最后给出路径使用的建议以及使用过程当中须要注意的事项。

Android 文件存储

Android 文件存储分为内部存储和外部存储。

内部存储

用于保存应用的私有文件，其余应用没法访问这些数据，建立的文件在此应用的包名目录下，没有 root 权限 的手机没法在手机的 文件管理 应用中看到此目录，不过能够经过 Android Studio 工具查看，路径为：data/data/包名：

看下包名下具体的目录结构：

  • cache 目录：对应 getTemporaryDirectory 方法，用于缓存文件，此目录随时可能被系统清除。
  • files 目录：对应 getApplicationSupportDirectory 方法。
  • code_cache：此目录存储 Flutter 相关代码和资源。
    • flutter_engine/skia：Flutter 渲染引擎。
    • flutter_guidePVWGWK/flutter_guide/build/flutter_assets：Flutter 资源文件。
  • shared_prefs： SharePreferences 的默认路径。
  • app_flutter：对应 getApplicationDocumentsDirectory方法。
  • app_flutter/dbName：使用 sqlite 的默认路径，sqlite 也能够指定位置。

SharePreferences 和 sqlite 是两种保存数据的第三方插件。

内部存储的特色：

  • 安全性，其余应用没法访问这些数据。
  • 当应用卸载的时候，这些数据也会被删除，避免垃圾文件。
  • 不须要申请额外权限。
  • 存储的空间有限，此目录数据随时可能被系统清除，也能够经过 设置 中的 清除数据 能够清除此目录数据。
  • 国内特点，不一样手机厂商对此目录作了不一样的限制，好比整体大小限制、单个应用程序所占空间大小限制、清除数据策略不一样等。

外部存储

外部存储能够经过手机的 文件管理 应用查看，

这里面有一个特殊的目录：Android/data/包名:

看到这个目录是否是以为和内部存储目录很是类似，一个包名表明一个应用程序：

  • cache：缓存目录，对应 getExternalCacheDirectories 方法。
  • files：对应 getExternalStorageDirectories 方法。

此目录的特色：

  • 当应用卸载的时候，这些数据也会被删除，避免垃圾文件。
  • 不须要申请额外权限。
  • 空间大且不会被系统清除，经过 设置 中的 清除数据 能够清除此目录数据。
  • 用户能够直接对文件进行删除、导入操做。

外部存储除了 Android/data/ 目录，还有和此目录同级的目录，特色：

  • 全部应用程序都可访问。
  • 用户能够直接对文件进行删除、导入操做。
  • 须要申请读写权限。

Android 官方对此目录的管理愈来愈严格， Android 11 系统已经开始强制执行分区存储，详情见：https://developer.android.com/preview/privacy/storage?hl=zh-cn

上面说了这么多，总结以下：

  • SharePreferences 和 sqlite 数据建议存放在内部存储，插件已经帮咱们完成了，无需手动处理。
  • 严格保密的数据，好比用户数据，建议存放在内部存储，对应 getApplicationSupportDirectory 方法。
  • 其他全部的数据建议存放 Android/data/包名/ ，对应 getExternalCacheDirectories 和 getExternalStorageDirectories 方法。

iOS 文件存储

iOS 文件存储相比 Android 要简单的多，由于 iOS 对用户隐私保护很是严格，每一个 iOS 应用程序都有一个单独的文件系统，并且只能在对应的文件系统中进行操做，此区域被称为沙盒。

每一个应用沙盒含有3个文件夹：Documents, Library 和 tmp：

  • Documents：应用程序数据文件写入到这个目录下。这个目录用于存储用户数据。保存应用程序的重要数据文件和用户数据文件等。iTunes 同步时会备份该目录，对应 getApplicationDocumentsDirectory 方法。
  • Library：对应 getLibraryDirectory 方法。
    • Caches：保存应用程序使用时产生的支持文件、缓存文件、日志文件等，好比下载的音乐,视频,SDWebImage缓存等。对应 getTemporaryDirectory 方法。
    • Preferences：包含应用程序的偏好设置文件，iCloud会备份设置信息。
    • Application Support：对应 getApplicationSupportDirectory 方法。
  • tmp：存放临时文件，不会被备份，并且这个文件下的数据有可能随时被清除的可能，按照官方说法每三天清理一次缓存数据。

path_provider 使用

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';

///
/// desc:
///

class PathProviderDemo extends StatefulWidget {
  @override
  _PathProviderDemoState createState() => _PathProviderDemoState();
}

class _PathProviderDemoState extends State<PathProviderDemo> {
  Future<Directory> _tempDirectory;
  Future<Directory> _appSupportDirectory;
  Future<Directory> _appLibraryDirectory;
  Future<Directory> _appDocumentsDirectory;
  Future<Directory> _externalStorageDirectory;
  Future<List<Directory>> _externalStorageDirectories;
  Future<List<Directory>> _externalCacheDirectories;
  Future<Directory> _downloadDirectory;

  @override
  void initState() {
    super.initState();
    setState(() {
      _tempDirectory = getTemporaryDirectory();
      _appSupportDirectory = getApplicationSupportDirectory();
      _appLibraryDirectory = getLibraryDirectory();
      _appDocumentsDirectory = getApplicationDocumentsDirectory();
      _externalStorageDirectory = getExternalStorageDirectory();
      _externalCacheDirectories = getExternalCacheDirectories();
      _externalStorageDirectories = getExternalStorageDirectories();
      _downloadDirectory = getDownloadsDirectory();
    });
  }

  Widget _buildDirectory(
      BuildContext context, AsyncSnapshot<Directory> snapshot) {
    Text text = const Text('');
    if (snapshot.connectionState == ConnectionState.done) {
      if (snapshot.hasError) {
        text = Text('Error: ${snapshot.error}');
      } else if (snapshot.hasData) {
        text = Text('path: ${snapshot.data.path}');
      } else {
        text = const Text('path unavailable');
      }
    }
    return Padding(padding: EdgeInsets.symmetric(horizontal: 16), child: text);
  }

  Widget _buildDirectories(
      BuildContext context, AsyncSnapshot<List<Directory>> snapshot) {
    Text text = const Text('');
    if (snapshot.connectionState == ConnectionState.done) {
      if (snapshot.hasError) {
        text = Text('Error: ${snapshot.error}');
      } else if (snapshot.hasData) {
        final String combined =
            snapshot.data.map((Directory d) => d.path).join(', ');
        text = Text('paths: $combined');
      } else {
        text = const Text('path unavailable');
      }
    }
    return Padding(
        padding: const EdgeInsets.symmetric(horizontal: 16), child: text);
  }

  Widget _buildItem(String title, Future<Directory> future) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        Padding(
          padding: const EdgeInsets.symmetric(horizontal: 16),
          child: Text(title),
        ),
        FutureBuilder<Directory>(future: future, builder: _buildDirectory),
      ],
    );
  }

  Widget _buildItem1(String title, Future<List<Directory>> future) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        Padding(
          padding: const EdgeInsets.symmetric(horizontal: 16),
          child: Text(title),
        ),
        FutureBuilder<List<Directory>>(
            future: future,
            builder: _buildDirectories),
      ],
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(),
      body: Center(
        child: ListView(
          itemExtent: 120,
          children: <Widget>[
            _buildItem('getTemporaryDirectory', _tempDirectory),
            _buildItem('getApplicationSupportDirectory', _appSupportDirectory),
            _buildItem('getLibraryDirectory', _appLibraryDirectory),
            _buildItem(
                'getApplicationDocumentsDirectory', _appDocumentsDirectory),
            _buildItem(
                'getExternalStorageDirectory', _externalStorageDirectory),
            _buildItem('getDownloadsDirectory', _downloadDirectory),

            _buildItem1('getExternalStorageDirectories',_externalStorageDirectories),
            _buildItem1('getExternalCacheDirectories',_externalCacheDirectories),

          ],
        ),
      ),
    );
  }
}

Android 系统各个路径：

iOS 系统各个路径：

交流

交流

老孟Flutter博客（330个控件用法+实战入门系列文章）：http://laomengit.com

欢迎加入Flutter交流群（微信：laomengit）、关注公众号【老孟Flutter】：
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程