SDWebImage v5.14.1 Release Notes

Release Date: 2022-11-11 // 3 months ago
  • ๐Ÿš€ See all tickets marked for the 5.14.1 release

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix the iOS 12 crash because the underlyingQueue is nil #3434 #3433
    • ๐Ÿ›  Fix the missing lock for callbackTokens which may cause thread-safe issue #3439 #3438
    • ๐Ÿ‘‰ Use CoreGraphics to decode PDF instead of ImageIO to solve iOS 16's issue #3436

Previous changes from v5.14.0

  • ๐Ÿš€ See all tickets marked for the 5.14.0 release

    Behavior Changes

    • ๐Ÿ—„ Introduce SDWebImageContextImageDecodeOptions, deprecate SDImageCoderWebImageContext #3421
    • โšก๏ธ - Note the deprecated SDImageCoderWebImageContext is no longer used. Update your codebase to use SDWebImageContextImageDecodeOptions to pass extra information from manager to coder. Loaded image will also store the same information in image.sd_decodeOptions
    • ๐Ÿ”จ Refactor the hack when multiple different thumbnail image requests for same url called at the same time #3423
    • - Now the SDWebImageDownloader can callback each thumbnail request for same url with the correct image size as well (previously can't)
    • - Now if manager's callback image is thumbnail (image.sd_isThumbnail == YES), or transformed (image.sd_isTransformed == YES), the callback data will be nil. This because the image does not match downloaded data actually. If you really need original full size data, query the disk cache again using the original key. You may need SDWebImageWaitStoreCache options as well. (previously behavior is undefined, may callback with full size data, or encoded small size data, or even nil)

    ๐Ÿ”‹ Features

    Coder

    • ๐Ÿ‘Œ Support use url.path or custom UTI hint passed to ImageIO, solve the TIFF/NEF/SRW raw image decoding with wrong size #3419
    • - Note from 5.14.0, we may pass the file extension to coder as a UTI hint
    • โž• Added SDImageCoderDecodeUseLazyDecoding to control whether to use lazy-decoding for ImageIO #3425
    • 0๏ธโƒฃ - Note from 5.14.0, by default we enable lazy decoding for static image coder, disable lazy decoding for animated image coder, suitable for most cases. If you want, pass .decodeUseLazyDecoding = YES to context option .imageDecodeOptions

    ๐ŸŽ Performance

    • โ†ช Introduce new workaround to strip CGImage retained CGImageSource on iOS 15 #3425 #3387
    • - Note this also fix the limitation that you can not use lazy-decoding for animated image on iOS 15+. Pass .decodeUseLazyDecoding = YES to context option .imageDecodeOptions
    • ๐ŸŽ Replace conformsToProtocol call with appropriate respondsToSelector check to improve performance #3429
    • ๐Ÿ›  Fix del redundant autoreleasepool #3388

    ๐Ÿ›  Fixes

    • Avoid store again when origin disk cache hit during Thumbnail or Transformer with smaller pixel size #3428 #3395
    • โž• Add the possible nullable logic check when the force-decode/copy failed #3427