All Versions
Latest Version
Avg Release Cycle
33 days
Latest Release
314 days ago

Changelog History
Page 6

  • v5.3.1 Changes

    November 09, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the case even when Animated Image View is not visible, user call startAnimating can still do animation #2888
  • v5.3.0 Changes

    November 06, 2019

    ๐Ÿ”‹ Features

    Animated Image

    • ๐Ÿ”จ Refactoring the SDAnimatedImageView with player backend called SDAnimatedImagePlayer, make it easier for common usage. #2882
    • ๐Ÿ‘€ The player use protocol based implementation, which can be used for many scenarios, like WatchKit, CALayer, or even SwiftUI. See wiki
    • ๐Ÿ‘Œ Supports the control of AnimatedImage View/Player 's play rate #2885
    • ๐Ÿ‘Œ Supports the runloop mode control for macOS. Which can be useful when user want to pause animation when drag the mouse, or presenting modal window #2886

    Data Decryptor

    • Decrypt the encrypted image data after download and just before decoding. #2866
    • ๐Ÿ‘€ Provide a built-in convenience for Base64-encoded image data. See wiki

    Response Modifier

    • Modify the HTTP response after download, paired with request modifier #2866
    • ๐Ÿ‘€ Can be used for custom HTTP header check, mock data, etc. See wiki
  • v5.2.5 Changes

    October 27, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix macOS SDWebImageIndicator center layout issue when indicator was initialized with 0 frame #2875
  • v5.2.4 Changes

    October 27, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the regression issue that SDAnimatedImageView on macOS will change the wrong duration speed when pause and resume again #2873
    • ๐Ÿ›  Fix SDAnimatedImage on macOS use extra animates property check, which is not intuitive and cause extra setup before usage #2874
  • v5.2.3 Changes

    October 09, 2019

    ๐Ÿ›  Fixes

    • โช Revert the change for APNG constants fix for iOS 8 devices which cause crash #2863
  • v5.2.2 Changes

    October 02, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix warnings when deployment target version set to iOS 13+ #2860 #2859
  • v5.2.1 Changes

    October 01, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ‘‰ Make the SDWebImageDownloadToken to not retain the completion block so that user don't need weak-strong dance #2856 #2855

    โœ… Tests

    • โœ… Try to fix the test case test15DownloaderLIFOExecutionOrder #2857
  • v5.2.0 Changes

    September 27, 2019

    ๐Ÿ”‹ Features

    Mac Catalyst

    • ๐ŸŽ Full compatible with Catalyst (UIKit for macOS)
    • ๐Ÿ‘Œ Supports CococaPods and SwiftPM only. Carthage need their own toolchain upgrade in the future
    • ๐Ÿ— Provide the build script to build xcframework contains Mac Catalyst variant, see Installation Guide.

    Image Coder

    • ๐Ÿ‘Œ Supports HEIC sequence (animated) image on iOS 13/macOS 10.15+ #2849
      • Note the HEIC animated coder does not enable by default. Add SDImageHEICCoder if you need the animation.
    • ๐Ÿ”จ Refactor APNG and GIF coder implementation with abstract base class #2846
      • Now we use SDImageIOAnimatedCoder base class for all animated Image/IO coder implementation. Developer can get use of this as well.

    Animated Image

    • ๐Ÿ‘Œ Support to clear frame buffer or reset frame index when stopped for SDAnimatedImageView #2815

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the downloader LIFO order inverse issue when adding new urls during previous url query #2852 #2823
    • ๐Ÿ›  Fix the macOS SDAnimatedImageRep to match Netscape standard of GIF loop count, which should use 1 when there are no loop count information #2847 #2155
  • v5.1.1 Changes

    September 04, 2019

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix that some option mask check with local BOOL variable, error result on 32 bit device. #2819 #2817
    • ๐Ÿ›  Fix the macOS that SDAnimatedImageView does not works for imageScaling and imageAlignment properties #2820
    • ๐Ÿ›  Fix the case when SDAnimatedImageView dealloc on the fetch queue, will cause it trigger the UIKit/AppKit method on non-main queue and captured by UI Main Thread Checker #2825
  • v5.1.0 Changes

    August 03, 2019

    ๐Ÿ”‹ Features

    ๐Ÿ“ฆ Swift Package Manager

    • โž• Add support for Swift Package Manager #2756

    Options Processor

    • ๐Ÿ‘Œ Supports global control on options and context for individual image request #2736

    Context Option

    • ๐Ÿ‘Œ Supports store original image to cache for transformer via SDWebImageContextOriginalStoreCacheType #2590
    • โž• Add a new option SDWebImageMatchAnimatedImageClass, to ensure we always match the custom image class instead of UIImage/NSImage class #2801


    • ๐Ÿ”ฆ Expose the memoryCache and diskCache object on SDImageCache, Make it useful for user who have custom property beyond SDImageCacheConfig #2779

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix SDAnimatedImageView's frame buffer bug when display link is pause #2782
    • ๐Ÿ›  Fix the bug that UIButton setBackgroundImage convenient method does not pass the options arg to next function call #2785
    • โž• Add a autoreleasepool when prefetch many images #2792
    • ๐Ÿ”‹ Feature supports dynamic style indicator for iOS 13, fix indicator color on macOS 10.14+ #2753
    • ๐Ÿ›  Fix for CocoaPods modular headers warning by removing the custom modulemap #2749


    • โฌ†๏ธ Follow App Store submit rule, upgrade the minimum Xcode version to Xcode 10.0 #2780
    • ๐Ÿ— Provide a script target to directly build all SDWebImage framework and generate all in one XCFramework from Xcode 11 #2764

    Notable Behavior Changes

    • Ensure we always callback user's completion block even when cancelled with SDWebImageErrorCancelled error code #2692

    This may effect some users. In previous 4.0~5.0 version, we will not callback completion block when we receive cancel call. (including all View Category/Cache/Manager/Downloader APIs)

    But from 5.1, we always callback on this case with error code SDWebImageErrorCancelled. You can filter this error code if you don't care about cancel.

    This change makes usages like Dispatch Group, observer, or any logic which relay on the completion's callback become acceptable, which is not reliable and will cause issue in previous versions.

    • ๐Ÿ”„ Change that the sd_imageProgress property to not auto-create instance by framework #2763

    Now, we don't create the NSProgress object from internal method call, this does not affect user's KVO usage.

    • ๐Ÿ”„ Change the default value of accept request header #2772

    Now, the default HTTP header filed Accept, use image/*,*/*;q=0.8, instead of image/*;q=0.8.