Built a FLAnimatedImageView category that hooks this class to the SDWebImage sys…

…tem. It's very similar to UIImageView (WebCache). There are explicit methods for loading an animated image.

+/*
+ * This file is part of the SDWebImage package.
+ * (c) Olivier Poitrey <rs@dailymotion.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+
+#if COCOAPODS
+    @import FLAnimatedImage;
+#else
+    #import "FLAnimatedImageView.h"
+#endif
+
+#import "SDWebImageManager.h"
+
+
+/**
+ *  A category for the FLAnimatedImage imageView class that hooks it to the SDWebImage system.
+ *  Very similar to the base class category (UIImageView (WebCache))
+ */
+@interface FLAnimatedImageView (WebCache)
+
+/**
+ * Get the current image URL.
+ *
+ * Note that because of the limitations of categories this property can get out of sync
+ * if you use setImage: directly.
+ */
+- (NSURL *)sd_imageURL;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ *
+ * @param url The url for the image.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ * Uses a placeholder until the request finishes.
+ *
+ * @param url         The url for the image.
+ * @param placeholder The image to be set initially, until the image request finishes.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ * Uses a placeholder until the request finishes.
+ *
+ *  @param url         The url for the image.
+ *  @param placeholder The image to be set initially, until the image request finishes.
+ *  @param options     The options to use when downloading the image. @see SDWebImageOptions for the possible values.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ *
+ *  @param url            The url for the image.
+ *  @param completedBlock A block called when operation has been completed. This block has no return value
+ *                        and takes the requested UIImage as first parameter. In case of error the image parameter
+ *                        is nil and the second parameter may contain an NSError. The third parameter is a Boolean
+ *                        indicating if the image was retrieved from the local cache or from the network.
+ *                        The fourth parameter is the original image url.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url completed:(SDExternalCompletionBlock)completedBlock;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ * Uses a placeholder until the request finishes.
+ *
+ *  @param url            The url for the image.
+ *  @param placeholder    The image to be set initially, until the image request finishes.
+ *  @param completedBlock A block called when operation has been completed. This block has no return value
+ *                        and takes the requested UIImage as first parameter. In case of error the image parameter
+ *                        is nil and the second parameter may contain an NSError. The third parameter is a Boolean
+ *                        indicating if the image was retrieved from the local cache or from the network.
+ *                        The fourth parameter is the original image url.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDExternalCompletionBlock)completedBlock;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ * Uses a placeholder until the request finishes.
+ *
+ *  @param url            The url for the image.
+ *  @param placeholder    The image to be set initially, until the image request finishes.
+ *  @param options        The options to use when downloading the image. @see SDWebImageOptions for the possible values.
+ *  @param completedBlock A block called when operation has been completed. This block has no return value
+ *                        and takes the requested UIImage as first parameter. In case of error the image parameter
+ *                        is nil and the second parameter may contain an NSError. The third parameter is a Boolean
+ *                        indicating if the image was retrieved from the local cache or from the network.
+ *                        The fourth parameter is the original image url.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDExternalCompletionBlock)completedBlock;
+
+/**
+ * Load the image at the given url (either from cache or download) and load it in this imageView. It works with both static and dynamic images
+ * The download is asynchronous and cached.
+ * Uses a placeholder until the request finishes.
+ *
+ *  @param url            The url for the image.
+ *  @param placeholder    The image to be set initially, until the image request finishes.
+ *  @param options        The options to use when downloading the image. @see SDWebImageOptions for the possible values.
+ *  @param progressBlock  A block called while image is downloading
+ *  @param completedBlock A block called when operation has been completed. This block has no return value
+ *                        and takes the requested UIImage as first parameter. In case of error the image parameter
+ *                        is nil and the second parameter may contain an NSError. The third parameter is a Boolean
+ *                        indicating if the image was retrieved from the local cache or from the network.
+ *                        The fourth parameter is the original image url.
+ */
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDExternalCompletionBlock)completedBlock;
+
+/**
+ * Cancel the image load
+ */
+- (void)sd_cancelCurrentAnimatedImageLoad;
+
+@end

