SDWebImageFLPlugin 0.6.0

SDWebImageFLPlugin 0.6.0

Maintained by DreamPiggy, Bogdan Poplauschi.

Depends on:
SDWebImage/Core~> 5.10
FLAnimatedImage>= 1.0.11

  • By
  • DreamPiggy


CI Status Version License Platform SwiftPM compatible Carthage compatible codecov

Starting with the SDWebImage 5.0 version, we move the FLAnimatedImage support code from the Core Repo to this stand-alone repo.

Code which previously use FLAnimatedImage with SDWebImage can continue to work with this plugin. But it's recommended to use the 5.0 Animated Image Solution to get better support and more features.

What's for

SDWebImageFLPlugin is a plugin for SDWebImage framework, which provide the image loading support for FLAnimatedImage animated GIF engine.

By using SDWebImageFLPlugin, you can use all you familiar SDWebImage's loading method, on the FLAnimatedImageView, which is the base component of FLAnimatedImage.

To use it, simply make sure you use FLAnimatedImageView instead of UIImageView and import this plugin.


To load images from network, just simply call the View Category method like normal UIImageView.

  • Objective-C
FLAnimatedImageView *imageView;
[imageView sd_setImageWithURL:[NSURL URLWithString:@""]];
  • Swift
let imageView: FLAnimatedImageView
imageView.sd_setImage(with: URL(string: ""))

The magic because we create one custom animation class called SDFLAnimatedImage to load GIF images, and use UIImage for normal images.

For placeholder, you can even provide a FLAnimatedImage to allow GIF placeholder on FLAnimatedImageView using the wrapper class SDFLAnimatedImage.

  • Objective-C
FLAnimatedImageView *imageView;
FLAnimatedImage *animatedImage = [FLAnimatedImage animatedImageWithGIFData:gifData];
SDFLAnimatedImage *placeholder = [[SDFLAnimatedImage alloc] initWithAnimatedImage:animatedImage];
[imageView sd_setImageWithURL:[NSURL URLWithString:@""] placeholderImage:placeholder];
  • Swift
let imageView: FLAnimatedImageView
let animatedImage = FLAnimatedImage(animatedGIFData: gifData)
let placeholder = SDFLAnimatedImage(animatedImage: animatedImage)
imageView.sd_setImage(with: URL(string: ""), placeholderImage: placeholder)


  • iOS 9+
  • Xcode 11+



SDWebImageFLPlugin is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'SDWebImageFLPlugin'


SDWebImageFLPlugin is available through Carthage.

github "SDWebImage/SDWebImageFLPlugin"

Swift Package Manager (Xcode 11+)

SDWebImageFLPlugin is available through Swift Package Manager.

let package = Package(
    dependencies: [
        .package(url: "", from: "0.6.0")


DreamPiggy, [email protected]


SDWebImageFLPlugin is available under the MIT license. See the LICENSE file for more info.