SDWebImage v5.0.0 Release Notes

Release Date: 2019-04-02 // almost 5 years ago
  • ๐Ÿš€ See all tickets marked for the 5.0.0 release

    ๐Ÿ”‹ Features

    Animated Image

    • Introduce SDAnimatedImageView and SDAnimatedImage for full stack solution of animated images.
    • ๐Ÿ‘Œ Supports custom coders for nearly every animated image format.
    • ๐Ÿ‘Œ Supports progressive loading for animated images.
    • ๐ŸŽ iOS/tvOS/macOS cross-platform support.

    Transformer

    • Using transformer to apply image processing after image was loaded.
    • Built-in transformer for common usage: Rounded Corner, Resize, Crop, Flip, Rotate, Tint Color, Blur Effect, Core Image Filter...
    • Convenient category methods for UIImage/NSImage

    Custom Loader

    • Using SDImageLoader protocol to implements your own image loader.
    • Not limited on HTTP, you can even using SDWebImage with PhotoKit and third-party SDKs.
    • ๐Ÿ‘Œ Supports multiple loaders at the same time when using SDImageLoadersManager.

    Custom Cache

    • Using SDImageCache protocol to implement your own image cache.
    • Standalone disk cache and memory cache class for advanced usage and customization.
    • ๐Ÿ‘Œ Supports multiple caches at the same time when using SDImageCachesManager.

    Indicator

    • ๐Ÿ‘‰ Use indicator to provide a loading view, customizable.
    • Built-in Activity Indicator and Progress Indicator.
    • ๐ŸŽ iOS/tvOS/macOS cross-platform support.

    ๐Ÿ”Œ Plugins

    ๐Ÿ‘Œ Improvements

    Swift

    • ๐Ÿ‘ Better Swift support with some manual renaming APIs.
    • Full nullability annotation.
    • Using class property for shared instance.
    • Using NS_TYPED_ENUM and NS_STRING_ENUM for better generated APIs.

    API

    • Using context option to control detail behavior for each image request beyond the limit of enums.
    • Using prefetcher to manage token (list of URL requests) to avoid conflict.
    • ๐Ÿ‘‰ Use request modifier to modify constructed URLRequest.

    Project

    • ๐Ÿ‘Œ Supports the latest Xcode 10.
    • ๐Ÿ‘Œ Supports iOS 8.0+/tvOS 9.0+/watchOS 2.0+/macOS 10.10+.
    • ๐Ÿšš MapKit support for Carthage moved the standalone SDWebImageMapKit target.
    • Using module map and umbrella headers.

    Migration

    Check 5.0 migration guide for the migration from 4.x to 5.x.