QBImagePicker 使用教程

1. 项目介绍

QBImagePicker 是一个用于 iOS 的开源库，它扩展了 UIImagePickerController 类，支持多选图像和视频。QBImagePicker 提供了类似于系统内置图像选择器的用户界面，并且具有快速、内存高效的特点。它支持多种自定义选项，如网格大小、导航消息等，适用于 iPhone 和 iPad。

2. 项目快速启动

2.1 安装

使用 CocoaPods 安装

在 Podfile 文件中添加以下内容：

pod 'QBImagePickerController'

然后在终端中运行：

pod install

手动安装

将 QBImagePicker 文件夹拖拽到你的项目中，并在需要使用的类中引入头文件：

#import "QBImagePickerController.h"

2.2 基本使用

在需要使用 QBImagePicker 的类中，实现 QBImagePickerControllerDelegate 协议，并创建 QBImagePickerController 实例：

#import "QBImagePickerController.h"

@interface ViewController () <QBImagePickerControllerDelegate>
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    QBImagePickerController *imagePickerController = [QBImagePickerController new];
    imagePickerController.delegate = self;
    imagePickerController.allowsMultipleSelection = YES;
    imagePickerController.maximumNumberOfSelection = 6;
    imagePickerController.showsNumberOfSelectedAssets = YES;
    
    [self presentViewController:imagePickerController animated:YES completion:NULL];
}

#pragma mark - QBImagePickerControllerDelegate

- (void)qb_imagePickerController:(QBImagePickerController *)imagePickerController didFinishPickingAssets:(NSArray *)assets {
    for (PHAsset *asset in assets) {
        // 处理选中的资源
    }
    [self dismissViewControllerAnimated:YES completion:NULL];
}

- (void)qb_imagePickerControllerDidCancel:(QBImagePickerController *)imagePickerController {
    [self dismissViewControllerAnimated:YES completion:NULL];
}

@end

3. 应用案例和最佳实践

3.1 多选图像

在社交应用中，用户可能需要一次性选择多张照片进行上传。使用 QBImagePicker 可以轻松实现这一功能：

QBImagePickerController *imagePickerController = [QBImagePickerController new];
imagePickerController.delegate = self;
imagePickerController.allowsMultipleSelection = YES;
imagePickerController.maximumNumberOfSelection = 10;
[self presentViewController:imagePickerController animated:YES completion:NULL];

3.2 自定义相册显示

有时你可能只想显示特定的相册，例如只显示“相机胶卷”和“全景图”：

imagePickerController.assetCollectionSubtypes = @[
    @(PHAssetCollectionSubtypeSmartAlbumUserLibrary), // 相机胶卷
    @(PHAssetCollectionSubtypeSmartAlbumPanoramas)    // 全景图
];

4. 典型生态项目

4.1 与 react-native-image-crop-picker 集成

react-native-image-crop-picker 是一个用于 React Native 的图像选择和裁剪库，它支持 iOS 和 Android。在 iOS 端，它使用了 QBImagePicker 来实现多选图像的功能。

4.2 与 PhotoKit 集成

QBImagePicker 完全支持 PhotoKit，可以与 iOS 的 PhotoKit 框架无缝集成，提供高效的图像和视频选择功能。

通过以上步骤，你可以快速上手并使用 QBImagePicker 来增强你的 iOS 应用的图像选择功能。