Swiftpack.co - SDWebImage/SDWebImageFLPlugin as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by SDWebImage.
SDWebImage/SDWebImageFLPlugin 0.6.0
A SDWebImage plugin to support GIF using FLAnimatedImage and category
⭐️ 25
🕓 1 year ago
.package(url: "https://github.com/SDWebImage/SDWebImageFLPlugin.git", from: "0.6.0")


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:@"http://www.domain.com/path/to/image.gif?raw=true"]];
  • Swift
let imageView: FLAnimatedImageView
imageView.sd_setImage(with: URL(string: "http://www.domain.com/path/to/image.gif?raw=true"))

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:@"http://www.domain.com/path/to/image.gif?raw=true"] placeholderImage:placeholder];
  • Swift
let imageView: FLAnimatedImageView
let animatedImage = FLAnimatedImage(animatedGIFData: gifData)
let placeholder = SDFLAnimatedImage(animatedImage: animatedImage)
imageView.sd_setImage(with: URL(string: "http://www.domain.com/path/to/image.gif?raw=true"), 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: "https://github.com/SDWebImage/SDWebImageFLPlugin.git", from: "0.6.0")


DreamPiggy, [email protected]


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


Stars: 25
Last commit: 1 year ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

0.6.0 - SwiftPM
1 year ago


  • Add SPM support #16

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics