当前位置：首页 > article >正文

Flutter 学习之旅之 flutter 在 Android 端读取相册图片显示

article 2026/4/3 14:20:07

Flutter 学习之旅之 flutter 在 Android 端读取相册图片显示

一、简单介绍

二、简单介绍 image_picker

三、安装 image_picker

四、简单案例实现

五、关键代码

代码说明：

一、简单介绍

Flutter 是一款开源的 UI 软件开发工具包，由 Google 开发和维护。它允许开发者使用一套代码同时构建跨平台的应用程序，包括移动设备（iOS 和 Android）、Web 和桌面平台（Windows、macOS 和 Linux）。

Flutter 使用 Dart 编程语言，它可以将代码编译为 ARM 或 Intel 机器代码以及 JavaScript，从而实现快速的性能。Flutter 提供了一个丰富的预置小部件库，开发者可以根据自己的需求灵活地控制每个像素，从而创建自定义的、适应性强的设计，这些设计在任何屏幕上都能呈现出色的外观和感觉。

二、简单介绍 image_picker

网址：image_picker | Flutter package

image_picker 是 Flutter 中一个非常流行的插件，用于从设备的相册中选择图片或使用相机拍摄新照片。

三、安装 image_picker

1、直接运行命令

使用 Flutter：flutter pub add image_picker

2、或者在 pubspec.yaml 添加

dependencies:image_picker: ^1.1.2

四、简单案例实现

1、这里使用 Android Studio 进行创建 Flutter 项目

2、创建一个 application 的 Flutter 项目

3、工程创建后如下

4、在安卓端添加文件读取权限

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STTORAGE"/>

5、在 lib/main.dart 编写代码实现相册图片显示

6、连接设备，运行设备上的简单效果如下

五、关键代码

import 'dart:io'; // 导入 Dart 的文件操作库，用于处理图片文件import 'package:flutter/material.dart'; // 导入 Flutter 的 Material Design 组件库
import 'package:image_picker/image_picker.dart'; // 导入图片选择器插件void main() {runApp(MyApp()); // 启动应用
}// 定义一个无状态的 MyApp 组件，作为应用的根组件
class MyApp extends StatelessWidget {@overrideWidget build(BuildContext context) {return MaterialApp(title: 'Flutter Photo Picker', // 应用的标题theme: ThemeData(primarySwatch: Colors.blue), // 设置应用的主题颜色为蓝色home: PhotoPickerPage(), // 设置首页为 PhotoPickerPage 组件);}
}// 定义一个有状态的 PhotoPickerPage 组件，用于实现图片选择功能
class PhotoPickerPage extends StatefulWidget {@override_PhotoPickerPageState createState() => _PhotoPickerPageState();
}// 定义 PhotoPickerPage 的状态类，用于管理图片选择的状态
class _PhotoPickerPageState extends State<PhotoPickerPage> {final ImagePicker _picker = ImagePicker(); // 创建一个图片选择器实例XFile? _imageFile; // 定义一个变量，用于存储选择的图片文件// 定义一个异步方法，用于从图库中选择图片Future<void> _pickImage() async {try {// 调用图片选择器的 pickImage 方法，从图库中选择图片final pickedFile = await _picker.pickImage(source: ImageSource.gallery);setState(() {// 更新状态，将选择的图片文件赋值给 _imageFile_imageFile = pickedFile;});} catch (e) {// 捕获异常并打印错误信息print('Error picking image: $e');}}@overrideWidget build(BuildContext context) {return Scaffold(appBar: AppBar(title: Text('选择照片'), // 设置应用栏的标题),body: Column(mainAxisAlignment: MainAxisAlignment.center, // 将子组件垂直居中children: <Widget>[// 设置图片显示区域Container(width: 300, // 设置容器的固定宽度为 300height: 300, // 设置容器的固定高度为 300decoration: BoxDecoration(border: Border.all(color: Colors.grey), // 添加灰色边框，便于观察容器边界),child: _imageFile == null? Center(child: Text('没有选择照片')) // 如果没有选择图片，显示提示文本: ClipRRect(borderRadius: BorderRadius.circular(8), // 添加圆角，半径为 8child: Image.file(File(_imageFile!.path), // 显示选择的图片文件fit: BoxFit.contain, // 设置图片填充方式为完整显示，保持宽高比例),),),SizedBox(height: 20), // 添加一个高度为 20 的间隔ElevatedButton(onPressed: _pickImage, // 点击按钮时调用 _pickImage 方法选择图片child: Text('选择照片'), // 设置按钮的文本),],),);}
}

代码说明：

导入库：

dart:io 用于处理文件操作。

flutter/material 提供了 Material Design 风格的组件。

image_picker 是一个第三方插件，用于从图库或相机中选择图片。

MyApp 组件：

作为应用的根组件，配置了应用的基本信息，如标题和主题颜色。

PhotoPickerPage 组件：

一个有状态的组件，用于实现图片选择和显示功能。

_PhotoPickerPageState 状态类：

管理图片选择的状态。

_pickImage 方法用于从图库中选择图片，并更新状态。

UI 布局：

使用 Scaffold 提供应用的基本结构，包括应用栏。

使用 Column 垂直排列子组件。

使用 Container 设置图片显示区域的固定大小，并通过 ClipRRect 添加圆角。

使用 BoxFit.contain 确保图片完整显示，同时保持宽高比例。

按钮功能：

点击按钮时调用 _pickImage 方法，从图库中选择图片并更新显示。

六、一些问题说明

1、未能打开相册

问题描述：
尝试打开相册时，应用无法获取权限或无法打开相册界面。
解决方法：

确保在 AndroidManifest.xml 文件中正确添加了以下权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

对于 Android 6.0（API 级别 23）及以上版本，需要动态请求权限。可以使用 permission_handler 插件来请求运行时权限。
检查是否正确初始化了 image_picker 插件，并确保调用权限请求的代码逻辑正确。

2、图片选择后未显示

问题描述：
选择图片后，图片未能正确显示在界面上。
解决方法：

检查是否正确处理了选择后的返回值。确保在 pickImage 方法的回调中正确更新了图片路径。
确保图片路径正确，并且图片文件确实存在。例如，可以打印图片路径进行调试。
如果使用了 setState 更新图片路径，确保路径更新后界面能够正确刷新。
如果图片路径是一个文件路径，确保使用 File 类加载图片，例如：
```
Image.file(File(_imageFile!.path));
```

3、安卓版本过低，无法读取图片

问题描述：
在某些低版本的 Android 设备上，图片无法正确读取或显示。
解决方法：

确保设备运行的是 Android 4.0（API 级别 14）或更高版本。
如果需要支持更低版本的 Android，建议检查 image_picker 的版本兼容性，或者使用其他兼容性更好的插件。
如果问题依然存在，可以尝试更新 image_picker 插件到最新版本，或者查阅官方文档中的相关说明。

在开发过程中，可能会遇到各种问题或错误。以下是一些实用的建议，帮助您更高效地解决问题：

查阅官方文档：
官方文档是解决问题的首要资源。image_picker 的官方文档提供了详细的使用方法、配置说明和常见问题解答。
image_picker 官方文档

搜索社区论坛：
如果官方文档中没有找到答案，可以尝试搜索 Stack Overflow、GitHub Issues 或其他社区论坛。许多开发者可能已经遇到并解决了类似的问题。