一. 最简单的保存函数

1. UIImage的函数来保存图片

   • 较为简单, 只需要一个函数一个方法就可以保存

   • 但是不能创建相册, 保存的图片会直接保存到默认的系统相册中

       /** 该函数用于将图片保存到系统相册中
         UIImage * _Nonnull image : 要保存的图片
         id  _Nullable completionTarget : 调用completionSelector方法的对象, 一般为self
         SEL  _Nullable completionSelector : 当保存完成调用的方法, 是一个系统指定的方法
         void * _Nullable contextInfo : 上下文信息, 用于传给完成后的回调方法, 一般为nil
       */
       UIImageWriteToSavedPhotosAlbum(_image, self, @selector(image:didFinishSavingWithError:contextInfo:), nil);
       
       - (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {
           
           if (error) {
               NSLog(@"保存失败");
           } else {
               NSLog(@"保存成功");
           }
       }
     

   • 注意点

     1. 第三个参数一定要使用系统的回调方法, 否则这个方法会报错
     2. 系统指定的image: didFinishSavingWithError: contextInfo:方法一定要实现, 否则也会出现问题

二. 使用PHPhotoLibrary来保存图片

1. 框架的简单介绍:

   1. PHPhotoLibrary类, 专门用于管理系统的相片, 相簿等功能, 他可以获取系统相册中的相片信息, 也可以将App中获取的图片/相片存到手机相册中, 以及iCloud Photos中.
   2. 对于手机相册的各种操作, 几乎都是通过PHPhotoLibrary的单例对象, 在ChangeBlock中, 以ChangeRequest来执行的
      • 相片请求操作: PHAssetChangeRequest
      • 相册请求操作: PHAssetCollectionChangeRequest
      • 相册列表请求操作: PHCollectionListChangeRequest(小的暂时没试过)
   3. PHObjectPlaceholder对象
      • 这个对象是用于存储图片时的占位对象
      • 如果你想保存一个图片到一个相册中, 需要先将这个占位对象添加到相册中, 当ChangeBlock调用结束之后, 会根据占位对象的标识符搜索到占位对象的所在位置, 然后在保存图片
   4. PHAuthorization: 用于查看当前App的相册授权状态
      • 这个类用于获取当前你的App, 系统对其相册访问权限的授权状态
      • 通过对四种不同的授权状态的判断, 我们可以做出对应的操作
        • PHAuthorizationStatusNotDetermined : 用户还没有决定是否授权
        • PHAuthorizationStatusRestricted : 访问权限受限制, 这个很少见, 如家长模式的限制才会有
        • PHAuthorizationStatusDenied : 用户拒绝App访问相册
        • PHAuthorizationStatusAuthorized : 用户已经授权了访问
   5. PHFetchResult: 检索相簿中的相册/相片
      • 这个类创建的对象, 是一个有序集合, 可以用于保存系统相簿中的相片/相册的搜索结果列表
      • 该对象的每个元素, 都有一个localizedTitle, 即搜索得到的相片/相册的名称, 可以通过这个属性来获得指定的相册/相片
      • 一般是通过遍历的方式, 然后判断localizedTitle, 取得我们想要的相片/相册

2. 保存图片的步骤

   1. 提供给外界调用的方法, 通过传入要保存的图片, 和指定的相册名称来保存一张图片

      • 在这个方法中, 要获取当前App的相册授权状态

      • 如果用户授权了, 就直接调用步骤2的方法, 保存图片

      • 如果用户没有确定是否授权, 要创建授权申请, 让用户选择

      • 如果用户已经拒绝了授权, 要显示一个指示框, 让用户去打开授权

          + (void)saveImage:(UIImage *)image assetCollectionName:(NSString *)collectionName {
              
              // 1. 获取当前App的相册授权状态
              PHAuthorizationStatus authorizationStatus = [PHPhotoLibrary authorizationStatus];
              
              // 2. 判断授权状态
              if (authorizationStatus == PHAuthorizationStatusAuthorized) {
                  
                  // 2.1 如果已经授权, 保存图片(调用步骤2的方法)
                  [self saveImage:image toCollectionWithName:collectionName];
                  
              } else if (authorizationStatus == PHAuthorizationStatusNotDetermined) { // 如果没决定, 弹出指示框, 让用户选择
                  
                  [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
                      
                      // 如果用户选择授权, 则保存图片
                      if (status == PHAuthorizationStatusAuthorized) {
                          [self saveImage:image toCollectionWithName:collectionName];
                      }
                  }];
                  
              } else {
                  
                  [SVProgressHUD showWithStatus:@"请在设置界面, 授权访问相册"];
              }
          }
        

   2. 用于保存图片的方法, 通过外接接口获取到的图片, 相册名称来进行保存

      • 将一个相片保存到一个自定义的相册, 需要同时创建相片变动请求和相册变动请求

      • 根据传入的相册名, 要判断一下当前系统是否有这个相册(这里需要步骤3的方法, 传入相册名称, 来获取相册)

      • 在这个步骤, 需要用到的四个核心对象为PHPhotoLibrary, PHAssetCollectionChangeRequest, PHAssetChangeRequest, 以及PHObjectPlaceholder

          // 保存图片
          + (void)saveImage:(UIImage *)image toCollectionWithName:(NSString *)collectionName {
              
              // 1. 获取相片库对象
              PHPhotoLibrary *library = [PHPhotoLibrary sharedPhotoLibrary];
              
              // 2. 调用changeBlock
              [library performChanges:^{
                  
                  // 2.1 创建一个相册变动请求
                  PHAssetCollectionChangeRequest *collectionRequest;
                  
                  // 2.2 取出指定名称的相册
                  PHAssetCollection *assetCollection = [self getCurrentPhotoCollectionWithTitle:collectionName];
                  
                  // 2.3 判断相册是否存在
                  if (assetCollection) { // 如果存在就使用当前的相册创建相册请求
                      collectionRequest = [PHAssetCollectionChangeRequest changeRequestForAssetCollection:assetCollection];
                  } else { // 如果不存在, 就创建一个新的相册请求
                      collectionRequest = [PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:collectionName];
                  }
                  
                  // 2.4 根据传入的相片, 创建相片变动请求
                  PHAssetChangeRequest *assetRequest = [PHAssetChangeRequest creationRequestForAssetFromImage:image];
                  
                  // 2.4 创建一个占位对象
                  PHObjectPlaceholder *placeholder = [assetRequest placeholderForCreatedAsset];
                  
                  // 2.5 将占位对象添加到相册请求中
                  [collectionRequest addAssets:@[placeholder]];
                  
              } completionHandler:^(BOOL success, NSError * _Nullable error) {
                  
                  // 3. 判断是否出错, 如果报错, 声明保存不成功
                  if (error) {
                      [SVProgressHUD showErrorWithStatus:@"保存失败"];
                  } else {
                      [SVProgressHUD showSuccessWithStatus:@"保存成功"];
                  }
              }];
          }
        

   3. 步骤三用于获取当前系统中是否有指定的相册

      • 如果有的话, 就返回已有相册

      • 如果没有的话, 就返回nil, 让步骤二去创建一个新的系统相册

      • 此处需要用到的关键类为: FHFetchResult, 用于搜索相册/相片名称的集合对象

      • 通过搜索结果的localizedTitle来找到对应的相册

          + (PHAssetCollection *)getCurrentPhotoCollectionWithTitle:(NSString *)collectionName {
              
              // 1. 创建搜索集合
              PHFetchResult *result = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
              
              // 2. 遍历搜索集合并取出对应的相册
              for (PHAssetCollection *assetCollection in result) {
                  
                  if ([assetCollection.localizedTitle containsString:collectionName]) {
                      return assetCollection;
                  }
              }
              
              return nil;
          }