升级Pod后Swift项目找不到AWSS3TransferManager相关类型问题求助

问题原因 #

这个报错是AWS SDK for iOS版本升级导致的接口变更。从2.16.0版本开始，AWS官方正式废弃并移除了AWSS3TransferManager相关的全套API，你用到的AWSS3TransferManagerUploadRequest、AWSS3TransferManagerDownloadRequest两个类型也在被移除的范围内，所以即便导入了import AWSS3也无法找到对应定义。

解决方案 #

有两种可选方案，你可以根据项目需求选择：

方案1：固定旧版本SDK（临时适配，不推荐长期使用）

如果暂时不想修改业务代码，可以在Podfile中固定AWSS3的版本到2.15.x及以下：

pod 'AWSS3', '~> 2.14.0'

修改后执行pod update即可恢复旧接口的可用性。

方案2：迁移到官方推荐的新接口AWSS3TransferUtility（推荐）

新的AWSS3TransferUtility接口原生支持断点续传、进度回调，稳定性比旧接口更高，迁移步骤如下：

1. 修改依赖和导入
   首先更新Podfile，添加AWSS3TransferUtility依赖：

   pod 'AWSS3TransferUtility'
   

   执行pod install后，把原来的import AWSS3替换为：

   import AWSS3
   import AWSS3TransferUtility
   

2. 替换变量定义
   原来的请求存储变量可以替换为新的任务类型：

   // 旧代码
   // var uploadRequests = Array<AWSS3TransferManagerUploadRequest?>()
   // var downloadRequests = Array<AWSS3TransferManagerDownloadRequest?>()
   
   // 新代码
   var uploadTasks: [AWSS3TransferUtilityUploadTask?] = []
   var downloadTasks: [AWSS3TransferUtilityDownloadTask?] = []
   var downloadFileURLs = Array<URL?>()
   var uploadFileURLs = Array<URL?>()
   

3. 替换下载逻辑
   新接口不需要提前创建Request实例，直接调用AWSS3TransferUtility的方法生成任务即可，对应的listObjects、下载控制逻辑替换如下：

   func listObjects() {
       let s3 = AWSS3.default()
       guard let listObjectsRequest = AWSS3ListObjectsRequest() else { return }
       listObjectsRequest.bucket = "dice-ios"
       s3.listObjects(listObjectsRequest).continueWith { task in
           if let error = task.error {
               print("listObjects failed: [\(error)]")
               return nil
           }
           guard let listObjectsOutput = task.result,
                 let contents = listObjectsOutput.contents else {
               return nil
           }
           
           let transferUtility = AWSS3TransferUtility.default()
           for s3Object in contents {
               guard let key = s3Object.key else { continue }
               let downloadingFileURL = URL(fileURLWithPath: NSTemporaryDirectory())
                   .appendingPathComponent("download")
                   .appendingPathComponent(key)
               let downloadingFilePath = downloadingFileURL.path
               
               if FileManager.default.fileExists(atPath: downloadingFilePath) {
                   self.downloadTasks.append(nil)
                   self.downloadFileURLs.append(downloadingFileURL)
               } else {
                   // 创建下载任务
                   transferUtility.download(
                       to: downloadingFileURL,
                       bucket: "dice-ios",
                       key: key,
                       expression: nil,
                       completionHandler: { _, url, _, error in
                           if let error = error {
                               print("download failed: [\(error)]")
                               return
                           }
                           DispatchQueue.main.async {
                               print("downloaded file url: \(downloadingFileURL)")
                               // 原有列表刷新逻辑可以在这里实现
                           }
                       }
                   ).continueWith { createTask in
                       if let downloadTask = createTask.result {
                           self.downloadTasks.append(downloadTask)
                           self.downloadFileURLs.append(nil)
                       } else if let error = createTask.error {
                           print("创建下载任务失败: \(error)")
                           self.downloadTasks.append(nil)
                       }
                       return nil
                   }
               }
           }
           
           DispatchQueue.main.async {
               // 原有列表刷新逻辑
           }
           return nil
       }
   }
   
   func resumeDownload(task: AWSS3TransferUtilityDownloadTask) {
       switch task.status {
       case .paused, .notStarted:
           task.resume()
       case .running:
           print("下载正在进行中")
       case .completed:
           print("下载已完成")
       case .canceled, .unknown:
           print("下载状态异常")
       @unknown default:
           break
       }
   }
   
   func downloadAll() {
       downloadTasks.forEach { task in
           guard let task = task, 
                 task.status == .notStarted || task.status == .paused else {
               return
           }
           task.resume()
       }
   }
   

4. 上传逻辑对应替换示例
   上传也采用类似的调用方式：

   func uploadFile(localURL: URL, bucket: String, key: String) {
       AWSS3TransferUtility.default().uploadFile(
           localURL,
           bucket: bucket,
           key: key,
           contentType: "application/octet-stream",
           expression: nil,
           completionHandler: { _, error in
               if let error = error {
                   print("上传失败: \(error)")
                   return
               }
               print("上传成功")
           }
       ).continueWith { createTask in
           if let uploadTask = createTask.result {
               self.uploadTasks.append(uploadTask)
           }
           return nil
       }
   }
   

内容的提问来源于stack exchange，提问作者Muju