All Versions
Latest Version
Avg Release Cycle
15 days
Latest Release
141 days ago

Changelog History
Page 5

  • v5.0.5

    June 03, 2019


    • ๐Ÿ›  Fix the Static Library target issue of headers, which cause the integrated application failed to Archive because of copied headers #2741
  • v5.0.4

    June 03, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix get button background image operation key bug #2737
    • ๐Ÿ›  Fix that CGImageDestinationCreateWithData 0 count arg will log a warning #2739

    โœ… Tests

    • ๐Ÿ›  Fix the example NSLog issue, and replace the unavailable test image dataset #2740
  • v5.0.3

    May 16, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix SDWebImageDecodeFirstFrameOnly flag is ignored when image loaded from cache #2725
    • ๐Ÿ›  Fix that SDAnimatedImageView initWithImage will skip the initialize logic and crash #2728
    • Replace if judge with MAX() function in scale less than 1 #2710


    • Replace the private prefix header files with the manually import for each implementation files #2723

    โœ… Tests

    • โž• Added many test case to ensure the code behavior and coverage #2711

    ๐Ÿ“š Documentation

    • ๐Ÿ“š Update the documentation coverage for jazzy. Use the correct format to provide class/protocol/type API Documentation #2722
  • v5.0.2

    April 25, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the bug of SDAnimatedImageView on macOS, which can only render SDAnimatedImage but not normal NSImage (including animated image) #2706
    • ๐Ÿ›  Fix that CGImageCreateDecoded:orientation: use the wrong aspect ratio when orientation is left/leftMirrored/right/rightMirrored #2708
    • ๐Ÿ›  Fix one bug of sd_colorAtPoint:, which set the alpha value default to 255 and should be 1. #2708

    ๐Ÿ“š Documentation

    • ๐Ÿ›  Fixes typo in SDImageCacheConfig maxDiskAge info #2699
  • v5.0.1

    April 11, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fixes crash for apng coder when properties are nil #2691
    • ๐Ÿ›  Fix rounded corner bug which leads to image upside down #2673
    • ๐Ÿ›  Fix tint image bug which leads to image upside down #2674


    • ๐Ÿ›  Fix the Travis-CI script about code coverage submit #2676
  • v5.0.0

    April 02, 2019

    ๐Ÿš€ 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.


    • 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.


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

    ๐Ÿ”Œ Plugins

    ๐Ÿ‘Œ Improvements


    • ๐Ÿ‘ 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.


    • 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.


    • ๐Ÿ‘Œ 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.


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

  • v5.0.0-beta6

    March 15, 2019

    ๐Ÿš€ See all tickets marked for the 5.0.0-beta6 release

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the issue that SDWebImagePrefetch in 5.x, will submit all prefetch URLs to manager without any concurrent limit #2631
    • ๐Ÿ›  Fix the current transformer cache key generating rules, try to keep the image file extension #2635


    • ๐Ÿšš Move some internal classes into private header files, make it easy to maintain the code #2634
  • v5.0.0-beta5

    January 31, 2019

    ๐Ÿš€ See all tickets marked for the 5.0.0-beta5 release

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix encoding options does not works #2602
    • โœ‚ Remove unnecessary CGImage check when encode first frame #2609
  • v5.0.0-beta4

    January 26, 2019

    ๐Ÿš€ See all tickets marked for the 5.0.0 release

    ๐Ÿ”‹ Features

    • ๐Ÿ”ฆ Expose the graphics helper method for coder plugin author and fix scale issue #2523

    ๐ŸŽ Performances

    • โฌ‡ Decrease animated decode times when cache enable #2468
    • โœ‚ Remove kCGImageSourceShouldCache option when creating image source #2472
    • โž• Add autoreleasepool to release autorelease objects in advance when using GCD #2474

    ๐Ÿ›  Fixes

    • โž• Add protect when custom animated image class image data is nil during progressive animation check #2466
    • ๐Ÿ›  Fix background download #2500


    • ๐Ÿ”€ Merged targets + MapKit dedicated target for Carthage installs #2476. Carthage user now does not enable MapKit support by default.
    • โฌ†๏ธ Upgrade Xcode 10 + using xcconfig for project settings #2494

    Notable Changes (from beta3)


    • ๐Ÿšš Move webp component (and libwebp dependency) to SDWebImage/SDWebImageWebPCoder #2469. Any user who use WebP in 5.0.0 should add SDWebImageWebPCoder to your Podfile or Cartfile instead.
    • โ™ป๏ธ Refactory cache path about namespace && final cache directory #2535. Now the default disk cache path was moved to suitable path with the namespace.
    • ๐Ÿ‘‰ Use the memory bytes size, instead of pixel size to calculate the memory cost function #2568. Now the memory cost function use bytes size instead of pixels count.

    Swift Only:

    • ๐Ÿ›  Fix the accident changes of Swift API naming for sd_imageDataAsFormat: #2517

    โœ… You can always check 5.0 migration guide for the latest information for these changes.

  • v5.0.0-beta3

    August 30, 2018

    ๐Ÿš€ See all tickets marked for the 5.0.0 release

    ๐Ÿ”‹ Features

    • Minimum progress interval config for SDWebImageDownloader #2415 #2437 1d8454d
    • ๐Ÿ”‹ Feature disk cache migration from 4.x #2417 #2433
    • โž• Add SDImageFormatHEIF represent mif1 && msf1 brands #2423 (imported from 4.4.3)
    • โž• Add default HTTP User-Agent for specific system #2409 (imported from 4.4.3)
    • Replace valueForKey with objectForKey when access NSDictionary #2399
    • ๐Ÿ‘Œ Improved unit tests #2438 #2434
    • โœจ Enhanced contributing guide #2416
    • Adopt all the protocol APIs which contains getter value to use property instead, to make the API easy to use or Swift user #2452
    • โœ‚ Remove sd_setAnimationImagesWithURLs API, because its cause ambiguity, behave not consistently and have rare use case #2459
    • ๐Ÿ‘Œ Improved SDAnimatedImage protocol with initWithData:scale:options: #2453
    • Extra args for SDSetImageBlock (added cacheType and imageURL) #2449

    ๐Ÿ›  Fixes

    • Fix that using NS_TYPED_ENUM on SDImageFormat cause the existing Swift API (sd_UTTypeFromImageFormat) naming changed #2413
    • ๐Ÿ›  Fix that downloader options about image decoding is not correctly set #2414
    • ๐Ÿ‘‰ Make download receive response notification only dispatch to specific observer #2426
    • ๐Ÿ›  Fix a race condition during progressive animation load in SDAnimatedImageView #2435
    • ๐Ÿ›  Fix the bug that SDWebImageContextCacheKeyFilter wrongly be used as cache serializer and cause crash #2451
    • ๐Ÿ›  Fix resource key invalid when clean cached disk file #2462
    • โž• Add no expiration file support of disk cache #2461