See all tickets marked for the 5.21.5 release

Fixes

• Try to move the SDWebImageDownloaderOperation dataTask property initialization into synchronized lock to avoid thread-safe issue #3856 #3842

See all tickets marked for the 5.21.4 release

Fixes

• Using @synchronized to always lock the cache/loader operation to ensure thread-safe. Fix crash issue on iOS 26 #3855 #3849

See all tickets marked for the 5.21.3 release

Fixes

• Switched image encoding to a context-aware approach with a safe fallback, allowing per-request encoder selection without changing the public API. #3844 @CloudlessMoon

See all tickets marked for the 5.21.2 release

Fixes

• Do not ignore blendMode in SDImageTintTransformer #3831 @bdaz
• Fix the retryFailed option does not get modified by optionsProcessor #3829 @AirBlack
• Avoid self if be nil in block. #3826 @hawk0620

See all tickets marked for the 5.21.1 release

Projects

• [Xcode 26] - Fix watchOS build error with UITraitCollection in the new SDK #3819

Performance

• Reduce memory peak when playing the GIF on SDAnimatedImageView #3813

Note

If you use the self-signed binary XCFramework below in the GitHub action attachment, the certificate fingerprint has been updated to B5 88 AB D0 A0 B3 6E 8D 36 A3 05 6D C7 4D E7 46 2F 75 E4 9E 1D 83 03 D0 13 A9 94 AF 35 C2 D2 6F (SHA-256)

See all tickets marked for the 5.21.0 release

Features

HDR Decoding

• Supports HDR decoding on Apple ImageIO coder (avif/heic/jpeg-xl, etc) #3778
• • Note: Defaults to always use SDR, if you want HDR decoding, pass SDWebImageContextDecodeToHDR: @(YES) to context option. Pay attention even decoded CGImage is HDR ready, full rendering require display hardware support and per-image-view level control, it's recommended to read WWDC23 and use proper API to check for current display headroom to turn on HDR.
• • Note: Apple ImageIO coder requires macOS 14/iOS 17+ for HDR decoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL third-party codec

HDR Encoding

• Supports HDR encoding on Apple ImageIO coder #3799
• • Note: Defaults to always use SDR, if you want HDR dencoding, pass SDImageCoderEncodeToHDR: @(SDImageHDRTypeISOHDR) for ISO HDR encoding. And SDImageHDRTypeISOGainMap for ISO Gain Map based HDR encoding (like JPEG for compatibility)
• • Note: Apple ImageIO coder requires macOS 15/iOS 18+ for HDR encoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL third-party codec

Transformer

• Allows user to directly customize preserveImageMetadata for our built-in transformers #3796

UI Category

• Change the default callback queue policy to SafeAsyncMainThread, don't need main queue check at all #3797
• • Note: This should make sd_setImageWithURL related UI API to work on case like UICollectionViewDiffableDataSource , which is running on main thread but not main queue.

Fixes

• fix: sd_colorAtPoint/sd_colorsWithRect should early return when pixel format is not supported #3798
• • Note: In history this may return a wrong color for RGB10/RGB16 pixel format. Now it just return nil, which may supported in the future.

See all tickets marked for the 5.20.1 release

Fixes

• (macOS) Fix SDAnimatedImagePlayer leaking SDDisplayLink instances and leaving CVDisplayLink threads running #3776 #3779
• Fix the issue that previous optimization for special case (multiple same URL in prefetcher list) breaks the queryCacheType option sematic #3788

See all tickets marked for the 5.20.0 release

Features

Animation Transformer

• SDAniamtedImageView now supports to apply transformer (post-processing of frame), with the SDAnimatedImage. #3761
• You can apply transform like blurs, tint, CIFilters on animation frames.
• • Detailed behavior: Transform is applied just after the frame been decoded, on the global decode queue.
• • Detailed behavior: The transformed image replace the original decoded one, and re-use the design of maxBufferSize on SDAnimatedImageView

Disk Cache

• Supports LRU eviction on disk cache, change the default expire type to accessDate instead of modificationDate #3759
• • In previous versions, the disk cache does not actually supports LRU (The NSFileManager read API does not update the accessDate), this version fix this issue and change the default behavior to use accessDate

Tint Color

• Add blend mode to UIImage+Transform tint color API, default blend mode changed to sourceIn #3749
• • In previous versions, the blend mode use sourceAtop and does not match UIKit's tintColor naming. We now use sourceIn to match it.
• • Due to this changes, the SDWebImageTintTransformer defaults to use sourceIn blend mode as well. You can use transformer to tint SDAnimatedImageView as well

Fixes

• Fix sd_imageFormat sometimes returns undefined on static image #3760

See all tickets marked for the 5.19.7 release

Fixes

• Fix the thumbnail decoding on JPEG which contains EXIF orientation, use the new way to workaround JFIF bug #3743
• Fix the crash when some special urls cause the cache path return nil and crash #3740
• Fix the issue that some URL which has percent-encoding with \0 will cause nil cache path #3744

See all tickets marked for the 5.19.5 release

Performance

• Use the better way to detect lazy/non-lazy CGImage. Only do force decoding for lazy image (avoid thumbnail image been decoded twice) #3736

Fixes

• Remove the unused code for iOS 10 polyfill #3735