Flutter本地图片加载插件local_image_provider的使用

Flutter本地图片加载插件local_image_provider的使用

简介

local_image_provider 是一个用于搜索和检索移动设备上图片和相册元数据的库。该插件支持Android和iOS平台，并且能够以兼容 ImageProvider 的格式检索图片内容。需要注意的是，该插件没有UI组件，而是提供可以用来开发其他应用程序的本地照片信息。

最近更新

• 4.0.0-nullsafety 版本 支持null安全的应用程序。
• 3.0.0 版本 支持Web平台。在Web平台上使用时，它报告没有找到图片或相册，这意味着当依赖此插件的应用程序部署到Web时，不会阻止其部署。这是一个重大的更改，还使用了新的平台接口。
• 2.3.0 版本 提供更好的图像压缩支持，并改进了iOS 14及以上版本的新限制访问许可的支持。

注意：如果你有功能请求或问题报告，请在GitHub issues中发布。

使用方法

要获取设备上最新的十张本地图片，请导入插件并调用相应的函数：

import 'package:local_image_provider/local_image_provider.dart' as lip;

lip.LocalImageProvider imageProvider = lip.LocalImageProvider();
bool hasPermission = await imageProvider.initialize();
if (hasPermission) {
    List<lip.LocalImage> images = await imageProvider.findLatest(10);
    images.forEach((image) => print(image.id));
} else {
    print("用户拒绝访问设备上的图片。");
}

获取本地图片的 ImageProvider：

import 'package:local_image_provider/local_image_provider.dart' as lip;
import 'package:flutter/painting.dart';

lip.LocalImageProvider imageProvider = lip.LocalImageProvider();
bool hasPermission = await imageProvider.initialize();
if (hasPermission) {
    List<lip.LocalImage> images = await imageProvider.findLatest(1);
    if (!images.isEmpty) {
        lip.LocalImage image = images.first;
        DeviceImage deviceImg = DeviceImage(image);
    } else {
        print("设备上未找到任何图片。");
    }
} else {
    print("用户拒绝访问设备上的图片。");
}

DeviceImage 可以直接作为 ImageProvider 在 Flutter 中的 Image 小部件中使用。假设 _selectedImg 是一个 LocalImage，则可以通过以下方式将其显示在 Flutter 小部件树中：

Container(
    child: Image(
        image: DeviceImage(_selectedImg),
    ),
),

权限

使用此插件的应用程序需要以下用户权限。

iOS

在 <项目根目录>/ios/Runner/Info.plist 文件中添加以下键：

• NSPhotoLibraryUsageDescription - 描述您的应用为何需要访问照片库的权限。这在可视化编辑器中称为“隐私 - 照片库使用描述”。此权限是读取图片和相册信息所必需的。
• PHPhotoLibraryPreventAutomaticLimitedAccessAlert - （可选）设置为 YES 或 true，以阻止每次应用启动时出现的iOS对话框，如果用户已授予对其库的有限访问权限。

Android

在 <项目根目录>/android/app/src/main/AndroidManifest.xml 文件中添加存储权限：

• android.permission.READ_EXTERNAL_STORAGE - 允许应用查询和读取图片和相册信息。

构建问题

如果您在构建过程中遇到“文件 local_image_provider-Swift.h 缺失”的错误，请参阅Stack Overflow 中的相关解决方案。这个问题可能是由于混合使用了Swift插件与未使用Swift选项构建的Flutter项目。至少有一个用户通过在Podfile中添加 use_frameworks! 解决了这个问题。这看起来像这样：

...
target 'Runner' do
  use_frameworks!
...

示例代码

以下是完整的示例代码，展示了如何使用 local_image_provider 插件来加载本地图片：

import 'package:flutter/material.dart';
import 'package:local_image_provider_example/local_image_body_widget.dart';

void main() => runApp(ExampleApp());

/// 一个简单的应用程序，展示 local_image_provider 插件的功能。
///
/// 查看 [LocalImageBodyWidget] 获取示例应用程序的主要部分。
class ExampleApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: LocalImageBodyWidget(),
    );
  }
}