phoenix_gallery 是一个用于在 Flutter 应用中管理图片画廊的插件。它允许用户从设备的相册中选择多张图片，并在应用中显示这些图片。以下是如何使用 phoenix_gallery 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 phoenix_gallery 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  phoenix_gallery: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 导入包

在你的 Dart 文件中导入 phoenix_gallery 包：

import 'package:phoenix_gallery/phoenix_gallery.dart';

3. 请求权限

在 Android 和 iOS 上，访问相册需要相应的权限。你可以使用 permission_handler 插件来请求权限。

import 'package:permission_handler/permission_handler.dart';

Future<void> requestPermissions() async {
  if (await Permission.photos.request().isGranted) {
    // 权限已授予
  } else {
    // 权限被拒绝
  }
}

4. 打开图片选择器

使用 PhoenixGallery.pickImages 方法来打开图片选择器，并允许用户选择多张图片。

Future<void> pickImages() async {
  List<AssetEntity>? selectedImages = await PhoenixGallery.pickImages(
    maxImages: 10, // 最多选择10张图片
    enableCamera: true, // 是否允许拍照
  );

  if (selectedImages != null) {
    // 处理选中的图片
    for (var image in selectedImages) {
      // 例如，显示图片
      var file = await image.file;
      if (file != null) {
        // 使用 file 对象
      }
    }
  }
}

5. 显示选中的图片

你可以使用 Image.file 或 Image.memory 来显示选中的图片。

Widget buildImageGrid(List<File> imageFiles) {
  return GridView.builder(
    gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
      crossAxisCount: 3,
    ),
    itemCount: imageFiles.length,
    itemBuilder: (context, index) {
      return Image.file(
        imageFiles[index],
        fit: BoxFit.cover,
      );
    },
  );
}

6. 完整示例

以下是一个完整的示例，展示了如何使用 phoenix_gallery 插件来选择并显示图片：

import 'package:flutter/material.dart';
import 'package:phoenix_gallery/phoenix_gallery.dart';
import 'package:permission_handler/permission_handler.dart';
import 'dart:io';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ImageGallery(),
    );
  }
}

class ImageGallery extends StatefulWidget {
  @override
  _ImageGalleryState createState() => _ImageGalleryState();
}

class _ImageGalleryState extends State<ImageGallery> {
  List<File> imageFiles = [];

  Future<void> requestPermissions() async {
    if (await Permission.photos.request().isGranted) {
      // 权限已授予
    } else {
      // 权限被拒绝
    }
  }

  Future<void> pickImages() async {
    List<AssetEntity>? selectedImages = await PhoenixGallery.pickImages(
      maxImages: 10,
      enableCamera: true,
    );

    if (selectedImages != null) {
      for (var image in selectedImages) {
        var file = await image.file;
        if (file != null) {
          setState(() {
            imageFiles.add(file);
          });
        }
      }
    }
  }

  Widget buildImageGrid() {
    return GridView.builder(
      gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
        crossAxisCount: 3,
      ),
      itemCount: imageFiles.length,
      itemBuilder: (context, index) {
        return Image.file(
          imageFiles[index],
          fit: BoxFit.cover,
        );
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Image Gallery'),
        actions: [
          IconButton(
            icon: Icon(Icons.add),
            onPressed: () async {
              await requestPermissions();
              await pickImages();
            },
          ),
        ],
      ),
      body: buildImageGrid(),
    );
  }
}

7. 运行应用

现在你可以运行你的 Flutter 应用，并使用 phoenix_gallery 插件来选择并显示图片。

注意事项

• 在 iOS 上，你需要在 Info.plist 文件中添加相册访问权限的描述：

<key>NSPhotoLibraryUsageDescription</key>
<string>我们需要访问您的相册以选择图片</string>

• 在 Android 上，你需要在 AndroidManifest.xml 文件中添加相册访问权限：

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