iOS
AWS SDK

Загрузите изображение или видео на S3 с помощью AWS SDK

Прежде чем начать с примера, я бы рекомендовал создать Singleton с членом класса делегата, чтобы вы могли использовать прецедент загрузки файла в фоновом режиме и позволить пользователю продолжать использовать ваше приложение, пока файлы загружаются, даже когда приложение это фон.

Начнем с того, что мы должны создать перечисление, представляющее конфигурацию S3:

enum S3Configuration : String
{
    case IDENTITY_POOL_ID   = "YourIdentityPoolId"
    case BUCKET_NAME        = "YourBucketName"
    case CALLBACK_KEY       = "YourCustomStringForCallBackWhenUploadingInTheBackground"
    case CONTENT_TYPE_IMAGE = "image/png"
    case CONTENT_TYPE_VIDEO = "video/mp4"
}

Теперь мы должны установить учетные данные при первом запуске приложения, поэтому мы должны установить их внутри AppDelegate по методу didFinishLaunchingWithOptions (обратите внимание, что вы должны установить свой регион в параметре regionType ):

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool
{
  let credentialProvider = AWSCognitoCredentialsProvider(regionType: .EUWest1, identityPoolId: S3Configuration.IDENTITY_POOL_ID.rawValue)
  let configuration = AWSServiceConfiguration(region: .EUWest1, credentialsProvider: credentialProvider)
  AWSS3TransferUtility.registerS3TransferUtilityWithConfiguration(configuration, forKey: S3Configuration.CALLBACK_KEY.rawValue)
}

Поскольку мы уже находимся в AppDelegate, мы должны реализовать обратный вызов фона, который обрабатывается с помощью SDK AWS:

func application(application: UIApplication, handleEventsForBackgroundURLSession identifier: String, completionHandler: () -> Void)
{
    //  Will print the identifer you have set at the enum: .CALLBACK_KEY
    print("Identifier: " + identifier)
    //  Stores the completion handler.
    AWSS3TransferUtility.interceptApplication(application,
                                              handleEventsForBackgroundURLSession: identifier,
                                              completionHandler: completionHandler)
}

Теперь, когда пользователь переместит приложение на задний план, ваша загрузка продолжит фактическую загрузку.

Чтобы загрузить файл с помощью AWS SDK, нам придется записать файл на устройство и предоставить SDK реальный путь. Для примера предположим, что у нас есть UIImage (возможно, видео тоже ..), и мы напишем его в временную папку:

// Some image....
let image = UIImage()
let fileURL = NSURL(fileURLWithPath: NSTemporaryDirectory()).URLByAppendingPathComponent(fileName)
let filePath = fileURL.path!
let imageData = UIImageJPEGRepresentation(image, 1.0)
imageData!.writeToFile(filePath, atomically: true)

FileURL и имя_файла будут использоваться для фактической загрузки позже.

Есть два закрытия, которые нам нужно будет определить, которые предоставляются AWS SDK,

1. AWSS3TransferUtilityUploadCompletionHandlerBlock - закрытие, которое уведомляет о завершении загрузки (или нет)
2. AWSS3TransferUtilityUploadProgressBlock - закрытие, которое уведомляет каждый отправленный байт

Если вы планируете использовать Singleton, вы должны определить эти типы в качестве членов класса. Реализация должна выглядеть так:

var completionHandler : AWSS3TransferUtilityUploadCompletionHandlerBlock? =
    { (task, error) -> Void in

        if ((error) != nil)
        {
          print("Upload failed")
        }
        else
        {
          print("File uploaded successfully")
        }
    }

var progressBlock : AWSS3TransferUtilityUploadProgressBlock? = 
    { [unowned self] (task, bytesSent:Int64, totalBytesSent:Int64,  totalBytesExpectedToSend:Int64) -> Void in

     let progressInPercentage = Float(Double(totalBytesSent) / Double(totalBytesExpectedToSend)) * 100
     print(progressInPercentage)
    }

ПРИМЕЧАНИЕ. Если вы используете Singleton, вы можете определить делегата, который будет отчитываться о достигнутом прогрессе или когда файл будет выполнен. Если вы не используете Singleton, вы можете создать статический метод, который будет иметь соответствующие типы:

    static func uploadImageToS3(fileURL : NSURL,
                               fileName : String,
                progressFunctionUpdater : Float -> Void,
                            resultBlock : (NSError?) -> Void)
{
 //    Actual implementation .....
 //    ...
 //    ...
}

1. progressFunctionUpdater - отчитается о функции с прогрессом.
2. resultBlock - если вы возвращаете nil, тогда загрузка была еще успешной, вы отправляете объект ошибки

Дамы и господа, фактическая загрузка:

        let fileData = NSData(contentsOfFile: fileURL.relativePath!)

        let expression = AWSS3TransferUtilityUploadExpression()
        expression.uploadProgress = progressBlock
        
        let transferUtility = AWSS3TransferUtility.S3TransferUtilityForKey(S3Configuration.CALLBACK_KEY.rawValue)
        
        transferUtility?.uploadData(fileData!,
            bucket: S3Configuration.BUCKET_NAME.rawValue,
            key: fileName,
            contentType: S3Configuration.CONTENT_TYPE_IMAGE.rawData,
            expression: expression,
            completionHander: completionHandler).continueWithBlock
            { (task : AWSTask) -> AnyObject? in
                
                if let error = task.error
                {
                    print(error)
                }
                if let exception = task.exception
                {
                    print("Exception: " + exception.description)
                }
                if let uploadTask = task.result as? AWSS3TransferUtilityUploadTask
                {
                    print("Upload started...")
                }
                
                return nil
        }

Счастливая загрузка S3 :)