+/*
+ * This file is part of the SDWebImage package.
+ * (c) Olivier Poitrey <rs@dailymotion.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+
+#import "FLAnimatedImageView+WebCache.h"
+#import "objc/runtime.h"
+#import "UIView+WebCacheOperation.h"
+#import "NSData+ImageContentType.h"
+#import "FLAnimatedImage.h"
+#import "UIImageView+WebCache.h"
+
+static char imageURLKey;
+
+
+@implementation FLAnimatedImageView (WebCache)
+
+- (NSURL *)sd_imageURL {
+    return objc_getAssociatedObject(self, &imageURLKey);
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:nil options:0 progress:nil completed:nil];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:placeholder options:0 progress:nil completed:nil];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:placeholder options:options progress:nil completed:nil];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url completed:(SDExternalCompletionBlock)completedBlock {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:nil options:0 progress:nil completed:completedBlock];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder completed:(SDExternalCompletionBlock)completedBlock {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:placeholder options:0 progress:nil completed:completedBlock];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options completed:(SDExternalCompletionBlock)completedBlock {
+    [self sd_setAnimatedImageWithURL:url placeholderImage:placeholder options:options progress:nil completed:completedBlock];
+}
+
+- (void)sd_setAnimatedImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDExternalCompletionBlock)completedBlock {
+    [self sd_cancelCurrentAnimatedImageLoad];
+    objc_setAssociatedObject(self, &imageURLKey, url, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+
+    if (!(options & SDWebImageDelayPlaceholder)) {
+        dispatch_main_async_safe(^{
+            self.image = placeholder;
+        });
+    }
+    
+    if (url) {
+        // check if activityView is enabled or not
+        if ([self showActivityIndicatorView]) {
+            [self addActivityIndicator];
+        }
+        
+        __weak __typeof(self)wself = self;
+        id <SDWebImageOperation> operation = [SDWebImageManager.sharedManager loadImageWithURL:url options:options progress:progressBlock completed:^(UIImage *image, NSData *data, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
+            if (!wself) return;
+            dispatch_main_sync_safe(^{
+                [wself removeActivityIndicator];
+                
+                if (!wself) return;
+                if (image && (options & SDWebImageAvoidAutoSetImage) && completedBlock) {
+                    completedBlock(image, error, cacheType, url);
+                    return;
+                } else if (image) {
+                    NSString *imageContentType = [NSData sd_contentTypeForImageData:data];
+                    if ([imageContentType isEqualToString:@"image/gif"]) {
+                        wself.animatedImage = [FLAnimatedImage animatedImageWithGIFData:data];
+                        wself.image = nil;
+                    } else {
+                        wself.image = image;
+                        wself.animatedImage = nil;
+                    }
+                    [wself setNeedsLayout];
+                } else {
+                    if ((options & SDWebImageDelayPlaceholder)) {
+                        wself.image = placeholder;
+                        [wself setNeedsLayout];
+                    }
+                }
+                if (completedBlock && finished) {
+                    completedBlock(image, error, cacheType, url);
+                }
+            });
+        }];
+        [self sd_setImageLoadOperation:operation forKey:@"UIImageViewAnimatedImageLoad"];
+    } else {
+        dispatch_main_async_safe(^{
+            [self removeActivityIndicator];
+            
+            if (completedBlock) {
+                NSError *error = [NSError errorWithDomain:SDWebImageErrorDomain code:-1 userInfo:@{NSLocalizedDescriptionKey : @"Trying to load a nil url"}];
+                completedBlock(nil, error, SDImageCacheTypeNone, url);
+            }
+        });
+    }
+}
+
+- (void)sd_cancelCurrentAnimatedImageLoad {
+    [self sd_cancelImageLoadOperationWithKey:@"UIImageViewAnimatedImageLoad"];
+}
+
+
+@end