第二百二七回如何选择单个图片文件-优快云博客

本文链接：https://blog.youkuaiyun.com/talk_8/article/details/135209918

本文介绍了如何在Flutter应用中使用image_picker包实现可视化选择图片文件，包括包的使用、获取相对路径的方法、示例代码和注意事项。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

1. 概念介绍
2. 思路与方法
- 2.1 实现思路
- 2.2 实现方法
3. 示例代码
4. 内容总结

我们在上一章回中介绍了"如何播放视频"相关的内容，本章回中将介绍 如何选择单个图片文件.闲话休提，让我们一起Talk Flutter吧。

1. 概念介绍

我们在前面章回中介绍了加载本地图片和播放视频相关的内容，它们需要获取文件在本地存储的绝对路径，我们在很早的章回中介绍过path_provider包，它可以协助开发者获取到本地存储的路径，不过没有通过可视化的界面操作，本章回中将介绍一种通过可视化操作获取文件路径的方法，并且在此基础上获取图片文件。

在这里插入图片描述

2. 思路与方法

2.1 实现思路

我们通过三方包image_picker来获取文件路径，而且是通过可视化操作的方式来获取文件，我们只需要发出一个指令就可以打开手机上的文件系统，接下来就可以在该文件系统中以可视化的方式选择文件，选择文件后可以获取到该文件在文件系统中的相对路径。

这个包是Flutter官方提供的包，我们可以放心使用，而且在Android系统中不需要获取文件读写权限(早期版本需要，最新版本不需要，具体的版本号可以参考官方文档).我们在接下来的章回中将详细介绍该包的使用方法，包含获取图片文件和视频文件，以及通过相机来获取图片和视频文件。

2.2 实现方法

介绍完具体的实现思路后，我们介绍详细的实现方法。

在yaml配置文件中添加包，并且获取包到项目中；
创建文件选择器对象，也就是包中提供的ImagePicker类的实例；
使用文件选择器的pickImage()方法获取图片文件，该方法将返回图片文件在本地存储中的相对路径；
获取到文件路径后就可以使用Image组件的file()方法加载图片文件。

上面的步骤中使用了ImagePicker的pickImage()方法，该方法返回的是Future<XFile?>类型的对象，因此我们需要通过Future的then方法来获取文件路径。此外，该方法需要异步运行，因为获取文件路径是比较耗时的操作。

3. 示例代码

ImagePicker imagePicker = ImagePicker();

XFile? _mediaFile;

double imgWidth = 200;
double imgHeight = 400;

///注意获取图片需要异步操作
Future<XFile?> getImageFile() async {
  var imgFile = await imagePicker.pickImage(
    source: ImageSource.gallery,
    maxWidth: imgWidth,
    maxHeight: imgHeight,
    imageQuality: 10,
  );
  return imgFile;
}

///通过按钮来发出指令
ElevatedButton(
  onPressed: () {
    getImageFile().then((value) {
      ///因为是异步，所以需要通过setState更新数据源
      setState(() {
        ///返回的路径是app下的缓冲目录：data/user/0/packagename/cache/scaled_1000000010.jpg
        // debugPrint("path: v${value[0].path}");
        _mediaFile = value;
      });
    });
  },
  child: const Text("Load Image"),
),

///显示图片文件
_mediaFile == null
    ? const Icon(Icons.image)
    : (_mediaFile!.path.isEmpty
        ? const Text("do not select image")
        : Image.file(
            File(_mediaFile!.path),
            width: imgWidth,
            height: imgHeight,
            errorBuilder: (context, error, trace) {
              return Text("load image error: $error");
            },
          ))