SDWebImage中设置force decode policy的正确方式

背景介绍

SDWebImage是一个广泛使用的iOS图片加载和缓存库。在从3.x版本升级到5.19.1版本的过程中，开发者遇到了关于图片解码策略设置的问题。特别是在设置imageForceDecodePolicy时出现了崩溃问题。

问题分析

在SDWebImage 5.x版本中，图片解码策略的设置方式与3.x版本有较大变化。开发者尝试通过以下方式设置不进行强制解码：

updatedContext?[.imageForceDecodePolicy] = [SDImageForceDecodePolicy.never]

这种方式会导致崩溃，错误信息显示为-[Swift.__SwiftDeferredNSArray unsignedIntegerValue]: unrecognized selector sent to instance。这是因为SDWebImage内部期望接收的是一个NSNumber对象，而不是Swift数组。

正确解决方案

正确的设置方式应该是以下两种之一：

1. 直接使用rawValue：

updatedContext?[.imageForceDecodePolicy] = SDImageForceDecodePolicy.never.rawValue

2. 显式创建NSNumber对象：

updatedContext?[.imageForceDecodePolicy] = NSNumber(integer: SDImageForceDecodePolicy.never.rawValue)

版本迁移建议

从SDWebImage 3.x迁移到5.x时，需要注意以下配置的变化：

1. 缓存时间设置：

   • 旧版：SDImageCache.shared().maxCacheAge = 60 * 60 * 24
   • 新版：SDImageCache.shared.config.maxDiskAge = 60 * 60 * 24

2. 图片解码设置：

   • 旧版通过shouldDecompressImages属性控制
   • 新版需要通过imageForceDecodePolicy上下文选项控制

3. 图片转换器实现： 新版推荐继承SDImageResizingTransformer类来实现自定义图片转换逻辑

最佳实践

在实现图片转换器时，可以像这样处理大尺寸图片：

class HarkImageTransformer: SDImageResizingTransformer {
    override func transformedImage(with image: UIImage, forKey key: String) -> UIImage? {
        if image.size.width > 4000 {
            return UIImage(imageLiteralResourceName: "no_album_art")
        } else {
            return super.transformedImage(with: image, forKey: key)
        }
    }
}

总结

SDWebImage 5.x版本在API设计上更加现代化，但也带来了迁移成本。开发者需要特别注意：

1. 上下文选项的值类型必须是NSNumber或其兼容类型
2. 解码策略的设置方式已从属性改为上下文选项
3. 图片转换器的实现方式更加灵活

正确理解这些变化，可以帮助开发者更顺利地完成版本迁移，并充分利用新版本提供的功能。