FMPhotoPicker 使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00057/article/details/139018211

FMPhotoPicker 使用指南

FMPhotoPicker A modern, simple and zero-dependency photo picker with an elegant and customizable image editor 项目地址: https://gitcode.com/gh_mirrors/fm/FMPhotoPicker

1. 目录结构及介绍

FMPhotoPicker 是一个现代、简单且零依赖的照片选择器，它带有优雅且可定制化的图像编辑功能。下面是其基本的目录结构概览：

FMPhotoPicker/
├── FMPhotoPicker               # 核心源代码文件夹
│   ├── FMPhotoPicker.swift     # 主要逻辑实现
├── FMPhotoPickerExample        # 示例应用
│   ├── ViewController.swift    # 示例中的主要视图控制器
├── FMPhotoPicker.podspec       # CocoaPods 配置文件
├── LICENSE                     # 许可证文件
├── README.md                   # 项目说明文件
├── chglog                      # 更新日志
├── github                      # 可能是指向GitHub的相关资源或说明
├── gitignore                   # 忽略文件列表
├── resources                    # 包含额外资源如图标、图片等
│   └── ...                     # 资源文件
└── ...                          # 其他可能的配置或支持文件

FMPhotoPicker 文件夹包含了核心的相册选择与编辑逻辑。
FMPhotoPickerExample 是用于展示如何使用该库的应用示例。
FMPhotoPicker.podspec 专为CocoaPods用户准备的规格文件。
LICENSE 明确了软件使用的MIT许可证。
README.md 提供了项目快速入门和详细信息。

2. 项目的启动文件介绍

主要入口：在示例应用 (FMPhotoPickerExample) 中，ViewController.swift 往往是启动时加载的第一个文件，它演示了如何初始化并呈现FMPhotoPickerViewController来让用户进行照片选择。

初始化 FMPhotoPicker:

var config = FMPhotoPickerConfig()
let picker = FMPhotoPickerViewController(config: config)
picker.delegate = self
present(picker, animated: true)

这段代码展示了基本的使用流程，通过创建配置对象初始化选择器，并设置代理。

3. 项目的配置文件介绍

配置类 FMPhotoPickerConfig: 本项目的核心配置位于每次实例化FMPhotoPickerViewController前定义的FMPhotoPickerConfig对象中。
- 关键参数:
  - mediaTypes: 控制访问的媒体类型（图片、视频）。
  - selectMode: 单选或多选模式。
  - maxImage, maxVideo: 最多可选的图片和视频数量。
  - availableFilters, availableCrops: 编辑器中可用的滤镜和裁剪选项。
  - forceCropEnabled: 强制裁剪模式。
  - 更多配置项允许高度定制用户界面和行为。
- 自定义配置示例:
```
let config = FMPhotoPickerConfig(
  mediaTypes: [.image],
  selectMode: .single,
  maxImage: 5,
  availableFilters: [...], // 自定义或使用默认
  availableCrops: [...],   // 同上
  ...
)
```