加载本地图片的方法

我们在上一章回中介绍了"如何加载网络图片"相关的内容，本章回中将介绍如何加载本地图片.闲话休提，让我们一起Talk Flutter吧。

1. 概念介绍

我们在上一章回中介绍的内容与图片有关，本章回中仍然介绍图片相关的知识：加载本地图片。我们在这里说的本地图片表示图片存储于手机自带的文件系统中，我们可以
通过AndroidStudio的DeviceFileManger中看到图片。

2. 实现方法

2.1 主要步骤

加载本地图片的主要是步骤是使用file()方法，它是image类的静态方法，可以直接拿来使用。该方法提供了一些常用的属性，详细如下：

• color属性:主要用来修改图片的颜色；
• frameBuilder属性: 主要用来控制图片从本地加载过程中显示的内容；
• errorBuilder属性: 主要用来控制图片从本地加载失败后显示的内容；
  该方法还有一个没有命名的属性：file，该属性主要用来存放图片的绝对地址，这个是必不可少的内容。

2.2 注意事项

在加载本地图片时需要处理加载过程和加载错误，加载错误时通过errorBuilder属性控制，该属性是方法类型，它会把错误的信息通过方法的参数传递出来，我们可以
依据错误信息做相关的处理。加载过程中通过frameBuilder属性控制，该属性也是方法类型，它会把加载的帧数和加载完后的图片通过参数传递出来，我们可以显示
图片加载的帧数。稍后我们将通完示例代码来演示。

3. 示例代码

///对应目录：storage/emulated/0/Android/data/package_name/files
Future<Directory?>? _externalDocumentsDirectory;
String filePath = "";
  _externalDocumentsDirectory = getExternalStorageDirectory();

  _externalDocumentsDirectory?.then((value) {
    debugPrint("current path: ${value?.path} ");
    setState(() {
      filePath = "${value?.path}/switch.png";
    });
  });

Image.file(
  File(filePath),
  width: 200,
  height: 200,
  alignment: Alignment.center,
  fit: BoxFit.fill,
  ///处理文件导入正确相关的内容
  frameBuilder:(context,child,frame,wasSynchronouslyLoaded) {
    if(wasSynchronouslyLoaded) {
      return child;
    }else {
      // return Text("frame:${frame.toString()}");
      return child;
    }
  },
  ///处理文件导入错误相关的内容
  errorBuilder: (context,error,trace) {
    debugPrint("load file error: ${error.toString()}");
    return Text(error.toString());
  },
),

上面的示例代码中演示了如何使用Image的file()方法加载本地图片，同时处理了图片加载过程和加载错误的业务逻辑，不过我们处理的的比较简单，只是显示一个
加载中或者加载错误的文字信息。大家可以依据自身业务逻辑进行相关的处理。此外，代码中处理图片加载中的业务时可以判断帧数，通常加载完第一帧时就会返回图片信
息，不过这个帧数与图片自身有关，有些图片只有一帧，有些图片包含多帧。因此这个frameBuilder属性与具体的图片有关，可以不去处理它。
代码中使用了getExternalStorageDirectory()方法，该方法是path_provider包提供的接口，它可以获取到当前存储的绝对位置，具体的位置信息可以参考我们
在代码中的文字注释。我们提前在该位置所在的目录中存放了一个名叫switch.png的图片，运行程序程序可以看到该图片，大家可以替换成自己文件系统中的图片
文件，或者不放图片文件，此时会显示错误信息。

4. 内容总结

最后，我们对本章回的内容做一个全面的总结：

• 加载本地图片使用Image组件的file()方法；
• 加载图片时需要处理图片加载过程和加载错误的业务逻辑；
• 加载过程的属性与图片有关，可以依据实际业务来处理,或者不处理；
  看官们，与"如何加载本地图片"相关的内容就介绍到这里，欢迎大家在评论区交流与讨论!