选择器

Flutter图片与文件选择器

春节已过，今天是开工的第一天。我已经一个多星期没碰过电脑了，今日上班，打开电脑的第一件事就是想着写点什么。反正大家都还沉浸在节后的喜悦中，还没进入工作状态，与其浪费时间，不如做些更有意义的事情。

今天就跟大家简单分享一下Flutter开发过程中经常会用到的图片和文件选择器。

一、image_picker

一个适用于iOS和Android的Flutter插件，能够从图像库中选取图片、视频，还能够调用相机拍摄新的照片。

该插件由Flutter官方提供，github的Star高达16.7k，算是比较成熟且流行的插件了。

1、安装

flutter pub add image_picker

或者

/// pubspec.yaml文件添加依赖，并在执行flutter pub get命令

dependencies

  image_picker: ^0.8.6+1

2、使用

import 'package:image_picker/image_picker.dart';


/// 图片选取

Future<void> getImage() async {

    final XFile? file = await ImagePicker().pickImage(

      source: ImageSource.gallery, // 图库选择

      maxWidth: 1000.0, // 设置图片最大宽度，间接压缩了图片的体积

    );


    /// 选取图片失败file为null，要注意判断下。

    /// 获取图片路径后可以上传到服务器上

    print('${file?.path}');

}


/// 视频选取

Future<void> getImage() async {

    final XFile? file = await ImagePicker().pickVideo(

      source: ImageSource.camera, // 调用相机拍摄

    );


    print('${file?.path}');

}

在项目中，调用getImage方法就会打开图片选择器。

3、属性

source

图片来源，ImageSource.gallery图片库中选择，ImageSource.camera调用相机拍摄新图片。

maxWidth

图片的最大宽度，source为ImageSource.camera时有用，等于间接的压缩了图片的体积。如果不设置，以目前手机的相机性能，动不动就拍出了4、5M的照片，对于app来说，图片上传到服务端，将会很慢，建议设置此属性。

4、注意

iOS端如果出现闪退并且控制台报出：

The app's Info.plist must contain an NSPhotoLibraryAddUsageDescription key with a string value explaining to the user how the app uses this data.

那么，需要打开Xcode在Info.plist配置隐私提示语。

二、flutter_document_picker

文档选择器，image_picker只能选择图片和视频，如果要选择PDF，word文档、excel表格等就没办法了。这个时候可以使用flutter_document_picker插件，直接选取手机中的文件。

1、安装

flutter pub add flutter_document_picker

或者

/// pubspec.yaml文件添加依赖，并在执行flutter pub get命令

dependencies

  flutter_document_picker: ^5.1.0

2、使用

import 'package:image_picker/image_picker.dart';


/// 图片选取

Future<void> getDocument() async {

    FlutterDocumentPickerParams? params = FlutterDocumentPickerParams(

        // 允许选取的文件拓展类型，不加此属性则默认支持所有类型

        allowedFileExtensions: ['pdf', 'xls', 'xlsx', 'jpg', 'png', 'jpeg'],

    );


    String? path = await FlutterDocumentPicker.openDocument(

      params: params,

    );


    print('$path');

}