From fe0e42afc25d66efeb0ceaefbec089b99f93cf90 Mon Sep 17 00:00:00 2001
From: zxiou <zhangxu6@xiaomi.com>
Date: Thu, 21 Nov 2019 19:17:44 +0800
Subject: [PATCH 001/181] fix the core render of SDAnimatedImagePlayer and fix
 assignment animationRepeatCount does not work

Signed-off-by: zxiou <zhangxu6@xiaomi.com>
---
 .DS_Store                                     | Bin 0 -> 6148 bytes
 Examples/.DS_Store                            | Bin 0 -> 6148 bytes
 .../SDWebImage Demo/DetailViewController.m    |   2 +
 .../SDWebImage Demo/MasterViewController.m    |   1 +
 .../xcshareddata/IDEWorkspaceChecks.plist     |   8 ++
 SDWebImage/.DS_Store                          | Bin 0 -> 6148 bytes
 SDWebImage/Core/SDAnimatedImagePlayer.m       | 118 ++++++++++--------
 SDWebImage/Core/SDAnimatedImageView.m         |  13 ++
 8 files changed, 90 insertions(+), 52 deletions(-)
 create mode 100644 .DS_Store
 create mode 100644 Examples/.DS_Store
 create mode 100644 SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
 create mode 100644 SDWebImage/.DS_Store

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..2d16dfcc10fe0dc9f4cb84573ae26c03191498de
GIT binary patch
literal 6148
zcmeHKL2uJA6n^dsq(g`vCfLyzPODI>!nz$Mg%S?CAu?^!0By+<wShE_l9T|YD1T%7
zH;B_D?))9zvpuw`1*t-+CgfMy-;19=zrIg$90LIBkAn_C696o1g!Ogo78u2;%~?&4
zP>{(reAtH(crbu)ZnhaP3K#`$ngX<U*TDq`j&RRj+rNI9r+zGaj9>a`9OXs3{gc(!
z>bGv+u^RZhXT5cYqI3(d80UR2dreO-y<+HV|3HZNx9|CfQCOZdH=c{6@S-HlBsmH~
zobu)<N&->##W)FaxsIy>l&5jh+?-6dySpv^w7WBH@ky`OZt*AG?dh~(J$%&J+dmzB
z`aJnE{d%s{W%x3Zc3<NaT%fbC*bi=&#3C7BoVXi{1cAr!5zatBfI_8^q4zExblfvB
zN@ao?+ggS@5{{z<wvK=FE?<5B_G~$R@K5}7c>TX~D&fIj>MpU~4BkVIwR@;TI8!_H
zj+f=n<i|ygty%%SO{}}CPHgfS1&jhWUIBVPaBPIO#!8`lbzmp20El%QmWDpvC5Xc{
z+8Qf`7(ru-im0eeUon`X<2cvzY>kydMF*xYA53Rv`i8<}c3hv!>A-A-rZ);01!fgk
zQ;$tL|6lz1{y$4HPeuWwz<;Fxt2?gK$CC8fI#(Q>wH(_iHZq!5DU=lK^l>a5I*K>3
bNy8W?2hrA8DZ~*p^C2K*Fr86gr3(B460Dw@

literal 0
HcmV?d00001

diff --git a/Examples/.DS_Store b/Examples/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..fa4d26ea88797260ea849d0f24dece6255454310
GIT binary patch
literal 6148
zcmeHKyG{c^3>-s>NED=`++W}iR?$&VUqK6qC=DbM5~;7^yZAK54<Vup5)BO+OZM#g
zJiEFn&SwC&etWtGRsfcCN4$HOn?HA-*;!?bNaq=kxWx+|u*GIpeLCUXON<zBN6vSC
zV{XIK_J{Fx_q^Y2^On=cC@Te|fE17dQa}p)QUUM1wB<#jq7;w<Qs7Gg|2{OjV=tT%
z<I}+qBLH#1bQsq$OAwnUh`n%1WQJx*B_`Es#IU3@->R+`PKil})$n0;v(<!RaXZg%
zQ4Z^gic&xd94m01+m-kK8~P9P|1n8BDIf*@l>)XH#$nA@s@^(#Iq$WNeoyzB54s!I
oL1Bn?OpJESjkn{gD9XC#Yd-IVQ)1AW4?0ml1Fnlq3jDPKpS%Yac>n+a

literal 0
HcmV?d00001

diff --git a/Examples/SDWebImage Demo/DetailViewController.m b/Examples/SDWebImage Demo/DetailViewController.m
index 4327c9dd..ee9be9df 100644
--- a/Examples/SDWebImage Demo/DetailViewController.m	
+++ b/Examples/SDWebImage Demo/DetailViewController.m	
@@ -24,6 +24,8 @@
     [self.imageView sd_setImageWithURL:self.imageURL
                       placeholderImage:nil
                                options:SDWebImageProgressiveLoad];
+    self.imageView.shouldCustomLoopCount = YES;
+    self.imageView.animationRepeatCount = NSIntegerMax;
 }
 
 - (void)viewDidLoad {
diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index 14aea5ca..bb86ba17 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -63,6 +63,7 @@
         [SDWebImageDownloader sharedDownloader].config.executionOrder = SDWebImageDownloaderLIFOExecutionOrder;
         
         self.objects = [NSMutableArray arrayWithObjects:
+                    @"https://s2.ax1x.com/2019/11/01/KHYIgJ.gif",
                     @"http://www.httpwatch.com/httpgallery/authentication/authenticatedimage/default.aspx?0.35786508303135633",     // requires HTTP auth, used to demo the NTLM auth
                     @"http://assets.sbnation.com/assets/2512203/dogflops.gif",
                     @"https://raw.githubusercontent.com/liyong03/YLGIFImage/master/YLGIFImageDemo/YLGIFImageDemo/joy.gif",
diff --git a/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 00000000..18d98100
--- /dev/null
+++ b/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
diff --git a/SDWebImage/.DS_Store b/SDWebImage/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..516153fe4952f37097299528382f83d7f653aab6
GIT binary patch
literal 6148
zcmeHK!AiqG5Z!H~CWzRBV2`<Y>!GD;y$GSL2X8_|4=Qa!f(^uMNm7f}N`6EC$S?4B
zoY~zLOBFnc*qJc<W@l%1nU}DeWsLFmC}=QNVT_reh$Rb}F9gR?m!zaUh#cqe$Jx-2
zg%AC=rD$^eMF#NQ8LYzuOIi5&{rST<%JO>sotMhS+WLlR!Lw!FxC1eEb1xrdZ7;pT
z-kFyVd~Kf#5zlSUzlg$dud>q-N$y2Sn9AfR2qEP9GD-q5Zi`V8WO5!?4d6OfuTq^%
zng`9Ay?<1n*6c~ERR_CyIGtMN?q1{gw14;TIC+{rzbIBYe1KB6HO}A_jCq0gZkog*
zxdq=Weilba3=jjvzzQ*-w?K1qg=(f!i2-8ZXAI!}V1pt$8ViMT>wpG-A9373L;)M`
z5{R}&M`NK7MnJeq1yreAUop5!2fwZ39F2uSmCm?a8RpR|bA3bMa&_?AGMsToA+^K+
zF|f!$S#>LT{-1n*|6fd^9x*@+{3`~y(RI6RC`q5KOU2<?YlHSdQ82DhI8OmX9>oxg
eM{yNY3ixd_03D5mLhyjlkAS3s8e-sA8TbIFeo$oq

literal 0
HcmV?d00001

diff --git a/SDWebImage/Core/SDAnimatedImagePlayer.m b/SDWebImage/Core/SDAnimatedImagePlayer.m
index 2efd8805..39658b43 100644
--- a/SDWebImage/Core/SDAnimatedImagePlayer.m
+++ b/SDWebImage/Core/SDAnimatedImagePlayer.m
@@ -23,6 +23,7 @@
 @property (nonatomic, strong) NSMutableDictionary<NSNumber *, UIImage *> *frameBuffer;
 @property (nonatomic, assign) NSTimeInterval currentTime;
 @property (nonatomic, assign) BOOL bufferMiss;
+@property (nonatomic, assign) BOOL needsDisplayWhenImageBecomesAvailable;
 @property (nonatomic, assign) NSUInteger maxBufferCount;
 @property (nonatomic, strong) NSOperationQueue *fetchQueue;
 @property (nonatomic, strong) dispatch_semaphore_t lock;
@@ -165,6 +166,7 @@
     self.currentLoopCount = 0;
     self.currentTime = 0;
     self.bufferMiss = NO;
+    self.needsDisplayWhenImageBecomesAvailable = NO;
     [self handleFrameChange];
 }
 
@@ -217,8 +219,6 @@
     if (!self.isPlaying) {
         return;
     }
-    // Calculate refresh duration
-    NSTimeInterval duration = self.displayLink.duration;
     
     NSUInteger totalFrameCount = self.totalFrameCount;
     if (totalFrameCount <= 1) {
@@ -226,8 +226,6 @@
         [self stopPlaying];
         return;
     }
-    NSUInteger currentFrameIndex = self.currentFrameIndex;
-    NSUInteger nextFrameIndex = (currentFrameIndex + 1) % totalFrameCount;
     
     NSTimeInterval playbackRate = self.playbackRate;
     if (playbackRate <= 0) {
@@ -236,7 +234,46 @@
         return;
     }
     
-    // Check if we have the frame buffer firstly to improve performance
+    // Calculate refresh duration
+    NSTimeInterval duration = self.displayLink.duration;
+    
+    NSUInteger currentFrameIndex = self.currentFrameIndex;
+    NSUInteger nextFrameIndex = (currentFrameIndex + 1) % totalFrameCount;
+    
+    // Check if we need to display new frame firstly
+    BOOL bufferFull = NO;
+    if (self.needsDisplayWhenImageBecomesAvailable) {
+        UIImage *currentFrame;
+        SD_LOCK(self.lock);
+        currentFrame = self.frameBuffer[@(currentFrameIndex)];
+        SD_UNLOCK(self.lock);
+        
+        // Update the current frame
+        if (currentFrame) {
+            SD_LOCK(self.lock);
+            // Remove the frame buffer if need
+            if (self.frameBuffer.count > self.maxBufferCount) {
+                self.frameBuffer[@(currentFrameIndex)] = nil;
+            }
+            // Check whether we can stop fetch
+            if (self.frameBuffer.count == totalFrameCount) {
+                bufferFull = YES;
+            }
+            SD_UNLOCK(self.lock);
+            
+            // Update the current frame immediately
+            self.currentFrame = currentFrame;
+            [self handleFrameChange];
+            
+            self.bufferMiss = NO;
+            self.needsDisplayWhenImageBecomesAvailable = NO;
+        }
+        else {
+            self.bufferMiss = YES;
+        }
+    }
+    
+    // Check if we have the frame buffer
     if (!self.bufferMiss) {
         // Then check if timestamp is reached
         self.currentTime += duration;
@@ -246,6 +283,10 @@
             // Current frame timestamp not reached, return
             return;
         }
+        
+        // Otherwise, we shoudle be ready to display next frame
+        self.needsDisplayWhenImageBecomesAvailable = YES;
+        self.currentFrameIndex = nextFrameIndex;
         self.currentTime -= currentDuration;
         NSTimeInterval nextDuration = [self.animatedProvider animatedImageDurationAtIndex:nextFrameIndex];
         nextDuration = nextDuration / playbackRate;
@@ -253,45 +294,19 @@
             // Do not skip frame
             self.currentTime = nextDuration;
         }
-    }
-    
-    // Update the current frame
-    UIImage *currentFrame;
-    UIImage *fetchFrame;
-    SD_LOCK(self.lock);
-    currentFrame = self.frameBuffer[@(currentFrameIndex)];
-    fetchFrame = currentFrame ? self.frameBuffer[@(nextFrameIndex)] : nil;
-    SD_UNLOCK(self.lock);
-    BOOL bufferFull = NO;
-    if (currentFrame) {
-        SD_LOCK(self.lock);
-        // Remove the frame buffer if need
-        if (self.frameBuffer.count > self.maxBufferCount) {
-            self.frameBuffer[@(currentFrameIndex)] = nil;
-        }
-        // Check whether we can stop fetch
-        if (self.frameBuffer.count == totalFrameCount) {
-            bufferFull = YES;
-        }
-        SD_UNLOCK(self.lock);
-        self.currentFrame = currentFrame;
-        [self handleFrameChange];
-        self.currentFrameIndex = nextFrameIndex;
-        self.bufferMiss = NO;
-    } else {
-        self.bufferMiss = YES;
-    }
-    
-    // Update the loop count when last frame rendered
-    if (nextFrameIndex == 0 && !self.bufferMiss) {
-        // Update the loop count
-        self.currentLoopCount++;
-        [self handleLoopChnage];
-        // if reached the max loop count, stop animating, 0 means loop indefinitely
-        NSUInteger maxLoopCount = self.totalLoopCount;
-        if (maxLoopCount != 0 && (self.currentLoopCount >= maxLoopCount)) {
-            [self stopPlaying];
-            return;
+        
+        // Update the loop count when last frame rendered
+        if (nextFrameIndex == 0) {
+            // Update the loop count
+            self.currentLoopCount++;
+            [self handleLoopChnage];
+            
+            // if reached the max loop count, stop animating, 0 means loop indefinitely
+            NSUInteger maxLoopCount = self.totalLoopCount;
+            if (maxLoopCount != 0 && (self.currentLoopCount >= maxLoopCount)) {
+                [self stopPlaying];
+                return;
+            }
         }
     }
     
@@ -301,14 +316,13 @@
     }
     
     // Check if we should prefetch next frame or current frame
-    NSUInteger fetchFrameIndex;
-    if (self.bufferMiss) {
-        // When buffer miss, means the decode speed is slower than render speed, we fetch current miss frame
-        fetchFrameIndex = currentFrameIndex;
-    } else {
-        // Or, most cases, the decode speed is faster than render speed, we fetch next frame
-        fetchFrameIndex = nextFrameIndex;
-    }
+    // When buffer miss, means the decode speed is slower than render speed, we fetch current miss frame
+    // Or, most cases, the decode speed is faster than render speed, we fetch next frame
+    NSUInteger fetchFrameIndex = self.bufferMiss? currentFrameIndex : nextFrameIndex;
+    UIImage *fetchFrame;
+    SD_LOCK(self.lock);
+    fetchFrame = self.bufferMiss? nil : self.frameBuffer[@(nextFrameIndex)];
+    SD_UNLOCK(self.lock);
     
     if (!fetchFrame && !bufferFull && self.fetchQueue.operationCount == 0) {
         // Prefetch next frame in background queue
diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index 181f2db9..78f1cb8b 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -306,6 +306,19 @@
 #pragma mark - UIImageView Method Overrides
 #pragma mark Image Data
 
+- (void)setAnimationRepeatCount:(NSInteger)animationRepeatCount
+{
+#if SD_UIKIT
+    [super setAnimationRepeatCount:animationRepeatCount];
+#else
+    _animationRepeatCount = animationRepeatCount;
+#endif
+    
+    if (self.shouldCustomLoopCount) {
+        self.player.totalLoopCount = animationRepeatCount;
+    }
+}
+
 - (void)startAnimating
 {
     if (self.player) {

From d5da5dbef7362a683c2bb1d0dc7eac7f5459ab2b Mon Sep 17 00:00:00 2001
From: zxiou <zhangxu6@xiaomi.com>
Date: Thu, 21 Nov 2019 19:32:11 +0800
Subject: [PATCH 002/181] delete useless files

---
 .DS_Store            | Bin 6148 -> 0 bytes
 Examples/.DS_Store   | Bin 6148 -> 0 bytes
 SDWebImage/.DS_Store | Bin 6148 -> 0 bytes
 3 files changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 .DS_Store
 delete mode 100644 Examples/.DS_Store
 delete mode 100644 SDWebImage/.DS_Store

diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index 2d16dfcc10fe0dc9f4cb84573ae26c03191498de..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHKL2uJA6n^dsq(g`vCfLyzPODI>!nz$Mg%S?CAu?^!0By+<wShE_l9T|YD1T%7
zH;B_D?))9zvpuw`1*t-+CgfMy-;19=zrIg$90LIBkAn_C696o1g!Ogo78u2;%~?&4
zP>{(reAtH(crbu)ZnhaP3K#`$ngX<U*TDq`j&RRj+rNI9r+zGaj9>a`9OXs3{gc(!
z>bGv+u^RZhXT5cYqI3(d80UR2dreO-y<+HV|3HZNx9|CfQCOZdH=c{6@S-HlBsmH~
zobu)<N&->##W)FaxsIy>l&5jh+?-6dySpv^w7WBH@ky`OZt*AG?dh~(J$%&J+dmzB
z`aJnE{d%s{W%x3Zc3<NaT%fbC*bi=&#3C7BoVXi{1cAr!5zatBfI_8^q4zExblfvB
zN@ao?+ggS@5{{z<wvK=FE?<5B_G~$R@K5}7c>TX~D&fIj>MpU~4BkVIwR@;TI8!_H
zj+f=n<i|ygty%%SO{}}CPHgfS1&jhWUIBVPaBPIO#!8`lbzmp20El%QmWDpvC5Xc{
z+8Qf`7(ru-im0eeUon`X<2cvzY>kydMF*xYA53Rv`i8<}c3hv!>A-A-rZ);01!fgk
zQ;$tL|6lz1{y$4HPeuWwz<;Fxt2?gK$CC8fI#(Q>wH(_iHZq!5DU=lK^l>a5I*K>3
bNy8W?2hrA8DZ~*p^C2K*Fr86gr3(B460Dw@

diff --git a/Examples/.DS_Store b/Examples/.DS_Store
deleted file mode 100644
index fa4d26ea88797260ea849d0f24dece6255454310..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHKyG{c^3>-s>NED=`++W}iR?$&VUqK6qC=DbM5~;7^yZAK54<Vup5)BO+OZM#g
zJiEFn&SwC&etWtGRsfcCN4$HOn?HA-*;!?bNaq=kxWx+|u*GIpeLCUXON<zBN6vSC
zV{XIK_J{Fx_q^Y2^On=cC@Te|fE17dQa}p)QUUM1wB<#jq7;w<Qs7Gg|2{OjV=tT%
z<I}+qBLH#1bQsq$OAwnUh`n%1WQJx*B_`Es#IU3@->R+`PKil})$n0;v(<!RaXZg%
zQ4Z^gic&xd94m01+m-kK8~P9P|1n8BDIf*@l>)XH#$nA@s@^(#Iq$WNeoyzB54s!I
oL1Bn?OpJESjkn{gD9XC#Yd-IVQ)1AW4?0ml1Fnlq3jDPKpS%Yac>n+a

diff --git a/SDWebImage/.DS_Store b/SDWebImage/.DS_Store
deleted file mode 100644
index 516153fe4952f37097299528382f83d7f653aab6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHK!AiqG5Z!H~CWzRBV2`<Y>!GD;y$GSL2X8_|4=Qa!f(^uMNm7f}N`6EC$S?4B
zoY~zLOBFnc*qJc<W@l%1nU}DeWsLFmC}=QNVT_reh$Rb}F9gR?m!zaUh#cqe$Jx-2
zg%AC=rD$^eMF#NQ8LYzuOIi5&{rST<%JO>sotMhS+WLlR!Lw!FxC1eEb1xrdZ7;pT
z-kFyVd~Kf#5zlSUzlg$dud>q-N$y2Sn9AfR2qEP9GD-q5Zi`V8WO5!?4d6OfuTq^%
zng`9Ay?<1n*6c~ERR_CyIGtMN?q1{gw14;TIC+{rzbIBYe1KB6HO}A_jCq0gZkog*
zxdq=Weilba3=jjvzzQ*-w?K1qg=(f!i2-8ZXAI!}V1pt$8ViMT>wpG-A9373L;)M`
z5{R}&M`NK7MnJeq1yreAUop5!2fwZ39F2uSmCm?a8RpR|bA3bMa&_?AGMsToA+^K+
zF|f!$S#>LT{-1n*|6fd^9x*@+{3`~y(RI6RC`q5KOU2<?YlHSdQ82DhI8OmX9>oxg
eM{yNY3ixd_03D5mLhyjlkAS3s8e-sA8TbIFeo$oq


From dd8ea8f7fbca9c9ba29d55bb945cddc0812cd736 Mon Sep 17 00:00:00 2001
From: zxiou <zhangxu6@xiaomi.com>
Date: Fri, 22 Nov 2019 11:49:57 +0800
Subject: [PATCH 003/181] delete IDEWorkspaceChecks

---
 .DS_Store                                        | Bin 0 -> 8196 bytes
 .../xcshareddata/IDEWorkspaceChecks.plist        |   8 --------
 SDWebImage/.DS_Store                             | Bin 0 -> 8196 bytes
 3 files changed, 8 deletions(-)
 create mode 100644 .DS_Store
 delete mode 100644 SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
 create mode 100644 SDWebImage/.DS_Store

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..eeded2ff3a566d60f92b5dce46dd51e480df6b18
GIT binary patch
literal 8196
zcmeI1O^?z*7{{Ms(Jh*d95%|a7f)_XSq*S8LAD<DVvJQc@g+;UtxzqUrY%-Q3|~XP
zjq$XJcdvdC6Q6l;Wq~y!i6QYBGV>p1=0EN8OVjcc0AQV=Uk9iGfPqzL^&&P4ikKI5
zu9Wo17AiwOKnOj^ydq1yXl^wP5CI}U1c(3;AOh<^0H4{S7-u~9)hx9{fC&7T1jPNp
z#45C{b)r<>I<S!`0BRYBWx+n?0n%e?ZEKw<l~&wSWe-eSnNBg7vg5odmZP?{PLwJ;
zFl7g(kIZz2!sOA>XUgTk+DfS<0z_b*fXLl9VGlUO@O(Od=N`@+dr1^#xn+H2rH%5r
z^P5HmKU>B#r_T!~ck^M^anmQ_+dVh$d%FLC^XR1SdXK`OIIM2(@i=$GI7p>A^aEV-
z^dO9VUUc{{_A|MUqb9_0Du>nDXtdjE?3g#L=6J^(HJcXpZ#2f^igD#?{nmbW@aFC4
z-T3_n6&cfa2e>p7>BspnUpZ+U@wkUG!gT>0u;Bm#@L(SX;Nq){K)uRX8x$>T7sGF~
zRz|Tf*cl+(i-5p&cnwE*wfG1sffRc$qF&uO;)6sYFR^Q=f9xG_+x8*}*m(S<d3^u#
zr`yZ<{gwPlfBM`_5yIu)#9d&#DZGRXV|S55a4L3a++Ef`9e?Zl!*4qNrOsi%e=+#m
zJx+0e?$R8luN`{+3w%_Fz?u`-Q0G?@`Tw1>-~X?96m)t-fC#KYfR$~>?%)nTe?8A`
zCUR{PYZt31V%<ckv|uCCaa5U(qn`X>h<y{63Qt?>L@AD7p%(!X12sh8pAz^1W)Krj

literal 0
HcmV?d00001

diff --git a/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
deleted file mode 100644
index 18d98100..00000000
--- a/SDWebImage.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
+++ /dev/null
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>IDEDidComputeMac32BitWarning</key>
-	<true/>
-</dict>
-</plist>
diff --git a/SDWebImage/.DS_Store b/SDWebImage/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..3ed219f226727dcd24292f55e3fccd9848d5849f
GIT binary patch
literal 8196
zcmeHMT}&KR6u#dA?Tj7DfLN%y*+pz2NG((ZTD0A=w6=w&*rh<BN_TgrFm{-sJF^QE
zX)ujZlNyaN{yx;7s1JQH+WJ=io?7+ANMdZ`gFi3E#GeN>!57b+J4=8TeQ8XS&fUyC
z_nvd^xpThx?%dp2#u(bOS|ekXj4_EWF4a|3U8Qh4zpf}DUsFgDG@hl#ow1Z@r>KAN
z3hzJ>AP^uBAP^uBAP^vMJs?1PHZRgL`@XOSb$~#CzzvB2e?LU&;xgvT86mw_2UXq?
zfFwTxc!k<3Z;*`oGUm$}A<04oVkk*56#fwdVmRrezF*9jGeU~t4F2H*{><=CDDY;d
z_)*WDAtq!{2M7cRT!{c*K7}mKY?fjA!t;A-%rqRgq2X(U3JQx>tdwN>6-y5#M(pu~
zn{=~IdonY~d)-NQB;~hzY}=e~CsVzKK0c(D$8F0^8kU~%1{<1AE{FOIOS8w@?X0Ca
zUYvw5@Ok7RwQ_2zwP90zw5hpux;{G9($YZfdzz=GWvOCa<Ndo2k4_$+dUX24%OWTE
z?*&$}B*#}4CTKdjxcER3n$0J8X+FW5Rw>2dJ)K>9m3{q2+O`tLaeYWFaVW>#)a}mb
zIm)LmZJXIq%NbHj(@8U(HIuHs-88u~=}Me*#x~7v+c8|jwhs2Y`h=Sgw8+#y;Mf^A
z?gblC)vTlM*D02f(>o|4g(~B-?Hl7^oL)WSkgSe1i1g$$t1BXR)^6C;a$ju6Y>8T0
zrj#pd`f`S2q)h$5xS_ct2a`@(w=}~V9w1~b*EnM68Mzeoa*vf9)o05p*WP;D?cwlJ
z?|hX0Y|1#6HQY(HT9U*ZRpDw`JtrN~=nnVV8jq-XmT*<LMv?}(KAzF37HXv~TraCh
zsmCF7M2L+_qpUh|&ry2(VrY}nEUB7&z)YreQ>Zp8ZIaq4_vJ*|LRqeCljQ!iJvvIs
zI6~JR?vT_A(!+e>uB7Ac8`CYCo2Rz3DjYt@_1iT~*Ca`*j`huW=vBvR1&Y-|Fy;Xw
zt9%m*v-PZ%w!0p7gcikP>=ZlA&a(6DL-rZ_id|;kv7gzW>@POQ{sx1L60AiP>QIjj
zxEn2K#TK+-7aqiZBrt>#7&r<O$8a1|n8pd5#3?+DXYeduz-hdOH}EFT;4IGJ1AK%F
zxQNg31uo-9{DNQc8-B-Js34?-N<(GhenWY#cjxcl*O!x=U(CdH|6^R})vI$o^1!a$
zdzAQf&-HIsbAsPoe#@GQ=(@U%O`Es2&(mPZlV8X{k92}n9^3M4@*ehL3X7GXL=F%s
z^@-&cgu0S19%+_)SKSebsGNGDyS|3HAzB)udslr#Q45Ipvgh2;s6^Bv;<&Kh+pH*R
zAuR%7-O@(Z6-0Mo-4-S*^KJ1O3Iuv1{wI0=mAYTDOYA512b&|x7NHnrh@h6}+Jvpx
zNo4Ir7xtnT{TRR?4nfB-(e@D{u8SNdFiGS+iO2B-p2Sml4$l*HU&Kpzov8a3-o`t4
z7w_SHBJp{m@W=QBpAv~@@h!ezLfNjxl*JDVDVs}VEYr4zNtdViV)vkTEfFXX!7BOr
zf5-CQ|F7kgL976Q0D<ca0Tgy5I@;-`mV4>)vv!oO!*ub&{bq#phET;_xZXRClbrv<
eklIn-7W3tdkYu6qzkdj@g8e_(|2^v6(A7UOUMBVc

literal 0
HcmV?d00001


From d1be404b63ddcf5b6c28028232908bd97bddd7f6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 22 Nov 2019 16:16:20 +0800
Subject: [PATCH 004/181] Remove the untracked DS_Store file

---
 .DS_Store                                       | Bin 8196 -> 0 bytes
 .gitignore                                      |   2 ++
 Examples/SDWebImage Demo/DetailViewController.m |   2 +-
 Examples/SDWebImage Demo/MasterViewController.m |   2 +-
 SDWebImage/.DS_Store                            | Bin 8196 -> 0 bytes
 5 files changed, 4 insertions(+), 2 deletions(-)
 delete mode 100644 .DS_Store
 delete mode 100644 SDWebImage/.DS_Store

diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index eeded2ff3a566d60f92b5dce46dd51e480df6b18..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeI1O^?z*7{{Ms(Jh*d95%|a7f)_XSq*S8LAD<DVvJQc@g+;UtxzqUrY%-Q3|~XP
zjq$XJcdvdC6Q6l;Wq~y!i6QYBGV>p1=0EN8OVjcc0AQV=Uk9iGfPqzL^&&P4ikKI5
zu9Wo17AiwOKnOj^ydq1yXl^wP5CI}U1c(3;AOh<^0H4{S7-u~9)hx9{fC&7T1jPNp
z#45C{b)r<>I<S!`0BRYBWx+n?0n%e?ZEKw<l~&wSWe-eSnNBg7vg5odmZP?{PLwJ;
zFl7g(kIZz2!sOA>XUgTk+DfS<0z_b*fXLl9VGlUO@O(Od=N`@+dr1^#xn+H2rH%5r
z^P5HmKU>B#r_T!~ck^M^anmQ_+dVh$d%FLC^XR1SdXK`OIIM2(@i=$GI7p>A^aEV-
z^dO9VUUc{{_A|MUqb9_0Du>nDXtdjE?3g#L=6J^(HJcXpZ#2f^igD#?{nmbW@aFC4
z-T3_n6&cfa2e>p7>BspnUpZ+U@wkUG!gT>0u;Bm#@L(SX;Nq){K)uRX8x$>T7sGF~
zRz|Tf*cl+(i-5p&cnwE*wfG1sffRc$qF&uO;)6sYFR^Q=f9xG_+x8*}*m(S<d3^u#
zr`yZ<{gwPlfBM`_5yIu)#9d&#DZGRXV|S55a4L3a++Ef`9e?Zl!*4qNrOsi%e=+#m
zJx+0e?$R8luN`{+3w%_Fz?u`-Q0G?@`Tw1>-~X?96m)t-fC#KYfR$~>?%)nTe?8A`
zCUR{PYZt31V%<ckv|uCCaa5U(qn`X>h<y{63Qt?>L@AD7p%(!X12sh8pAz^1W)Krj

diff --git a/.gitignore b/.gitignore
index 8d02b18b..21074f2e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,5 @@
+# OS X
+.DS_Store
 # Xcode
 #
 build/
diff --git a/Examples/SDWebImage Demo/DetailViewController.m b/Examples/SDWebImage Demo/DetailViewController.m
index ee9be9df..cdcaf1d9 100644
--- a/Examples/SDWebImage Demo/DetailViewController.m	
+++ b/Examples/SDWebImage Demo/DetailViewController.m	
@@ -25,7 +25,7 @@
                       placeholderImage:nil
                                options:SDWebImageProgressiveLoad];
     self.imageView.shouldCustomLoopCount = YES;
-    self.imageView.animationRepeatCount = NSIntegerMax;
+    self.imageView.animationRepeatCount = 0;
 }
 
 - (void)viewDidLoad {
diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index bb86ba17..3a6c1780 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -63,7 +63,6 @@
         [SDWebImageDownloader sharedDownloader].config.executionOrder = SDWebImageDownloaderLIFOExecutionOrder;
         
         self.objects = [NSMutableArray arrayWithObjects:
-                    @"https://s2.ax1x.com/2019/11/01/KHYIgJ.gif",
                     @"http://www.httpwatch.com/httpgallery/authentication/authenticatedimage/default.aspx?0.35786508303135633",     // requires HTTP auth, used to demo the NTLM auth
                     @"http://assets.sbnation.com/assets/2512203/dogflops.gif",
                     @"https://raw.githubusercontent.com/liyong03/YLGIFImage/master/YLGIFImageDemo/YLGIFImageDemo/joy.gif",
@@ -75,6 +74,7 @@
                     @"https://isparta.github.io/compare-webp/image/gif_webp/webp/2.webp",
                     @"https://nokiatech.github.io/heif/content/images/ski_jump_1440x960.heic",
                     @"https://nokiatech.github.io/heif/content/image_sequences/starfield_animation.heic",
+                    @"https://s2.ax1x.com/2019/11/01/KHYIgJ.gif",
                     @"https://nr-platform.s3.amazonaws.com/uploads/platform/published_extension/branding_icon/275/AmazonS3.png",
                     @"http://via.placeholder.com/200x200.jpg",
                     nil];
diff --git a/SDWebImage/.DS_Store b/SDWebImage/.DS_Store
deleted file mode 100644
index 3ed219f226727dcd24292f55e3fccd9848d5849f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMT}&KR6u#dA?Tj7DfLN%y*+pz2NG((ZTD0A=w6=w&*rh<BN_TgrFm{-sJF^QE
zX)ujZlNyaN{yx;7s1JQH+WJ=io?7+ANMdZ`gFi3E#GeN>!57b+J4=8TeQ8XS&fUyC
z_nvd^xpThx?%dp2#u(bOS|ekXj4_EWF4a|3U8Qh4zpf}DUsFgDG@hl#ow1Z@r>KAN
z3hzJ>AP^uBAP^uBAP^vMJs?1PHZRgL`@XOSb$~#CzzvB2e?LU&;xgvT86mw_2UXq?
zfFwTxc!k<3Z;*`oGUm$}A<04oVkk*56#fwdVmRrezF*9jGeU~t4F2H*{><=CDDY;d
z_)*WDAtq!{2M7cRT!{c*K7}mKY?fjA!t;A-%rqRgq2X(U3JQx>tdwN>6-y5#M(pu~
zn{=~IdonY~d)-NQB;~hzY}=e~CsVzKK0c(D$8F0^8kU~%1{<1AE{FOIOS8w@?X0Ca
zUYvw5@Ok7RwQ_2zwP90zw5hpux;{G9($YZfdzz=GWvOCa<Ndo2k4_$+dUX24%OWTE
z?*&$}B*#}4CTKdjxcER3n$0J8X+FW5Rw>2dJ)K>9m3{q2+O`tLaeYWFaVW>#)a}mb
zIm)LmZJXIq%NbHj(@8U(HIuHs-88u~=}Me*#x~7v+c8|jwhs2Y`h=Sgw8+#y;Mf^A
z?gblC)vTlM*D02f(>o|4g(~B-?Hl7^oL)WSkgSe1i1g$$t1BXR)^6C;a$ju6Y>8T0
zrj#pd`f`S2q)h$5xS_ct2a`@(w=}~V9w1~b*EnM68Mzeoa*vf9)o05p*WP;D?cwlJ
z?|hX0Y|1#6HQY(HT9U*ZRpDw`JtrN~=nnVV8jq-XmT*<LMv?}(KAzF37HXv~TraCh
zsmCF7M2L+_qpUh|&ry2(VrY}nEUB7&z)YreQ>Zp8ZIaq4_vJ*|LRqeCljQ!iJvvIs
zI6~JR?vT_A(!+e>uB7Ac8`CYCo2Rz3DjYt@_1iT~*Ca`*j`huW=vBvR1&Y-|Fy;Xw
zt9%m*v-PZ%w!0p7gcikP>=ZlA&a(6DL-rZ_id|;kv7gzW>@POQ{sx1L60AiP>QIjj
zxEn2K#TK+-7aqiZBrt>#7&r<O$8a1|n8pd5#3?+DXYeduz-hdOH}EFT;4IGJ1AK%F
zxQNg31uo-9{DNQc8-B-Js34?-N<(GhenWY#cjxcl*O!x=U(CdH|6^R})vI$o^1!a$
zdzAQf&-HIsbAsPoe#@GQ=(@U%O`Es2&(mPZlV8X{k92}n9^3M4@*ehL3X7GXL=F%s
z^@-&cgu0S19%+_)SKSebsGNGDyS|3HAzB)udslr#Q45Ipvgh2;s6^Bv;<&Kh+pH*R
zAuR%7-O@(Z6-0Mo-4-S*^KJ1O3Iuv1{wI0=mAYTDOYA512b&|x7NHnrh@h6}+Jvpx
zNo4Ir7xtnT{TRR?4nfB-(e@D{u8SNdFiGS+iO2B-p2Sml4$l*HU&Kpzov8a3-o`t4
z7w_SHBJp{m@W=QBpAv~@@h!ezLfNjxl*JDVDVs}VEYr4zNtdViV)vkTEfFXX!7BOr
zf5-CQ|F7kgL976Q0D<ca0Tgy5I@;-`mV4>)vv!oO!*ub&{bq#phET;_xZXRClbrv<
eklIn-7W3tdkYu6qzkdj@g8e_(|2^v6(A7UOUMBVc


From 74526bdde4b080916100261d4301dad5863b67df Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 22 Nov 2019 16:22:42 +0800
Subject: [PATCH 005/181] Bumped version to 5.3.2

Update the CHANGELOG
---
 CHANGELOG.md        | 6 ++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2a196fbe..ea18fcfb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.3 Patch, on Nov 22nd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.2)
+See [all tickets marked for the 5.3.2 release](https://github.com/SDWebImage/SDWebImage/milestone/53)
+
+### Fixes
+- Fix animated image playback bugs that cause rendering frame is previous frame index #2895. Thanks @ZXIOU 
+
 ## [5.3 Patch, on Nov 9th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.1)
 See [all tickets marked for the 5.3.1 release](https://github.com/SDWebImage/SDWebImage/milestone/52)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index abe5f7c7..e6c81be4 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.3.1'
+  s.version = '5.3.2'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index b3d623a4..92626e2a 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.3.1</string>
+	<string>5.3.2</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.3.1</string>
+	<string>5.3.2</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 892a7ad892141812f49221e2983eff69a96aea7b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 23 Nov 2019 18:50:39 +0800
Subject: [PATCH 006/181] Add the feature to allows advanced user to provided
 extended data associarted with image data, used for scale factor saving, rich
 link metadata saving, etc

---
 SDWebImage.xcodeproj/project.pbxproj          |  20 +++
 SDWebImage/Core/NSData+ExtendedData.h         |  21 +++
 SDWebImage/Core/NSData+ExtendedData.m         |  23 ++++
 SDWebImage/Core/SDDiskCache.h                 |  20 +++
 SDWebImage/Core/SDDiskCache.m                 |  28 ++++
 SDWebImage/Core/SDImageCache.m                |  10 ++
 SDWebImage/Core/SDWebImageCacheSerializer.h   |   4 +
 .../NSFileManager+ExtendedAttributes.h        |  19 +++
 .../NSFileManager+ExtendedAttributes.m        | 128 ++++++++++++++++++
 WebImage/SDWebImage.h                         |   1 +
 10 files changed, 274 insertions(+)
 create mode 100644 SDWebImage/Core/NSData+ExtendedData.h
 create mode 100644 SDWebImage/Core/NSData+ExtendedData.m
 create mode 100644 SDWebImage/Private/NSFileManager+ExtendedAttributes.h
 create mode 100644 SDWebImage/Private/NSFileManager+ExtendedAttributes.m

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 1174fe97..28197f70 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -89,6 +89,12 @@
 		325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325C46282233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
 		325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
+		325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */; settings = {ATTRIBUTES = (Private, ); }; };
+		325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */; };
+		325F7CCA238942AB00AEDFCC /* NSData+ExtendedData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		325F7CCB238942AB00AEDFCC /* NSData+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */; };
+		325F7CCC2389463D00AEDFCC /* NSData+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */; };
+		325F7CCD2389467800AEDFCC /* NSData+ExtendedData.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */; };
 		326E2F2E236F0B23006F847F /* SDAnimatedImagePlayer.h in Headers */ = {isa = PBXBuildFile; fileRef = 326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		326E2F2F236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
 		326E2F30236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
@@ -298,6 +304,7 @@
 			dstPath = include/SDWebImage;
 			dstSubfolderSpec = 16;
 			files = (
+				325F7CCD2389467800AEDFCC /* NSData+ExtendedData.h in Copy Headers */,
 				326E2F36236F1E30006F847F /* SDAnimatedImagePlayer.h in Copy Headers */,
 				3250C9F12355E3DF0093A896 /* SDWebImageDownloaderDecryptor.h in Copy Headers */,
 				325427662355783C0042BAA4 /* SDWebImageDownloaderResponseModifier.h in Copy Headers */,
@@ -407,6 +414,10 @@
 		325C461F2233A02E004CAE11 /* UIColor+HexString.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "UIColor+HexString.m"; sourceTree = "<group>"; };
 		325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSBezierPath+RoundedCorners.h"; sourceTree = "<group>"; };
 		325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+RoundedCorners.m"; sourceTree = "<group>"; };
+		325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSFileManager+ExtendedAttributes.h"; sourceTree = "<group>"; };
+		325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSFileManager+ExtendedAttributes.m"; sourceTree = "<group>"; };
+		325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "NSData+ExtendedData.h"; path = "Core/NSData+ExtendedData.h"; sourceTree = "<group>"; };
+		325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "NSData+ExtendedData.m"; path = "Core/NSData+ExtendedData.m"; sourceTree = "<group>"; };
 		326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDAnimatedImagePlayer.h; path = Core/SDAnimatedImagePlayer.h; sourceTree = "<group>"; };
 		326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDAnimatedImagePlayer.m; path = Core/SDAnimatedImagePlayer.m; sourceTree = "<group>"; };
 		326E2F31236F1D58006F847F /* SDDeviceHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDDeviceHelper.h; sourceTree = "<group>"; };
@@ -635,6 +646,8 @@
 				325C461F2233A02E004CAE11 /* UIColor+HexString.m */,
 				325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */,
 				325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */,
+				325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */,
+				325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */,
 				329F123F223FAD3400B309FD /* SDInternalMacros.h */,
 				329F123E223FAD3400B309FD /* SDInternalMacros.m */,
 				329F1235223FAA3B00B309FD /* SDmetamacros.h */,
@@ -744,6 +757,8 @@
 			children = (
 				5D5B9140188EE8DD006D06BD /* NSData+ImageContentType.h */,
 				5D5B9141188EE8DD006D06BD /* NSData+ImageContentType.m */,
+				325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */,
+				325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */,
 				A18A6CC5172DC28500419892 /* UIImage+GIF.h */,
 				A18A6CC6172DC28500419892 /* UIImage+GIF.m */,
 				329A18571FFF5DFD008C9A2F /* UIImage+Metadata.h */,
@@ -849,6 +864,7 @@
 				3257EAFA21898AED0097B271 /* SDImageGraphics.h in Headers */,
 				32D3CDD121DDE87300C4DB49 /* UIImage+MemoryCacheCost.h in Headers */,
 				328BB6AC2081FEE500760D6C /* SDWebImageCacheSerializer.h in Headers */,
+				325F7CCA238942AB00AEDFCC /* NSData+ExtendedData.h in Headers */,
 				325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */,
 				321B378F2083290E00C0EA77 /* SDImageLoadersManager.h in Headers */,
 				329A185B1FFF5DFD008C9A2F /* UIImage+Metadata.h in Headers */,
@@ -906,6 +922,7 @@
 				32C0FDE32013426C001B8F2D /* SDWebImageIndicator.h in Headers */,
 				32F7C0712030114C00873181 /* SDImageTransformer.h in Headers */,
 				32E67311235765B500DB4987 /* SDDisplayLink.h in Headers */,
+				325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */,
 				4A2CAE2D1AB4BB7500B6BC39 /* UIImage+GIF.h in Headers */,
 				4A2CAE291AB4BB7500B6BC39 /* NSData+ImageContentType.h in Headers */,
 				328BB69E2081FED200760D6C /* SDWebImageCacheKeyFilter.h in Headers */,
@@ -1098,6 +1115,7 @@
 				3257EAFD21898AED0097B271 /* SDImageGraphics.m in Sources */,
 				3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */,
 				325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */,
+				325F7CCB238942AB00AEDFCC /* NSData+ExtendedData.m in Sources */,
 				321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9F02355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
@@ -1127,6 +1145,7 @@
 				321E609C1F38E8ED00405457 /* SDImageIOCoder.m in Sources */,
 				4A2CAE261AB4BB7000B6BC39 /* SDWebImagePrefetcher.m in Sources */,
 				328BB6C92082581100760D6C /* SDDiskCache.m in Sources */,
+				325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */,
 				3248475F201775F600AF9E5A /* SDAnimatedImageView.m in Sources */,
 				32D1222C2080B2EB003685A3 /* SDImageCachesManager.m in Sources */,
 				32B9B53F206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
@@ -1198,6 +1217,7 @@
 				5376130D155AD0D5005750A4 /* SDWebImagePrefetcher.m in Sources */,
 				328BB6C72082581100760D6C /* SDDiskCache.m in Sources */,
 				3248475D201775F600AF9E5A /* SDAnimatedImageView.m in Sources */,
+				325F7CCC2389463D00AEDFCC /* NSData+ExtendedData.m in Sources */,
 				32D1222A2080B2EB003685A3 /* SDImageCachesManager.m in Sources */,
 				32B9B53D206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
 				43A9186B1D8308FE00B3925F /* SDImageCacheConfig.m in Sources */,
diff --git a/SDWebImage/Core/NSData+ExtendedData.h b/SDWebImage/Core/NSData+ExtendedData.h
new file mode 100644
index 00000000..abc80ad4
--- /dev/null
+++ b/SDWebImage/Core/NSData+ExtendedData.h
@@ -0,0 +1,21 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+* (c) Fabrice Aneche
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import <Foundation/Foundation.h>
+#import "SDWebImageCompat.h"
+
+@interface NSData (ExtendedData)
+
+/**
+ Read and Write the extended data to the image data. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
+ The extended data will be write to disk cache as well as the image data. The disk cache preserve both of the data and extended data with the same cache key.
+ */
+@property (nonatomic, strong, nullable) NSData *sd_extendedData;
+
+@end
diff --git a/SDWebImage/Core/NSData+ExtendedData.m b/SDWebImage/Core/NSData+ExtendedData.m
new file mode 100644
index 00000000..e50863cc
--- /dev/null
+++ b/SDWebImage/Core/NSData+ExtendedData.m
@@ -0,0 +1,23 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+* (c) Fabrice Aneche
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "NSData+ExtendedData.h"
+#import <objc/runtime.h>
+
+@implementation NSData (ExtendedData)
+
+- (NSData *)sd_extendedData {
+    return objc_getAssociatedObject(self, @selector(sd_extendedData));
+}
+
+- (void)setSd_extendedData:(NSData *)sd_extendedData {
+    objc_setAssociatedObject(self, @selector(sd_extendedData), sd_extendedData, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+@end
diff --git a/SDWebImage/Core/SDDiskCache.h b/SDWebImage/Core/SDDiskCache.h
index ffc440e5..dc5e1fae 100644
--- a/SDWebImage/Core/SDDiskCache.h
+++ b/SDWebImage/Core/SDDiskCache.h
@@ -54,6 +54,26 @@
  */
 - (void)setData:(nullable NSData *)data forKey:(nonnull NSString *)key;
 
+/**
+ Returns the extended data associated with a given key.
+ This method may blocks the calling thread until file read finished.
+ 
+ @param key A string identifying the data. If nil, just return nil.
+ @return The value associated with key, or nil if no value is associated with key.
+ */
+- (nullable NSData *)extendedDataForKey:(nonnull NSString *)key;
+
+/**
+ Set extended data with a given key.
+ 
+ @discussion You can set any extended data to exist cache key. Without override the exist disk file data.
+ on UNIX, the common way for this is to use the Extended file attributes (xattr)
+ 
+ @param extendedData The extended data (pass nil to remove).
+ @param key The key with which to associate the value. If nil, this method has no effect.
+*/
+- (void)setExtendedData:(nullable NSData *)extendedData forKey:(nonnull NSString *)key;
+
 /**
  Removes the value of the specified key in the cache.
  This method may blocks the calling thread until file delete finished.
diff --git a/SDWebImage/Core/SDDiskCache.m b/SDWebImage/Core/SDDiskCache.m
index 1d5ec44e..dff1f37f 100644
--- a/SDWebImage/Core/SDDiskCache.m
+++ b/SDWebImage/Core/SDDiskCache.m
@@ -8,8 +8,11 @@
 
 #import "SDDiskCache.h"
 #import "SDImageCacheConfig.h"
+#import "NSFileManager+ExtendedAttributes.h"
 #import <CommonCrypto/CommonDigest.h>
 
+static NSString * const SDDiskCacheExtendedAttributeName = @"com.hackemist.SDDiskCache";
+
 @interface SDDiskCache ()
 
 @property (nonatomic, copy) NSString *diskCachePath;
@@ -95,6 +98,31 @@
     }
 }
 
+- (NSData *)extendedDataForKey:(NSString *)key {
+    NSParameterAssert(key);
+    
+    // get cache Path for image key
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    
+    NSData *extendedData = [self.fileManager extendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+    
+    return extendedData;
+}
+
+- (void)setExtendedData:(NSData *)extendedData forKey:(NSString *)key {
+    NSParameterAssert(key);
+    // get cache Path for image key
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    
+    if (!extendedData) {
+        // Remove
+        [self.fileManager removeExtendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+    } else {
+        // Override
+        [self.fileManager setExtendedAttribute:SDDiskCacheExtendedAttributeName value:extendedData atPath:cachePathForKey traverseLink:NO overwrite:YES error:nil];
+    }
+}
+
 - (void)removeDataForKey:(NSString *)key {
     NSParameterAssert(key);
     NSString *filePath = [self cachePathForKey:key];
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 4c16f763..b8075ab2 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -14,6 +14,7 @@
 #import "SDAnimatedImage.h"
 #import "UIImage+MemoryCacheCost.h"
 #import "UIImage+Metadata.h"
+#import "NSData+ExtendedData.h"
 
 @interface SDImageCache ()
 
@@ -238,6 +239,10 @@
     }
     
     [self.diskCache setData:imageData forKey:key];
+    NSData *extendedData = imageData.sd_extendedData;
+    if (extendedData) {
+        [self.diskCache setExtendedData:extendedData forKey:key];
+    }
 }
 
 #pragma mark - Query and Retrieve Ops
@@ -320,6 +325,11 @@
     
     NSData *data = [self.diskCache dataForKey:key];
     if (data) {
+        // Check extended data
+        NSData *extendedData = [self.diskCache extendedDataForKey:key];
+        if (extendedData) {
+            data.sd_extendedData = extendedData;
+        }
         return data;
     }
     
diff --git a/SDWebImage/Core/SDWebImageCacheSerializer.h b/SDWebImage/Core/SDWebImageCacheSerializer.h
index 84c92a37..3c271b1f 100644
--- a/SDWebImage/Core/SDWebImageCacheSerializer.h
+++ b/SDWebImage/Core/SDWebImageCacheSerializer.h
@@ -17,6 +17,10 @@ typedef NSData * _Nullable(^SDWebImageCacheSerializerBlock)(UIImage * _Nonnull i
  */
 @protocol SDWebImageCacheSerializer <NSObject>
 
+/// Provide the image data associated to the image and store to disk cache
+/// @param image The loaded image
+/// @param data The original loaded image data
+/// @param imageURL The image URL
 - (nullable NSData *)cacheDataWithImage:(nonnull UIImage *)image originalData:(nullable NSData *)data imageURL:(nullable NSURL *)imageURL;
 
 @end
diff --git a/SDWebImage/Private/NSFileManager+ExtendedAttributes.h b/SDWebImage/Private/NSFileManager+ExtendedAttributes.h
new file mode 100644
index 00000000..fef3a6cb
--- /dev/null
+++ b/SDWebImage/Private/NSFileManager+ExtendedAttributes.h
@@ -0,0 +1,19 @@
+//
+//  NSFileManager+ExtendedAttributes.h
+//  NSFileManager+ExtendedAttributes
+//
+//  Created by Jesús A. Álvarez on 2008-12-17.
+//  Copyright 2008-2009 namedfork.net. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface NSFileManager (ExtendedAttributes)
+
+- (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
+- (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
+- (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
+- (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err;
+- (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
+
+@end
diff --git a/SDWebImage/Private/NSFileManager+ExtendedAttributes.m b/SDWebImage/Private/NSFileManager+ExtendedAttributes.m
new file mode 100644
index 00000000..2ec60bf4
--- /dev/null
+++ b/SDWebImage/Private/NSFileManager+ExtendedAttributes.m
@@ -0,0 +1,128 @@
+//
+//  NSFileManager+ExtendedAttributes.m
+//  NSFileManager+ExtendedAttributes
+//
+//  Created by Jesús A. Álvarez on 2008-12-17.
+//  Copyright 2008-2009 namedfork.net. All rights reserved.
+//
+
+#import "NSFileManager+ExtendedAttributes.h"
+#import <sys/xattr.h>
+
+@implementation NSFileManager (ExtendedAttributes)
+
+- (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
+    int flags = follow? 0 : XATTR_NOFOLLOW;
+    
+    // get size of name list
+    ssize_t nameBuffLen = listxattr([path fileSystemRepresentation], NULL, 0, flags);
+    if (nameBuffLen == -1) {
+        if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
+            [NSDictionary dictionaryWithObjectsAndKeys:
+             [NSString stringWithUTF8String:strerror(errno)], @"error",
+             @"listxattr", @"function",
+             path, @":path",
+             [NSNumber numberWithBool:follow], @":traverseLink",
+             nil]
+            ];
+        return nil;
+    } else if (nameBuffLen == 0) return [NSArray array];
+    
+    // get name list
+    NSMutableData *nameBuff = [NSMutableData dataWithLength:nameBuffLen];
+    listxattr([path fileSystemRepresentation], [nameBuff mutableBytes], nameBuffLen, flags);
+    
+    // convert to array
+    NSMutableArray * names = [NSMutableArray arrayWithCapacity:5];
+    char *nextName, *endOfNames = [nameBuff mutableBytes] + nameBuffLen;
+    for(nextName = [nameBuff mutableBytes]; nextName < endOfNames; nextName += 1+strlen(nextName))
+        [names addObject:[NSString stringWithUTF8String:nextName]];
+    return [NSArray arrayWithArray:names];
+}
+
+- (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
+    int flags = follow? 0 : XATTR_NOFOLLOW;
+    
+    // get size of name list
+    ssize_t nameBuffLen = listxattr([path fileSystemRepresentation], NULL, 0, flags);
+    if (nameBuffLen == -1) {
+        if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
+            [NSDictionary dictionaryWithObjectsAndKeys:
+             [NSString stringWithUTF8String:strerror(errno)], @"error",
+             @"listxattr", @"function",
+             path, @":path",
+             [NSNumber numberWithBool:follow], @":traverseLink",
+             nil]
+            ];
+        return NO;
+    } else if (nameBuffLen == 0) return NO;
+    
+    // get name list
+    NSMutableData *nameBuff = [NSMutableData dataWithLength:nameBuffLen];
+    listxattr([path fileSystemRepresentation], [nameBuff mutableBytes], nameBuffLen, flags);
+    
+    // find our name
+    char *nextName, *endOfNames = [nameBuff mutableBytes] + nameBuffLen;
+    for(nextName = [nameBuff mutableBytes]; nextName < endOfNames; nextName += 1+strlen(nextName))
+        if (strcmp(nextName, [name UTF8String]) == 0) return YES;
+    return NO;
+}
+
+- (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
+    int flags = follow? 0 : XATTR_NOFOLLOW;
+    // get length
+    ssize_t attrLen = getxattr([path fileSystemRepresentation], [name UTF8String], NULL, 0, 0, flags);
+    if (attrLen == -1) {
+        if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
+                         [NSDictionary dictionaryWithObjectsAndKeys:
+                          [NSString stringWithUTF8String:strerror(errno)], @"error",
+                          @"getxattr", @"function",
+                          name, @":name",
+                          path, @":path",
+                          [NSNumber numberWithBool:follow], @":traverseLink",
+                          nil]
+                         ];
+        return nil;
+    }
+    
+    // get attribute data
+    NSMutableData * attrData = [NSMutableData dataWithLength:attrLen];
+    getxattr([path fileSystemRepresentation], [name UTF8String], [attrData mutableBytes], attrLen, 0, flags);
+    return attrData;
+}
+
+- (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err {
+    int flags = (follow? 0 : XATTR_NOFOLLOW) | (overwrite? 0 : XATTR_CREATE);
+    if (0 == setxattr([path fileSystemRepresentation], [name UTF8String], [value bytes], [value length], 0, flags)) return YES;
+    // error
+    if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
+                     [NSDictionary dictionaryWithObjectsAndKeys:
+                      [NSString stringWithUTF8String:strerror(errno)], @"error",
+                      @"setxattr", @"function",
+                      name, @":name",
+                      [NSNumber numberWithUnsignedInteger:[value length]], @":value.length",
+                      path, @":path",
+                      [NSNumber numberWithBool:follow], @":traverseLink",
+                      [NSNumber numberWithBool:overwrite], @":overwrite",
+                      nil]
+                     ];
+    return NO;
+}
+
+- (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
+    int flags = (follow? 0 : XATTR_NOFOLLOW);
+    if (0 == removexattr([path fileSystemRepresentation], [name UTF8String], flags)) return YES;
+    // error
+    if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
+                     [NSDictionary dictionaryWithObjectsAndKeys:
+                      [NSString stringWithUTF8String:strerror(errno)], @"error",
+                      @"removexattr", @"function",
+                      name, @":name",
+                      path, @":path",
+                      [NSNumber numberWithBool:follow], @":traverseLink",
+                      nil]
+                     ];
+    return NO;
+}
+
+@end
diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index 6a683cd1..4641b7bd 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -67,6 +67,7 @@ FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
 #import <SDWebImage/UIImage+GIF.h>
 #import <SDWebImage/UIImage+ForceDecode.h>
 #import <SDWebImage/NSData+ImageContentType.h>
+#import <SDWebImage/NSData+ExtendedData.h>
 #import <SDWebImage/SDWebImageDefine.h>
 #import <SDWebImage/SDWebImageError.h>
 #import <SDWebImage/SDWebImageOptionsProcessor.h>

From 7c8d3225c85533167a83b3068fbda72a04f5becb Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 24 Nov 2019 01:33:08 +0800
Subject: [PATCH 007/181] Rename the the extended data to bind it into the
 UIImage object, which make it compatible for memory cache

---
 SDWebImage.xcodeproj/project.pbxproj          | 24 +++++++++----------
 SDWebImage/Core/SDImageCache.m                | 22 +++++++++--------
 ...+ExtendedData.h => UIImage+ExtendedData.h} |  4 ++--
 ...+ExtendedData.m => UIImage+ExtendedData.m} |  4 ++--
 WebImage/SDWebImage.h                         |  2 +-
 5 files changed, 29 insertions(+), 27 deletions(-)
 rename SDWebImage/Core/{NSData+ExtendedData.h => UIImage+ExtendedData.h} (75%)
 rename SDWebImage/Core/{NSData+ExtendedData.m => UIImage+ExtendedData.m} (88%)

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 28197f70..d70207fd 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -91,10 +91,10 @@
 		325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
 		325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */; };
-		325F7CCA238942AB00AEDFCC /* NSData+ExtendedData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		325F7CCB238942AB00AEDFCC /* NSData+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */; };
-		325F7CCC2389463D00AEDFCC /* NSData+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */; };
-		325F7CCD2389467800AEDFCC /* NSData+ExtendedData.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */; };
+		325F7CCA238942AB00AEDFCC /* UIImage+ExtendedData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		325F7CCB238942AB00AEDFCC /* UIImage+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */; };
+		325F7CCC2389463D00AEDFCC /* UIImage+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */; };
+		325F7CCD2389467800AEDFCC /* UIImage+ExtendedData.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */; };
 		326E2F2E236F0B23006F847F /* SDAnimatedImagePlayer.h in Headers */ = {isa = PBXBuildFile; fileRef = 326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		326E2F2F236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
 		326E2F30236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
@@ -304,7 +304,7 @@
 			dstPath = include/SDWebImage;
 			dstSubfolderSpec = 16;
 			files = (
-				325F7CCD2389467800AEDFCC /* NSData+ExtendedData.h in Copy Headers */,
+				325F7CCD2389467800AEDFCC /* UIImage+ExtendedData.h in Copy Headers */,
 				326E2F36236F1E30006F847F /* SDAnimatedImagePlayer.h in Copy Headers */,
 				3250C9F12355E3DF0093A896 /* SDWebImageDownloaderDecryptor.h in Copy Headers */,
 				325427662355783C0042BAA4 /* SDWebImageDownloaderResponseModifier.h in Copy Headers */,
@@ -416,8 +416,8 @@
 		325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+RoundedCorners.m"; sourceTree = "<group>"; };
 		325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSFileManager+ExtendedAttributes.h"; sourceTree = "<group>"; };
 		325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSFileManager+ExtendedAttributes.m"; sourceTree = "<group>"; };
-		325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "NSData+ExtendedData.h"; path = "Core/NSData+ExtendedData.h"; sourceTree = "<group>"; };
-		325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "NSData+ExtendedData.m"; path = "Core/NSData+ExtendedData.m"; sourceTree = "<group>"; };
+		325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "UIImage+ExtendedData.h"; path = "Core/UIImage+ExtendedData.h"; sourceTree = "<group>"; };
+		325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "UIImage+ExtendedData.m"; path = "Core/UIImage+ExtendedData.m"; sourceTree = "<group>"; };
 		326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDAnimatedImagePlayer.h; path = Core/SDAnimatedImagePlayer.h; sourceTree = "<group>"; };
 		326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDAnimatedImagePlayer.m; path = Core/SDAnimatedImagePlayer.m; sourceTree = "<group>"; };
 		326E2F31236F1D58006F847F /* SDDeviceHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDDeviceHelper.h; sourceTree = "<group>"; };
@@ -757,8 +757,8 @@
 			children = (
 				5D5B9140188EE8DD006D06BD /* NSData+ImageContentType.h */,
 				5D5B9141188EE8DD006D06BD /* NSData+ImageContentType.m */,
-				325F7CC8238942AB00AEDFCC /* NSData+ExtendedData.h */,
-				325F7CC9238942AB00AEDFCC /* NSData+ExtendedData.m */,
+				325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */,
+				325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */,
 				A18A6CC5172DC28500419892 /* UIImage+GIF.h */,
 				A18A6CC6172DC28500419892 /* UIImage+GIF.m */,
 				329A18571FFF5DFD008C9A2F /* UIImage+Metadata.h */,
@@ -864,7 +864,7 @@
 				3257EAFA21898AED0097B271 /* SDImageGraphics.h in Headers */,
 				32D3CDD121DDE87300C4DB49 /* UIImage+MemoryCacheCost.h in Headers */,
 				328BB6AC2081FEE500760D6C /* SDWebImageCacheSerializer.h in Headers */,
-				325F7CCA238942AB00AEDFCC /* NSData+ExtendedData.h in Headers */,
+				325F7CCA238942AB00AEDFCC /* UIImage+ExtendedData.h in Headers */,
 				325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */,
 				321B378F2083290E00C0EA77 /* SDImageLoadersManager.h in Headers */,
 				329A185B1FFF5DFD008C9A2F /* UIImage+Metadata.h in Headers */,
@@ -1115,7 +1115,7 @@
 				3257EAFD21898AED0097B271 /* SDImageGraphics.m in Sources */,
 				3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */,
 				325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */,
-				325F7CCB238942AB00AEDFCC /* NSData+ExtendedData.m in Sources */,
+				325F7CCB238942AB00AEDFCC /* UIImage+ExtendedData.m in Sources */,
 				321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9F02355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
@@ -1217,7 +1217,7 @@
 				5376130D155AD0D5005750A4 /* SDWebImagePrefetcher.m in Sources */,
 				328BB6C72082581100760D6C /* SDDiskCache.m in Sources */,
 				3248475D201775F600AF9E5A /* SDAnimatedImageView.m in Sources */,
-				325F7CCC2389463D00AEDFCC /* NSData+ExtendedData.m in Sources */,
+				325F7CCC2389463D00AEDFCC /* UIImage+ExtendedData.m in Sources */,
 				32D1222A2080B2EB003685A3 /* SDImageCachesManager.m in Sources */,
 				32B9B53D206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
 				43A9186B1D8308FE00B3925F /* SDImageCacheConfig.m in Sources */,
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index b8075ab2..207deab0 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -14,7 +14,7 @@
 #import "SDAnimatedImage.h"
 #import "UIImage+MemoryCacheCost.h"
 #import "UIImage+Metadata.h"
-#import "NSData+ExtendedData.h"
+#import "UIImage+ExtendedData.h"
 
 @interface SDImageCache ()
 
@@ -198,6 +198,13 @@
                     data = [[SDImageCodersManager sharedManager] encodedDataWithImage:image format:format options:nil];
                 }
                 [self _storeImageDataToDisk:data forKey:key];
+                if (image) {
+                    // Check extended data
+                    NSData *extendedData = image.sd_extendedData;
+                    if (extendedData) {
+                        [self.diskCache setExtendedData:extendedData forKey:key];
+                    }
+                }
             }
             
             if (completionBlock) {
@@ -239,10 +246,6 @@
     }
     
     [self.diskCache setData:imageData forKey:key];
-    NSData *extendedData = imageData.sd_extendedData;
-    if (extendedData) {
-        [self.diskCache setExtendedData:extendedData forKey:key];
-    }
 }
 
 #pragma mark - Query and Retrieve Ops
@@ -325,11 +328,6 @@
     
     NSData *data = [self.diskCache dataForKey:key];
     if (data) {
-        // Check extended data
-        NSData *extendedData = [self.diskCache extendedDataForKey:key];
-        if (extendedData) {
-            data.sd_extendedData = extendedData;
-        }
         return data;
     }
     
@@ -356,6 +354,10 @@
 - (nullable UIImage *)diskImageForKey:(nullable NSString *)key data:(nullable NSData *)data options:(SDImageCacheOptions)options context:(SDWebImageContext *)context {
     if (data) {
         UIImage *image = SDImageCacheDecodeImageData(data, key, [[self class] imageOptionsFromCacheOptions:options], context);
+        if (image) {
+            // Check extended data
+            image.sd_extendedData = [self.diskCache extendedDataForKey:key];
+        }
         return image;
     } else {
         return nil;
diff --git a/SDWebImage/Core/NSData+ExtendedData.h b/SDWebImage/Core/UIImage+ExtendedData.h
similarity index 75%
rename from SDWebImage/Core/NSData+ExtendedData.h
rename to SDWebImage/Core/UIImage+ExtendedData.h
index abc80ad4..d7de86cb 100644
--- a/SDWebImage/Core/NSData+ExtendedData.h
+++ b/SDWebImage/Core/UIImage+ExtendedData.h
@@ -10,10 +10,10 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
-@interface NSData (ExtendedData)
+@interface UIImage (ExtendedData)
 
 /**
- Read and Write the extended data to the image data. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
+ Read and Write the extended data and bind it to the image. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
  The extended data will be write to disk cache as well as the image data. The disk cache preserve both of the data and extended data with the same cache key.
  */
 @property (nonatomic, strong, nullable) NSData *sd_extendedData;
diff --git a/SDWebImage/Core/NSData+ExtendedData.m b/SDWebImage/Core/UIImage+ExtendedData.m
similarity index 88%
rename from SDWebImage/Core/NSData+ExtendedData.m
rename to SDWebImage/Core/UIImage+ExtendedData.m
index e50863cc..21c79ba7 100644
--- a/SDWebImage/Core/NSData+ExtendedData.m
+++ b/SDWebImage/Core/UIImage+ExtendedData.m
@@ -7,10 +7,10 @@
 * file that was distributed with this source code.
 */
 
-#import "NSData+ExtendedData.h"
+#import "UIImage+ExtendedData.h"
 #import <objc/runtime.h>
 
-@implementation NSData (ExtendedData)
+@implementation UIImage (ExtendedData)
 
 - (NSData *)sd_extendedData {
     return objc_getAssociatedObject(self, @selector(sd_extendedData));
diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index 4641b7bd..9d17cae2 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -46,6 +46,7 @@ FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
 #import <SDWebImage/UIImage+Metadata.h>
 #import <SDWebImage/UIImage+MultiFormat.h>
 #import <SDWebImage/UIImage+MemoryCacheCost.h>
+#import <SDWebImage/UIImage+ExtendedData.h>
 #import <SDWebImage/SDWebImageOperation.h>
 #import <SDWebImage/SDWebImageDownloader.h>
 #import <SDWebImage/SDWebImageTransition.h>
@@ -67,7 +68,6 @@ FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
 #import <SDWebImage/UIImage+GIF.h>
 #import <SDWebImage/UIImage+ForceDecode.h>
 #import <SDWebImage/NSData+ImageContentType.h>
-#import <SDWebImage/NSData+ExtendedData.h>
 #import <SDWebImage/SDWebImageDefine.h>
 #import <SDWebImage/SDWebImageError.h>
 #import <SDWebImage/SDWebImageOptionsProcessor.h>

From 46b0c4bae83103209431b2ec1eddae718a55d6df Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 25 Nov 2019 15:43:31 +0800
Subject: [PATCH 008/181] Use the NSCoding object instead of `NSData`, make it
 possible to directlly get the extended data from memory cache without
 unarhive by user.

---
 SDWebImage.xcodeproj/project.pbxproj        | 24 ++++++++++-----------
 SDWebImage/Core/SDImageCache.m              | 16 +++++++++-----
 SDWebImage/Core/SDWebImageManager.m         |  4 ++++
 SDWebImage/Core/UIImage+ExtendedCacheData.h | 22 +++++++++++++++++++
 SDWebImage/Core/UIImage+ExtendedCacheData.m | 23 ++++++++++++++++++++
 SDWebImage/Core/UIImage+ExtendedData.h      | 21 ------------------
 SDWebImage/Core/UIImage+ExtendedData.m      | 23 --------------------
 WebImage/SDWebImage.h                       |  2 +-
 8 files changed, 73 insertions(+), 62 deletions(-)
 create mode 100644 SDWebImage/Core/UIImage+ExtendedCacheData.h
 create mode 100644 SDWebImage/Core/UIImage+ExtendedCacheData.m
 delete mode 100644 SDWebImage/Core/UIImage+ExtendedData.h
 delete mode 100644 SDWebImage/Core/UIImage+ExtendedData.m

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index d70207fd..5312d1be 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -91,10 +91,10 @@
 		325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
 		325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */; };
-		325F7CCA238942AB00AEDFCC /* UIImage+ExtendedData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		325F7CCB238942AB00AEDFCC /* UIImage+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */; };
-		325F7CCC2389463D00AEDFCC /* UIImage+ExtendedData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */; };
-		325F7CCD2389467800AEDFCC /* UIImage+ExtendedData.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */; };
+		325F7CCA238942AB00AEDFCC /* UIImage+ExtendedCacheData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		325F7CCB238942AB00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */; };
+		325F7CCC2389463D00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */; };
+		325F7CCD2389467800AEDFCC /* UIImage+ExtendedCacheData.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */; };
 		326E2F2E236F0B23006F847F /* SDAnimatedImagePlayer.h in Headers */ = {isa = PBXBuildFile; fileRef = 326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		326E2F2F236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
 		326E2F30236F0B23006F847F /* SDAnimatedImagePlayer.m in Sources */ = {isa = PBXBuildFile; fileRef = 326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */; };
@@ -304,7 +304,7 @@
 			dstPath = include/SDWebImage;
 			dstSubfolderSpec = 16;
 			files = (
-				325F7CCD2389467800AEDFCC /* UIImage+ExtendedData.h in Copy Headers */,
+				325F7CCD2389467800AEDFCC /* UIImage+ExtendedCacheData.h in Copy Headers */,
 				326E2F36236F1E30006F847F /* SDAnimatedImagePlayer.h in Copy Headers */,
 				3250C9F12355E3DF0093A896 /* SDWebImageDownloaderDecryptor.h in Copy Headers */,
 				325427662355783C0042BAA4 /* SDWebImageDownloaderResponseModifier.h in Copy Headers */,
@@ -416,8 +416,8 @@
 		325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+RoundedCorners.m"; sourceTree = "<group>"; };
 		325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSFileManager+ExtendedAttributes.h"; sourceTree = "<group>"; };
 		325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSFileManager+ExtendedAttributes.m"; sourceTree = "<group>"; };
-		325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "UIImage+ExtendedData.h"; path = "Core/UIImage+ExtendedData.h"; sourceTree = "<group>"; };
-		325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "UIImage+ExtendedData.m"; path = "Core/UIImage+ExtendedData.m"; sourceTree = "<group>"; };
+		325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "UIImage+ExtendedCacheData.h"; path = "Core/UIImage+ExtendedCacheData.h"; sourceTree = "<group>"; };
+		325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "UIImage+ExtendedCacheData.m"; path = "Core/UIImage+ExtendedCacheData.m"; sourceTree = "<group>"; };
 		326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDAnimatedImagePlayer.h; path = Core/SDAnimatedImagePlayer.h; sourceTree = "<group>"; };
 		326E2F2D236F0B23006F847F /* SDAnimatedImagePlayer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDAnimatedImagePlayer.m; path = Core/SDAnimatedImagePlayer.m; sourceTree = "<group>"; };
 		326E2F31236F1D58006F847F /* SDDeviceHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDDeviceHelper.h; sourceTree = "<group>"; };
@@ -757,8 +757,8 @@
 			children = (
 				5D5B9140188EE8DD006D06BD /* NSData+ImageContentType.h */,
 				5D5B9141188EE8DD006D06BD /* NSData+ImageContentType.m */,
-				325F7CC8238942AB00AEDFCC /* UIImage+ExtendedData.h */,
-				325F7CC9238942AB00AEDFCC /* UIImage+ExtendedData.m */,
+				325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */,
+				325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */,
 				A18A6CC5172DC28500419892 /* UIImage+GIF.h */,
 				A18A6CC6172DC28500419892 /* UIImage+GIF.m */,
 				329A18571FFF5DFD008C9A2F /* UIImage+Metadata.h */,
@@ -864,7 +864,7 @@
 				3257EAFA21898AED0097B271 /* SDImageGraphics.h in Headers */,
 				32D3CDD121DDE87300C4DB49 /* UIImage+MemoryCacheCost.h in Headers */,
 				328BB6AC2081FEE500760D6C /* SDWebImageCacheSerializer.h in Headers */,
-				325F7CCA238942AB00AEDFCC /* UIImage+ExtendedData.h in Headers */,
+				325F7CCA238942AB00AEDFCC /* UIImage+ExtendedCacheData.h in Headers */,
 				325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */,
 				321B378F2083290E00C0EA77 /* SDImageLoadersManager.h in Headers */,
 				329A185B1FFF5DFD008C9A2F /* UIImage+Metadata.h in Headers */,
@@ -1115,7 +1115,7 @@
 				3257EAFD21898AED0097B271 /* SDImageGraphics.m in Sources */,
 				3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */,
 				325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */,
-				325F7CCB238942AB00AEDFCC /* UIImage+ExtendedData.m in Sources */,
+				325F7CCB238942AB00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */,
 				321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9F02355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
@@ -1217,7 +1217,7 @@
 				5376130D155AD0D5005750A4 /* SDWebImagePrefetcher.m in Sources */,
 				328BB6C72082581100760D6C /* SDDiskCache.m in Sources */,
 				3248475D201775F600AF9E5A /* SDAnimatedImageView.m in Sources */,
-				325F7CCC2389463D00AEDFCC /* UIImage+ExtendedData.m in Sources */,
+				325F7CCC2389463D00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */,
 				32D1222A2080B2EB003685A3 /* SDImageCachesManager.m in Sources */,
 				32B9B53D206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
 				43A9186B1D8308FE00B3925F /* SDImageCacheConfig.m in Sources */,
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 207deab0..dd39f0da 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -14,7 +14,7 @@
 #import "SDAnimatedImage.h"
 #import "UIImage+MemoryCacheCost.h"
 #import "UIImage+Metadata.h"
-#import "UIImage+ExtendedData.h"
+#import "UIImage+ExtendedCacheData.h"
 
 @interface SDImageCache ()
 
@@ -200,9 +200,12 @@
                 [self _storeImageDataToDisk:data forKey:key];
                 if (image) {
                     // Check extended data
-                    NSData *extendedData = image.sd_extendedData;
-                    if (extendedData) {
-                        [self.diskCache setExtendedData:extendedData forKey:key];
+                    id<NSCoding> extendedObject = image.sd_extendedObject;
+                    if (extendedObject) {
+                        NSData *extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject];
+                        if (extendedData) {
+                            [self.diskCache setExtendedData:extendedData forKey:key];
+                        }
                     }
                 }
             }
@@ -356,7 +359,10 @@
         UIImage *image = SDImageCacheDecodeImageData(data, key, [[self class] imageOptionsFromCacheOptions:options], context);
         if (image) {
             // Check extended data
-            image.sd_extendedData = [self.diskCache extendedDataForKey:key];
+            NSData *extendedData = [self.diskCache extendedDataForKey:key];
+            if (extendedData) {
+                image.sd_extendedObject = [NSKeyedUnarchiver unarchiveObjectWithData:extendedData];
+            }
         }
         return image;
     } else {
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index dece6dbf..9a727e61 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -10,6 +10,7 @@
 #import "SDImageCache.h"
 #import "SDWebImageDownloader.h"
 #import "UIImage+Metadata.h"
+#import "UIImage+ExtendedCacheData.h"
 #import "SDWebImageError.h"
 #import "SDInternalMacros.h"
 
@@ -341,6 +342,9 @@ static id<SDImageLoader> _defaultImageLoader;
                     } else {
                         cacheData = (imageWasTransformed ? nil : downloadedData);
                     }
+                    // keep the original image format and extended data
+                    transformedImage.sd_imageFormat = downloadedImage.sd_imageFormat;
+                    transformedImage.sd_extendedObject = downloadedImage.sd_extendedObject;
                     [self.imageCache storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType completion:nil];
                 }
                 
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.h b/SDWebImage/Core/UIImage+ExtendedCacheData.h
new file mode 100644
index 00000000..6ba220e1
--- /dev/null
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.h
@@ -0,0 +1,22 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+* (c) Fabrice Aneche
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import <Foundation/Foundation.h>
+#import "SDWebImageCompat.h"
+
+@interface UIImage (ExtendedCacheData)
+
+/**
+ Read and Write the extended object and bind it to the image. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
+ The extended object should conforms to NSCoding, which we use `NSKeyedArchiver` and `NSKeyedUnarchiver` to archive it to data, and write to disk cache.
+ @note The disk cache preserve both of the data and extended data with the same cache key. For manual query, use the `SDDiskCache` protocol method `extendedDataForKey:` instead.
+ */
+@property (nonatomic, strong, nullable) id<NSCoding> sd_extendedObject;
+
+@end
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.m b/SDWebImage/Core/UIImage+ExtendedCacheData.m
new file mode 100644
index 00000000..38b58fc1
--- /dev/null
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.m
@@ -0,0 +1,23 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+* (c) Fabrice Aneche
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "UIImage+ExtendedCacheData.h"
+#import <objc/runtime.h>
+
+@implementation UIImage (ExtendedCacheData)
+
+- (id<NSCoding>)sd_extendedObject {
+    return objc_getAssociatedObject(self, @selector(sd_extendedObject));
+}
+
+- (void)setSd_extendedObject:(id<NSCoding>)sd_extendedObject {
+    objc_setAssociatedObject(self, @selector(sd_extendedObject), sd_extendedObject, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+@end
diff --git a/SDWebImage/Core/UIImage+ExtendedData.h b/SDWebImage/Core/UIImage+ExtendedData.h
deleted file mode 100644
index d7de86cb..00000000
--- a/SDWebImage/Core/UIImage+ExtendedData.h
+++ /dev/null
@@ -1,21 +0,0 @@
-/*
-* This file is part of the SDWebImage package.
-* (c) Olivier Poitrey <rs@dailymotion.com>
-* (c) Fabrice Aneche
-*
-* For the full copyright and license information, please view the LICENSE
-* file that was distributed with this source code.
-*/
-
-#import <Foundation/Foundation.h>
-#import "SDWebImageCompat.h"
-
-@interface UIImage (ExtendedData)
-
-/**
- Read and Write the extended data and bind it to the image. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
- The extended data will be write to disk cache as well as the image data. The disk cache preserve both of the data and extended data with the same cache key.
- */
-@property (nonatomic, strong, nullable) NSData *sd_extendedData;
-
-@end
diff --git a/SDWebImage/Core/UIImage+ExtendedData.m b/SDWebImage/Core/UIImage+ExtendedData.m
deleted file mode 100644
index 21c79ba7..00000000
--- a/SDWebImage/Core/UIImage+ExtendedData.m
+++ /dev/null
@@ -1,23 +0,0 @@
-/*
-* This file is part of the SDWebImage package.
-* (c) Olivier Poitrey <rs@dailymotion.com>
-* (c) Fabrice Aneche
-*
-* For the full copyright and license information, please view the LICENSE
-* file that was distributed with this source code.
-*/
-
-#import "UIImage+ExtendedData.h"
-#import <objc/runtime.h>
-
-@implementation UIImage (ExtendedData)
-
-- (NSData *)sd_extendedData {
-    return objc_getAssociatedObject(self, @selector(sd_extendedData));
-}
-
-- (void)setSd_extendedData:(NSData *)sd_extendedData {
-    objc_setAssociatedObject(self, @selector(sd_extendedData), sd_extendedData, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
-}
-
-@end
diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index 9d17cae2..ab0f43e5 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -46,7 +46,7 @@ FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
 #import <SDWebImage/UIImage+Metadata.h>
 #import <SDWebImage/UIImage+MultiFormat.h>
 #import <SDWebImage/UIImage+MemoryCacheCost.h>
-#import <SDWebImage/UIImage+ExtendedData.h>
+#import <SDWebImage/UIImage+ExtendedCacheData.h>
 #import <SDWebImage/SDWebImageOperation.h>
 #import <SDWebImage/SDWebImageDownloader.h>
 #import <SDWebImage/SDWebImageTransition.h>

From 9f470954c4c2edfc9ddbbe0758458f61dadba837 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 25 Nov 2019 17:05:27 +0800
Subject: [PATCH 009/181] Change the id<NSCoding> into id<NSObject, NSCoding>,
 to support directlly usage like isKindOfClass

---
 SDWebImage/Core/SDImageCache.m              | 4 ++--
 SDWebImage/Core/UIImage+ExtendedCacheData.h | 3 ++-
 SDWebImage/Core/UIImage+ExtendedCacheData.m | 4 ++--
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index dd39f0da..481054bb 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -200,8 +200,8 @@
                 [self _storeImageDataToDisk:data forKey:key];
                 if (image) {
                     // Check extended data
-                    id<NSCoding> extendedObject = image.sd_extendedObject;
-                    if (extendedObject) {
+                    id extendedObject = image.sd_extendedObject;
+                    if ([extendedObject conformsToProtocol:@protocol(NSCoding)]) {
                         NSData *extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject];
                         if (extendedData) {
                             [self.diskCache setExtendedData:extendedData forKey:key];
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.h b/SDWebImage/Core/UIImage+ExtendedCacheData.h
index 6ba220e1..e11508dd 100644
--- a/SDWebImage/Core/UIImage+ExtendedCacheData.h
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.h
@@ -16,7 +16,8 @@
  Read and Write the extended object and bind it to the image. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
  The extended object should conforms to NSCoding, which we use `NSKeyedArchiver` and `NSKeyedUnarchiver` to archive it to data, and write to disk cache.
  @note The disk cache preserve both of the data and extended data with the same cache key. For manual query, use the `SDDiskCache` protocol method `extendedDataForKey:` instead.
+ @note You can specify arbitrary object conforms to NSCoding (NSObject protocol here is used to support object like `dispatch_data_t`, which is not NSObject subclass). If you load image from disk cache, you should check the extended object class to avoid corrupted data.
  */
-@property (nonatomic, strong, nullable) id<NSCoding> sd_extendedObject;
+@property (nonatomic, strong, nullable) id<NSObject, NSCoding> sd_extendedObject;
 
 @end
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.m b/SDWebImage/Core/UIImage+ExtendedCacheData.m
index 38b58fc1..05d29cff 100644
--- a/SDWebImage/Core/UIImage+ExtendedCacheData.m
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.m
@@ -12,11 +12,11 @@
 
 @implementation UIImage (ExtendedCacheData)
 
-- (id<NSCoding>)sd_extendedObject {
+- (id<NSObject, NSCoding>)sd_extendedObject {
     return objc_getAssociatedObject(self, @selector(sd_extendedObject));
 }
 
-- (void)setSd_extendedObject:(id<NSCoding>)sd_extendedObject {
+- (void)setSd_extendedObject:(id<NSObject, NSCoding>)sd_extendedObject {
     objc_setAssociatedObject(self, @selector(sd_extendedObject), sd_extendedObject, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
 }
 

From 1df1d6a3ce425321d1d4381f20ab2629af0ab509 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 25 Nov 2019 19:57:50 +0800
Subject: [PATCH 010/181] Using the new NSKeyedArchive method on iOS 11+, use
 try catch on the old fireware to protect runtime crash

---
 SDWebImage/Core/SDImageCache.m              | 33 +++++++++++++++++++--
 SDWebImage/Core/UIImage+ExtendedCacheData.h |  1 +
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 481054bb..362a299b 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -202,7 +202,20 @@
                     // Check extended data
                     id extendedObject = image.sd_extendedObject;
                     if ([extendedObject conformsToProtocol:@protocol(NSCoding)]) {
-                        NSData *extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject];
+                        NSData *extendedData;
+                        if (@available(iOS 11, tvOS 11, macOS 10.13, watchOS 4, *)) {
+                            NSError *error;
+                            extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject requiringSecureCoding:NO error:&error];
+                            if (error) {
+                                NSLog(@"NSKeyedArchiver archive failed with error: %@", error);
+                            }
+                        } else {
+                            @try {
+                                extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject];
+                            } @catch (NSException *exception) {
+                                NSLog(@"NSKeyedArchiver archive failed with exception: %@", exception);
+                            }
+                        }
                         if (extendedData) {
                             [self.diskCache setExtendedData:extendedData forKey:key];
                         }
@@ -361,7 +374,23 @@
             // Check extended data
             NSData *extendedData = [self.diskCache extendedDataForKey:key];
             if (extendedData) {
-                image.sd_extendedObject = [NSKeyedUnarchiver unarchiveObjectWithData:extendedData];
+                id extendedObject;
+                if (@available(iOS 11, tvOS 11, macOS 10.13, watchOS 4, *)) {
+                    NSError *error;
+                    NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingFromData:extendedData error:&error];
+                    unarchiver.requiresSecureCoding = NO;
+                    extendedObject = [unarchiver decodeTopLevelObjectForKey:NSKeyedArchiveRootObjectKey error:&error];
+                    if (error) {
+                        NSLog(@"NSKeyedUnarchiver unarchive failed with error: %@", error);
+                    }
+                } else {
+                    @try {
+                        extendedObject = [NSKeyedUnarchiver unarchiveObjectWithData:extendedData];
+                    } @catch (NSException *exception) {
+                        NSLog(@"NSKeyedUnarchiver unarchive failed with exception: %@", exception);
+                    }
+                }
+                image.sd_extendedObject = extendedObject;
             }
         }
         return image;
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.h b/SDWebImage/Core/UIImage+ExtendedCacheData.h
index e11508dd..429640e0 100644
--- a/SDWebImage/Core/UIImage+ExtendedCacheData.h
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.h
@@ -17,6 +17,7 @@
  The extended object should conforms to NSCoding, which we use `NSKeyedArchiver` and `NSKeyedUnarchiver` to archive it to data, and write to disk cache.
  @note The disk cache preserve both of the data and extended data with the same cache key. For manual query, use the `SDDiskCache` protocol method `extendedDataForKey:` instead.
  @note You can specify arbitrary object conforms to NSCoding (NSObject protocol here is used to support object like `dispatch_data_t`, which is not NSObject subclass). If you load image from disk cache, you should check the extended object class to avoid corrupted data.
+ @warning This object don't need to implements NSSecureCoding (but it's recommended),  because we allows arbitrary class.
  */
 @property (nonatomic, strong, nullable) id<NSObject, NSCoding> sd_extendedObject;
 

From 9aa4ac1ca729e6de91e10491264f6b54f76ae5d4 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 25 Nov 2019 21:53:12 +0800
Subject: [PATCH 011/181] Rename the NSFileManager+ExtendedAttributes into the
 SDFileAttributeHelper, because it does not have any reply on NSFileManager
 API

---
 SDWebImage.xcodeproj/project.pbxproj            | 16 ++++++++--------
 SDWebImage/Core/SDDiskCache.m                   |  8 ++++----
 ...ndedAttributes.h => SDFileAttributeHelper.h} | 15 +++++++--------
 ...ndedAttributes.m => SDFileAttributeHelper.m} | 17 ++++++++---------
 4 files changed, 27 insertions(+), 29 deletions(-)
 rename SDWebImage/Private/{NSFileManager+ExtendedAttributes.h => SDFileAttributeHelper.h} (50%)
 rename SDWebImage/Private/{NSFileManager+ExtendedAttributes.m => SDFileAttributeHelper.m} (91%)

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 5312d1be..9635e935 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -89,8 +89,8 @@
 		325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325C46282233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
 		325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
-		325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */; settings = {ATTRIBUTES = (Private, ); }; };
-		325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */; };
+		325F7CC623893B2E00AEDFCC /* SDFileAttributeHelper.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */; settings = {ATTRIBUTES = (Private, ); }; };
+		325F7CC723893B2E00AEDFCC /* SDFileAttributeHelper.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */; };
 		325F7CCA238942AB00AEDFCC /* UIImage+ExtendedCacheData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		325F7CCB238942AB00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */; };
 		325F7CCC2389463D00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */; };
@@ -414,8 +414,8 @@
 		325C461F2233A02E004CAE11 /* UIColor+HexString.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "UIColor+HexString.m"; sourceTree = "<group>"; };
 		325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSBezierPath+RoundedCorners.h"; sourceTree = "<group>"; };
 		325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+RoundedCorners.m"; sourceTree = "<group>"; };
-		325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSFileManager+ExtendedAttributes.h"; sourceTree = "<group>"; };
-		325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSFileManager+ExtendedAttributes.m"; sourceTree = "<group>"; };
+		325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDFileAttributeHelper.h; sourceTree = "<group>"; };
+		325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDFileAttributeHelper.m; sourceTree = "<group>"; };
 		325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "UIImage+ExtendedCacheData.h"; path = "Core/UIImage+ExtendedCacheData.h"; sourceTree = "<group>"; };
 		325F7CC9238942AB00AEDFCC /* UIImage+ExtendedCacheData.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = "UIImage+ExtendedCacheData.m"; path = "Core/UIImage+ExtendedCacheData.m"; sourceTree = "<group>"; };
 		326E2F2C236F0B23006F847F /* SDAnimatedImagePlayer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDAnimatedImagePlayer.h; path = Core/SDAnimatedImagePlayer.h; sourceTree = "<group>"; };
@@ -646,8 +646,8 @@
 				325C461F2233A02E004CAE11 /* UIColor+HexString.m */,
 				325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */,
 				325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */,
-				325F7CC423893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h */,
-				325F7CC523893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m */,
+				325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */,
+				325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */,
 				329F123F223FAD3400B309FD /* SDInternalMacros.h */,
 				329F123E223FAD3400B309FD /* SDInternalMacros.m */,
 				329F1235223FAA3B00B309FD /* SDmetamacros.h */,
@@ -922,7 +922,7 @@
 				32C0FDE32013426C001B8F2D /* SDWebImageIndicator.h in Headers */,
 				32F7C0712030114C00873181 /* SDImageTransformer.h in Headers */,
 				32E67311235765B500DB4987 /* SDDisplayLink.h in Headers */,
-				325F7CC623893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.h in Headers */,
+				325F7CC623893B2E00AEDFCC /* SDFileAttributeHelper.h in Headers */,
 				4A2CAE2D1AB4BB7500B6BC39 /* UIImage+GIF.h in Headers */,
 				4A2CAE291AB4BB7500B6BC39 /* NSData+ImageContentType.h in Headers */,
 				328BB69E2081FED200760D6C /* SDWebImageCacheKeyFilter.h in Headers */,
@@ -1145,7 +1145,7 @@
 				321E609C1F38E8ED00405457 /* SDImageIOCoder.m in Sources */,
 				4A2CAE261AB4BB7000B6BC39 /* SDWebImagePrefetcher.m in Sources */,
 				328BB6C92082581100760D6C /* SDDiskCache.m in Sources */,
-				325F7CC723893B2E00AEDFCC /* NSFileManager+ExtendedAttributes.m in Sources */,
+				325F7CC723893B2E00AEDFCC /* SDFileAttributeHelper.m in Sources */,
 				3248475F201775F600AF9E5A /* SDAnimatedImageView.m in Sources */,
 				32D1222C2080B2EB003685A3 /* SDImageCachesManager.m in Sources */,
 				32B9B53F206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
diff --git a/SDWebImage/Core/SDDiskCache.m b/SDWebImage/Core/SDDiskCache.m
index dff1f37f..1dd9e10b 100644
--- a/SDWebImage/Core/SDDiskCache.m
+++ b/SDWebImage/Core/SDDiskCache.m
@@ -8,7 +8,7 @@
 
 #import "SDDiskCache.h"
 #import "SDImageCacheConfig.h"
-#import "NSFileManager+ExtendedAttributes.h"
+#import "SDFileAttributeHelper.h"
 #import <CommonCrypto/CommonDigest.h>
 
 static NSString * const SDDiskCacheExtendedAttributeName = @"com.hackemist.SDDiskCache";
@@ -104,7 +104,7 @@ static NSString * const SDDiskCacheExtendedAttributeName = @"com.hackemist.SDDis
     // get cache Path for image key
     NSString *cachePathForKey = [self cachePathForKey:key];
     
-    NSData *extendedData = [self.fileManager extendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+    NSData *extendedData = [SDFileAttributeHelper extendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
     
     return extendedData;
 }
@@ -116,10 +116,10 @@ static NSString * const SDDiskCacheExtendedAttributeName = @"com.hackemist.SDDis
     
     if (!extendedData) {
         // Remove
-        [self.fileManager removeExtendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+        [SDFileAttributeHelper removeExtendedAttribute:SDDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
     } else {
         // Override
-        [self.fileManager setExtendedAttribute:SDDiskCacheExtendedAttributeName value:extendedData atPath:cachePathForKey traverseLink:NO overwrite:YES error:nil];
+        [SDFileAttributeHelper setExtendedAttribute:SDDiskCacheExtendedAttributeName value:extendedData atPath:cachePathForKey traverseLink:NO overwrite:YES error:nil];
     }
 }
 
diff --git a/SDWebImage/Private/NSFileManager+ExtendedAttributes.h b/SDWebImage/Private/SDFileAttributeHelper.h
similarity index 50%
rename from SDWebImage/Private/NSFileManager+ExtendedAttributes.h
rename to SDWebImage/Private/SDFileAttributeHelper.h
index fef3a6cb..1e66ded7 100644
--- a/SDWebImage/Private/NSFileManager+ExtendedAttributes.h
+++ b/SDWebImage/Private/SDFileAttributeHelper.h
@@ -1,6 +1,5 @@
 //
-//  NSFileManager+ExtendedAttributes.h
-//  NSFileManager+ExtendedAttributes
+//  This file is from https://gist.github.com/zydeco/6292773
 //
 //  Created by Jesús A. Álvarez on 2008-12-17.
 //  Copyright 2008-2009 namedfork.net. All rights reserved.
@@ -8,12 +7,12 @@
 
 #import <Foundation/Foundation.h>
 
-@interface NSFileManager (ExtendedAttributes)
+@interface SDFileAttributeHelper : NSObject
 
-- (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-- (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-- (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-- (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err;
-- (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
++ (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
++ (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
++ (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
++ (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err;
++ (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
 
 @end
diff --git a/SDWebImage/Private/NSFileManager+ExtendedAttributes.m b/SDWebImage/Private/SDFileAttributeHelper.m
similarity index 91%
rename from SDWebImage/Private/NSFileManager+ExtendedAttributes.m
rename to SDWebImage/Private/SDFileAttributeHelper.m
index 2ec60bf4..fcb8ad47 100644
--- a/SDWebImage/Private/NSFileManager+ExtendedAttributes.m
+++ b/SDWebImage/Private/SDFileAttributeHelper.m
@@ -1,17 +1,16 @@
 //
-//  NSFileManager+ExtendedAttributes.m
-//  NSFileManager+ExtendedAttributes
+//  This file is from https://gist.github.com/zydeco/6292773
 //
 //  Created by Jesús A. Álvarez on 2008-12-17.
 //  Copyright 2008-2009 namedfork.net. All rights reserved.
 //
 
-#import "NSFileManager+ExtendedAttributes.h"
+#import "SDFileAttributeHelper.h"
 #import <sys/xattr.h>
 
-@implementation NSFileManager (ExtendedAttributes)
+@implementation SDFileAttributeHelper
 
-- (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     
     // get size of name list
@@ -40,7 +39,7 @@
     return [NSArray arrayWithArray:names];
 }
 
-- (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     
     // get size of name list
@@ -68,7 +67,7 @@
     return NO;
 }
 
-- (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     // get length
     ssize_t attrLen = getxattr([path fileSystemRepresentation], [name UTF8String], NULL, 0, 0, flags);
@@ -91,7 +90,7 @@
     return attrData;
 }
 
-- (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err {
++ (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err {
     int flags = (follow? 0 : XATTR_NOFOLLOW) | (overwrite? 0 : XATTR_CREATE);
     if (0 == setxattr([path fileSystemRepresentation], [name UTF8String], [value bytes], [value length], 0, flags)) return YES;
     // error
@@ -109,7 +108,7 @@
     return NO;
 }
 
-- (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
     int flags = (follow? 0 : XATTR_NOFOLLOW);
     if (0 == removexattr([path fileSystemRepresentation], [name UTF8String], flags)) return YES;
     // error

From dd2c5263c8482266023033369c049ac1dd6a7492 Mon Sep 17 00:00:00 2001
From: Ben Cherry <bcherry@gmail.com>
Date: Tue, 26 Nov 2019 10:22:35 -0800
Subject: [PATCH 012/181] Support using NSCache delegate with SDMemoryCache
 default implementation

---
 SDWebImage/Core/SDMemoryCache.h | 9 +++++----
 SDWebImage/Core/SDMemoryCache.m | 7 ++++---
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/SDWebImage/Core/SDMemoryCache.h b/SDWebImage/Core/SDMemoryCache.h
index 8b415816..43c39e84 100644
--- a/SDWebImage/Core/SDMemoryCache.h
+++ b/SDWebImage/Core/SDMemoryCache.h
@@ -15,6 +15,7 @@
 @protocol SDMemoryCache <NSObject>
 
 @required
+
 /**
  Create a new memory cache instance with the specify cache config. You can check `maxMemoryCost` and `maxMemoryCount` used for memory cache.
 
@@ -25,7 +26,7 @@
 
 /**
  Returns the value associated with a given key.
- 
+
  @param key An object identifying the value. If nil, just return nil.
  @return The value associated with key, or nil if no value is associated with key.
  */
@@ -33,7 +34,7 @@
 
 /**
  Sets the value of the specified key in the cache (0 cost).
- 
+
  @param object The object to be stored in the cache. If nil, it calls `removeObjectForKey:`.
  @param key    The key with which to associate the value. If nil, this method has no effect.
  @discussion Unlike an NSMutableDictionary object, a cache does not copy the key
@@ -44,7 +45,7 @@
 /**
  Sets the value of the specified key in the cache, and associates the key-value
  pair with the specified cost.
- 
+
  @param object The object to store in the cache. If nil, it calls `removeObjectForKey`.
  @param key    The key with which to associate the value. If nil, this method has no effect.
  @param cost   The cost with which to associate the key-value pair.
@@ -55,7 +56,7 @@
 
 /**
  Removes the value of the specified key in the cache.
- 
+
  @param key The key identifying the value to be removed. If nil, this method has no effect.
  */
 - (void)removeObjectForKey:(nonnull id)key;
diff --git a/SDWebImage/Core/SDMemoryCache.m b/SDWebImage/Core/SDMemoryCache.m
index e3991994..b354b495 100644
--- a/SDWebImage/Core/SDMemoryCache.m
+++ b/SDWebImage/Core/SDMemoryCache.m
@@ -30,6 +30,7 @@ static void * SDMemoryCacheContext = &SDMemoryCacheContext;
 #if SD_UIKIT
     [[NSNotificationCenter defaultCenter] removeObserver:self name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
 #endif
+    self.delegate = nil;
 }
 
 - (instancetype)init {
@@ -54,14 +55,14 @@ static void * SDMemoryCacheContext = &SDMemoryCacheContext;
     SDImageCacheConfig *config = self.config;
     self.totalCostLimit = config.maxMemoryCost;
     self.countLimit = config.maxMemoryCount;
-    
+
     [config addObserver:self forKeyPath:NSStringFromSelector(@selector(maxMemoryCost)) options:0 context:SDMemoryCacheContext];
     [config addObserver:self forKeyPath:NSStringFromSelector(@selector(maxMemoryCount)) options:0 context:SDMemoryCacheContext];
-    
+
 #if SD_UIKIT
     self.weakCache = [[NSMapTable alloc] initWithKeyOptions:NSPointerFunctionsStrongMemory valueOptions:NSPointerFunctionsWeakMemory capacity:0];
     self.weakCacheLock = dispatch_semaphore_create(1);
-    
+
     [[NSNotificationCenter defaultCenter] addObserver:self
                                              selector:@selector(didReceiveMemoryWarning:)
                                                  name:UIApplicationDidReceiveMemoryWarningNotification

From 5f2a9695d866673bcecde7ca9ba8fcd37a91adbe Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 28 Nov 2019 19:49:51 +0800
Subject: [PATCH 013/181] Add the test case for SDFileAttributeHelper, fix the
 issue that associated object is lost

---
 SDWebImage/Core/SDWebImageDefine.m          |  2 ++
 SDWebImage/Core/SDWebImageManager.m         |  1 +
 SDWebImage/Core/UIImage+ExtendedCacheData.h |  2 +-
 Tests/Tests/SDUtilsTests.m                  | 29 +++++++++++++++++++++
 4 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 0b2f2b5f..6231e36d 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -9,6 +9,7 @@
 #import "SDWebImageDefine.h"
 #import "UIImage+Metadata.h"
 #import "NSImage+Compatibility.h"
+#import "UIImage+ExtendedCacheData.h"
 
 #pragma mark - Image scale
 
@@ -112,6 +113,7 @@ inline UIImage * _Nullable SDScaledImageForScaleFactor(CGFloat scale, UIImage *
     }
     scaledImage.sd_isIncremental = image.sd_isIncremental;
     scaledImage.sd_imageFormat = image.sd_imageFormat;
+    scaledImage.sd_extendedObject = image.sd_extendedObject;
     
     return scaledImage;
 }
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 9a727e61..32b41211 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -343,6 +343,7 @@ static id<SDImageLoader> _defaultImageLoader;
                         cacheData = (imageWasTransformed ? nil : downloadedData);
                     }
                     // keep the original image format and extended data
+                    transformedImage.sd_isIncremental = downloadedImage.sd_isIncremental;
                     transformedImage.sd_imageFormat = downloadedImage.sd_imageFormat;
                     transformedImage.sd_extendedObject = downloadedImage.sd_extendedObject;
                     [self.imageCache storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType completion:nil];
diff --git a/SDWebImage/Core/UIImage+ExtendedCacheData.h b/SDWebImage/Core/UIImage+ExtendedCacheData.h
index 429640e0..482c8c40 100644
--- a/SDWebImage/Core/UIImage+ExtendedCacheData.h
+++ b/SDWebImage/Core/UIImage+ExtendedCacheData.h
@@ -16,7 +16,7 @@
  Read and Write the extended object and bind it to the image. Which can hold some extra metadata like Image's scale factor, URL rich link, date, etc.
  The extended object should conforms to NSCoding, which we use `NSKeyedArchiver` and `NSKeyedUnarchiver` to archive it to data, and write to disk cache.
  @note The disk cache preserve both of the data and extended data with the same cache key. For manual query, use the `SDDiskCache` protocol method `extendedDataForKey:` instead.
- @note You can specify arbitrary object conforms to NSCoding (NSObject protocol here is used to support object like `dispatch_data_t`, which is not NSObject subclass). If you load image from disk cache, you should check the extended object class to avoid corrupted data.
+ @note You can specify arbitrary object conforms to NSCoding (NSObject protocol here is used to support object using `NS_ROOT_CLASS`, which is not NSObject subclass). If you load image from disk cache, you should check the extended object class to avoid corrupted data.
  @warning This object don't need to implements NSSecureCoding (but it's recommended),  because we allows arbitrary class.
  */
 @property (nonatomic, strong, nullable) id<NSObject, NSCoding> sd_extendedObject;
diff --git a/Tests/Tests/SDUtilsTests.m b/Tests/Tests/SDUtilsTests.m
index e8b8d471..eafeb5e5 100644
--- a/Tests/Tests/SDUtilsTests.m
+++ b/Tests/Tests/SDUtilsTests.m
@@ -11,6 +11,7 @@
 #import "SDWeakProxy.h"
 #import "SDDisplayLink.h"
 #import "SDInternalMacros.h"
+#import "SDFileAttributeHelper.h"
 
 @interface SDUtilsTests : SDTestCase
 
@@ -74,6 +75,34 @@
     expect(duration).beLessThan(0.02);
 }
 
+- (void)testSDFileAttributeHelper {
+    NSData *fileData = [@"File Data" dataUsingEncoding:NSUTF8StringEncoding];
+    NSData *extendedData = [@"Extended Data" dataUsingEncoding:NSUTF8StringEncoding];
+    NSString *filePath = @"/tmp/file.dat";
+    [NSFileManager.defaultManager removeItemAtPath:filePath error:nil];
+    [fileData writeToFile:filePath atomically:YES];
+    BOOL exist = [NSFileManager.defaultManager fileExistsAtPath:filePath];
+    expect(exist).beTruthy();
+    
+    NSArray *names = [SDFileAttributeHelper extendedAttributeNamesAtPath:filePath traverseLink:NO error:nil];
+    expect(names.count).equal(0);
+    
+    NSString *attr = @"com.com.hackemist.test";
+    [SDFileAttributeHelper setExtendedAttribute:@"com.com.hackemist.test" value:extendedData atPath:filePath traverseLink:NO overwrite:YES error:nil];
+    
+    BOOL hasAttr =[SDFileAttributeHelper hasExtendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
+    expect(hasAttr).beTruthy();
+    
+    NSData *queriedData = [SDFileAttributeHelper extendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
+    expect(extendedData).equal(queriedData);
+    
+    BOOL removed = [SDFileAttributeHelper removeExtendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
+    expect(removed).beTruthy();
+    
+    hasAttr = [SDFileAttributeHelper hasExtendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
+    expect(hasAttr).beFalsy();
+}
+
 - (void)testSDScaledImageForKey {
     // Test nil
     expect(SDScaledImageForKey(nil, nil)).beNil();

From 5c1351a2fdc3bfc054efb63d28a397c5c2813e6f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 28 Nov 2019 20:54:25 +0800
Subject: [PATCH 014/181] Added `test47DiskCacheExtendedData` test case

---
 Tests/Tests/SDImageCacheTests.m | 22 ++++++++++++++++++++++
 Tests/Tests/SDUtilsTests.m      |  8 ++++++--
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index 3e54963e..516a7f36 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -491,6 +491,28 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
 }
 #endif
 
+- (void)test47DiskCacheExtendedData {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"SDImageCache extended data read/write works"];
+    UIImage *image = [self testPNGImage];
+    NSDictionary *extendedObject = @{@"Test" : @"Object"};
+    image.sd_extendedObject = extendedObject;
+    [SDImageCache.sharedImageCache removeImageFromMemoryForKey:kTestImageKeyPNG];
+    [SDImageCache.sharedImageCache removeImageFromDiskForKey:kTestImageKeyPNG];
+    // Write extended data
+    [SDImageCache.sharedImageCache storeImage:image forKey:kTestImageKeyPNG completion:^{
+        NSData *extendedData = [SDImageCache.sharedImageCache.diskCache extendedDataForKey:kTestImageKeyPNG];
+        expect(extendedData).toNot.beNil();
+        // Read extended data
+        UIImage *newImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kTestImageKeyPNG];
+        id newExtendedObject = newImage.sd_extendedObject;
+        expect(extendedObject).equal(newExtendedObject);
+        // Remove extended data
+        [SDImageCache.sharedImageCache.diskCache setExtendedData:nil forKey:kTestImageKeyPNG];
+        [expectation fulfill];
+    }];
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 #pragma mark - SDImageCache & SDImageCachesManager
 - (void)test50SDImageCacheQueryOp {
     XCTestExpectation *expectation = [self expectationWithDescription:@"SDImageCache query op works"];
diff --git a/Tests/Tests/SDUtilsTests.m b/Tests/Tests/SDUtilsTests.m
index eafeb5e5..89012e20 100644
--- a/Tests/Tests/SDUtilsTests.m
+++ b/Tests/Tests/SDUtilsTests.m
@@ -87,12 +87,16 @@
     NSArray *names = [SDFileAttributeHelper extendedAttributeNamesAtPath:filePath traverseLink:NO error:nil];
     expect(names.count).equal(0);
     
-    NSString *attr = @"com.com.hackemist.test";
-    [SDFileAttributeHelper setExtendedAttribute:@"com.com.hackemist.test" value:extendedData atPath:filePath traverseLink:NO overwrite:YES error:nil];
+    NSString *attr = @"com.hackemist.test";
+    [SDFileAttributeHelper setExtendedAttribute:attr value:extendedData atPath:filePath traverseLink:NO overwrite:YES error:nil];
     
     BOOL hasAttr =[SDFileAttributeHelper hasExtendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
     expect(hasAttr).beTruthy();
     
+    names = [SDFileAttributeHelper extendedAttributeNamesAtPath:filePath traverseLink:NO error:nil];
+    expect(names.count).equal(1);
+    expect(names.firstObject).equal(attr);
+    
     NSData *queriedData = [SDFileAttributeHelper extendedAttribute:attr atPath:filePath traverseLink:NO error:nil];
     expect(extendedData).equal(queriedData);
     

From e37d07bda8957d0b86604c26a462db2ed8643fd6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 29 Nov 2019 12:48:36 +0800
Subject: [PATCH 015/181] Add `SDWebImageWaitStoreCache`, which wait for all
 the async disk cache written finished and then callback, useful for advanced
 user who want to touch the cache right in completion block

---
 SDWebImage/Core/SDWebImageDefine.h  |  8 +++
 SDWebImage/Core/SDWebImageManager.m | 84 ++++++++++++++++++++++++-----
 2 files changed, 78 insertions(+), 14 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 8e60469b..a9a34367 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -184,6 +184,14 @@ typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
      * Note this options is not compatible with `SDWebImageDecodeFirstFrameOnly`, which always produce a UIImage/NSImage.
      */
     SDWebImageMatchAnimatedImageClass = 1 << 21,
+    
+    /**
+     * By default, when we load the image from network, the image will be written to the cache (memory and disk, controlled by your `storeCacheType` context option)
+     * This maybe an asynchronously operation and the final `SDInternalCompletionBlock` callback does not gurantee the disk cache written is finished and may cause logic error. (For example, you modify the disk data just in completion block, however, the disk cache is not ready)
+     * If you need to process with the disk cache in the completion block, you should use this option to ensure the disk cache already been written when callback.
+     * Note if you use this when using the custom cache serializer, or using the transformer, we will also wait until the output image data written is finished.
+     */
+    SDWebImageWaitStoreCache = 1 << 22,
 };
 
 
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 32b41211..f51f2ca9 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -265,7 +265,7 @@ static id<SDImageLoader> _defaultImageLoader;
                     [self.failedURLs removeObject:url];
                     SD_UNLOCK(self.failedURLsLock);
                 }
-                
+                // Continue store cache process
                 [self callStoreCacheProcessForOperation:operation url:url options:options context:context downloadedImage:downloadedImage downloadedData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
             }
             
@@ -310,6 +310,7 @@ static id<SDImageLoader> _defaultImageLoader;
     
     BOOL shouldTransformImage = downloadedImage && (!downloadedImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage)) && transformer;
     BOOL shouldCacheOriginal = downloadedImage && finished;
+    BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     
     // if available, store original image to cache
     if (shouldCacheOriginal) {
@@ -319,41 +320,75 @@ static id<SDImageLoader> _defaultImageLoader;
             dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0), ^{
                 @autoreleasepool {
                     NSData *cacheData = [cacheSerializer cacheDataWithImage:downloadedImage originalData:downloadedData imageURL:url];
-                    [self.imageCache storeImage:downloadedImage imageData:cacheData forKey:key cacheType:targetStoreCacheType completion:nil];
+                    [self storeImage:downloadedImage imageData:cacheData forKey:key cacheType:targetStoreCacheType waitStoreCache:waitStoreCache completion:^{
+                        // Continue transform process
+                        [self callTransformProcessForOperation:operation url:url options:options context:context originalImage:downloadedImage originalData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
+                    }];
                 }
             });
         } else {
-            [self.imageCache storeImage:downloadedImage imageData:downloadedData forKey:key cacheType:targetStoreCacheType completion:nil];
+            [self storeImage:downloadedImage imageData:downloadedData forKey:key cacheType:targetStoreCacheType waitStoreCache:waitStoreCache completion:^{
+                // Continue transform process
+                [self callTransformProcessForOperation:operation url:url options:options context:context originalImage:downloadedImage originalData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
+            }];
         }
+    } else {
+        // Continue transform process
+        [self callTransformProcessForOperation:operation url:url options:options context:context originalImage:downloadedImage originalData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
     }
+}
+
+// Transform process
+- (void)callTransformProcessForOperation:(nonnull SDWebImageCombinedOperation *)operation
+                                     url:(nonnull NSURL *)url
+                                 options:(SDWebImageOptions)options
+                                 context:(SDWebImageContext *)context
+                           originalImage:(nullable UIImage *)originalImage
+                            originalData:(nullable NSData *)originalData
+                                finished:(BOOL)finished
+                                progress:(nullable SDImageLoaderProgressBlock)progressBlock
+                               completed:(nullable SDInternalCompletionBlock)completedBlock {
+    // the target image store cache type
+    SDImageCacheType storeCacheType = SDImageCacheTypeAll;
+    if (context[SDWebImageContextStoreCacheType]) {
+        storeCacheType = [context[SDWebImageContextStoreCacheType] integerValue];
+    }
+    id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter];
+    NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
+    id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
+    id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
+    BOOL shouldTransformImage = originalImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage)) && transformer;
+    BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     // if available, store transformed image to cache
     if (shouldTransformImage) {
         dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0), ^{
             @autoreleasepool {
-                UIImage *transformedImage = [transformer transformedImageWithImage:downloadedImage forKey:key];
+                UIImage *transformedImage = [transformer transformedImageWithImage:originalImage forKey:key];
                 if (transformedImage && finished) {
                     NSString *transformerKey = [transformer transformerKey];
                     NSString *cacheKey = SDTransformedKeyForKey(key, transformerKey);
-                    BOOL imageWasTransformed = ![transformedImage isEqual:downloadedImage];
+                    BOOL imageWasTransformed = ![transformedImage isEqual:originalImage];
                     NSData *cacheData;
                     // pass nil if the image was transformed, so we can recalculate the data from the image
                     if (cacheSerializer && (storeCacheType == SDImageCacheTypeDisk || storeCacheType == SDImageCacheTypeAll)) {
-                        cacheData = [cacheSerializer cacheDataWithImage:transformedImage  originalData:(imageWasTransformed ? nil : downloadedData) imageURL:url];
+                        cacheData = [cacheSerializer cacheDataWithImage:transformedImage originalData:(imageWasTransformed ? nil : originalData) imageURL:url];
                     } else {
-                        cacheData = (imageWasTransformed ? nil : downloadedData);
+                        cacheData = (imageWasTransformed ? nil : originalData);
                     }
                     // keep the original image format and extended data
-                    transformedImage.sd_isIncremental = downloadedImage.sd_isIncremental;
-                    transformedImage.sd_imageFormat = downloadedImage.sd_imageFormat;
-                    transformedImage.sd_extendedObject = downloadedImage.sd_extendedObject;
-                    [self.imageCache storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType completion:nil];
+                    transformedImage.sd_isIncremental = originalImage.sd_isIncremental;
+                    transformedImage.sd_imageFormat = originalImage.sd_imageFormat;
+                    transformedImage.sd_extendedObject = originalImage.sd_extendedObject;
+                    [self storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType waitStoreCache:waitStoreCache completion:^{
+                        [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
+                    }];
+                } else {
+                    [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
                 }
-                
-                [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:downloadedData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
             }
         });
     } else {
-        [self callCompletionBlockForOperation:operation completion:completedBlock image:downloadedImage data:downloadedData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
+        [self callCompletionBlockForOperation:operation completion:completedBlock image:originalImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
     }
 }
 
@@ -368,6 +403,27 @@ static id<SDImageLoader> _defaultImageLoader;
     SD_UNLOCK(self.runningOperationsLock);
 }
 
+- (void)storeImage:(nullable UIImage *)image
+         imageData:(nullable NSData *)data
+            forKey:(nullable NSString *)key
+         cacheType:(SDImageCacheType)cacheType
+    waitStoreCache:(BOOL)waitStoreCache
+        completion:(nullable SDWebImageNoParamsBlock)completion {
+    // Check whether we should wait the store cache finished. If not, callback immediately
+    [self.imageCache storeImage:image imageData:data forKey:key cacheType:cacheType completion:^{
+        if (waitStoreCache) {
+            if (completion) {
+                completion();
+            }
+        }
+    }];
+    if (!waitStoreCache) {
+        if (completion) {
+            completion();
+        }
+    }
+}
+
 - (void)callCompletionBlockForOperation:(nullable SDWebImageCombinedOperation*)operation
                              completion:(nullable SDInternalCompletionBlock)completionBlock
                                   error:(nullable NSError *)error

From 9f6422b506b377fe35d36c2d81cf81613d86ac7e Mon Sep 17 00:00:00 2001
From: Ben Cherry <bcherry@gmail.com>
Date: Tue, 26 Nov 2019 10:22:35 -0800
Subject: [PATCH 016/181] Support using NSCache delegate with SDMemoryCache
 default implementation

---
 SDWebImage/Core/SDMemoryCache.h | 9 +++++----
 SDWebImage/Core/SDMemoryCache.m | 7 ++++---
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/SDWebImage/Core/SDMemoryCache.h b/SDWebImage/Core/SDMemoryCache.h
index 8b415816..43c39e84 100644
--- a/SDWebImage/Core/SDMemoryCache.h
+++ b/SDWebImage/Core/SDMemoryCache.h
@@ -15,6 +15,7 @@
 @protocol SDMemoryCache <NSObject>
 
 @required
+
 /**
  Create a new memory cache instance with the specify cache config. You can check `maxMemoryCost` and `maxMemoryCount` used for memory cache.
 
@@ -25,7 +26,7 @@
 
 /**
  Returns the value associated with a given key.
- 
+
  @param key An object identifying the value. If nil, just return nil.
  @return The value associated with key, or nil if no value is associated with key.
  */
@@ -33,7 +34,7 @@
 
 /**
  Sets the value of the specified key in the cache (0 cost).
- 
+
  @param object The object to be stored in the cache. If nil, it calls `removeObjectForKey:`.
  @param key    The key with which to associate the value. If nil, this method has no effect.
  @discussion Unlike an NSMutableDictionary object, a cache does not copy the key
@@ -44,7 +45,7 @@
 /**
  Sets the value of the specified key in the cache, and associates the key-value
  pair with the specified cost.
- 
+
  @param object The object to store in the cache. If nil, it calls `removeObjectForKey`.
  @param key    The key with which to associate the value. If nil, this method has no effect.
  @param cost   The cost with which to associate the key-value pair.
@@ -55,7 +56,7 @@
 
 /**
  Removes the value of the specified key in the cache.
- 
+
  @param key The key identifying the value to be removed. If nil, this method has no effect.
  */
 - (void)removeObjectForKey:(nonnull id)key;
diff --git a/SDWebImage/Core/SDMemoryCache.m b/SDWebImage/Core/SDMemoryCache.m
index e3991994..b354b495 100644
--- a/SDWebImage/Core/SDMemoryCache.m
+++ b/SDWebImage/Core/SDMemoryCache.m
@@ -30,6 +30,7 @@ static void * SDMemoryCacheContext = &SDMemoryCacheContext;
 #if SD_UIKIT
     [[NSNotificationCenter defaultCenter] removeObserver:self name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
 #endif
+    self.delegate = nil;
 }
 
 - (instancetype)init {
@@ -54,14 +55,14 @@ static void * SDMemoryCacheContext = &SDMemoryCacheContext;
     SDImageCacheConfig *config = self.config;
     self.totalCostLimit = config.maxMemoryCost;
     self.countLimit = config.maxMemoryCount;
-    
+
     [config addObserver:self forKeyPath:NSStringFromSelector(@selector(maxMemoryCost)) options:0 context:SDMemoryCacheContext];
     [config addObserver:self forKeyPath:NSStringFromSelector(@selector(maxMemoryCount)) options:0 context:SDMemoryCacheContext];
-    
+
 #if SD_UIKIT
     self.weakCache = [[NSMapTable alloc] initWithKeyOptions:NSPointerFunctionsStrongMemory valueOptions:NSPointerFunctionsWeakMemory capacity:0];
     self.weakCacheLock = dispatch_semaphore_create(1);
-    
+
     [[NSNotificationCenter defaultCenter] addObserver:self
                                              selector:@selector(didReceiveMemoryWarning:)
                                                  name:UIApplicationDidReceiveMemoryWarningNotification

From 1f801b44effa48efe72deab39cdb1140935901d2 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 3 Dec 2019 19:40:36 +0800
Subject: [PATCH 017/181] Bumped version to 5.3.3

Update the CHANGELOG
---
 CHANGELOG.md        | 6 ++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ea18fcfb..6d2a9021 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.3 Patch, on Dec 3rd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.3)
+See [all tickets marked for the 5.3.3 release](https://github.com/SDWebImage/SDWebImage/milestone/54)
+
+### Fixes
+- Fix the crash when using NSCache delegate with SDMemoryCache default implementation on dealloc #2899
+
 ## [5.3 Patch, on Nov 22nd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.2)
 See [all tickets marked for the 5.3.2 release](https://github.com/SDWebImage/SDWebImage/milestone/53)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index e6c81be4..80187e75 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.3.2'
+  s.version = '5.3.3'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 92626e2a..62181bd0 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.3.2</string>
+	<string>5.3.3</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.3.2</string>
+	<string>5.3.3</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 936d04f726d012f63fb397856d9aa02bdfa681c0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 3 Dec 2019 20:42:46 +0800
Subject: [PATCH 018/181] Fix the build issue on SDWebImage Static library
 target

---
 SDWebImage.xcodeproj/project.pbxproj | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 9635e935..1020e639 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -45,6 +45,7 @@
 		321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */ = {isa = PBXBuildFile; fileRef = 321E60BD1F38E91700405457 /* UIImage+ForceDecode.m */; };
 		3237F9E820161AE000A88143 /* NSImage+Compatibility.m in Sources */ = {isa = PBXBuildFile; fileRef = 4397D2F51D0DE2DF00BB2784 /* NSImage+Compatibility.m */; };
 		3237F9EB20161AE000A88143 /* NSImage+Compatibility.m in Sources */ = {isa = PBXBuildFile; fileRef = 4397D2F51D0DE2DF00BB2784 /* NSImage+Compatibility.m */; };
+		3240BB6523968FA1003BA07D /* SDFileAttributeHelper.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */; };
 		3244062C2296C5F400A36084 /* SDWebImageOptionsProcessor.h in Headers */ = {isa = PBXBuildFile; fileRef = 324406292296C5F400A36084 /* SDWebImageOptionsProcessor.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
 		3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
@@ -1190,6 +1191,7 @@
 				321E60C41F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9EF2355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
+				3240BB6523968FA1003BA07D /* SDFileAttributeHelper.m in Sources */,
 				328BB6A22081FED200760D6C /* SDWebImageCacheKeyFilter.m in Sources */,
 				32E67312235765B500DB4987 /* SDDisplayLink.m in Sources */,
 				53761309155AD0D5005750A4 /* SDImageCache.m in Sources */,

From 69d163fc37216bd704ef61df8b0bc485404d1ffc Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 3 Dec 2019 21:20:20 +0800
Subject: [PATCH 019/181] Using one global function to ensure we always sync
 all the UIImage category assocaited object status correctly inside our
 framework

---
 SDWebImage.xcodeproj/project.pbxproj    | 10 +++++++++
 SDWebImage/Core/SDImageCoderHelper.m    |  6 ++---
 SDWebImage/Core/SDWebImageDefine.m      |  5 ++---
 SDWebImage/Core/SDWebImageManager.m     |  6 ++---
 SDWebImage/Private/SDAssociatedObject.h | 14 ++++++++++++
 SDWebImage/Private/SDAssociatedObject.m | 29 +++++++++++++++++++++++++
 6 files changed, 60 insertions(+), 10 deletions(-)
 create mode 100644 SDWebImage/Private/SDAssociatedObject.h
 create mode 100644 SDWebImage/Private/SDAssociatedObject.m

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 1020e639..fefb9564 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -46,6 +46,9 @@
 		3237F9E820161AE000A88143 /* NSImage+Compatibility.m in Sources */ = {isa = PBXBuildFile; fileRef = 4397D2F51D0DE2DF00BB2784 /* NSImage+Compatibility.m */; };
 		3237F9EB20161AE000A88143 /* NSImage+Compatibility.m in Sources */ = {isa = PBXBuildFile; fileRef = 4397D2F51D0DE2DF00BB2784 /* NSImage+Compatibility.m */; };
 		3240BB6523968FA1003BA07D /* SDFileAttributeHelper.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */; };
+		3240BB6823968FE7003BA07D /* SDAssociatedObject.h in Headers */ = {isa = PBXBuildFile; fileRef = 3240BB6623968FE6003BA07D /* SDAssociatedObject.h */; settings = {ATTRIBUTES = (Private, ); }; };
+		3240BB6923968FE7003BA07D /* SDAssociatedObject.m in Sources */ = {isa = PBXBuildFile; fileRef = 3240BB6723968FE6003BA07D /* SDAssociatedObject.m */; };
+		3240BB6A23968FE7003BA07D /* SDAssociatedObject.m in Sources */ = {isa = PBXBuildFile; fileRef = 3240BB6723968FE6003BA07D /* SDAssociatedObject.m */; };
 		3244062C2296C5F400A36084 /* SDWebImageOptionsProcessor.h in Headers */ = {isa = PBXBuildFile; fileRef = 324406292296C5F400A36084 /* SDWebImageOptionsProcessor.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
 		3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
@@ -387,6 +390,8 @@
 		321E60A11F38E8F600405457 /* SDImageGIFCoder.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = SDImageGIFCoder.m; path = Core/SDImageGIFCoder.m; sourceTree = "<group>"; };
 		321E60BC1F38E91700405457 /* UIImage+ForceDecode.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "UIImage+ForceDecode.h"; path = "Core/UIImage+ForceDecode.h"; sourceTree = "<group>"; };
 		321E60BD1F38E91700405457 /* UIImage+ForceDecode.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "UIImage+ForceDecode.m"; path = "Core/UIImage+ForceDecode.m"; sourceTree = "<group>"; };
+		3240BB6623968FE6003BA07D /* SDAssociatedObject.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SDAssociatedObject.h; sourceTree = "<group>"; };
+		3240BB6723968FE6003BA07D /* SDAssociatedObject.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SDAssociatedObject.m; sourceTree = "<group>"; };
 		324406292296C5F400A36084 /* SDWebImageOptionsProcessor.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDWebImageOptionsProcessor.h; path = Core/SDWebImageOptionsProcessor.h; sourceTree = "<group>"; };
 		3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDWebImageOptionsProcessor.m; path = Core/SDWebImageOptionsProcessor.m; sourceTree = "<group>"; };
 		32484757201775F600AF9E5A /* SDAnimatedImageView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = SDAnimatedImageView.m; path = Core/SDAnimatedImageView.m; sourceTree = "<group>"; };
@@ -631,6 +636,8 @@
 			children = (
 				32B5CC5E222F89C2005EB74E /* SDAsyncBlockOperation.h */,
 				32B5CC5F222F89C2005EB74E /* SDAsyncBlockOperation.m */,
+				3240BB6623968FE6003BA07D /* SDAssociatedObject.h */,
+				3240BB6723968FE6003BA07D /* SDAssociatedObject.m */,
 				325C460622339426004CAE11 /* SDWeakProxy.h */,
 				325C460722339426004CAE11 /* SDWeakProxy.m */,
 				32E6730F235765B500DB4987 /* SDDisplayLink.h */,
@@ -886,6 +893,7 @@
 				326E2F2E236F0B23006F847F /* SDAnimatedImagePlayer.h in Headers */,
 				807A122A1F89636300EC2A9B /* SDImageCodersManager.h in Headers */,
 				3244062C2296C5F400A36084 /* SDWebImageOptionsProcessor.h in Headers */,
+				3240BB6823968FE7003BA07D /* SDAssociatedObject.h in Headers */,
 				4A2CAE211AB4BB7000B6BC39 /* SDWebImageManager.h in Headers */,
 				4A2CAE1F1AB4BB6C00B6BC39 /* SDImageCache.h in Headers */,
 				4A2CAE351AB4BB7500B6BC39 /* UIImageView+WebCache.h in Headers */,
@@ -1124,6 +1132,7 @@
 				32E67313235765B500DB4987 /* SDDisplayLink.m in Sources */,
 				4A2CAE2E1AB4BB7500B6BC39 /* UIImage+GIF.m in Sources */,
 				326E2F35236F1D58006F847F /* SDDeviceHelper.m in Sources */,
+				3240BB6A23968FE7003BA07D /* SDAssociatedObject.m in Sources */,
 				80B6DF822142B44400BCB334 /* NSButton+WebCache.m in Sources */,
 				32D3CDCF21DDE87300C4DB49 /* UIImage+MemoryCacheCost.m in Sources */,
 				329F1241223FAD3400B309FD /* SDInternalMacros.m in Sources */,
@@ -1196,6 +1205,7 @@
 				32E67312235765B500DB4987 /* SDDisplayLink.m in Sources */,
 				53761309155AD0D5005750A4 /* SDImageCache.m in Sources */,
 				326E2F34236F1D58006F847F /* SDDeviceHelper.m in Sources */,
+				3240BB6923968FE7003BA07D /* SDAssociatedObject.m in Sources */,
 				80B6DF832142B44500BCB334 /* NSButton+WebCache.m in Sources */,
 				32D3CDCE21DDE87300C4DB49 /* UIImage+MemoryCacheCost.m in Sources */,
 				329F1240223FAD3400B309FD /* SDInternalMacros.m in Sources */,
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 52ab2ea3..3cc0c7ea 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -12,7 +12,7 @@
 #import "NSData+ImageContentType.h"
 #import "SDAnimatedImageRep.h"
 #import "UIImage+ForceDecode.h"
-#import "UIImage+Metadata.h"
+#import "SDAssociatedObject.h"
 
 #if SD_UIKIT || SD_WATCH
 static const size_t kBytesPerPixel = 4;
@@ -291,8 +291,8 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     }
     UIImage *decodedImage = [[UIImage alloc] initWithCGImage:imageRef scale:image.scale orientation:image.imageOrientation];
     CGImageRelease(imageRef);
+    SDImageCopyAssociatedObject(image, decodedImage);
     decodedImage.sd_isDecoded = YES;
-    decodedImage.sd_imageFormat = image.sd_imageFormat;
     return decodedImage;
 #endif
 }
@@ -425,8 +425,8 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         if (destImage == nil) {
             return image;
         }
+        SDImageCopyAssociatedObject(image, destImage);
         destImage.sd_isDecoded = YES;
-        destImage.sd_imageFormat = image.sd_imageFormat;
         return destImage;
     }
 #endif
diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 6231e36d..173f092a 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -10,6 +10,7 @@
 #import "UIImage+Metadata.h"
 #import "NSImage+Compatibility.h"
 #import "UIImage+ExtendedCacheData.h"
+#import "SDAssociatedObject.h"
 
 #pragma mark - Image scale
 
@@ -111,9 +112,7 @@ inline UIImage * _Nullable SDScaledImageForScaleFactor(CGFloat scale, UIImage *
         scaledImage = [[UIImage alloc] initWithCGImage:image.CGImage scale:scale orientation:kCGImagePropertyOrientationUp];
 #endif
     }
-    scaledImage.sd_isIncremental = image.sd_isIncremental;
-    scaledImage.sd_imageFormat = image.sd_imageFormat;
-    scaledImage.sd_extendedObject = image.sd_extendedObject;
+    SDImageCopyAssociatedObject(image, scaledImage);
     
     return scaledImage;
 }
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index f51f2ca9..61c0a36c 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -10,7 +10,7 @@
 #import "SDImageCache.h"
 #import "SDWebImageDownloader.h"
 #import "UIImage+Metadata.h"
-#import "UIImage+ExtendedCacheData.h"
+#import "SDAssociatedObject.h"
 #import "SDWebImageError.h"
 #import "SDInternalMacros.h"
 
@@ -376,9 +376,7 @@ static id<SDImageLoader> _defaultImageLoader;
                         cacheData = (imageWasTransformed ? nil : originalData);
                     }
                     // keep the original image format and extended data
-                    transformedImage.sd_isIncremental = originalImage.sd_isIncremental;
-                    transformedImage.sd_imageFormat = originalImage.sd_imageFormat;
-                    transformedImage.sd_extendedObject = originalImage.sd_extendedObject;
+                    SDImageCopyAssociatedObject(originalImage, transformedImage);
                     [self storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType waitStoreCache:waitStoreCache completion:^{
                         [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
                     }];
diff --git a/SDWebImage/Private/SDAssociatedObject.h b/SDWebImage/Private/SDAssociatedObject.h
new file mode 100644
index 00000000..199cf4fc
--- /dev/null
+++ b/SDWebImage/Private/SDAssociatedObject.h
@@ -0,0 +1,14 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "SDWebImageCompat.h"
+
+/// Copy the associated object from source image to target image. The associated object including all the category read/write properties.
+/// @param source source
+/// @param target target
+FOUNDATION_EXPORT void SDImageCopyAssociatedObject(UIImage * _Nullable source, UIImage * _Nullable target);
diff --git a/SDWebImage/Private/SDAssociatedObject.m b/SDWebImage/Private/SDAssociatedObject.m
new file mode 100644
index 00000000..18355fed
--- /dev/null
+++ b/SDWebImage/Private/SDAssociatedObject.m
@@ -0,0 +1,29 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "SDAssociatedObject.h"
+#import "UIImage+Metadata.h"
+#import "UIImage+ExtendedCacheData.h"
+#import "UIImage+MemoryCacheCost.h"
+#import "UIImage+ForceDecode.h"
+
+void SDImageCopyAssociatedObject(UIImage * _Nullable source, UIImage * _Nullable target) {
+    if (!source || !target) {
+        return;
+    }
+    // Image Metadata
+    target.sd_isIncremental = source.sd_isIncremental;
+    target.sd_imageLoopCount = source.sd_imageLoopCount;
+    target.sd_imageFormat = source.sd_imageFormat;
+    // Force Decode
+    target.sd_isDecoded = source.sd_isDecoded;
+    // Extended Cache Data
+    target.sd_extendedObject = source.sd_extendedObject;
+    // Memory Cache Cost
+    target.sd_memoryCost = source.sd_memoryCost;
+}

From 7f0789aca9e9a92bddd0900a212f43ec16b1024b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 4 Dec 2019 16:18:52 +0800
Subject: [PATCH 020/181] memory cost should not be copied between different
 UIImage, it's a getter-only method in general

---
 SDWebImage/Private/SDAssociatedObject.m | 2 --
 1 file changed, 2 deletions(-)

diff --git a/SDWebImage/Private/SDAssociatedObject.m b/SDWebImage/Private/SDAssociatedObject.m
index 18355fed..a7c70763 100644
--- a/SDWebImage/Private/SDAssociatedObject.m
+++ b/SDWebImage/Private/SDAssociatedObject.m
@@ -24,6 +24,4 @@ void SDImageCopyAssociatedObject(UIImage * _Nullable source, UIImage * _Nullable
     target.sd_isDecoded = source.sd_isDecoded;
     // Extended Cache Data
     target.sd_extendedObject = source.sd_extendedObject;
-    // Memory Cache Cost
-    target.sd_memoryCost = source.sd_memoryCost;
 }

From bc9b488bf34b1077af990f5ee312b68845e6d6c3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Dec 2019 19:26:18 +0800
Subject: [PATCH 021/181] Bumped version to 5.4.0

Update the CHANGELOG
---
 CHANGELOG.md        | 15 +++++++++++++++
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6d2a9021..69558fea 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,18 @@
+## [5.4.0 Extended Cache Metadata, on Dec 5th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.0)
+See [all tickets marked for the 5.4.0 release](https://github.com/SDWebImage/SDWebImage/milestone/51)
+
+### Features
+
+#### Cache
+- Allows advanced user to read/write extended metadata associated with image data from disk cache #2898
+- This metadata will be processed at the same time when store or query the image. The metadata should conforms to `NSCoding` for archive and unarchive.
+
+#### Manager
+- Add `SDWebImageWaitStoreCache`, which wait for all the async disk cache written finished and then callback, useful for advanced user who want to touch the cache right in completion block #2900
+
+### Fixes
+- Using one global function to ensure we always sync all the UIImage category associated object status correctly inside our framework #2902
+
 ## [5.3 Patch, on Dec 3rd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.3)
 See [all tickets marked for the 5.3.3 release](https://github.com/SDWebImage/SDWebImage/milestone/54)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 80187e75..6e7c4229 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.3.3'
+  s.version = '5.4.0'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 62181bd0..7c51b93f 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.3.3</string>
+	<string>5.4.0</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.3.3</string>
+	<string>5.4.0</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 9dae0e7b961ba5c6dda545ec2c6a40733babdd79 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Dec 2019 19:33:10 +0800
Subject: [PATCH 022/181] Fix the thread safe issue with Downloader and
 DownloaderOperation during cancel

---
 SDWebImage/Core/SDWebImageDownloader.m | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index 80d30b59..5b931ea2 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -403,7 +403,12 @@ static void * SDWebImageDownloaderContext = &SDWebImageDownloaderContext;
     NSOperation<SDWebImageDownloaderOperation> *returnOperation = nil;
     for (NSOperation<SDWebImageDownloaderOperation> *operation in self.downloadQueue.operations) {
         if ([operation respondsToSelector:@selector(dataTask)]) {
-            if (operation.dataTask.taskIdentifier == task.taskIdentifier) {
+            // So we lock the operation here, and in `SDWebImageDownloaderOperation`, we use `@synchonzied (self)`, to ensure the thread safe between these two classes.
+            NSURLSessionTask *operationTask;
+            @synchronized (operation) {
+                operationTask = operation.dataTask;
+            }
+            if (operationTask.taskIdentifier == task.taskIdentifier) {
                 returnOperation = operation;
                 break;
             }

From 1601418d51e947cf4f8a9884820e8114eb334a43 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Dec 2019 19:40:45 +0800
Subject: [PATCH 023/181] Remove one unused import

---
 SDWebImage/Core/SDWebImageDefine.m | 1 -
 1 file changed, 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 173f092a..496392c4 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -9,7 +9,6 @@
 #import "SDWebImageDefine.h"
 #import "UIImage+Metadata.h"
 #import "NSImage+Compatibility.h"
-#import "UIImage+ExtendedCacheData.h"
 #import "SDAssociatedObject.h"
 
 #pragma mark - Image scale

From 7ef9a314b12c1a31edb0d09d41fcba93143fe772 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 6 Dec 2019 15:44:40 +0800
Subject: [PATCH 024/181] Update the CHANGELOG for 5.4.0

---
 CHANGELOG.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 69558fea..ed842941 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,4 @@
-## [5.4.0 Extended Cache Metadata, on Dec 5th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.0)
+## [5.4.0 Extended Cache Metadata, on Dec 6th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.0)
 See [all tickets marked for the 5.4.0 release](https://github.com/SDWebImage/SDWebImage/milestone/51)
 
 ### Features
@@ -12,6 +12,7 @@ See [all tickets marked for the 5.4.0 release](https://github.com/SDWebImage/SDW
 
 ### Fixes
 - Using one global function to ensure we always sync all the UIImage category associated object status correctly inside our framework #2902
+- Fix the thread safe issue with Downloader and DownloaderOperation during cancel #2903
 
 ## [5.3 Patch, on Dec 3rd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.3)
 See [all tickets marked for the 5.3.3 release](https://github.com/SDWebImage/SDWebImage/milestone/54)

From 5cf8ddc6cb0d2fda77b9bad760650808fd88d7c2 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 13 Dec 2019 17:26:20 +0800
Subject: [PATCH 025/181] update the Readme with PDF/SVG/Link plugin repos from
 SDWebImage organization

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 6199e699..f18658fb 100644
--- a/README.md
+++ b/README.md
@@ -56,10 +56,13 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageBPGCoder](https://github.com/SDWebImage/SDWebImageBPGCoder) - coder for BPG format
 - [SDWebImageFLIFCoder](https://github.com/SDWebImage/SDWebImageFLIFCoder) - coder for FLIF format
 - [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder) - coder for AVIF (AV1-based) format
+- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format image
+- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format image
 - and more from community!
 
 #### Loaders
 - [SDWebImagePhotosPlugin](https://github.com/SDWebImage/SDWebImagePhotosPlugin) - plugin to support loading images from Photos (using `Photos.framework`) 
+- [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
 #### Integration with 3rd party libraries
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs

From 0b120584274741fd0b297f012783e2061ba088af Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 16 Dec 2019 12:44:52 +0800
Subject: [PATCH 026/181] Fix the test case compile warning of
 `SDWebImageTestDiskCache`

---
 Tests/Tests/SDWebImageTestCache.m | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Tests/Tests/SDWebImageTestCache.m b/Tests/Tests/SDWebImageTestCache.m
index 7ef29cf7..68b2a154 100644
--- a/Tests/Tests/SDWebImageTestCache.m
+++ b/Tests/Tests/SDWebImageTestCache.m
@@ -9,6 +9,9 @@
 
 #import "SDWebImageTestCache.h"
 #import <SDWebImage/SDImageCacheConfig.h>
+#import "SDFileAttributeHelper.h"
+
+static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hackemist.SDWebImageTestDiskCache";
 
 @implementation SDWebImageTestMemoryCache
 
@@ -104,4 +107,18 @@
     return size;
 }
 
+- (nullable NSData *)extendedDataForKey:(nonnull NSString *)key {
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    return [SDFileAttributeHelper extendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+}
+
+- (void)setExtendedData:(nullable NSData *)extendedData forKey:(nonnull NSString *)key {
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    if (!extendedData) {
+        [SDFileAttributeHelper removeExtendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+    } else {
+        [SDFileAttributeHelper setExtendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName value:extendedData atPath:cachePathForKey traverseLink:NO overwrite:YES error:nil];
+    }
+}
+
 @end

From 6ff83fde6bba99491a78096cdbc8ac5711f4666b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 15:54:15 +0800
Subject: [PATCH 027/181] Added SDGraphicsImageRenderer (which bridge to
 UIGraphicsImageRenderer on iOS 10+), prepare to replace old CGContext create
 code

---
 SDWebImage.xcodeproj/project.pbxproj      |  12 ++
 SDWebImage/Core/SDGraphicsImageRenderer.h |  44 +++++++
 SDWebImage/Core/SDGraphicsImageRenderer.m | 140 ++++++++++++++++++++++
 WebImage/SDWebImage.h                     |   1 +
 4 files changed, 197 insertions(+)
 create mode 100644 SDWebImage/Core/SDGraphicsImageRenderer.h
 create mode 100644 SDWebImage/Core/SDGraphicsImageRenderer.m

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index fefb9564..39537274 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -52,6 +52,9 @@
 		3244062C2296C5F400A36084 /* SDWebImageOptionsProcessor.h in Headers */ = {isa = PBXBuildFile; fileRef = 324406292296C5F400A36084 /* SDWebImageOptionsProcessor.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
 		3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */ = {isa = PBXBuildFile; fileRef = 3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */; };
+		3246A70323A567AC00FBEA10 /* SDGraphicsImageRenderer.h in Headers */ = {isa = PBXBuildFile; fileRef = 3246A70123A567AC00FBEA10 /* SDGraphicsImageRenderer.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		3246A70423A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */ = {isa = PBXBuildFile; fileRef = 3246A70223A567AC00FBEA10 /* SDGraphicsImageRenderer.m */; };
+		3246A70523A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */ = {isa = PBXBuildFile; fileRef = 3246A70223A567AC00FBEA10 /* SDGraphicsImageRenderer.m */; };
 		3248475D201775F600AF9E5A /* SDAnimatedImageView.m in Sources */ = {isa = PBXBuildFile; fileRef = 32484757201775F600AF9E5A /* SDAnimatedImageView.m */; };
 		3248475F201775F600AF9E5A /* SDAnimatedImageView.m in Sources */ = {isa = PBXBuildFile; fileRef = 32484757201775F600AF9E5A /* SDAnimatedImageView.m */; };
 		32484765201775F600AF9E5A /* SDAnimatedImageView+WebCache.h in Headers */ = {isa = PBXBuildFile; fileRef = 32484758201775F600AF9E5A /* SDAnimatedImageView+WebCache.h */; settings = {ATTRIBUTES = (Public, ); }; };
@@ -121,6 +124,7 @@
 		328BB6CF2082581100760D6C /* SDMemoryCache.h in Headers */ = {isa = PBXBuildFile; fileRef = 328BB6BF2082581100760D6C /* SDMemoryCache.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		328BB6D32082581100760D6C /* SDMemoryCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 328BB6C02082581100760D6C /* SDMemoryCache.m */; };
 		328BB6D52082581100760D6C /* SDMemoryCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 328BB6C02082581100760D6C /* SDMemoryCache.m */; };
+		328E9DE523A61DD30051C893 /* SDGraphicsImageRenderer.h in Copy Headers */ = {isa = PBXBuildFile; fileRef = 3246A70123A567AC00FBEA10 /* SDGraphicsImageRenderer.h */; };
 		3290FA061FA478AF0047D20C /* SDImageFrame.h in Headers */ = {isa = PBXBuildFile; fileRef = 3290FA021FA478AF0047D20C /* SDImageFrame.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		3290FA0A1FA478AF0047D20C /* SDImageFrame.m in Sources */ = {isa = PBXBuildFile; fileRef = 3290FA031FA478AF0047D20C /* SDImageFrame.m */; };
 		3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */ = {isa = PBXBuildFile; fileRef = 3290FA031FA478AF0047D20C /* SDImageFrame.m */; };
@@ -308,6 +312,7 @@
 			dstPath = include/SDWebImage;
 			dstSubfolderSpec = 16;
 			files = (
+				328E9DE523A61DD30051C893 /* SDGraphicsImageRenderer.h in Copy Headers */,
 				325F7CCD2389467800AEDFCC /* UIImage+ExtendedCacheData.h in Copy Headers */,
 				326E2F36236F1E30006F847F /* SDAnimatedImagePlayer.h in Copy Headers */,
 				3250C9F12355E3DF0093A896 /* SDWebImageDownloaderDecryptor.h in Copy Headers */,
@@ -394,6 +399,8 @@
 		3240BB6723968FE6003BA07D /* SDAssociatedObject.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SDAssociatedObject.m; sourceTree = "<group>"; };
 		324406292296C5F400A36084 /* SDWebImageOptionsProcessor.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDWebImageOptionsProcessor.h; path = Core/SDWebImageOptionsProcessor.h; sourceTree = "<group>"; };
 		3244062A2296C5F400A36084 /* SDWebImageOptionsProcessor.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDWebImageOptionsProcessor.m; path = Core/SDWebImageOptionsProcessor.m; sourceTree = "<group>"; };
+		3246A70123A567AC00FBEA10 /* SDGraphicsImageRenderer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDGraphicsImageRenderer.h; path = Core/SDGraphicsImageRenderer.h; sourceTree = "<group>"; };
+		3246A70223A567AC00FBEA10 /* SDGraphicsImageRenderer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDGraphicsImageRenderer.m; path = Core/SDGraphicsImageRenderer.m; sourceTree = "<group>"; };
 		32484757201775F600AF9E5A /* SDAnimatedImageView.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = SDAnimatedImageView.m; path = Core/SDAnimatedImageView.m; sourceTree = "<group>"; };
 		32484758201775F600AF9E5A /* SDAnimatedImageView+WebCache.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "SDAnimatedImageView+WebCache.h"; path = "Core/SDAnimatedImageView+WebCache.h"; sourceTree = "<group>"; };
 		32484759201775F600AF9E5A /* SDAnimatedImageView.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = SDAnimatedImageView.h; path = Core/SDAnimatedImageView.h; sourceTree = "<group>"; };
@@ -577,6 +584,8 @@
 				32CF1C061FA496B000004BD1 /* SDImageCoderHelper.m */,
 				3257EAF721898AED0097B271 /* SDImageGraphics.h */,
 				3257EAF821898AED0097B271 /* SDImageGraphics.m */,
+				3246A70123A567AC00FBEA10 /* SDGraphicsImageRenderer.h */,
+				3246A70223A567AC00FBEA10 /* SDGraphicsImageRenderer.m */,
 			);
 			name = Decoder;
 			sourceTree = "<group>";
@@ -905,6 +914,7 @@
 				4A2CAE1D1AB4BB6800B6BC39 /* SDWebImageDownloaderOperation.h in Headers */,
 				4A2CAE2B1AB4BB7500B6BC39 /* UIButton+WebCache.h in Headers */,
 				4A2CAE251AB4BB7000B6BC39 /* SDWebImagePrefetcher.h in Headers */,
+				3246A70323A567AC00FBEA10 /* SDGraphicsImageRenderer.h in Headers */,
 				328BB6CF2082581100760D6C /* SDMemoryCache.h in Headers */,
 				325C460F223394D8004CAE11 /* SDImageCachesManagerOperation.h in Headers */,
 				321E60881F38E8C800405457 /* SDImageCoder.h in Headers */,
@@ -1125,6 +1135,7 @@
 				3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */,
 				325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */,
 				325F7CCB238942AB00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */,
+				3246A70523A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */,
 				321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3244062E2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9F02355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
@@ -1198,6 +1209,7 @@
 				3290FA0A1FA478AF0047D20C /* SDImageFrame.m in Sources */,
 				325C46222233A02E004CAE11 /* UIColor+HexString.m in Sources */,
 				321E60C41F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
+				3246A70423A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */,
 				3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
 				3250C9EF2355D9DA0093A896 /* SDWebImageDownloaderDecryptor.m in Sources */,
 				3240BB6523968FA1003BA07D /* SDFileAttributeHelper.m in Sources */,
diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.h b/SDWebImage/Core/SDGraphicsImageRenderer.h
new file mode 100644
index 00000000..2899b3b4
--- /dev/null
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.h
@@ -0,0 +1,44 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "SDWebImageCompat.h"
+
+typedef void (^SDGraphicsImageDrawingActions)(CGContextRef _Nonnull context);
+
+typedef NS_ENUM(NSInteger, SDGraphicsImageRendererFormatRange) {
+    SDGraphicsImageRendererFormatRangeUnspecified = -1,
+    SDGraphicsImageRendererFormatRangeAutomatic = 0,
+    SDGraphicsImageRendererFormatRangeExtended,
+    SDGraphicsImageRendererFormatRangeStandard
+};
+
+@interface SDGraphicsImageRendererFormat : NSObject
+
+@property (nonatomic) CGFloat scale;
+@property (nonatomic) BOOL opaque;
+
+/**
+ For iOS 12+, the value is from system API
+ For iOS 10-11, the value is from `prefersExtendedRange` property
+ For iOS 9, the value is `.unspecified`
+ */
+@property (nonatomic) SDGraphicsImageRendererFormatRange preferredRange;
+
+- (nonnull instancetype)init;
++ (nonnull instancetype)preferredFormat;
+
+@end
+
+@interface SDGraphicsImageRenderer : NSObject
+
+- (nonnull instancetype)initWithSize:(CGSize)size;
+- (nonnull instancetype)initWithSize:(CGSize)size format:(nonnull SDGraphicsImageRendererFormat *)format;
+
+- (nonnull UIImage *)imageWithActions:(nonnull NS_NOESCAPE SDGraphicsImageDrawingActions)actions;
+
+@end
diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.m b/SDWebImage/Core/SDGraphicsImageRenderer.m
new file mode 100644
index 00000000..980ef2b4
--- /dev/null
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.m
@@ -0,0 +1,140 @@
+/*
+* This file is part of the SDWebImage package.
+* (c) Olivier Poitrey <rs@dailymotion.com>
+*
+* For the full copyright and license information, please view the LICENSE
+* file that was distributed with this source code.
+*/
+
+#import "SDGraphicsImageRenderer.h"
+#import "SDImageGraphics.h"
+
+@interface SDGraphicsImageRendererFormat ()
+@property (nonatomic, strong) UIGraphicsImageRendererFormat *uiformat API_AVAILABLE(ios(10.0));
+@end
+
+@implementation SDGraphicsImageRendererFormat
+
+- (instancetype)init {
+    self = [super init];
+    if (self) {
+        if (@available(iOS 10.0, *)) {
+            UIGraphicsImageRendererFormat *uiformat = [[UIGraphicsImageRendererFormat alloc] init];
+            self.uiformat = uiformat;
+            self.scale = uiformat.scale;
+            self.opaque = uiformat.opaque;
+            if (@available(iOS 12.0, *)) {
+                self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
+            } else {
+                if (uiformat.prefersExtendedRange) {
+                    self.preferredRange = SDGraphicsImageRendererFormatRangeExtended;
+                } else {
+                    self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
+                }
+            }
+        } else {
+            self.scale = 1.0;
+            self.opaque = NO;
+            self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+        }
+    }
+    return self;
+}
+
+- (instancetype)initForMainScreen {
+    self = [super init];
+    if (self) {
+        if (@available(iOS 10.0, *)) {
+            UIGraphicsImageRendererFormat *uiformat;
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wunguarded-availability"
+            // iOS 11.0.0 GM does have `preferredFormat`, but iOS 11 betas did not (argh!)
+            if ([UIGraphicsImageRenderer respondsToSelector:@selector(preferredFormat)]) {
+                uiformat = [UIGraphicsImageRendererFormat preferredFormat];
+            } else {
+                uiformat = [UIGraphicsImageRendererFormat defaultFormat];
+            }
+            self.uiformat = uiformat;
+            self.scale = uiformat.scale;
+            self.opaque = uiformat.opaque;
+            if (@available(iOS 12.0, *)) {
+                self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
+            } else {
+                if (uiformat.prefersExtendedRange) {
+                    self.preferredRange = SDGraphicsImageRendererFormatRangeExtended;
+                } else {
+                    self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
+                }
+            }
+#pragma clang diagnostic pop
+        } else {
+#if SD_WATCH
+            CGFloat screenScale = [WKInterfaceDevice currentDevice].screenScale;
+#elif SD_UIKIT
+            CGFloat screenScale = [UIScreen mainScreen].scale;
+#elif SD_MAC
+            CGFloat screenScale = [NSScreen mainScreen].backingScaleFactor;
+#endif
+            self.scale = screenScale;
+            self.opaque = NO;
+            self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+        }
+    }
+    return self;
+}
+
++ (instancetype)preferredFormat {
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] initForMainScreen];
+    return format;
+}
+
+@end
+
+@interface SDGraphicsImageRenderer ()
+@property (nonatomic, assign) CGSize size;
+@property (nonatomic, strong) SDGraphicsImageRendererFormat *format;
+@property (nonatomic, strong) UIGraphicsImageRenderer *uirenderer API_AVAILABLE(ios(10.0));
+@end
+
+@implementation SDGraphicsImageRenderer
+
+- (instancetype)initWithSize:(CGSize)size {
+    return [self initWithSize:size format:SDGraphicsImageRendererFormat.preferredFormat];
+}
+
+- (instancetype)initWithSize:(CGSize)size format:(SDGraphicsImageRendererFormat *)format {
+    NSParameterAssert(format);
+    self = [super init];
+    if (self) {
+        self.size = size;
+        self.format = format;
+        if (@available(iOS 10.0, *)) {
+            UIGraphicsImageRendererFormat *uiformat = format.uiformat;
+            self.uirenderer = [[UIGraphicsImageRenderer alloc] initWithSize:size format:uiformat];
+        }
+    }
+    return self;
+}
+
+- (UIImage *)imageWithActions:(NS_NOESCAPE SDGraphicsImageDrawingActions)actions {
+    NSParameterAssert(actions);
+    if (@available(iOS 10.0, *)) {
+        UIGraphicsImageDrawingActions uiactions = ^(UIGraphicsImageRendererContext *rendererContext) {
+            if (actions) {
+                actions(rendererContext.CGContext);
+            }
+        };
+        return [self.uirenderer imageWithActions:uiactions];
+    } else {
+        SDGraphicsBeginImageContextWithOptions(self.size, self.format.opaque, self.format.scale);
+        CGContextRef context = SDGraphicsGetCurrentContext();
+        if (actions) {
+            actions(context);
+        }
+        UIImage *image = SDGraphicsGetImageFromCurrentImageContext();
+        SDGraphicsEndImageContext();
+        return image;
+    }
+}
+
+@end
diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index ab0f43e5..f219978e 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -65,6 +65,7 @@ FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
 #import <SDWebImage/SDImageFrame.h>
 #import <SDWebImage/SDImageCoderHelper.h>
 #import <SDWebImage/SDImageGraphics.h>
+#import <SDWebImage/SDGraphicsImageRenderer.h>
 #import <SDWebImage/UIImage+GIF.h>
 #import <SDWebImage/UIImage+ForceDecode.h>
 #import <SDWebImage/NSData+ImageContentType.h>

From ee0aa220e051f6807017afe98c34ba2a1a3643e6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 16:36:13 +0800
Subject: [PATCH 028/181] Fix the compile issue on watchOS/macOS

---
 SDWebImage/Core/SDGraphicsImageRenderer.m | 40 ++++++++++++++++-------
 1 file changed, 29 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.m b/SDWebImage/Core/SDGraphicsImageRenderer.m
index 980ef2b4..029a4f40 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.m
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.m
@@ -10,7 +10,9 @@
 #import "SDImageGraphics.h"
 
 @interface SDGraphicsImageRendererFormat ()
-@property (nonatomic, strong) UIGraphicsImageRendererFormat *uiformat API_AVAILABLE(ios(10.0));
+#if SD_UIKIT
+@property (nonatomic, strong) UIGraphicsImageRendererFormat *uiformat API_AVAILABLE(ios(10.0), tvos(10.0));
+#endif
 @end
 
 @implementation SDGraphicsImageRendererFormat
@@ -18,12 +20,13 @@
 - (instancetype)init {
     self = [super init];
     if (self) {
-        if (@available(iOS 10.0, *)) {
+#if SD_UIKIT
+        if (@available(iOS 10.0, tvOS 10.10, *)) {
             UIGraphicsImageRendererFormat *uiformat = [[UIGraphicsImageRendererFormat alloc] init];
             self.uiformat = uiformat;
             self.scale = uiformat.scale;
             self.opaque = uiformat.opaque;
-            if (@available(iOS 12.0, *)) {
+            if (@available(iOS 12.0, tvOS 12.0, *)) {
                 self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
             } else {
                 if (uiformat.prefersExtendedRange) {
@@ -33,21 +36,25 @@
                 }
             }
         } else {
+#endif
             self.scale = 1.0;
             self.opaque = NO;
             self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+#if SD_UIKIT
         }
+#endif
     }
     return self;
 }
 
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wunguarded-availability"
 - (instancetype)initForMainScreen {
     self = [super init];
     if (self) {
-        if (@available(iOS 10.0, *)) {
+#if SD_UIKIT
+        if (@available(iOS 10.0, tvOS 10.0, *)) {
             UIGraphicsImageRendererFormat *uiformat;
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Wunguarded-availability"
             // iOS 11.0.0 GM does have `preferredFormat`, but iOS 11 betas did not (argh!)
             if ([UIGraphicsImageRenderer respondsToSelector:@selector(preferredFormat)]) {
                 uiformat = [UIGraphicsImageRendererFormat preferredFormat];
@@ -57,7 +64,7 @@
             self.uiformat = uiformat;
             self.scale = uiformat.scale;
             self.opaque = uiformat.opaque;
-            if (@available(iOS 12.0, *)) {
+            if (@available(iOS 12.0, tvOS 12.0, *)) {
                 self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
             } else {
                 if (uiformat.prefersExtendedRange) {
@@ -66,8 +73,8 @@
                     self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
                 }
             }
-#pragma clang diagnostic pop
         } else {
+#endif
 #if SD_WATCH
             CGFloat screenScale = [WKInterfaceDevice currentDevice].screenScale;
 #elif SD_UIKIT
@@ -78,10 +85,13 @@
             self.scale = screenScale;
             self.opaque = NO;
             self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+#if SD_UIKIT
         }
+#endif
     }
     return self;
 }
+#pragma clang diagnostic pop
 
 + (instancetype)preferredFormat {
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] initForMainScreen];
@@ -93,7 +103,9 @@
 @interface SDGraphicsImageRenderer ()
 @property (nonatomic, assign) CGSize size;
 @property (nonatomic, strong) SDGraphicsImageRendererFormat *format;
-@property (nonatomic, strong) UIGraphicsImageRenderer *uirenderer API_AVAILABLE(ios(10.0));
+#if SD_UIKIT
+@property (nonatomic, strong) UIGraphicsImageRenderer *uirenderer API_AVAILABLE(ios(10.0), tvos(10.0));
+#endif
 @end
 
 @implementation SDGraphicsImageRenderer
@@ -108,17 +120,20 @@
     if (self) {
         self.size = size;
         self.format = format;
-        if (@available(iOS 10.0, *)) {
+#if SD_UIKIT
+        if (@available(iOS 10.0, tvOS 10.0, *)) {
             UIGraphicsImageRendererFormat *uiformat = format.uiformat;
             self.uirenderer = [[UIGraphicsImageRenderer alloc] initWithSize:size format:uiformat];
         }
+#endif
     }
     return self;
 }
 
 - (UIImage *)imageWithActions:(NS_NOESCAPE SDGraphicsImageDrawingActions)actions {
     NSParameterAssert(actions);
-    if (@available(iOS 10.0, *)) {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.0, *)) {
         UIGraphicsImageDrawingActions uiactions = ^(UIGraphicsImageRendererContext *rendererContext) {
             if (actions) {
                 actions(rendererContext.CGContext);
@@ -126,6 +141,7 @@
         };
         return [self.uirenderer imageWithActions:uiactions];
     } else {
+#endif
         SDGraphicsBeginImageContextWithOptions(self.size, self.format.opaque, self.format.scale);
         CGContextRef context = SDGraphicsGetCurrentContext();
         if (actions) {
@@ -134,7 +150,9 @@
         UIImage *image = SDGraphicsGetImageFromCurrentImageContext();
         SDGraphicsEndImageContext();
         return image;
+#if SD_UIKIT
     }
+#endif
 }
 
 @end

From 8fa6c7519c2e41b5f8a5031c3b0e730d0a21ae2c Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 16:58:20 +0800
Subject: [PATCH 029/181] Replace the SDGraphicsBeginImageContextWithOptions
 with SDGraphicsImageRenderer

---
 SDWebImage/Core/UIImage+Transform.m | 96 +++++++++++++++--------------
 1 file changed, 49 insertions(+), 47 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 8637b1a2..723d48be 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -9,6 +9,7 @@
 #import "UIImage+Transform.h"
 #import "NSImage+Compatibility.h"
 #import "SDImageGraphics.h"
+#import "SDGraphicsImageRenderer.h"
 #import "NSBezierPath+RoundedCorners.h"
 #import <Accelerate/Accelerate.h>
 #if SD_UIKIT || SD_MAC
@@ -165,11 +166,10 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 @implementation UIImage (Transform)
 
-- (void)sd_drawInRect:(CGRect)rect withScaleMode:(SDImageScaleMode)scaleMode clipsToBounds:(BOOL)clips {
+- (void)sd_drawInRect:(CGRect)rect context:(CGContextRef)context scaleMode:(SDImageScaleMode)scaleMode clipsToBounds:(BOOL)clips {
     CGRect drawRect = SDCGRectFitWithScaleMode(rect, self.size, scaleMode);
     if (drawRect.size.width == 0 || drawRect.size.height == 0) return;
     if (clips) {
-        CGContextRef context = SDGraphicsGetCurrentContext();
         if (context) {
             CGContextSaveGState(context);
             CGContextAddRect(context, rect);
@@ -184,10 +184,12 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 - (nullable UIImage *)sd_resizedImageWithSize:(CGSize)size scaleMode:(SDImageScaleMode)scaleMode {
     if (size.width <= 0 || size.height <= 0) return nil;
-    SDGraphicsBeginImageContextWithOptions(size, NO, self.scale);
-    [self sd_drawInRect:CGRectMake(0, 0, size.width, size.height) withScaleMode:scaleMode clipsToBounds:NO];
-    UIImage *image = SDGraphicsGetImageFromCurrentImageContext();
-    SDGraphicsEndImageContext();
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
+    format.scale = self.scale;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:size format:format];
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        [self sd_drawInRect:CGRectMake(0, 0, size.width, size.height) context:context scaleMode:scaleMode clipsToBounds:NO];
+    }];
     return image;
 }
 
@@ -213,43 +215,43 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 - (nullable UIImage *)sd_roundedCornerImageWithRadius:(CGFloat)cornerRadius corners:(SDRectCorner)corners borderWidth:(CGFloat)borderWidth borderColor:(nullable UIColor *)borderColor {
     if (!self.CGImage) return nil;
-    SDGraphicsBeginImageContextWithOptions(self.size, NO, self.scale);
-    CGContextRef context = SDGraphicsGetCurrentContext();
-    CGRect rect = CGRectMake(0, 0, self.size.width, self.size.height);
-    
-    CGFloat minSize = MIN(self.size.width, self.size.height);
-    if (borderWidth < minSize / 2) {
-#if SD_UIKIT || SD_WATCH
-        UIBezierPath *path = [UIBezierPath bezierPathWithRoundedRect:CGRectInset(rect, borderWidth, borderWidth) byRoundingCorners:corners cornerRadii:CGSizeMake(cornerRadius, cornerRadius)];
-#else
-        NSBezierPath *path = [NSBezierPath sd_bezierPathWithRoundedRect:CGRectInset(rect, borderWidth, borderWidth) byRoundingCorners:corners cornerRadius:cornerRadius];
-#endif
-        [path closePath];
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
+    format.scale = self.scale;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:self.size format:format];
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        CGRect rect = CGRectMake(0, 0, self.size.width, self.size.height);
         
-        CGContextSaveGState(context);
-        [path addClip];
-        [self drawInRect:rect];
-        CGContextRestoreGState(context);
-    }
-    
-    if (borderColor && borderWidth < minSize / 2 && borderWidth > 0) {
-        CGFloat strokeInset = (floor(borderWidth * self.scale) + 0.5) / self.scale;
-        CGRect strokeRect = CGRectInset(rect, strokeInset, strokeInset);
-        CGFloat strokeRadius = cornerRadius > self.scale / 2 ? cornerRadius - self.scale / 2 : 0;
+        CGFloat minSize = MIN(self.size.width, self.size.height);
+        if (borderWidth < minSize / 2) {
 #if SD_UIKIT || SD_WATCH
-        UIBezierPath *path = [UIBezierPath bezierPathWithRoundedRect:strokeRect byRoundingCorners:corners cornerRadii:CGSizeMake(strokeRadius, strokeRadius)];
+            UIBezierPath *path = [UIBezierPath bezierPathWithRoundedRect:CGRectInset(rect, borderWidth, borderWidth) byRoundingCorners:corners cornerRadii:CGSizeMake(cornerRadius, cornerRadius)];
 #else
-        NSBezierPath *path = [NSBezierPath sd_bezierPathWithRoundedRect:strokeRect byRoundingCorners:corners cornerRadius:strokeRadius];
+            NSBezierPath *path = [NSBezierPath sd_bezierPathWithRoundedRect:CGRectInset(rect, borderWidth, borderWidth) byRoundingCorners:corners cornerRadius:cornerRadius];
 #endif
-        [path closePath];
+            [path closePath];
+            
+            CGContextSaveGState(context);
+            [path addClip];
+            [self drawInRect:rect];
+            CGContextRestoreGState(context);
+        }
         
-        path.lineWidth = borderWidth;
-        [borderColor setStroke];
-        [path stroke];
-    }
-    
-    UIImage *image = SDGraphicsGetImageFromCurrentImageContext();
-    SDGraphicsEndImageContext();
+        if (borderColor && borderWidth < minSize / 2 && borderWidth > 0) {
+            CGFloat strokeInset = (floor(borderWidth * self.scale) + 0.5) / self.scale;
+            CGRect strokeRect = CGRectInset(rect, strokeInset, strokeInset);
+            CGFloat strokeRadius = cornerRadius > self.scale / 2 ? cornerRadius - self.scale / 2 : 0;
+#if SD_UIKIT || SD_WATCH
+            UIBezierPath *path = [UIBezierPath bezierPathWithRoundedRect:strokeRect byRoundingCorners:corners cornerRadii:CGSizeMake(strokeRadius, strokeRadius)];
+#else
+            NSBezierPath *path = [NSBezierPath sd_bezierPathWithRoundedRect:strokeRect byRoundingCorners:corners cornerRadius:strokeRadius];
+#endif
+            [path closePath];
+            
+            path.lineWidth = borderWidth;
+            [borderColor setStroke];
+            [path stroke];
+        }
+    }];
     return image;
 }
 
@@ -347,15 +349,15 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     // blend mode, see https://en.wikipedia.org/wiki/Alpha_compositing
     CGBlendMode blendMode = kCGBlendModeSourceAtop;
     
-    SDGraphicsBeginImageContextWithOptions(size, NO, scale);
-    CGContextRef context = SDGraphicsGetCurrentContext();
-    [self drawInRect:rect];
-    CGContextSetBlendMode(context, blendMode);
-    CGContextSetFillColorWithColor(context, tintColor.CGColor);
-    CGContextFillRect(context, rect);
-    UIImage *image = SDGraphicsGetImageFromCurrentImageContext();
-    SDGraphicsEndImageContext();
-    
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
+    format.scale = scale;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:size format:format];
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        [self drawInRect:rect];
+        CGContextSetBlendMode(context, blendMode);
+        CGContextSetFillColorWithColor(context, tintColor.CGColor);
+        CGContextFillRect(context, rect);
+    }];
     return image;
 }
 

From d5734cd6cd2d67cc2eb08368b7150f2e793c6a72 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 19:41:52 +0800
Subject: [PATCH 030/181] Fix the implementation of
 SDGraphicsImageRendererFormat, now use the dynamic getter/setter to forward
 to UIGraphicsImageRendererFormat

---
 SDWebImage/Core/SDGraphicsImageRenderer.m | 120 ++++++++++++++++++----
 1 file changed, 98 insertions(+), 22 deletions(-)

diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.m b/SDWebImage/Core/SDGraphicsImageRenderer.m
index 029a4f40..141da2ff 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.m
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.m
@@ -16,6 +16,104 @@
 @end
 
 @implementation SDGraphicsImageRendererFormat
+@synthesize scale = _scale;
+@synthesize opaque = _opaque;
+@synthesize preferredRange = _preferredRange;
+
+#pragma mark - Property
+- (CGFloat)scale {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        return self.uiformat.scale;
+    } else {
+        return _scale;
+    }
+#else
+    return _scale;
+#endif
+}
+
+- (void)setScale:(CGFloat)scale {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        self.uiformat.scale = scale;
+    } else {
+        _scale = scale;
+    }
+#else
+    _scale = scale;
+#endif
+}
+
+- (BOOL)opaque {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        return self.uiformat.opaque;
+    } else {
+        return _opaque;
+    }
+#else
+    return _opaque;
+#endif
+}
+
+- (void)setOpaque:(BOOL)opaque {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        self.uiformat.opaque = opaque;
+    } else {
+        _opaque = opaque;
+    }
+#else
+    _opaque = opaque;
+#endif
+}
+
+- (SDGraphicsImageRendererFormatRange)preferredRange {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        if (@available(iOS 12.0, tvOS 12.0, *)) {
+            return (SDGraphicsImageRendererFormatRange)self.uiformat.preferredRange;
+        } else {
+            BOOL prefersExtendedRange = self.uiformat.prefersExtendedRange;
+            if (prefersExtendedRange) {
+                return SDGraphicsImageRendererFormatRangeExtended;
+            } else {
+                return SDGraphicsImageRendererFormatRangeStandard;
+            }
+        }
+    } else {
+        return _preferredRange;
+    }
+#else
+    return _preferredRange;
+#endif
+}
+
+- (void)setPreferredRange:(SDGraphicsImageRendererFormatRange)preferredRange {
+#if SD_UIKIT
+    if (@available(iOS 10.0, tvOS 10.10, *)) {
+        if (@available(iOS 12.0, tvOS 12.0, *)) {
+            self.uiformat.preferredRange = (UIGraphicsImageRendererFormatRange)preferredRange;
+        } else {
+            switch (preferredRange) {
+                case SDGraphicsImageRendererFormatRangeExtended:
+                    self.uiformat.prefersExtendedRange = YES;
+                    break;
+                case SDGraphicsImageRendererFormatRangeStandard:
+                    self.uiformat.prefersExtendedRange = NO;
+                default:
+                    // Automatic means default
+                    break;
+            }
+        }
+    } else {
+        _preferredRange = preferredRange;
+    }
+#else
+    _preferredRange = preferredRange;
+#endif
+}
 
 - (instancetype)init {
     self = [super init];
@@ -24,17 +122,6 @@
         if (@available(iOS 10.0, tvOS 10.10, *)) {
             UIGraphicsImageRendererFormat *uiformat = [[UIGraphicsImageRendererFormat alloc] init];
             self.uiformat = uiformat;
-            self.scale = uiformat.scale;
-            self.opaque = uiformat.opaque;
-            if (@available(iOS 12.0, tvOS 12.0, *)) {
-                self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
-            } else {
-                if (uiformat.prefersExtendedRange) {
-                    self.preferredRange = SDGraphicsImageRendererFormatRangeExtended;
-                } else {
-                    self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
-                }
-            }
         } else {
 #endif
             self.scale = 1.0;
@@ -62,17 +149,6 @@
                 uiformat = [UIGraphicsImageRendererFormat defaultFormat];
             }
             self.uiformat = uiformat;
-            self.scale = uiformat.scale;
-            self.opaque = uiformat.opaque;
-            if (@available(iOS 12.0, tvOS 12.0, *)) {
-                self.preferredRange = (SDGraphicsImageRendererFormatRange)uiformat.preferredRange;
-            } else {
-                if (uiformat.prefersExtendedRange) {
-                    self.preferredRange = SDGraphicsImageRendererFormatRangeExtended;
-                } else {
-                    self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
-                }
-            }
         } else {
 #endif
 #if SD_WATCH

From c49bc5c925559b2ec4441654328eed8e3b5d1306 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 19:42:52 +0800
Subject: [PATCH 031/181] Change the implementation of
 `sd_rotatedImageWithAngle` using the UIGraphicsRenderer, avoid always using
 ARGB8888

---
 SDWebImage/Core/UIImage+Transform.m   | 44 +++++++++------------------
 Tests/Tests/SDImageTransformerTests.m |  2 +-
 2 files changed, 16 insertions(+), 30 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 723d48be..45cd7fba 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -259,37 +259,23 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     if (!self.CGImage) return nil;
     size_t width = (size_t)CGImageGetWidth(self.CGImage);
     size_t height = (size_t)CGImageGetHeight(self.CGImage);
-    CGRect newRect = CGRectApplyAffineTransform(CGRectMake(0., 0., width, height),
+    CGRect newRect = CGRectApplyAffineTransform(CGRectMake(0, 0, width, height),
                                                 fitSize ? CGAffineTransformMakeRotation(angle) : CGAffineTransformIdentity);
     
-    CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB();
-    CGContextRef context = CGBitmapContextCreate(NULL,
-                                                 (size_t)newRect.size.width,
-                                                 (size_t)newRect.size.height,
-                                                 8,
-                                                 (size_t)newRect.size.width * 4,
-                                                 colorSpace,
-                                                 kCGBitmapByteOrderDefault | kCGImageAlphaPremultipliedFirst);
-    CGColorSpaceRelease(colorSpace);
-    if (!context) return nil;
-    
-    CGContextSetShouldAntialias(context, true);
-    CGContextSetAllowsAntialiasing(context, true);
-    CGContextSetInterpolationQuality(context, kCGInterpolationHigh);
-    
-    CGContextTranslateCTM(context, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
-    CGContextRotateCTM(context, angle);
-    
-    CGContextDrawImage(context, CGRectMake(-(width * 0.5), -(height * 0.5), width, height), self.CGImage);
-    CGImageRef imgRef = CGBitmapContextCreateImage(context);
-#if SD_UIKIT || SD_WATCH
-    UIImage *img = [UIImage imageWithCGImage:imgRef scale:self.scale orientation:self.imageOrientation];
-#else
-    UIImage *img = [[UIImage alloc] initWithCGImage:imgRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
-#endif
-    CGImageRelease(imgRef);
-    CGContextRelease(context);
-    return img;
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
+    format.scale = self.scale;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:newRect.size format:format];
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        CGContextSetShouldAntialias(context, true);
+        CGContextSetAllowsAntialiasing(context, true);
+        CGContextSetInterpolationQuality(context, kCGInterpolationHigh);
+        // Use UIKit coordinate counterclockwise (⟲)
+        CGContextTranslateCTM(context, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
+        CGContextRotateCTM(context, -angle);
+        
+        [self drawInRect:CGRectMake(-(width * 0.5), -(height * 0.5), width, height)];
+    }];
+    return image;
 }
 
 - (nullable UIImage *)sd_flippedImageWithHorizontal:(BOOL)horizontal vertical:(BOOL)vertical {
diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index d0105f57..6ddcfc14 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -73,7 +73,7 @@
     expect(CGSizeEqualToSize(rotatedImage.size, self.testImage.size)).beTruthy();
     // Fit size, may change size
     rotatedImage = [self.testImage sd_rotatedImageWithAngle:angle fitSize:YES];
-    CGSize rotatedSize = CGSizeMake(floor(300 * 1.414), floor(300 * 1.414)); // 45º, square length * sqrt(2)
+    CGSize rotatedSize = CGSizeMake(ceil(300 * 1.414), ceil(300 * 1.414)); // 45º, square length * sqrt(2)
     expect(CGSizeEqualToSize(rotatedImage.size, rotatedSize)).beTruthy();
     // Check image not inversion
     UIColor *leftCenterColor = [rotatedImage sd_colorAtPoint:CGPointMake(60, 175)];

From 48a7b7f943a9a267eb58857fac88837db735ef38 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 19:49:41 +0800
Subject: [PATCH 032/181] Fix the issues during refactory, the
 UIGraphicsRenderer using the point size, not pixel size

---
 SDWebImage/Core/UIImage+Transform.m | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 45cd7fba..db5de997 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -257,8 +257,8 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 - (nullable UIImage *)sd_rotatedImageWithAngle:(CGFloat)angle fitSize:(BOOL)fitSize {
     if (!self.CGImage) return nil;
-    size_t width = (size_t)CGImageGetWidth(self.CGImage);
-    size_t height = (size_t)CGImageGetHeight(self.CGImage);
+    size_t width = self.size.width;
+    size_t height = self.size.height;
     CGRect newRect = CGRectApplyAffineTransform(CGRectMake(0, 0, width, height),
                                                 fitSize ? CGAffineTransformMakeRotation(angle) : CGAffineTransformIdentity);
     

From 1e778f0fe66461a76b24018efff36ff2a754aad4 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 20:20:38 +0800
Subject: [PATCH 033/181] Refactory the `sd_flippedImageWithHorizontal` with
 the UIGraphicsRenderer, do not always need ARGB8888

---
 SDWebImage/Core/UIImage+Transform.m | 48 +++++++++++------------------
 1 file changed, 18 insertions(+), 30 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index db5de997..ffcd9327 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -280,37 +280,25 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 - (nullable UIImage *)sd_flippedImageWithHorizontal:(BOOL)horizontal vertical:(BOOL)vertical {
     if (!self.CGImage) return nil;
-    size_t width = (size_t)CGImageGetWidth(self.CGImage);
-    size_t height = (size_t)CGImageGetHeight(self.CGImage);
-    size_t bytesPerRow = width * 4;
-    CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB();
-    CGContextRef context = CGBitmapContextCreate(NULL, width, height, 8, bytesPerRow, colorSpace, kCGBitmapByteOrderDefault | kCGImageAlphaPremultipliedFirst);
-    CGColorSpaceRelease(colorSpace);
-    if (!context) return nil;
+    size_t width = self.size.width;
+    size_t height = self.size.height;
     
-    CGContextDrawImage(context, CGRectMake(0, 0, width, height), self.CGImage);
-    UInt8 *data = (UInt8 *)CGBitmapContextGetData(context);
-    if (!data) {
-        CGContextRelease(context);
-        return nil;
-    }
-    vImage_Buffer src = { data, height, width, bytesPerRow };
-    vImage_Buffer dest = { data, height, width, bytesPerRow };
-    if (vertical) {
-        vImageVerticalReflect_ARGB8888(&src, &dest, kvImageBackgroundColorFill);
-    }
-    if (horizontal) {
-        vImageHorizontalReflect_ARGB8888(&src, &dest, kvImageBackgroundColorFill);
-    }
-    CGImageRef imgRef = CGBitmapContextCreateImage(context);
-    CGContextRelease(context);
-#if SD_UIKIT || SD_WATCH
-    UIImage *img = [UIImage imageWithCGImage:imgRef scale:self.scale orientation:self.imageOrientation];
-#else
-    UIImage *img = [[UIImage alloc] initWithCGImage:imgRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
-#endif
-    CGImageRelease(imgRef);
-    return img;
+    SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
+    format.scale = self.scale;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:self.size format:format];
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        // Use UIKit coordinate system
+        if (horizontal) {
+            CGAffineTransform flipHorizontal = CGAffineTransformMake(-1, 0, 0, 1, width, 0);
+            CGContextConcatCTM(context, flipHorizontal);
+        }
+        if (vertical) {
+            CGAffineTransform flipVertical = CGAffineTransformMake(1, 0, 0, -1, 0, height);
+            CGContextConcatCTM(context, flipVertical);
+        }
+        [self drawInRect:CGRectMake(0, 0, width, height)];
+    }];
+    return image;
 }
 
 #pragma mark - Image Blending

From 3929f2cd2a354f2fc23b1be819c73451f9ed35e5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 15 Dec 2019 20:44:32 +0800
Subject: [PATCH 034/181] Replace the background decode core function
 CGImageCreateDecoded with UIGraphicsRenderer, this one should use the
 perferred format

---
 SDWebImage/Core/SDImageCoderHelper.m | 35 ++++++++++++++++------------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 3cc0c7ea..1a3391e1 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -12,6 +12,7 @@
 #import "NSData+ImageContentType.h"
 #import "SDAnimatedImageRep.h"
 #import "UIImage+ForceDecode.h"
+#import "SDGraphicsImageRenderer.h"
 #import "SDAssociatedObject.h"
 
 #if SD_UIKIT || SD_WATCH
@@ -257,22 +258,26 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     }
     
     BOOL hasAlpha = [self CGImageContainsAlpha:cgImage];
-    // iOS prefer BGRA8888 (premultiplied) or BGRX8888 bitmapInfo for screen rendering, which is same as `UIGraphicsBeginImageContext()` or `- [CALayer drawInContext:]`
-    // Though you can use any supported bitmapInfo (see: https://developer.apple.com/library/content/documentation/GraphicsImaging/Conceptual/drawingwithquartz2d/dq_context/dq_context.html#//apple_ref/doc/uid/TP30001066-CH203-BCIBHHBB ) and let Core Graphics reorder it when you call `CGContextDrawImage`
-    // But since our build-in coders use this bitmapInfo, this can have a little performance benefit
-    CGBitmapInfo bitmapInfo = kCGBitmapByteOrder32Host;
-    bitmapInfo |= hasAlpha ? kCGImageAlphaPremultipliedFirst : kCGImageAlphaNoneSkipFirst;
-    CGContextRef context = CGBitmapContextCreate(NULL, newWidth, newHeight, 8, 0, [self colorSpaceGetDeviceRGB], bitmapInfo);
-    if (!context) {
-        return NULL;
-    }
     
-    // Apply transform
-    CGAffineTransform transform = SDCGContextTransformFromOrientation(orientation, CGSizeMake(newWidth, newHeight));
-    CGContextConcatCTM(context, transform);
-    CGContextDrawImage(context, CGRectMake(0, 0, width, height), cgImage); // The rect is bounding box of CGImage, don't swap width & height
-    CGImageRef newImageRef = CGBitmapContextCreateImage(context);
-    CGContextRelease(context);
+    // Using UIGraphicsRenderer on supported platforms, and use the main screeen's perferred format (like Wide Color)
+    SDGraphicsImageRendererFormat *format = [SDGraphicsImageRendererFormat preferredFormat];
+    format.scale = 1; // use pixel instead of point
+    format.opaque = !hasAlpha;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:CGSizeMake(newWidth, newHeight) format:format];
+    UIImage *newImage = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        // Apply transform
+        CGAffineTransform transform = SDCGContextTransformFromOrientation(orientation, CGSizeMake(newWidth, newHeight));
+        CGContextConcatCTM(context, transform);
+#if SD_MAC
+        UIImage *drawImage = [[UIImage alloc] initWithCGImage:cgImage scale:1 orientation:kCGImagePropertyOrientationUp];
+#else
+        UIImage *drawImage = [[UIImage alloc] initWithCGImage:cgImage scale:1 orientation:UIImageOrientationUp];
+#endif
+        [drawImage drawInRect:CGRectMake(0, 0, width, height)]; // The rect is bounding box of CGImage, don't swap width & height
+    }];
+    CGImageRef newImageRef = newImage.CGImage;
+    // Retain the CGImage because this temp `newImage` will release after function return
+    CGImageRetain(newImageRef);
     
     return newImageRef;
 }

From 92e3bfcc3e9ee89e0b0250cc48603c64406fbedf Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 16 Dec 2019 11:44:52 +0800
Subject: [PATCH 035/181] Fix the sd_rotatedImageWithAngle on macOS, which
 should not apply the counterclockwise reverse

---
 SDWebImage/Core/UIImage+Transform.m | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index ffcd9327..54d3cef9 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -269,9 +269,13 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
         CGContextSetShouldAntialias(context, true);
         CGContextSetAllowsAntialiasing(context, true);
         CGContextSetInterpolationQuality(context, kCGInterpolationHigh);
-        // Use UIKit coordinate counterclockwise (⟲)
         CGContextTranslateCTM(context, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
+#if SD_UIKIT
+        // Use UIKit coordinate system counterclockwise (⟲)
         CGContextRotateCTM(context, -angle);
+#else
+        CGContextRotateCTM(context, angle);
+#endif
         
         [self drawInRect:CGRectMake(-(width * 0.5), -(height * 0.5), width, height)];
     }];

From 1ee04f64b0a97698ad51e67fce85e220c50696db Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 16 Dec 2019 17:26:09 +0800
Subject: [PATCH 036/181] Update all the documentation of the
 SDGraphicsImageRenderer, fix small behavior to match Apple's documentation

---
 SDWebImage/Core/SDGraphicsImageRenderer.h | 40 +++++++++++++++++++----
 SDWebImage/Core/SDGraphicsImageRenderer.m | 13 ++++++--
 SDWebImage/Core/SDImageGraphics.h         |  1 +
 3 files changed, 45 insertions(+), 9 deletions(-)

diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.h b/SDWebImage/Core/SDGraphicsImageRenderer.h
index 2899b3b4..e450d639 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.h
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.h
@@ -8,8 +8,15 @@
 
 #import "SDWebImageCompat.h"
 
-typedef void (^SDGraphicsImageDrawingActions)(CGContextRef _Nonnull context);
+/**
+ These following class are provided to use `UIGraphicsImageRenderer` with polyfill, which allows write cross-platform(AppKit/UIKit) code and avoid runtime version check.
+ Compared to `UIGraphicsBeginImageContext`, `UIGraphicsImageRenderer` use dynamic bitmap info from your draw code to generate CGContext, not always use ARGB8888, which is more performant on RAM usage.
+ For usage, See more in Apple's documentation: https://developer.apple.com/documentation/uikit/uigraphicsimagerenderer
+ For UIKit on iOS/tvOS 10+, these method just use the same `UIGraphicsImageRenderer` API.
+ For others (macOS/watchOS or iOS/tvOS 10-), these method use the `SDImageGraphics.h` to implements the same behavior.
+*/
 
+typedef void (^SDGraphicsImageDrawingActions)(CGContextRef _Nonnull context);
 typedef NS_ENUM(NSInteger, SDGraphicsImageRendererFormatRange) {
     SDGraphicsImageRendererFormatRangeUnspecified = -1,
     SDGraphicsImageRendererFormatRangeAutomatic = 0,
@@ -17,28 +24,49 @@ typedef NS_ENUM(NSInteger, SDGraphicsImageRendererFormatRange) {
     SDGraphicsImageRendererFormatRangeStandard
 };
 
+/// A set of drawing attributes that represent the configuration of an image renderer context.
 @interface SDGraphicsImageRendererFormat : NSObject
 
+/// The display scale of the image renderer context.
+/// The default value is equal to the scale of the main screen.
 @property (nonatomic) CGFloat scale;
+
+/// A Boolean value indicating whether the underlying Core Graphics context has an alpha channel.
+/// The default value is NO.
 @property (nonatomic) BOOL opaque;
 
-/**
- For iOS 12+, the value is from system API
- For iOS 10-11, the value is from `prefersExtendedRange` property
- For iOS 9, the value is `.unspecified`
- */
+/// Specifying whether the bitmap context should use extended color.
+/// For iOS 12+, the value is from system `preferredRange` property
+/// For iOS 10-11, the value is from system `prefersExtendedRange` property
+/// For iOS 9-, the value is `.standard`
 @property (nonatomic) SDGraphicsImageRendererFormatRange preferredRange;
 
+/// Init the default format. See each properties's default value.
 - (nonnull instancetype)init;
+
+/// Returns a new format best suited for the main screen’s current configuration.
 + (nonnull instancetype)preferredFormat;
 
 @end
 
+/// A graphics renderer for creating Core Graphics-backed images.
 @interface SDGraphicsImageRenderer : NSObject
 
+/// Creates an image renderer for drawing images of a given size.
+/// @param size The size of images output from the renderer, specified in points.
+/// @return An initialized image renderer.
 - (nonnull instancetype)initWithSize:(CGSize)size;
+
+/// Creates a new image renderer with a given size and format.
+/// @param size The size of images output from the renderer, specified in points.
+/// @param format A SDGraphicsImageRendererFormat object that encapsulates the format used to create the renderer context.
+/// @return An initialized image renderer.
 - (nonnull instancetype)initWithSize:(CGSize)size format:(nonnull SDGraphicsImageRendererFormat *)format;
 
+/// Creates an image by following a set of drawing instructions.
+/// @param actions A SDGraphicsImageDrawingActions block that, when invoked by the renderer, executes a set of drawing instructions to create the output image.
+/// @note You should not retain or use the context outside the block, it's non-escaping.
+/// @return A UIImage object created by the supplied drawing actions.
 - (nonnull UIImage *)imageWithActions:(nonnull NS_NOESCAPE SDGraphicsImageDrawingActions)actions;
 
 @end
diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.m b/SDWebImage/Core/SDGraphicsImageRenderer.m
index 141da2ff..869de2ca 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.m
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.m
@@ -124,9 +124,16 @@
             self.uiformat = uiformat;
         } else {
 #endif
-            self.scale = 1.0;
+#if SD_WATCH
+            CGFloat screenScale = [WKInterfaceDevice currentDevice].screenScale;
+#elif SD_UIKIT
+            CGFloat screenScale = [UIScreen mainScreen].scale;
+#elif SD_MAC
+            CGFloat screenScale = [NSScreen mainScreen].backingScaleFactor;
+#endif
+            self.scale = screenScale;
             self.opaque = NO;
-            self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+            self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
 #if SD_UIKIT
         }
 #endif
@@ -160,7 +167,7 @@
 #endif
             self.scale = screenScale;
             self.opaque = NO;
-            self.preferredRange = SDGraphicsImageRendererFormatRangeUnspecified;
+            self.preferredRange = SDGraphicsImageRendererFormatRangeStandard;
 #if SD_UIKIT
         }
 #endif
diff --git a/SDWebImage/Core/SDImageGraphics.h b/SDWebImage/Core/SDImageGraphics.h
index 67019c5b..131d6850 100644
--- a/SDWebImage/Core/SDImageGraphics.h
+++ b/SDWebImage/Core/SDImageGraphics.h
@@ -13,6 +13,7 @@
  These following graphics context method are provided to easily write cross-platform(AppKit/UIKit) code.
  For UIKit, these methods just call the same method in `UIGraphics.h`. See the documentation for usage.
  For AppKit, these methods use `NSGraphicsContext` to create image context and match the behavior like UIKit.
+ @note If you don't care bitmap format (ARGB8888) and just draw image, use `SDGraphicsImageRenderer` instead. It's more performant on RAM usage.`
  */
 
 /// Returns the current graphics context.

From 5cb365ece9351c6d50931699837c8739e1aa65d6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 21 Dec 2019 17:20:19 +0800
Subject: [PATCH 037/181] Revert "Replace the background decode core function
 CGImageCreateDecoded with UIGraphicsRenderer, this one should use the
 perferred format"

This reverts commit 3929f2cd2a354f2fc23b1be819c73451f9ed35e5.
---
 SDWebImage/Core/SDImageCoderHelper.m | 35 ++++++++++++----------------
 1 file changed, 15 insertions(+), 20 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 1a3391e1..3cc0c7ea 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -12,7 +12,6 @@
 #import "NSData+ImageContentType.h"
 #import "SDAnimatedImageRep.h"
 #import "UIImage+ForceDecode.h"
-#import "SDGraphicsImageRenderer.h"
 #import "SDAssociatedObject.h"
 
 #if SD_UIKIT || SD_WATCH
@@ -258,26 +257,22 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     }
     
     BOOL hasAlpha = [self CGImageContainsAlpha:cgImage];
+    // iOS prefer BGRA8888 (premultiplied) or BGRX8888 bitmapInfo for screen rendering, which is same as `UIGraphicsBeginImageContext()` or `- [CALayer drawInContext:]`
+    // Though you can use any supported bitmapInfo (see: https://developer.apple.com/library/content/documentation/GraphicsImaging/Conceptual/drawingwithquartz2d/dq_context/dq_context.html#//apple_ref/doc/uid/TP30001066-CH203-BCIBHHBB ) and let Core Graphics reorder it when you call `CGContextDrawImage`
+    // But since our build-in coders use this bitmapInfo, this can have a little performance benefit
+    CGBitmapInfo bitmapInfo = kCGBitmapByteOrder32Host;
+    bitmapInfo |= hasAlpha ? kCGImageAlphaPremultipliedFirst : kCGImageAlphaNoneSkipFirst;
+    CGContextRef context = CGBitmapContextCreate(NULL, newWidth, newHeight, 8, 0, [self colorSpaceGetDeviceRGB], bitmapInfo);
+    if (!context) {
+        return NULL;
+    }
     
-    // Using UIGraphicsRenderer on supported platforms, and use the main screeen's perferred format (like Wide Color)
-    SDGraphicsImageRendererFormat *format = [SDGraphicsImageRendererFormat preferredFormat];
-    format.scale = 1; // use pixel instead of point
-    format.opaque = !hasAlpha;
-    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:CGSizeMake(newWidth, newHeight) format:format];
-    UIImage *newImage = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
-        // Apply transform
-        CGAffineTransform transform = SDCGContextTransformFromOrientation(orientation, CGSizeMake(newWidth, newHeight));
-        CGContextConcatCTM(context, transform);
-#if SD_MAC
-        UIImage *drawImage = [[UIImage alloc] initWithCGImage:cgImage scale:1 orientation:kCGImagePropertyOrientationUp];
-#else
-        UIImage *drawImage = [[UIImage alloc] initWithCGImage:cgImage scale:1 orientation:UIImageOrientationUp];
-#endif
-        [drawImage drawInRect:CGRectMake(0, 0, width, height)]; // The rect is bounding box of CGImage, don't swap width & height
-    }];
-    CGImageRef newImageRef = newImage.CGImage;
-    // Retain the CGImage because this temp `newImage` will release after function return
-    CGImageRetain(newImageRef);
+    // Apply transform
+    CGAffineTransform transform = SDCGContextTransformFromOrientation(orientation, CGSizeMake(newWidth, newHeight));
+    CGContextConcatCTM(context, transform);
+    CGContextDrawImage(context, CGRectMake(0, 0, width, height), cgImage); // The rect is bounding box of CGImage, don't swap width & height
+    CGImageRef newImageRef = CGBitmapContextCreateImage(context);
+    CGContextRelease(context);
     
     return newImageRef;
 }

From a7682d58b45970bd41727acfd9a04919292f13ba Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 21 Dec 2019 20:02:13 +0800
Subject: [PATCH 038/181] Add the test case testSDGraphicsImageRenderer, update
 the documentation

---
 SDWebImage/Core/SDGraphicsImageRenderer.h |  5 +++--
 Tests/Tests/SDUtilsTests.m                | 27 +++++++++++++++++++++++
 2 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.h b/SDWebImage/Core/SDGraphicsImageRenderer.h
index e450d639..900acd76 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.h
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.h
@@ -10,10 +10,11 @@
 
 /**
  These following class are provided to use `UIGraphicsImageRenderer` with polyfill, which allows write cross-platform(AppKit/UIKit) code and avoid runtime version check.
- Compared to `UIGraphicsBeginImageContext`, `UIGraphicsImageRenderer` use dynamic bitmap info from your draw code to generate CGContext, not always use ARGB8888, which is more performant on RAM usage.
+ Compared to `UIGraphicsBeginImageContext`, `UIGraphicsImageRenderer` use dynamic bitmap from your draw code to generate CGContext, not always use ARGB8888, which is more performant on RAM usage.
+ Which means, if you draw CGImage/CIImage which contains grayscale only, the underlaying bitmap context use grayscale, it's managed by system and not a fixed type. (actually, the `kCGContextTypeAutomatic`)
  For usage, See more in Apple's documentation: https://developer.apple.com/documentation/uikit/uigraphicsimagerenderer
  For UIKit on iOS/tvOS 10+, these method just use the same `UIGraphicsImageRenderer` API.
- For others (macOS/watchOS or iOS/tvOS 10-), these method use the `SDImageGraphics.h` to implements the same behavior.
+ For others (macOS/watchOS or iOS/tvOS 10-), these method use the `SDImageGraphics.h` to implements the same behavior (but without dynamic bitmap support)
 */
 
 typedef void (^SDGraphicsImageDrawingActions)(CGContextRef _Nonnull context);
diff --git a/Tests/Tests/SDUtilsTests.m b/Tests/Tests/SDUtilsTests.m
index 89012e20..4d37f9c4 100644
--- a/Tests/Tests/SDUtilsTests.m
+++ b/Tests/Tests/SDUtilsTests.m
@@ -12,6 +12,7 @@
 #import "SDDisplayLink.h"
 #import "SDInternalMacros.h"
 #import "SDFileAttributeHelper.h"
+#import "UIColor+HexString.h"
 
 @interface SDUtilsTests : SDTestCase
 
@@ -107,6 +108,32 @@
     expect(hasAttr).beFalsy();
 }
 
+- (void)testSDGraphicsImageRenderer {
+    // Main Screen
+    SDGraphicsImageRendererFormat *format = SDGraphicsImageRendererFormat.preferredFormat;
+#if SD_UIKIT
+    CGFloat screenScale = [UIScreen mainScreen].scale;
+#elif SD_MAC
+    CGFloat screenScale = [NSScreen mainScreen].backingScaleFactor;
+#endif
+    expect(format.scale).equal(screenScale);
+    expect(format.opaque).beFalsy();
+#if SD_UIKIT
+    expect(format.preferredRange).equal(SDGraphicsImageRendererFormatRangeAutomatic);
+#elif SD_MAC
+    expect(format.preferredRange).equal(SDGraphicsImageRendererFormatRangeStandard);
+#endif
+    CGSize size = CGSizeMake(100, 100);
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:size format:format];
+    UIColor *color = UIColor.redColor;
+    UIImage *image = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        [color setFill];
+        CGContextFillRect(context, CGRectMake(0, 0, size.width, size.height));
+    }];
+    expect(image.scale).equal(format.scale);
+    expect([[image sd_colorAtPoint:CGPointMake(50, 50)].sd_hexString isEqualToString:color.sd_hexString]).beTruthy();
+}
+
 - (void)testSDScaledImageForKey {
     // Test nil
     expect(SDScaledImageForKey(nil, nil)).beNil();

From f041dcabefb0a0730d453c897ffbad56aaff21a3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 26 Dec 2019 14:53:53 +0800
Subject: [PATCH 039/181] Support to use the creation date and the change date
 to determine the disk cache expire date compare

---
 SDWebImage/Core/SDDiskCache.m        |  8 ++++++--
 SDWebImage/Core/SDImageCacheConfig.h | 14 +++++++++++---
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/SDDiskCache.m b/SDWebImage/Core/SDDiskCache.m
index 1dd9e10b..d7308dcc 100644
--- a/SDWebImage/Core/SDDiskCache.m
+++ b/SDWebImage/Core/SDDiskCache.m
@@ -146,11 +146,15 @@ static NSString * const SDDiskCacheExtendedAttributeName = @"com.hackemist.SDDis
         case SDImageCacheConfigExpireTypeAccessDate:
             cacheContentDateKey = NSURLContentAccessDateKey;
             break;
-            
         case SDImageCacheConfigExpireTypeModificationDate:
             cacheContentDateKey = NSURLContentModificationDateKey;
             break;
-            
+        case SDImageCacheConfigExpireTypeCreationDate:
+            cacheContentDateKey = NSURLCreationDateKey;
+            break;
+        case SDImageCacheConfigExpireTypeChangeDate:
+            cacheContentDateKey = NSURLAttributeModificationDateKey;
+            break;
         default:
             break;
     }
diff --git a/SDWebImage/Core/SDImageCacheConfig.h b/SDWebImage/Core/SDImageCacheConfig.h
index 460fd06b..e77e128c 100644
--- a/SDWebImage/Core/SDImageCacheConfig.h
+++ b/SDWebImage/Core/SDImageCacheConfig.h
@@ -12,13 +12,21 @@
 /// Image Cache Expire Type
 typedef NS_ENUM(NSUInteger, SDImageCacheConfigExpireType) {
     /**
-     * When the image is accessed it will update this value
+     * When the image cache is accessed it will update this value
      */
     SDImageCacheConfigExpireTypeAccessDate,
     /**
-     * The image was obtained from the disk cache (Default)
+     * When the image cache is created or modified it will update this value (Default)
      */
-    SDImageCacheConfigExpireTypeModificationDate
+    SDImageCacheConfigExpireTypeModificationDate,
+    /**
+     * When the image cache is created it will update this value
+     */
+    SDImageCacheConfigExpireTypeCreationDate,
+    /**
+     * When the image cache is created, modified, renamed, file attribute updated (like permission, xattr)  it will update this value
+     */
+    SDImageCacheConfigExpireTypeChangeDate,
 };
 
 /**

From e38388e13f1b2bd556454d9e4edb722d084d605a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 26 Dec 2019 17:44:09 +0800
Subject: [PATCH 040/181] Fix the issue that "There may be no complete callback
 when download the picture of the local path"

---
 SDWebImage/Core/SDWebImageDownloader.m | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index 5b931ea2..94bfa049 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -226,10 +226,11 @@ static void * SDWebImageDownloaderContext = &SDWebImageDownloaderContext;
             SD_UNLOCK(self.operationsLock);
         };
         self.URLOperations[url] = operation;
+        // Add the handlers before submitting to operation queue, avoid the race condition that operation finished before setting handlers.
+        downloadOperationCancelToken = [operation addHandlersForProgress:progressBlock completed:completedBlock];
         // Add operation to operation queue only after all configuration done according to Apple's doc.
         // `addOperation:` does not synchronously execute the `operation.completionBlock` so this will not cause deadlock.
         [self.downloadQueue addOperation:operation];
-        downloadOperationCancelToken = [operation addHandlersForProgress:progressBlock completed:completedBlock];
     } else {
         // When we reuse the download operation to attach more callbacks, there may be thread safe issue because the getter of callbacks may in another queue (decoding queue or delegate queue)
         // So we lock the operation here, and in `SDWebImageDownloaderOperation`, we use `@synchonzied (self)`, to ensure the thread safe between these two classes.

From 0d44d70e6209aabd357d510e49b91ad0349ba1c6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 26 Dec 2019 17:44:09 +0800
Subject: [PATCH 041/181] Fix the issue that "There may be no complete callback
 when download the picture of the local path"

---
 SDWebImage/Core/SDWebImageDownloader.m | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index 5b931ea2..94bfa049 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -226,10 +226,11 @@ static void * SDWebImageDownloaderContext = &SDWebImageDownloaderContext;
             SD_UNLOCK(self.operationsLock);
         };
         self.URLOperations[url] = operation;
+        // Add the handlers before submitting to operation queue, avoid the race condition that operation finished before setting handlers.
+        downloadOperationCancelToken = [operation addHandlersForProgress:progressBlock completed:completedBlock];
         // Add operation to operation queue only after all configuration done according to Apple's doc.
         // `addOperation:` does not synchronously execute the `operation.completionBlock` so this will not cause deadlock.
         [self.downloadQueue addOperation:operation];
-        downloadOperationCancelToken = [operation addHandlersForProgress:progressBlock completed:completedBlock];
     } else {
         // When we reuse the download operation to attach more callbacks, there may be thread safe issue because the getter of callbacks may in another queue (decoding queue or delegate queue)
         // So we lock the operation here, and in `SDWebImageDownloaderOperation`, we use `@synchonzied (self)`, to ensure the thread safe between these two classes.

From d44a5a331e65489e6306eb45f98c542138b1657f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 13 Dec 2019 17:26:20 +0800
Subject: [PATCH 042/181] update the Readme with PDF/SVG/Link plugin repos from
 SDWebImage organization

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 6199e699..f18658fb 100644
--- a/README.md
+++ b/README.md
@@ -56,10 +56,13 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageBPGCoder](https://github.com/SDWebImage/SDWebImageBPGCoder) - coder for BPG format
 - [SDWebImageFLIFCoder](https://github.com/SDWebImage/SDWebImageFLIFCoder) - coder for FLIF format
 - [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder) - coder for AVIF (AV1-based) format
+- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format image
+- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format image
 - and more from community!
 
 #### Loaders
 - [SDWebImagePhotosPlugin](https://github.com/SDWebImage/SDWebImagePhotosPlugin) - plugin to support loading images from Photos (using `Photos.framework`) 
+- [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
 #### Integration with 3rd party libraries
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs

From 0b3079d66b6f486376c9ce40f7f146b930d979df Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 16 Dec 2019 12:44:52 +0800
Subject: [PATCH 043/181] Fix the test case compile warning of
 `SDWebImageTestDiskCache`

---
 Tests/Tests/SDWebImageTestCache.m | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Tests/Tests/SDWebImageTestCache.m b/Tests/Tests/SDWebImageTestCache.m
index 7ef29cf7..68b2a154 100644
--- a/Tests/Tests/SDWebImageTestCache.m
+++ b/Tests/Tests/SDWebImageTestCache.m
@@ -9,6 +9,9 @@
 
 #import "SDWebImageTestCache.h"
 #import <SDWebImage/SDImageCacheConfig.h>
+#import "SDFileAttributeHelper.h"
+
+static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hackemist.SDWebImageTestDiskCache";
 
 @implementation SDWebImageTestMemoryCache
 
@@ -104,4 +107,18 @@
     return size;
 }
 
+- (nullable NSData *)extendedDataForKey:(nonnull NSString *)key {
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    return [SDFileAttributeHelper extendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+}
+
+- (void)setExtendedData:(nullable NSData *)extendedData forKey:(nonnull NSString *)key {
+    NSString *cachePathForKey = [self cachePathForKey:key];
+    if (!extendedData) {
+        [SDFileAttributeHelper removeExtendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName atPath:cachePathForKey traverseLink:NO error:nil];
+    } else {
+        [SDFileAttributeHelper setExtendedAttribute:SDWebImageTestDiskCacheExtendedAttributeName value:extendedData atPath:cachePathForKey traverseLink:NO overwrite:YES error:nil];
+    }
+}
+
 @end

From 247f74a5d191e9c6bd601d292c99cf9fe1658930 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 27 Dec 2019 15:05:43 +0800
Subject: [PATCH 044/181] Bumped version to 5.4.1

Update the CHANGELOG
---
 CHANGELOG.md        | 6 ++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ed842941..04c166c2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.4.1 - 5.4 Patch, on Dec 27th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.1)
+See [all tickets marked for the 5.4.1 release](https://github.com/SDWebImage/SDWebImage/milestone/56)
+
+### Fixes
+- Fix the issue that "There may be no complete callback when download the picture of the local path" #2917
+
 ## [5.4.0 Extended Cache Metadata, on Dec 6th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.0)
 See [all tickets marked for the 5.4.0 release](https://github.com/SDWebImage/SDWebImage/milestone/51)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 6e7c4229..1db2f2cf 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.4.0'
+  s.version = '5.4.1'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 7c51b93f..beb1d1ec 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.4.0</string>
+	<string>5.4.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.4.0</string>
+	<string>5.4.1</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 48fe948b8fdc3e8771f946a5f3e5d5cd616449e1 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 14:50:54 +0800
Subject: [PATCH 045/181] Fix the bug that watchOS sd_rotatedImageWithAngle
 does not works

---
 SDWebImage/Core/UIImage+Transform.m | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 54d3cef9..4565c2de 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -270,7 +270,7 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
         CGContextSetAllowsAntialiasing(context, true);
         CGContextSetInterpolationQuality(context, kCGInterpolationHigh);
         CGContextTranslateCTM(context, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
-#if SD_UIKIT
+#if SD_UIKIT || SD_WATCH
         // Use UIKit coordinate system counterclockwise (⟲)
         CGContextRotateCTM(context, -angle);
 #else

From cb7c4d59909ebb0a8e8d05a13d13d67450d195a5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 11:45:36 +0800
Subject: [PATCH 046/181] Add the compatible method for CIImage on macOS

---
 SDWebImage/Core/NSImage+Compatibility.h | 14 +++++++++++
 SDWebImage/Core/NSImage+Compatibility.m | 31 +++++++++++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/SDWebImage/Core/NSImage+Compatibility.h b/SDWebImage/Core/NSImage+Compatibility.h
index dccc1ffa..0a562cc4 100644
--- a/SDWebImage/Core/NSImage+Compatibility.h
+++ b/SDWebImage/Core/NSImage+Compatibility.h
@@ -19,6 +19,10 @@
 The underlying Core Graphics image object. This will actually use `CGImageForProposedRect` with the image size.
  */
 @property (nonatomic, readonly, nullable) CGImageRef CGImage;
+/**
+ The underlying Core Image data. This will actually use `bestRepresentationForRect` with the image size to find the `NSCIImageRep`.
+ */
+@property (nonatomic, readonly, nullable) CIImage *CIImage;
 /**
  The scale factor of the image. This wil actually use `bestRepresentationForRect` with image size and pixel size to calculate the scale factor. If failed, use the default value 1.0. Should be greater than or equal to 1.0.
  */
@@ -38,6 +42,16 @@ The underlying Core Graphics image object. This will actually use `CGImageForPro
  */
 - (nonnull instancetype)initWithCGImage:(nonnull CGImageRef)cgImage scale:(CGFloat)scale orientation:(CGImagePropertyOrientation)orientation;
 
+/**
+ Initializes and returns an image object with the specified Core Image object. The representation is `NSCIImageRep`.
+ 
+ @param ciImage A Core Image image object
+ @param scale The image scale factor
+ @param orientation The orientation of the image data
+ @return The image object
+ */
+- (nonnull instancetype)initWithCIImage:(nonnull CIImage *)ciImage scale:(CGFloat)scale orientation:(CGImagePropertyOrientation)orientation;
+
 /**
  Returns an image object with the scale factor. The representation is created from the image data.
  @note The difference between these this and `initWithData:` is that `initWithData:` will always use `backingScaleFactor` as scale factor.
diff --git a/SDWebImage/Core/NSImage+Compatibility.m b/SDWebImage/Core/NSImage+Compatibility.m
index 83b80bc6..7de0c703 100644
--- a/SDWebImage/Core/NSImage+Compatibility.m
+++ b/SDWebImage/Core/NSImage+Compatibility.m
@@ -20,6 +20,15 @@
     return cgImage;
 }
 
+- (nullable CIImage *)CIImage {
+    NSRect imageRect = NSMakeRect(0, 0, self.size.width, self.size.height);
+    NSImageRep *imageRep = [self bestRepresentationForRect:imageRect context:nil hints:nil];
+    if (![imageRep isKindOfClass:NSCIImageRep.class]) {
+        return nil;
+    }
+    return ((NSCIImageRep *)imageRep).CIImage;
+}
+
 - (CGFloat)scale {
     CGFloat scale = 1;
     NSRect imageRect = NSMakeRect(0, 0, self.size.width, self.size.height);
@@ -65,6 +74,28 @@
     return self;
 }
 
+- (instancetype)initWithCIImage:(nonnull CIImage *)ciImage scale:(CGFloat)scale orientation:(CGImagePropertyOrientation)orientation {
+    NSCIImageRep *imageRep;
+    if (orientation != kCGImagePropertyOrientationUp) {
+        CIImage *rotatedCIImage = [ciImage imageByApplyingOrientation:orientation];
+        imageRep = [[NSCIImageRep alloc] initWithCIImage:rotatedCIImage];
+    } else {
+        imageRep = [[NSCIImageRep alloc] initWithCIImage:ciImage];
+    }
+    if (scale < 1) {
+        scale = 1;
+    }
+    CGFloat pixelWidth = imageRep.pixelsWide;
+    CGFloat pixelHeight = imageRep.pixelsHigh;
+    NSSize size = NSMakeSize(pixelWidth / scale, pixelHeight / scale);
+    self = [self initWithSize:size];
+    if (self) {
+        imageRep.size = size;
+        [self addRepresentation:imageRep];
+    }
+    return self;
+}
+
 - (instancetype)initWithData:(nonnull NSData *)data scale:(CGFloat)scale {
     NSBitmapImageRep *imageRep = [[NSBitmapImageRep alloc] initWithData:data];
     if (!imageRep) {

From 4425c823ad4f285a2b7f581702f0ae8785b52bb7 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 14:55:45 +0800
Subject: [PATCH 047/181] Add CIImage support on transform methods

---
 SDWebImage/Core/UIImage+Transform.m | 56 ++++++++++++++++++++++++++---
 1 file changed, 51 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 4565c2de..1e776778 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -194,13 +194,30 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable UIImage *)sd_croppedImageWithRect:(CGRect)rect {
-    if (!self.CGImage) return nil;
     rect.origin.x *= self.scale;
     rect.origin.y *= self.scale;
     rect.size.width *= self.scale;
     rect.size.height *= self.scale;
     if (rect.size.width <= 0 || rect.size.height <= 0) return nil;
-    CGImageRef imageRef = CGImageCreateWithImageInRect(self.CGImage, rect);
+    
+# SD_UIKIT || SD_MAC
+    if (self.CIImage) {
+        CIImage *ciImage = [self.CIImage imageByCroppingToRect:rect];
+#if SD_UIKIT
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+#endif
+    
+    CGImageRef cgImage = self.CGImage;
+    if (!cgImage) {
+        return nil;
+    }
+    
+    CGImageRef imageRef = CGImageCreateWithImageInRect(cgImage, rect);
     if (!imageRef) {
         return nil;
     }
@@ -214,7 +231,6 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable UIImage *)sd_roundedCornerImageWithRadius:(CGFloat)cornerRadius corners:(SDRectCorner)corners borderWidth:(CGFloat)borderWidth borderColor:(nullable UIColor *)borderColor {
-    if (!self.CGImage) return nil;
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = self.scale;
     SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:self.size format:format];
@@ -256,12 +272,23 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable UIImage *)sd_rotatedImageWithAngle:(CGFloat)angle fitSize:(BOOL)fitSize {
-    if (!self.CGImage) return nil;
     size_t width = self.size.width;
     size_t height = self.size.height;
     CGRect newRect = CGRectApplyAffineTransform(CGRectMake(0, 0, width, height),
                                                 fitSize ? CGAffineTransformMakeRotation(angle) : CGAffineTransformIdentity);
     
+    if (self.CIImage) {
+        CGAffineTransform transform = CGAffineTransformMakeRotation(angle);
+        transform = CGAffineTransformTranslate(transform, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
+        CIImage *ciImage = [self.CIImage imageByApplyingTransform:transform];
+#if SD_UIKIT || SD_WATCH
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+    
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = self.scale;
     SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:newRect.size format:format];
@@ -283,10 +310,29 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable UIImage *)sd_flippedImageWithHorizontal:(BOOL)horizontal vertical:(BOOL)vertical {
-    if (!self.CGImage) return nil;
     size_t width = self.size.width;
     size_t height = self.size.height;
     
+    if (self.CIImage) {
+        CGAffineTransform transform = CGAffineTransformIdentity;
+        // Use UIKit coordinate system
+        if (horizontal) {
+            CGAffineTransform flipHorizontal = CGAffineTransformMake(-1, 0, 0, 1, width, 0);
+            transform = CGAffineTransformConcat(transform, flipHorizontal);
+        }
+        if (vertical) {
+            CGAffineTransform flipVertical = CGAffineTransformMake(1, 0, 0, -1, 0, height);
+            transform = CGAffineTransformConcat(transform, flipVertical);
+        }
+        CIImage *ciImage = [self.CIImage imageByApplyingTransform:transform];
+#if SD_UIKIT || SD_WATCH
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+    
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = self.scale;
     SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:self.size format:format];

From ac19d18d3c311d8bc9d111b85c356abdfd4a4975 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 15:37:43 +0800
Subject: [PATCH 048/181] Fix compile issue on watchOS, add
 `sd_tintedImageWithColor` support for CIImage

---
 SDWebImage/Core/UIImage+Transform.m | 61 +++++++++++++++++++++--------
 1 file changed, 44 insertions(+), 17 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 1e776778..ca4c83d7 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -200,7 +200,8 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     rect.size.height *= self.scale;
     if (rect.size.width <= 0 || rect.size.height <= 0) return nil;
     
-# SD_UIKIT || SD_MAC
+#if SD_UIKIT || SD_MAC
+    // CIImage shortcut
     if (self.CIImage) {
         CIImage *ciImage = [self.CIImage imageByCroppingToRect:rect];
 #if SD_UIKIT
@@ -212,21 +213,21 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     }
 #endif
     
-    CGImageRef cgImage = self.CGImage;
-    if (!cgImage) {
-        return nil;
-    }
-    
-    CGImageRef imageRef = CGImageCreateWithImageInRect(cgImage, rect);
+    CGImageRef imageRef = self.CGImage;
     if (!imageRef) {
         return nil;
     }
+    
+    CGImageRef croppedImageRef = CGImageCreateWithImageInRect(imageRef, rect);
+    if (!croppedImageRef) {
+        return nil;
+    }
 #if SD_UIKIT || SD_WATCH
-    UIImage *image = [UIImage imageWithCGImage:imageRef scale:self.scale orientation:self.imageOrientation];
+    UIImage *image = [UIImage imageWithCGImage:croppedImageRef scale:self.scale orientation:self.imageOrientation];
 #else
-    UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
+    UIImage *image = [[UIImage alloc] initWithCGImage:croppedImageRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
 #endif
-    CGImageRelease(imageRef);
+    CGImageRelease(croppedImageRef);
     return image;
 }
 
@@ -276,7 +277,9 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     size_t height = self.size.height;
     CGRect newRect = CGRectApplyAffineTransform(CGRectMake(0, 0, width, height),
                                                 fitSize ? CGAffineTransformMakeRotation(angle) : CGAffineTransformIdentity);
-    
+
+#if SD_UIKIT || SD_MAC
+    // CIImage shortcut
     if (self.CIImage) {
         CGAffineTransform transform = CGAffineTransformMakeRotation(angle);
         transform = CGAffineTransformTranslate(transform, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
@@ -288,6 +291,7 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 #endif
         return image;
     }
+#endif
     
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = self.scale;
@@ -312,7 +316,9 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 - (nullable UIImage *)sd_flippedImageWithHorizontal:(BOOL)horizontal vertical:(BOOL)vertical {
     size_t width = self.size.width;
     size_t height = self.size.height;
-    
+
+#if SD_UIKIT || SD_MAC
+    // CIImage shortcut
     if (self.CIImage) {
         CGAffineTransform transform = CGAffineTransformIdentity;
         // Use UIKit coordinate system
@@ -325,13 +331,14 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
             transform = CGAffineTransformConcat(transform, flipVertical);
         }
         CIImage *ciImage = [self.CIImage imageByApplyingTransform:transform];
-#if SD_UIKIT || SD_WATCH
+#if SD_UIKIT
         UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
 #else
         UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
 #endif
         return image;
     }
+#endif
     
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = self.scale;
@@ -354,15 +361,35 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 #pragma mark - Image Blending
 
 - (nullable UIImage *)sd_tintedImageWithColor:(nonnull UIColor *)tintColor {
-    if (!self.CGImage) return nil;
-    if (!tintColor.CGColor) return nil;
+#if SD_UIKIT || SD_MAC
+    // CIImage shortcut
+    if (self.CIImage) {
+        CIImage *colorImage = [CIImage imageWithColor:tintColor.CIColor];
+        CIFilter *filter = [CIFilter filterWithName:@"CISourceAtopCompositing"];
+        [filter setValue:colorImage forKey:kCIInputImageKey];
+        [filter setValue:self.CIImage forKey:kCIInputBackgroundImageKey];
+        CIImage *ciImage = filter.outputImage;
+//        CIImage *ciImage = [self.CIImage imageByCompositingOverImage:colorImage];
+#if SD_UIKIT
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+#endif
+    
+    CGImageRef imageRef = self.CGImage;
+    if (!imageRef) {
+        return nil;
+    }
     
     BOOL hasTint = CGColorGetAlpha(tintColor.CGColor) > __FLT_EPSILON__;
     if (!hasTint) {
 #if SD_UIKIT || SD_WATCH
-        return [UIImage imageWithCGImage:self.CGImage scale:self.scale orientation:self.imageOrientation];
+        return [UIImage imageWithCGImage:imageRef scale:self.scale orientation:self.imageOrientation];
 #else
-        return [[UIImage alloc] initWithCGImage:self.CGImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+        return [[UIImage alloc] initWithCGImage:imageRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
 #endif
     }
     

From eda7422c82985c4997ca6504a288c02cf4170074 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 21:38:56 +0800
Subject: [PATCH 049/181] Fix the issue of sd_croppedImageWithRect (UIKit) and
 sd_rotatedImageWithAngle for CIImage

---
 SDWebImage/Core/UIImage+Transform.m   | 111 +++++++++++++++-----------
 Tests/Tests/SDImageTransformerTests.m |   3 +-
 2 files changed, 66 insertions(+), 48 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index ca4c83d7..93e86356 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -203,7 +203,8 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 #if SD_UIKIT || SD_MAC
     // CIImage shortcut
     if (self.CIImage) {
-        CIImage *ciImage = [self.CIImage imageByCroppingToRect:rect];
+        CGRect croppingRect = CGRectMake(rect.origin.x, self.size.height - CGRectGetMaxY(rect), rect.size.width, rect.size.height);
+        CIImage *ciImage = [self.CIImage imageByCroppingToRect:croppingRect];
 #if SD_UIKIT
         UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
 #else
@@ -281,9 +282,16 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 #if SD_UIKIT || SD_MAC
     // CIImage shortcut
     if (self.CIImage) {
-        CGAffineTransform transform = CGAffineTransformMakeRotation(angle);
-        transform = CGAffineTransformTranslate(transform, +(newRect.size.width * 0.5), +(newRect.size.height * 0.5));
-        CIImage *ciImage = [self.CIImage imageByApplyingTransform:transform];
+        CIImage *ciImage = self.CIImage;
+        if (fitSize) {
+            CGAffineTransform transform = CGAffineTransformMakeRotation(angle);
+            ciImage = [ciImage imageByApplyingTransform:transform];
+        } else {
+            CIFilter *filter = [CIFilter filterWithName:@"CIStraightenFilter"];
+            [filter setValue:ciImage forKey:kCIInputImageKey];
+            [filter setValue:@(angle) forKey:kCIInputAngleKey];
+            ciImage = filter.outputImage;
+        }
 #if SD_UIKIT || SD_WATCH
         UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
 #else
@@ -361,36 +369,9 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 #pragma mark - Image Blending
 
 - (nullable UIImage *)sd_tintedImageWithColor:(nonnull UIColor *)tintColor {
-#if SD_UIKIT || SD_MAC
-    // CIImage shortcut
-    if (self.CIImage) {
-        CIImage *colorImage = [CIImage imageWithColor:tintColor.CIColor];
-        CIFilter *filter = [CIFilter filterWithName:@"CISourceAtopCompositing"];
-        [filter setValue:colorImage forKey:kCIInputImageKey];
-        [filter setValue:self.CIImage forKey:kCIInputBackgroundImageKey];
-        CIImage *ciImage = filter.outputImage;
-//        CIImage *ciImage = [self.CIImage imageByCompositingOverImage:colorImage];
-#if SD_UIKIT
-        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
-#else
-        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
-#endif
-        return image;
-    }
-#endif
-    
-    CGImageRef imageRef = self.CGImage;
-    if (!imageRef) {
-        return nil;
-    }
-    
     BOOL hasTint = CGColorGetAlpha(tintColor.CGColor) > __FLT_EPSILON__;
     if (!hasTint) {
-#if SD_UIKIT || SD_WATCH
-        return [UIImage imageWithCGImage:imageRef scale:self.scale orientation:self.imageOrientation];
-#else
-        return [[UIImage alloc] initWithCGImage:imageRef scale:self.scale orientation:kCGImagePropertyOrientationUp];
-#endif
+        return self;
     }
     
     CGSize size = self.size;
@@ -398,7 +379,7 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     CGFloat scale = self.scale;
     
     // blend mode, see https://en.wikipedia.org/wiki/Alpha_compositing
-    CGBlendMode blendMode = kCGBlendModeSourceAtop;
+    CGBlendMode blendMode = kCGBlendModeNormal;
     
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = scale;
@@ -413,10 +394,19 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable UIColor *)sd_colorAtPoint:(CGPoint)point {
-    if (!self) {
-        return nil;
+    CGImageRef imageRef;
+    // CIImage compatible
+    if (self.CIImage) {
+        CIImage *ciImage = self.CIImage;
+        imageRef = ciImage.CGImage;
+        if (!imageRef) {
+            CIContext *context = [CIContext context];
+            imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
+        }
+    } else {
+        imageRef = self.CGImage;
     }
-    CGImageRef imageRef = self.CGImage;
+    
     if (!imageRef) {
         return nil;
     }
@@ -457,10 +447,19 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 - (nullable NSArray<UIColor *> *)sd_colorsWithRect:(CGRect)rect {
-    if (!self) {
-        return nil;
+    CGImageRef imageRef;
+    // CIImage shortcut
+    if (self.CIImage) {
+        CIImage *ciImage = self.CIImage;
+        imageRef = ciImage.CGImage;
+        if (!imageRef) {
+            CIContext *context = [CIContext context];
+            imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
+        }
+    } else {
+        imageRef = self.CGImage;
     }
-    CGImageRef imageRef = self.CGImage;
+    
     if (!imageRef) {
         return nil;
     }
@@ -524,15 +523,26 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     if (self.size.width < 1 || self.size.height < 1) {
         return nil;
     }
-    if (!self.CGImage) {
-        return nil;
-    }
-    
     BOOL hasBlur = blurRadius > __FLT_EPSILON__;
     if (!hasBlur) {
         return self;
     }
     
+#if SD_UIKIT || SD_MAC
+    if (self.CIImage) {
+        CIFilter *filter = [CIFilter filterWithName:@"CIGaussianBlur"];
+        [filter setValue:self.CIImage forKey:kCIInputImageKey];
+        [filter setValue:@(blurRadius) forKey:kCIInputRadiusKey];
+        CIImage *ciImage = filter.outputImage;
+#if SD_UIKIT
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+#endif
+    
     CGFloat scale = self.scale;
     CGImageRef imageRef = self.CGImage;
     
@@ -615,12 +625,19 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 #if SD_UIKIT || SD_MAC
 - (nullable UIImage *)sd_filteredImageWithFilter:(nonnull CIFilter *)filter {
-    if (!self.CGImage) return nil;
-    
-    CIContext *context = [CIContext context];
-    CIImage *inputImage = [CIImage imageWithCGImage:self.CGImage];
+    CIImage *inputImage;
+    if (self.CIImage) {
+        inputImage = self.CIImage;
+    } else {
+        CGImageRef imageRef = self.CGImage;
+        if (!imageRef) {
+            return nil;
+        }
+        inputImage = [CIImage imageWithCGImage:imageRef];
+    }
     if (!inputImage) return nil;
     
+    CIContext *context = [CIContext context];
     [filter setValue:inputImage forKey:kCIInputImageKey];
     CIImage *outputImage = filter.outputImage;
     if (!outputImage) return nil;
diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index 6ddcfc14..13d394f6 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -74,7 +74,8 @@
     // Fit size, may change size
     rotatedImage = [self.testImage sd_rotatedImageWithAngle:angle fitSize:YES];
     CGSize rotatedSize = CGSizeMake(ceil(300 * 1.414), ceil(300 * 1.414)); // 45º, square length * sqrt(2)
-    expect(CGSizeEqualToSize(rotatedImage.size, rotatedSize)).beTruthy();
+    expect(rotatedImage.size.width - rotatedSize.width <= 1).beTruthy();
+    expect(rotatedImage.size.height - rotatedSize.height <= 1).beTruthy();
     // Check image not inversion
     UIColor *leftCenterColor = [rotatedImage sd_colorAtPoint:CGPointMake(60, 175)];
     expect([leftCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();

From a67ea9d371aa208fbd06e220f83ebcf0e2d5eb7a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 29 Dec 2019 21:53:30 +0800
Subject: [PATCH 050/181] Fix the regression of sd_tintedImageWithColor with
 `CISourceAtopCompositing` filter

---
 SDWebImage/Core/UIImage+Transform.m | 43 ++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 93e86356..fa3841e2 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -164,6 +164,28 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     return [UIColor colorWithRed:r green:g blue:b alpha:a];
 }
 
+static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
+    CGFloat red, green, blue, alpha;
+#if SD_UIKIT
+    if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+        [color getWhite:&red alpha:&alpha];
+        green = red;
+        blue = red;
+    }
+#else
+    @try {
+        [color getRed:&red green:&green blue:&blue alpha:&alpha];
+    }
+    @catch (NSException *exception) {
+        [color getWhite:&red alpha:&alpha];
+        green = red;
+        blue = red;
+    }
+#endif
+    CIColor *ciColor = [CIColor colorWithRed:red green:green blue:blue alpha:alpha];
+    return ciColor;
+}
+
 @implementation UIImage (Transform)
 
 - (void)sd_drawInRect:(CGRect)rect context:(CGContextRef)context scaleMode:(SDImageScaleMode)scaleMode clipsToBounds:(BOOL)clips {
@@ -374,12 +396,31 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
         return self;
     }
     
+#if SD_UIKIT || SD_MAC
+    // CIImage shortcut
+    if (self.CIImage) {
+        CIImage *ciImage = self.CIImage;
+        CIImage *colorImage = [CIImage imageWithColor:SDCIColorConvertFromUIColor(tintColor)];
+        colorImage = [colorImage imageByCroppingToRect:ciImage.extent];
+        CIFilter *filter = [CIFilter filterWithName:@"CISourceAtopCompositing"];
+        [filter setValue:colorImage forKey:kCIInputImageKey];
+        [filter setValue:ciImage forKey:kCIInputBackgroundImageKey];
+        ciImage = filter.outputImage;
+#if SD_UIKIT
+        UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
+#else
+        UIImage *image = [[UIImage alloc] initWithCIImage:ciImage scale:self.scale orientation:kCGImagePropertyOrientationUp];
+#endif
+        return image;
+    }
+#endif
+    
     CGSize size = self.size;
     CGRect rect = { CGPointZero, size };
     CGFloat scale = self.scale;
     
     // blend mode, see https://en.wikipedia.org/wiki/Alpha_compositing
-    CGBlendMode blendMode = kCGBlendModeNormal;
+    CGBlendMode blendMode = kCGBlendModeSourceAtop;
     
     SDGraphicsImageRendererFormat *format = [[SDGraphicsImageRendererFormat alloc] init];
     format.scale = scale;

From 0c152231116e9d9aefb558ab82dc66eae8923eb6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 30 Dec 2019 17:17:16 +0800
Subject: [PATCH 051/181] Fix CIGaussianBlur cropping rect

---
 SDWebImage/Core/UIImage+Transform.m | 1 +
 1 file changed, 1 insertion(+)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index fa3841e2..7a321c1f 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -575,6 +575,7 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
         [filter setValue:self.CIImage forKey:kCIInputImageKey];
         [filter setValue:@(blurRadius) forKey:kCIInputRadiusKey];
         CIImage *ciImage = filter.outputImage;
+        ciImage = [ciImage imageByCroppingToRect:CGRectMake(0, 0, self.size.width, self.size.height)];
 #if SD_UIKIT
         UIImage *image = [UIImage imageWithCIImage:ciImage scale:self.scale orientation:self.imageOrientation];
 #else

From 40957da785f5e56357bdc34e85d2408ff7a4b224 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 30 Dec 2019 17:18:08 +0800
Subject: [PATCH 052/181] Fix `sd_blurredImageWithRadius` CGImage
 implementation bug that does not considerate bitmap other than BGRA

---
 SDWebImage/Core/UIImage+Transform.m | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 7a321c1f..a55eb130 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -588,6 +588,18 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
     CGFloat scale = self.scale;
     CGImageRef imageRef = self.CGImage;
     
+    //convert to BGRA if it isn't
+    if (CGImageGetBitsPerPixel(imageRef) != 32 ||
+        CGImageGetBitsPerComponent(imageRef) != 8 ||
+        !((CGImageGetBitmapInfo(imageRef) & kCGBitmapAlphaInfoMask))) {
+        SDGraphicsBeginImageContextWithOptions(self.size, NO, self.scale);
+        [self drawInRect:CGRectMake(0, 0, self.size.width, self.size.height)];
+        imageRef = SDGraphicsGetImageFromCurrentImageContext().CGImage;
+        SDGraphicsEndImageContext();
+    } else {
+        CGImageRetain(imageRef);
+    }
+    
     vImage_Buffer effect = {}, scratch = {};
     vImage_Buffer *input = NULL, *output = NULL;
     
@@ -602,7 +614,7 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
     };
     
     vImage_Error err;
-    err = vImageBuffer_InitWithCGImage(&effect, &format, NULL, imageRef, kvImagePrintDiagnosticsToConsole);
+    err = vImageBuffer_InitWithCGImage(&effect, &format, NULL, imageRef, kvImageNoFlags);
     if (err != kvImageNoError) {
         NSLog(@"UIImage+Transform error: vImageBuffer_InitWithCGImage returned error code %zi for inputImage: %@", err, self);
         return nil;

From 2163691d1130e2b3295c2a58138078294549674b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 30 Dec 2019 17:41:08 +0800
Subject: [PATCH 053/181] Fix the compile issue on watchOS

---
 SDWebImage/Core/UIImage+Transform.m | 51 +++++++++++++++++------------
 1 file changed, 30 insertions(+), 21 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index a55eb130..7ff7e98a 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -164,7 +164,9 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
     return [UIColor colorWithRed:r green:g blue:b alpha:a];
 }
 
-static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
+#if SD_UIKIT || SD_MAC
+// Core Image Support
+static inline CIColor *SDCIColorFromUIColor(UIColor * _Nonnull color) {
     CGFloat red, green, blue, alpha;
 #if SD_UIKIT
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
@@ -186,6 +188,19 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
     return ciColor;
 }
 
+static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciImage) {
+    CGImageRef imageRef = NULL;
+    if (@available(iOS 10, macOS 10.12, tvOS 10, *)) {
+        imageRef = ciImage.CGImage;
+    }
+    if (!imageRef) {
+        CIContext *context = [CIContext context];
+        imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
+    }
+    return imageRef;
+}
+#endif
+
 @implementation UIImage (Transform)
 
 - (void)sd_drawInRect:(CGRect)rect context:(CGContextRef)context scaleMode:(SDImageScaleMode)scaleMode clipsToBounds:(BOOL)clips {
@@ -400,7 +415,7 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
     // CIImage shortcut
     if (self.CIImage) {
         CIImage *ciImage = self.CIImage;
-        CIImage *colorImage = [CIImage imageWithColor:SDCIColorConvertFromUIColor(tintColor)];
+        CIImage *colorImage = [CIImage imageWithColor:SDCIColorFromUIColor(tintColor)];
         colorImage = [colorImage imageByCroppingToRect:ciImage.extent];
         CIFilter *filter = [CIFilter filterWithName:@"CISourceAtopCompositing"];
         [filter setValue:colorImage forKey:kCIInputImageKey];
@@ -435,19 +450,16 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
 }
 
 - (nullable UIColor *)sd_colorAtPoint:(CGPoint)point {
-    CGImageRef imageRef;
+    CGImageRef imageRef = NULL;
     // CIImage compatible
+#if SD_UIKIT || SD_MAC
     if (self.CIImage) {
-        CIImage *ciImage = self.CIImage;
-        imageRef = ciImage.CGImage;
-        if (!imageRef) {
-            CIContext *context = [CIContext context];
-            imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
-        }
-    } else {
+        imageRef = SDCGImageFromCIImage(self.CIImage);
+    }
+#endif
+    if (!imageRef) {
         imageRef = self.CGImage;
     }
-    
     if (!imageRef) {
         return nil;
     }
@@ -488,19 +500,16 @@ static inline CIColor *SDCIColorConvertFromUIColor(UIColor * _Nonnull color) {
 }
 
 - (nullable NSArray<UIColor *> *)sd_colorsWithRect:(CGRect)rect {
-    CGImageRef imageRef;
-    // CIImage shortcut
+    CGImageRef imageRef = NULL;
+    // CIImage compatible
+#if SD_UIKIT || SD_MAC
     if (self.CIImage) {
-        CIImage *ciImage = self.CIImage;
-        imageRef = ciImage.CGImage;
-        if (!imageRef) {
-            CIContext *context = [CIContext context];
-            imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
-        }
-    } else {
+        imageRef = SDCGImageFromCIImage(self.CIImage);
+    }
+#endif
+    if (!imageRef) {
         imageRef = self.CGImage;
     }
-    
     if (!imageRef) {
         return nil;
     }

From 3006ff299e32f73193f5c79c9c5c9008a839e4ee Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 30 Dec 2019 22:41:00 +0800
Subject: [PATCH 054/181] Fix the leak of CGImageRef from UIImage (getter only)

---
 SDWebImage/Core/UIImage+Transform.m | 2 --
 1 file changed, 2 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 7ff7e98a..125d886e 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -605,8 +605,6 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
         [self drawInRect:CGRectMake(0, 0, self.size.width, self.size.height)];
         imageRef = SDGraphicsGetImageFromCurrentImageContext().CGImage;
         SDGraphicsEndImageContext();
-    } else {
-        CGImageRetain(imageRef);
     }
     
     vImage_Buffer effect = {}, scratch = {};

From 1afadafc7887f01ce76203cc7b458ddec2f71416 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Jan 2020 11:58:12 +0800
Subject: [PATCH 055/181] Update all transformer test cases to support Core
 Image

---
 Tests/Tests/SDImageTransformerTests.m | 137 ++++++++++++++++++++------
 1 file changed, 108 insertions(+), 29 deletions(-)

diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index 13d394f6..e7a44f5c 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -13,7 +13,8 @@
 
 @interface SDImageTransformerTests : SDTestCase
 
-@property (nonatomic, strong) UIImage *testImage;
+@property (nonatomic, strong) UIImage *testImageCG;
+@property (nonatomic, strong) UIImage *testImageCI;
 
 @end
 
@@ -22,21 +23,37 @@
 #pragma mark - UIImage+Transform
 
 // UIImage+Transform test is hard to write because it's more about visual effect. Current it's tied to the `TestImage.png`, please keep that image or write new test with new image
-- (void)test01UIImageTransformResize {
+- (void)test01UIImageTransformResizeCG {
+    [self test01UIImageTransformResizeWithImage:self.testImageCG];
+}
+
+- (void)test01UIImageTransformResizeCI {
+    [self test01UIImageTransformResizeWithImage:self.testImageCI];
+}
+
+- (void)test01UIImageTransformResizeWithImage:(UIImage *)testImage {
     CGSize scaleDownSize = CGSizeMake(200, 100);
-    UIImage *scaledDownImage = [self.testImage sd_resizedImageWithSize:scaleDownSize scaleMode:SDImageScaleModeFill];
+    UIImage *scaledDownImage = [testImage sd_resizedImageWithSize:scaleDownSize scaleMode:SDImageScaleModeFill];
     expect(CGSizeEqualToSize(scaledDownImage.size, scaleDownSize)).beTruthy();
     CGSize scaleUpSize = CGSizeMake(2000, 1000);
-    UIImage *scaledUpImage = [self.testImage sd_resizedImageWithSize:scaleUpSize scaleMode:SDImageScaleModeAspectFit];
+    UIImage *scaledUpImage = [testImage sd_resizedImageWithSize:scaleUpSize scaleMode:SDImageScaleModeAspectFit];
     expect(CGSizeEqualToSize(scaledUpImage.size, scaleUpSize)).beTruthy();
     // Check image not inversion
     UIColor *topCenterColor = [scaledUpImage sd_colorAtPoint:CGPointMake(1000, 50)];
     expect([topCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test02UIImageTransformCrop {
+- (void)test02UIImageTransformCropCG {
+    [self test02UIImageTransformCropWithImage:self.testImageCG];
+}
+
+- (void)test02UIImageTransformCropCI {
+    [self test02UIImageTransformCropWithImage:self.testImageCI];
+}
+
+- (void)test02UIImageTransformCropWithImage:(UIImage *)testImage {
     CGRect rect = CGRectMake(50, 10, 200, 200);
-    UIImage *croppedImage = [self.testImage sd_croppedImageWithRect:rect];
+    UIImage *croppedImage = [testImage sd_croppedImageWithRect:rect];
     expect(CGSizeEqualToSize(croppedImage.size, CGSizeMake(200, 200))).beTruthy();
     UIColor *startColor = [croppedImage sd_colorAtPoint:CGPointZero];
     expect([startColor.sd_hexString isEqualToString:[UIColor clearColor].sd_hexString]).beTruthy();
@@ -45,7 +62,15 @@
     expect([topCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test03UIImageTransformRoundedCorner {
+- (void)test03UIImageTransformRoundedCornerCG {
+    [self test03UIImageTransformRoundedCornerWithImage:self.testImageCG];
+}
+
+- (void)test03UIImageTransformRoundedCornerCI {
+    [self test03UIImageTransformRoundedCornerWithImage:self.testImageCI];
+}
+
+- (void)test03UIImageTransformRoundedCornerWithImage:(UIImage *)testImage {
     CGFloat radius = 50;
 #if SD_UIKIT
     SDRectCorner corners = UIRectCornerAllCorners;
@@ -54,7 +79,7 @@
 #endif
     CGFloat borderWidth = 1;
     UIColor *borderColor = [UIColor blackColor];
-    UIImage *roundedCornerImage = [self.testImage sd_roundedCornerImageWithRadius:radius corners:corners borderWidth:borderWidth borderColor:borderColor];
+    UIImage *roundedCornerImage = [testImage sd_roundedCornerImageWithRadius:radius corners:corners borderWidth:borderWidth borderColor:borderColor];
     expect(CGSizeEqualToSize(roundedCornerImage.size, CGSizeMake(300, 300))).beTruthy();
     UIColor *startColor = [roundedCornerImage sd_colorAtPoint:CGPointZero];
     expect([startColor.sd_hexString isEqualToString:[UIColor clearColor].sd_hexString]).beTruthy();
@@ -66,13 +91,21 @@
     expect([topCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test04UIImageTransformRotate {
+- (void)test04UIImageTransformRotateCG {
+    [self test04UIImageTransformRotateWithImage:self.testImageCG];
+}
+
+- (void)test04UIImageTransformRotateCI {
+    [self test04UIImageTransformRotateWithImage:self.testImageCI];
+}
+
+- (void)test04UIImageTransformRotateWithImage:(UIImage *)testImage {
     CGFloat angle = M_PI_4;
-    UIImage *rotatedImage = [self.testImage sd_rotatedImageWithAngle:angle fitSize:NO];
+    UIImage *rotatedImage = [testImage sd_rotatedImageWithAngle:angle fitSize:NO];
     // Not fit size and no change
-    expect(CGSizeEqualToSize(rotatedImage.size, self.testImage.size)).beTruthy();
+    expect(CGSizeEqualToSize(rotatedImage.size, testImage.size)).beTruthy();
     // Fit size, may change size
-    rotatedImage = [self.testImage sd_rotatedImageWithAngle:angle fitSize:YES];
+    rotatedImage = [testImage sd_rotatedImageWithAngle:angle fitSize:YES];
     CGSize rotatedSize = CGSizeMake(ceil(300 * 1.414), ceil(300 * 1.414)); // 45º, square length * sqrt(2)
     expect(rotatedImage.size.width - rotatedSize.width <= 1).beTruthy();
     expect(rotatedImage.size.height - rotatedSize.height <= 1).beTruthy();
@@ -81,11 +114,19 @@
     expect([leftCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test05UIImageTransformFlip {
+- (void)test05UIImageTransformFlipCG {
+    [self test05UIImageTransformFlipWithImage:self.testImageCG];
+}
+
+- (void)test05UIImageTransformFlipCI {
+    [self test05UIImageTransformFlipWithImage:self.testImageCI];
+}
+
+- (void)test05UIImageTransformFlipWithImage:(UIImage *)testImage {
     BOOL horizontal = YES;
     BOOL vertical = YES;
-    UIImage *flippedImage = [self.testImage sd_flippedImageWithHorizontal:horizontal vertical:vertical];
-    expect(CGSizeEqualToSize(flippedImage.size, self.testImage.size)).beTruthy();
+    UIImage *flippedImage = [testImage sd_flippedImageWithHorizontal:horizontal vertical:vertical];
+    expect(CGSizeEqualToSize(flippedImage.size, testImage.size)).beTruthy();
     // Test pixel colors method here
     UIColor *checkColor = [flippedImage sd_colorAtPoint:CGPointMake(75, 75)];
     expect(checkColor);
@@ -99,10 +140,18 @@
     expect([bottomCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test06UIImageTransformTint {
+- (void)test06UIImageTransformTintCG {
+    [self test06UIImageTransformTintWithImage:self.testImageCG];
+}
+
+- (void)test06UIImageTransformTintCI {
+    [self test06UIImageTransformTintWithImage:self.testImageCI];
+}
+
+- (void)test06UIImageTransformTintWithImage:(UIImage *)testImage {
     UIColor *tintColor = [UIColor blackColor];
-    UIImage *tintedImage = [self.testImage sd_tintedImageWithColor:tintColor];
-    expect(CGSizeEqualToSize(tintedImage.size, self.testImage.size)).beTruthy();
+    UIImage *tintedImage = [testImage sd_tintedImageWithColor:tintColor];
+    expect(CGSizeEqualToSize(tintedImage.size, testImage.size)).beTruthy();
     // Check center color, should keep clear
     UIColor *centerColor = [tintedImage sd_colorAtPoint:CGPointMake(150, 150)];
     expect([centerColor.sd_hexString isEqualToString:[UIColor clearColor].sd_hexString]);
@@ -114,10 +163,18 @@
     expect([topCenterColor.sd_hexString isEqualToString:[UIColor blackColor].sd_hexString]).beTruthy();
 }
 
-- (void)test07UIImageTransformBlur {
+- (void)test07UIImageTransformBlurCG {
+    [self test07UIImageTransformBlurWithImage:self.testImageCG];
+}
+
+- (void)test07UIImageTransformBlurCI {
+    [self test07UIImageTransformBlurWithImage:self.testImageCI];
+}
+
+- (void)test07UIImageTransformBlurWithImage:(UIImage *)testImage {
     CGFloat radius = 50;
-    UIImage *blurredImage = [self.testImage sd_blurredImageWithRadius:radius];
-    expect(CGSizeEqualToSize(blurredImage.size, self.testImage.size)).beTruthy();
+    UIImage *blurredImage = [testImage sd_blurredImageWithRadius:radius];
+    expect(CGSizeEqualToSize(blurredImage.size, testImage.size)).beTruthy();
     // Check left color, should be blurred
     UIColor *leftColor = [blurredImage sd_colorAtPoint:CGPointMake(80, 150)];
     // Hard-code from the output
@@ -128,11 +185,19 @@
     expect([topCenterColor.sd_hexString isEqualToString:@"#9a430d06"]).beTruthy();
 }
 
-- (void)test08UIImageTransformFilter {
+- (void)test08UIImageTransformFilterCG {
+    [self test08UIImageTransformFilterWithImage:self.testImageCG];
+}
+
+- (void)test08UIImageTransformFilterCI {
+    [self test08UIImageTransformFilterWithImage:self.testImageCI];
+}
+
+- (void)test08UIImageTransformFilterWithImage:(UIImage *)testImage {
     // Invert color filter
     CIFilter *filter = [CIFilter filterWithName:@"CIColorInvert"];
-    UIImage *filteredImage = [self.testImage sd_filteredImageWithFilter:filter];
-    expect(CGSizeEqualToSize(filteredImage.size, self.testImage.size)).beTruthy();
+    UIImage *filteredImage = [testImage sd_filteredImageWithFilter:filter];
+    expect(CGSizeEqualToSize(filteredImage.size, testImage.size)).beTruthy();
     // Check left color, should be inverted
     UIColor *leftColor = [filteredImage sd_colorAtPoint:CGPointMake(80, 150)];
     // Hard-code from the output
@@ -199,7 +264,7 @@
     NSString *transformerKey = [transformerKeys componentsJoinedByString:@"-"]; // SDImageTransformerKeySeparator
     expect([pipelineTransformer.transformerKey isEqualToString:transformerKey]).beTruthy();
     
-    UIImage *transformedImage = [pipelineTransformer transformedImageWithImage:self.testImage forKey:@"Test"];
+    UIImage *transformedImage = [pipelineTransformer transformedImageWithImage:self.testImageCG forKey:@"Test"];
     expect(transformedImage).notTo.beNil();
     expect(CGSizeEqualToSize(transformedImage.size, cropRect.size)).beTruthy();
 }
@@ -240,6 +305,8 @@
     expect(SDTransformedKeyForKey(key, transformerKey)).equal(@"ftp://root:password@foo.com/image-SDImageFlippingTransformer(1,0).png");
 }
 
+#pragma mark - Coder Helper
+
 - (void)test20CGImageCreateDecodedWithOrientation {
     // Test EXIF orientation tag, you can open this image with `Preview.app`, open inspector (Command+I) and rotate (Command+L/R) to check
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:[self testPNGPathForName:@"TestEXIF"]];
@@ -332,11 +399,23 @@
 
 #pragma mark - Helper
 
-- (UIImage *)testImage {
-    if (!_testImage) {
-        _testImage = [[UIImage alloc] initWithContentsOfFile:[self testPNGPathForName:@"TestImage"]];
+- (UIImage *)testImageCG {
+    if (!_testImageCG) {
+        _testImageCG = [[UIImage alloc] initWithContentsOfFile:[self testPNGPathForName:@"TestImage"]];
     }
-    return _testImage;
+    return _testImageCG;
+}
+
+- (UIImage *)testImageCI {
+    if (!_testImageCI) {
+        CIImage *ciImage = [[CIImage alloc] initWithContentsOfURL:[NSURL fileURLWithPath:[self testPNGPathForName:@"TestImage"]]];
+#if SD_UIKIT
+        _testImageCI = [[UIImage alloc] initWithCIImage:ciImage scale:1 orientation:UIImageOrientationUp];
+#else
+        _testImageCI = [[UIImage alloc] initWithCIImage:ciImage scale:1 orientation:kCGImagePropertyOrientationUp];
+#endif
+    }
+    return _testImageCI;
 }
 
 - (NSString *)testPNGPathForName:(NSString *)name {

From 86e3a164dc511a2a8089dfe25e4320fe1d90186b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Jan 2020 14:45:13 +0800
Subject: [PATCH 056/181] Fix the test case of blur radius calculation. CG and
 CI now match in visual

---
 SDWebImage/Core/UIImage+Transform.m   | 3 ++-
 Tests/Tests/SDImageTransformerTests.m | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 125d886e..b069526c 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -582,7 +582,8 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     if (self.CIImage) {
         CIFilter *filter = [CIFilter filterWithName:@"CIGaussianBlur"];
         [filter setValue:self.CIImage forKey:kCIInputImageKey];
-        [filter setValue:@(blurRadius) forKey:kCIInputRadiusKey];
+        // Blur Radius use pixel count
+        [filter setValue:@(blurRadius / 2) forKey:kCIInputRadiusKey];
         CIImage *ciImage = filter.outputImage;
         ciImage = [ciImage imageByCroppingToRect:CGRectMake(0, 0, self.size.width, self.size.height)];
 #if SD_UIKIT
diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index e7a44f5c..9bc28ea5 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -182,7 +182,8 @@
     expect([leftColor.sd_hexString isEqualToString:expectedColor.sd_hexString]);
     // Check rounded corner operation not inversion the image
     UIColor *topCenterColor = [blurredImage sd_colorAtPoint:CGPointMake(150, 20)];
-    expect([topCenterColor.sd_hexString isEqualToString:@"#9a430d06"]).beTruthy();
+    UIColor *bottomCenterColor = [blurredImage sd_colorAtPoint:CGPointMake(150, 280)];
+    expect([topCenterColor.sd_hexString isEqualToString:bottomCenterColor.sd_hexString]).beFalsy();
 }
 
 - (void)test08UIImageTransformFilterCG {

From b62f48724dfa371b86395e0c0664a80bae9efa03 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Jan 2020 17:52:17 +0800
Subject: [PATCH 057/181] Use CIColor method instead of custom implementation

---
 SDWebImage/Core/UIImage+Transform.m | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index b069526c..091566bb 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -166,28 +166,6 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 
 #if SD_UIKIT || SD_MAC
 // Core Image Support
-static inline CIColor *SDCIColorFromUIColor(UIColor * _Nonnull color) {
-    CGFloat red, green, blue, alpha;
-#if SD_UIKIT
-    if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
-        [color getWhite:&red alpha:&alpha];
-        green = red;
-        blue = red;
-    }
-#else
-    @try {
-        [color getRed:&red green:&green blue:&blue alpha:&alpha];
-    }
-    @catch (NSException *exception) {
-        [color getWhite:&red alpha:&alpha];
-        green = red;
-        blue = red;
-    }
-#endif
-    CIColor *ciColor = [CIColor colorWithRed:red green:green blue:blue alpha:alpha];
-    return ciColor;
-}
-
 static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciImage) {
     CGImageRef imageRef = NULL;
     if (@available(iOS 10, macOS 10.12, tvOS 10, *)) {
@@ -415,7 +393,7 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     // CIImage shortcut
     if (self.CIImage) {
         CIImage *ciImage = self.CIImage;
-        CIImage *colorImage = [CIImage imageWithColor:SDCIColorFromUIColor(tintColor)];
+        CIImage *colorImage = [CIImage imageWithColor:[[CIColor alloc] initWithColor:tintColor]];
         colorImage = [colorImage imageByCroppingToRect:ciImage.extent];
         CIFilter *filter = [CIFilter filterWithName:@"CISourceAtopCompositing"];
         [filter setValue:colorImage forKey:kCIInputImageKey];

From 375e94f31cd5f2de6bbcf28c121c32f515e18821 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Jan 2020 13:46:25 +0800
Subject: [PATCH 058/181] Fix the leak of CIImage based UIImage for
 `sd_colorAtPoint`

---
 SDWebImage/Core/UIImage+Transform.m | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 091566bb..53fc334c 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -165,8 +165,8 @@ static inline UIColor * SDGetColorFromPixel(Pixel_8888 pixel, CGBitmapInfo bitma
 }
 
 #if SD_UIKIT || SD_MAC
-// Core Image Support
-static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciImage) {
+// Create-Rule, caller should call CGImageRelease
+static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull ciImage) {
     CGImageRef imageRef = NULL;
     if (@available(iOS 10, macOS 10.12, tvOS 10, *)) {
         imageRef = ciImage.CGImage;
@@ -174,6 +174,8 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     if (!imageRef) {
         CIContext *context = [CIContext context];
         imageRef = [context createCGImage:ciImage fromRect:ciImage.extent];
+    } else {
+        CGImageRetain(imageRef);
     }
     return imageRef;
 }
@@ -432,11 +434,12 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     // CIImage compatible
 #if SD_UIKIT || SD_MAC
     if (self.CIImage) {
-        imageRef = SDCGImageFromCIImage(self.CIImage);
+        imageRef = SDCreateCGImageFromCIImage(self.CIImage);
     }
 #endif
     if (!imageRef) {
         imageRef = self.CGImage;
+        CGImageRetain(imageRef);
     }
     if (!imageRef) {
         return nil;
@@ -446,34 +449,38 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     CGFloat width = CGImageGetWidth(imageRef);
     CGFloat height = CGImageGetHeight(imageRef);
     if (point.x < 0 || point.y < 0 || point.x >= width || point.y >= height) {
+        CGImageRelease(imageRef);
         return nil;
     }
     
     // Get pixels
     CGDataProviderRef provider = CGImageGetDataProvider(imageRef);
     if (!provider) {
+        CGImageRelease(imageRef);
         return nil;
     }
     CFDataRef data = CGDataProviderCopyData(provider);
     if (!data) {
+        CGImageRelease(imageRef);
         return nil;
     }
     
     // Get pixel at point
     size_t bytesPerRow = CGImageGetBytesPerRow(imageRef);
     size_t components = CGImageGetBitsPerPixel(imageRef) / CGImageGetBitsPerComponent(imageRef);
+    CGBitmapInfo bitmapInfo = CGImageGetBitmapInfo(imageRef);
     
     CFRange range = CFRangeMake(bytesPerRow * point.y + components * point.x, 4);
     if (CFDataGetLength(data) < range.location + range.length) {
         CFRelease(data);
+        CGImageRelease(imageRef);
         return nil;
     }
     Pixel_8888 pixel = {0};
     CFDataGetBytes(data, range, pixel);
     CFRelease(data);
-    
+    CGImageRelease(imageRef);
     // Convert to color
-    CGBitmapInfo bitmapInfo = CGImageGetBitmapInfo(imageRef);
     return SDGetColorFromPixel(pixel, bitmapInfo);
 }
 
@@ -482,11 +489,12 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     // CIImage compatible
 #if SD_UIKIT || SD_MAC
     if (self.CIImage) {
-        imageRef = SDCGImageFromCIImage(self.CIImage);
+        imageRef = SDCreateCGImageFromCIImage(self.CIImage);
     }
 #endif
     if (!imageRef) {
         imageRef = self.CGImage;
+        CGImageRetain(imageRef);
     }
     if (!imageRef) {
         return nil;
@@ -496,16 +504,19 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     CGFloat width = CGImageGetWidth(imageRef);
     CGFloat height = CGImageGetHeight(imageRef);
     if (CGRectGetWidth(rect) <= 0 || CGRectGetHeight(rect) <= 0 || CGRectGetMinX(rect) < 0 || CGRectGetMinY(rect) < 0 || CGRectGetMaxX(rect) > width || CGRectGetMaxY(rect) > height) {
+        CGImageRelease(imageRef);
         return nil;
     }
     
     // Get pixels
     CGDataProviderRef provider = CGImageGetDataProvider(imageRef);
     if (!provider) {
+        CGImageRelease(imageRef);
         return nil;
     }
     CFDataRef data = CGDataProviderCopyData(provider);
     if (!data) {
+        CGImageRelease(imageRef);
         return nil;
     }
     
@@ -517,6 +528,7 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
     size_t end = bytesPerRow * (CGRectGetMaxY(rect) - 1) + components * CGRectGetMaxX(rect);
     if (CFDataGetLength(data) < (CFIndex)end) {
         CFRelease(data);
+        CGImageRelease(imageRef);
         return nil;
     }
     
@@ -540,6 +552,7 @@ static inline CGImageRef _Nullable SDCGImageFromCIImage(CIImage * _Nonnull ciIma
         [colors addObject:color];
     }
     CFRelease(data);
+    CGImageRelease(imageRef);
     
     return [colors copy];
 }

From f6d95e3fa02984181f8ceaae8a6b8041f07d1126 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 7 Jan 2020 12:15:17 +0800
Subject: [PATCH 059/181] SDAnimatedImage now only keep the animated coder when
 frame count >=1, else we wil lbehave like UIImage to save RAM usage

---
 SDWebImage/Core/SDAnimatedImage.h |  1 +
 SDWebImage/Core/SDAnimatedImage.m | 21 ++++++++++++++++-----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/SDAnimatedImage.h b/SDWebImage/Core/SDAnimatedImage.h
index feb118e6..569eb88f 100644
--- a/SDWebImage/Core/SDAnimatedImage.h
+++ b/SDWebImage/Core/SDAnimatedImage.h
@@ -72,6 +72,7 @@
 
 // This class override these methods from UIImage(NSImage), and it supports NSSecureCoding.
 // You should use these methods to create a new animated image. Use other methods just call super instead.
+// Pay attention, when the animated image frame count <= 1, all the `SDAnimatedImage` protocol methods will return nil or 0 value, you'd better check the frame count before usage and keep fallback.
 + (nullable instancetype)imageNamed:(nonnull NSString *)name; // Cache in memory, no Asset Catalog support
 #if __has_include(<UIKit/UITraitCollection.h>)
 + (nullable instancetype)imageNamed:(nonnull NSString *)name inBundle:(nullable NSBundle *)bundle compatibleWithTraitCollection:(nullable UITraitCollection *)traitCollection; // Cache in memory, no Asset Catalog support
diff --git a/SDWebImage/Core/SDAnimatedImage.m b/SDWebImage/Core/SDAnimatedImage.m
index ce86e331..422d6578 100644
--- a/SDWebImage/Core/SDAnimatedImage.m
+++ b/SDWebImage/Core/SDAnimatedImage.m
@@ -156,7 +156,10 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
     self = [super initWithCGImage:image.CGImage scale:MAX(scale, 1) orientation:image.imageOrientation];
 #endif
     if (self) {
-        _animatedCoder = animatedCoder;
+        // Only keep the animated coder if frame count > 1, save RAM usage for non-animated image format (APNG/WebP)
+        if (animatedCoder.animatedImageFrameCount > 1) {
+            _animatedCoder = animatedCoder;
+        }
         NSData *data = [animatedCoder animatedImageData];
         SDImageFormat format = [NSData sd_imageFormatForImageData:data];
         _animatedImageFormat = format;
@@ -166,6 +169,9 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
 
 #pragma mark - Preload
 - (void)preloadAllFrames {
+    if (!_animatedCoder) {
+        return;
+    }
     if (!self.isAllFramesLoaded) {
         NSMutableArray<SDImageFrame *> *frames = [NSMutableArray arrayWithCapacity:self.animatedImageFrameCount];
         for (size_t i = 0; i < self.animatedImageFrameCount; i++) {
@@ -180,6 +186,9 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
 }
 
 - (void)unloadAllFrames {
+    if (!_animatedCoder) {
+        return;
+    }
     if (self.isAllFramesLoaded) {
         self.loadedAnimatedImageFrames = nil;
         self.allFramesLoaded = NO;
@@ -190,11 +199,12 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
 - (instancetype)initWithCoder:(NSCoder *)aDecoder {
     self = [super initWithCoder:aDecoder];
     if (self) {
+        _animatedImageFormat = [aDecoder decodeIntegerForKey:NSStringFromSelector(@selector(animatedImageFormat))];
         NSData *animatedImageData = [aDecoder decodeObjectOfClass:[NSData class] forKey:NSStringFromSelector(@selector(animatedImageData))];
-        CGFloat scale = self.scale;
         if (!animatedImageData) {
             return self;
         }
+        CGFloat scale = self.scale;
         id<SDAnimatedImageCoder> animatedCoder = nil;
         for (id<SDImageCoder>coder in [SDImageCodersManager sharedManager].coders) {
             if ([coder conformsToProtocol:@protocol(SDAnimatedImageCoder)]) {
@@ -207,15 +217,16 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
         if (!animatedCoder) {
             return self;
         }
-        _animatedCoder = animatedCoder;
-        SDImageFormat format = [NSData sd_imageFormatForImageData:animatedImageData];
-        _animatedImageFormat = format;
+        if (animatedCoder.animatedImageFrameCount > 1) {
+            _animatedCoder = animatedCoder;
+        }
     }
     return self;
 }
 
 - (void)encodeWithCoder:(NSCoder *)aCoder {
     [super encodeWithCoder:aCoder];
+    [aCoder encodeInteger:self.animatedImageFormat forKey:NSStringFromSelector(@selector(animatedImageFormat))];
     NSData *animatedImageData = self.animatedImageData;
     if (animatedImageData) {
         [aCoder encodeObject:animatedImageData forKey:NSStringFromSelector(@selector(animatedImageData))];

From 5b3909308fdf6c06bd8bdf39389620c91b9abca5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 7 Jan 2020 21:45:24 +0800
Subject: [PATCH 060/181] Bumped version to 5.4.1

Update the CHANGELOG
---
 CHANGELOG.md        | 6 ++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 04c166c2..7f82b05c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.4.2 - 5.4 Patch, on Jan 7th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.4.2)
+See [all tickets marked for the 5.4.2 release](https://github.com/SDWebImage/SDWebImage/milestone/58)
+
+### Fixes
+- SDAnimatedImage now only keep the animated coder when frame count >=1 , else we will behave like UIImage to save RAM usage #2924
+
 ## [5.4.1 - 5.4 Patch, on Dec 27th, 2019](https://github.com/rs/SDWebImage/releases/tag/5.4.1)
 See [all tickets marked for the 5.4.1 release](https://github.com/SDWebImage/SDWebImage/milestone/56)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 1db2f2cf..446b443a 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.4.1'
+  s.version = '5.4.2'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index beb1d1ec..d243db93 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.4.1</string>
+	<string>5.4.2</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.4.1</string>
+	<string>5.4.2</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From e7d8341e8bf1e3041c03b22fd840df2055f8fad4 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 8 Jan 2020 18:58:21 +0800
Subject: [PATCH 061/181] Fix the documenrtation about the SDAnimatedImage's
 behavior for static image

---
 SDWebImage/Core/SDAnimatedImage.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDAnimatedImage.h b/SDWebImage/Core/SDAnimatedImage.h
index 569eb88f..a1e2fb19 100644
--- a/SDWebImage/Core/SDAnimatedImage.h
+++ b/SDWebImage/Core/SDAnimatedImage.h
@@ -72,7 +72,7 @@
 
 // This class override these methods from UIImage(NSImage), and it supports NSSecureCoding.
 // You should use these methods to create a new animated image. Use other methods just call super instead.
-// Pay attention, when the animated image frame count <= 1, all the `SDAnimatedImage` protocol methods will return nil or 0 value, you'd better check the frame count before usage and keep fallback.
+// Pay attention, when the animated image frame count <= 1, all the `SDAnimatedImageProvider` protocol methods will return nil or 0 value, you'd better check the frame count before usage and keep fallback.
 + (nullable instancetype)imageNamed:(nonnull NSString *)name; // Cache in memory, no Asset Catalog support
 #if __has_include(<UIKit/UITraitCollection.h>)
 + (nullable instancetype)imageNamed:(nonnull NSString *)name inBundle:(nullable NSBundle *)bundle compatibleWithTraitCollection:(nullable UITraitCollection *)traitCollection; // Cache in memory, no Asset Catalog support

From a244962926f9e6fea3bcf2f77519b0252d88ea82 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 20:20:50 +0800
Subject: [PATCH 062/181] Add the thumbnail decoding API for protocols, update
 the code for ImageIO coders

---
 SDWebImage/Core/SDImageCoder.h                | 15 ++++
 SDWebImage/Core/SDImageCoder.m                |  2 +
 SDWebImage/Core/SDImageIOAnimatedCoder.m      | 75 ++++++++++++++++---
 SDWebImage/Core/SDImageIOCoder.m              | 29 ++++++-
 .../Private/SDImageIOAnimatedCoderInternal.h  |  1 +
 5 files changed, 109 insertions(+), 13 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 3b2049e5..817ce825 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -27,6 +27,21 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeFirstFrame
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeScaleFactor;
 
+/**
+ A Boolean value indicating whether to keep the original aspect ratio when generating thumbnail images (or bitmap images from vector format).
+ Defaults to YES.
+ @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodePreserveAspectRatio;
+
+/**
+ A CGSize value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.generationRule`) the value size.
+ Defaults to CGSizeZero, which means no thumbnail generation at all.
+ @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeThumbnailPixelSize;
+
+
 // These options are for image encoding
 /**
  A Boolean value indicating whether to encode the first frame only for animated image during encoding. (NSNumber). If not provide, encode animated image if need.
diff --git a/SDWebImage/Core/SDImageCoder.m b/SDWebImage/Core/SDImageCoder.m
index c963376b..df5224ae 100644
--- a/SDWebImage/Core/SDImageCoder.m
+++ b/SDWebImage/Core/SDImageCoder.m
@@ -10,6 +10,8 @@
 
 SDImageCoderOption const SDImageCoderDecodeFirstFrameOnly = @"decodeFirstFrameOnly";
 SDImageCoderOption const SDImageCoderDecodeScaleFactor = @"decodeScaleFactor";
+SDImageCoderOption const SDImageCoderDecodePreserveAspectRatio = @"decodePreserveAspectRatio";
+SDImageCoderOption const SDImageCoderDecodeThumbnailPixelSize = @"decodeThumbnailPixelSize";
 
 SDImageCoderOption const SDImageCoderEncodeFirstFrameOnly = @"encodeFirstFrameOnly";
 SDImageCoderOption const SDImageCoderEncodeCompressionQuality = @"encodeCompressionQuality";
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index b554fceb..1b71b54e 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -145,6 +145,40 @@
     return frameDuration;
 }
 
++ (UIImage *)createFrameAtIndex:(NSUInteger)index source:(CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize {
+    // Parse the image properties
+    NSDictionary *properties = (__bridge_transfer NSDictionary *)CGImageSourceCopyPropertiesAtIndex(source, index, NULL);
+    NSUInteger pixelWidth = [properties[(__bridge NSString *)kCGImagePropertyPixelWidth] unsignedIntegerValue];
+    NSUInteger pixelHeight = [properties[(__bridge NSString *)kCGImagePropertyPixelHeight] unsignedIntegerValue];
+    CGImagePropertyOrientation exifOrientation = (CGImagePropertyOrientation)[properties[(__bridge NSString *)kCGImagePropertyOrientation] unsignedIntegerValue];
+    if (!exifOrientation) {
+        exifOrientation = kCGImagePropertyOrientationUp;
+    }
+    
+    CGImageRef imageRef;
+    if (CGSizeEqualToSize(thumbnailSize, CGSizeZero) || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
+        imageRef = CGImageSourceCreateImageAtIndex(source, index, NULL);
+    } else {
+        NSMutableDictionary *thumbnailOptions = [NSMutableDictionary dictionary];
+        thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
+        thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = preserveAspectRatio ? @(MAX(thumbnailSize.width, thumbnailSize.height)) : @(MIN(thumbnailSize.width, thumbnailSize.height));
+        thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
+        imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)thumbnailOptions);
+    }
+    if (!imageRef) {
+        return nil;
+    }
+    
+#if SD_UIKIT || SD_WATCH
+    UIImageOrientation imageOrientation = [SDImageCoderHelper imageOrientationFromEXIFOrientation:exifOrientation];
+    UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:scale orientation:imageOrientation];
+#else
+    UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:scale orientation:exifOrientation];
+#endif
+    CGImageRelease(imageRef);
+    return image;
+}
+
 #pragma mark - Decode
 - (BOOL)canDecodeFromData:(nullable NSData *)data {
     return ([NSData sd_imageFormatForImageData:data] == self.class.imageFormat);
@@ -160,14 +194,34 @@
         scale = MAX([scaleFactor doubleValue], 1);
     }
     
+    CGSize thumbnailSize = CGSizeZero;
+    NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
+    if (thumbnailSizeValue != nil) {
 #if SD_MAC
-    SDAnimatedImageRep *imageRep = [[SDAnimatedImageRep alloc] initWithData:data];
-    NSSize size = NSMakeSize(imageRep.pixelsWide / scale, imageRep.pixelsHigh / scale);
-    imageRep.size = size;
-    NSImage *animatedImage = [[NSImage alloc] initWithSize:size];
-    [animatedImage addRepresentation:imageRep];
-    return animatedImage;
+        thumbnailSize = thumbnailSizeValue.sizeValue;
 #else
+        thumbnailSize = thumbnailSizeValue.CGSizeValue;
+#endif
+    }
+    
+    BOOL preserveAspectRatio = NO;
+    NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
+    if (preserveAspectRatioValue != nil) {
+        preserveAspectRatio = preserveAspectRatioValue.boolValue;
+    }
+    
+#if SD_MAC
+    // If don't use thumbnail, prefers the built-in generation of frames (GIF/APNG)
+    // Which decode frames in time and reduce memory usage
+    if (CGSizeEqualToSize(thumbnailSize, CGSizeZero)) {
+        SDAnimatedImageRep *imageRep = [[SDAnimatedImageRep alloc] initWithData:data];
+        NSSize size = NSMakeSize(imageRep.pixelsWide / scale, imageRep.pixelsHigh / scale);
+        imageRep.size = size;
+        NSImage *animatedImage = [[NSImage alloc] initWithSize:size];
+        [animatedImage addRepresentation:imageRep];
+        return animatedImage;
+    }
+#endif
     
     CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL);
     if (!source) {
@@ -178,19 +232,17 @@
     
     BOOL decodeFirstFrame = [options[SDImageCoderDecodeFirstFrameOnly] boolValue];
     if (decodeFirstFrame || count <= 1) {
-        animatedImage = [[UIImage alloc] initWithData:data scale:scale];
+        animatedImage = [self.class createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
     } else {
         NSMutableArray<SDImageFrame *> *frames = [NSMutableArray array];
         
         for (size_t i = 0; i < count; i++) {
-            CGImageRef imageRef = CGImageSourceCreateImageAtIndex(source, i, NULL);
-            if (!imageRef) {
+            UIImage *image = [self.class createFrameAtIndex:i source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
+            if (!image) {
                 continue;
             }
             
             NSTimeInterval duration = [self.class frameDurationAtIndex:i source:source];
-            UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:scale orientation:UIImageOrientationUp];
-            CGImageRelease(imageRef);
             
             SDImageFrame *frame = [SDImageFrame frameWithImage:image duration:duration];
             [frames addObject:frame];
@@ -205,7 +257,6 @@
     CFRelease(source);
     
     return animatedImage;
-#endif
 }
 
 #pragma mark - Progressive Decode
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index a6fa10af..c17c9f16 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -12,6 +12,7 @@
 #import <ImageIO/ImageIO.h>
 #import "UIImage+Metadata.h"
 #import "SDImageHEICCoderInternal.h"
+#import "SDImageIOAnimatedCoderInternal.h"
 
 @implementation SDImageIOCoder {
     size_t _width, _height;
@@ -74,7 +75,33 @@
         scale = MAX([scaleFactor doubleValue], 1) ;
     }
     
-    UIImage *image = [[UIImage alloc] initWithData:data scale:scale];
+    CGSize thumbnailSize = CGSizeZero;
+    NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
+    if (thumbnailSizeValue != nil) {
+#if SD_MAC
+        thumbnailSize = thumbnailSizeValue.sizeValue;
+#else
+        thumbnailSize = thumbnailSizeValue.CGSizeValue;
+#endif
+    }
+    
+    BOOL preserveAspectRatio = NO;
+    NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
+    if (preserveAspectRatioValue != nil) {
+        preserveAspectRatio = preserveAspectRatioValue.boolValue;
+    }
+    
+    CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL);
+    if (!source) {
+        return nil;
+    }
+    
+    UIImage *image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
+    CFRelease(source);
+    if (!image) {
+        return nil;
+    }
+    
     image.sd_imageFormat = [NSData sd_imageFormatForImageData:data];
     return image;
 }
diff --git a/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h b/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
index 4b500131..f2976ea8 100644
--- a/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
+++ b/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
@@ -13,5 +13,6 @@
 
 + (NSTimeInterval)frameDurationAtIndex:(NSUInteger)index source:(nonnull CGImageSourceRef)source;
 + (NSUInteger)imageLoopCountWithSource:(nonnull CGImageSourceRef)source;
++ (nullable UIImage *)createFrameAtIndex:(NSUInteger)index source:(nonnull CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize;
 
 @end

From 80c64544952c434b447cafec0a0e7cad561c3454 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 20:31:17 +0800
Subject: [PATCH 063/181] Add the support for incremental decoding for
 thumbnail images

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 38 +++++++++++++++---------
 SDWebImage/Core/SDImageIOCoder.m         | 35 ++++++++++++----------
 2 files changed, 44 insertions(+), 29 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 1b71b54e..10856ddc 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -32,6 +32,8 @@
     NSUInteger _frameCount;
     NSArray<SDImageIOCoderFrame *> *_frames;
     BOOL _finished;
+    BOOL _preserveAspectRatio;
+    CGSize _thumbnailSize;
 }
 
 - (void)dealloc
@@ -164,6 +166,10 @@
         thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = preserveAspectRatio ? @(MAX(thumbnailSize.width, thumbnailSize.height)) : @(MIN(thumbnailSize.width, thumbnailSize.height));
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
         imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)thumbnailOptions);
+        if (preserveAspectRatio) {
+            // kCGImageSourceCreateThumbnailWithTransform will apply EXIF transform as well, we should not apply twice
+            exifOrientation = kCGImagePropertyOrientationUp;
+        }
     }
     if (!imageRef) {
         return nil;
@@ -276,6 +282,22 @@
             scale = MAX([scaleFactor doubleValue], 1);
         }
         _scale = scale;
+        CGSize thumbnailSize = CGSizeZero;
+        NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
+        if (thumbnailSizeValue != nil) {
+    #if SD_MAC
+            thumbnailSize = thumbnailSizeValue.sizeValue;
+    #else
+            thumbnailSize = thumbnailSizeValue.CGSizeValue;
+    #endif
+        }
+        _thumbnailSize = thumbnailSize;
+        BOOL preserveAspectRatio = NO;
+        NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
+        if (preserveAspectRatioValue != nil) {
+            preserveAspectRatio = preserveAspectRatioValue.boolValue;
+        }
+        _preserveAspectRatio = preserveAspectRatio;
 #if SD_UIKIT
         [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didReceiveMemoryWarning:) name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
 #endif
@@ -316,20 +338,8 @@
     
     if (_width + _height > 0) {
         // Create the image
-        CGImageRef partialImageRef = CGImageSourceCreateImageAtIndex(_imageSource, 0, NULL);
-        
-        if (partialImageRef) {
-            CGFloat scale = _scale;
-            NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
-            if (scaleFactor != nil) {
-                scale = MAX([scaleFactor doubleValue], 1);
-            }
-#if SD_UIKIT || SD_WATCH
-            image = [[UIImage alloc] initWithCGImage:partialImageRef scale:scale orientation:UIImageOrientationUp];
-#else
-            image = [[UIImage alloc] initWithCGImage:partialImageRef scale:scale orientation:kCGImagePropertyOrientationUp];
-#endif
-            CGImageRelease(partialImageRef);
+        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        if (image) {
             image.sd_imageFormat = self.class.imageFormat;
         }
     }
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index c17c9f16..6e80d1a4 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -20,6 +20,8 @@
     CGImageSourceRef _imageSource;
     CGFloat _scale;
     BOOL _finished;
+    BOOL _preserveAspectRatio;
+    CGSize _thumbnailSize;
 }
 
 - (void)dealloc {
@@ -122,6 +124,22 @@
             scale = MAX([scaleFactor doubleValue], 1);
         }
         _scale = scale;
+        CGSize thumbnailSize = CGSizeZero;
+        NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
+        if (thumbnailSizeValue != nil) {
+    #if SD_MAC
+            thumbnailSize = thumbnailSizeValue.sizeValue;
+    #else
+            thumbnailSize = thumbnailSizeValue.CGSizeValue;
+    #endif
+        }
+        _thumbnailSize = thumbnailSize;
+        BOOL preserveAspectRatio = NO;
+        NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
+        if (preserveAspectRatioValue != nil) {
+            preserveAspectRatio = preserveAspectRatioValue.boolValue;
+        }
+        _preserveAspectRatio = preserveAspectRatio;
 #if SD_UIKIT
         [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didReceiveMemoryWarning:) name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
 #endif
@@ -167,21 +185,8 @@
     
     if (_width + _height > 0) {
         // Create the image
-        CGImageRef partialImageRef = CGImageSourceCreateImageAtIndex(_imageSource, 0, NULL);
-        
-        if (partialImageRef) {
-            CGFloat scale = _scale;
-            NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
-            if (scaleFactor != nil) {
-                scale = MAX([scaleFactor doubleValue], 1);
-            }
-#if SD_UIKIT || SD_WATCH
-            UIImageOrientation imageOrientation = [SDImageCoderHelper imageOrientationFromEXIFOrientation:_orientation];
-            image = [[UIImage alloc] initWithCGImage:partialImageRef scale:scale orientation:imageOrientation];
-#else
-            image = [[UIImage alloc] initWithCGImage:partialImageRef scale:scale orientation:_orientation];
-#endif
-            CGImageRelease(partialImageRef);
+        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        if (image) {
             CFStringRef uttype = CGImageSourceGetType(_imageSource);
             image.sd_imageFormat = [NSData sd_imageFormatFromUTType:uttype];
         }

From 0b0c0d2840690b2e2b9baaef5a08a960dc855442 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 20:37:20 +0800
Subject: [PATCH 064/181] Add the support for animated coder for thumbnail
 images

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 37 ++++++++++++++----------
 1 file changed, 21 insertions(+), 16 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 10856ddc..7451a712 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -431,6 +431,22 @@
             scale = MAX([scaleFactor doubleValue], 1);
         }
         _scale = scale;
+        CGSize thumbnailSize = CGSizeZero;
+        NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
+        if (thumbnailSizeValue != nil) {
+    #if SD_MAC
+            thumbnailSize = thumbnailSizeValue.sizeValue;
+    #else
+            thumbnailSize = thumbnailSizeValue.CGSizeValue;
+    #endif
+        }
+        _thumbnailSize = thumbnailSize;
+        BOOL preserveAspectRatio = NO;
+        NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
+        if (preserveAspectRatioValue != nil) {
+            preserveAspectRatio = preserveAspectRatioValue.boolValue;
+        }
+        _preserveAspectRatio = preserveAspectRatio;
         _imageSource = imageSource;
         _imageData = data;
 #if SD_UIKIT
@@ -482,24 +498,13 @@
 }
 
 - (UIImage *)animatedImageFrameAtIndex:(NSUInteger)index {
-    CGImageRef imageRef = CGImageSourceCreateImageAtIndex(_imageSource, index, NULL);
-    if (!imageRef) {
-        return nil;
-    }
+    UIImage *image = [self.class createFrameAtIndex:index source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
     // Image/IO create CGImage does not decode, so we do this because this is called background queue, this can avoid main queue block when rendering(especially when one more imageViews use the same image instance)
-    CGImageRef newImageRef = [SDImageCoderHelper CGImageCreateDecoded:imageRef];
-    if (!newImageRef) {
-        newImageRef = imageRef;
-    } else {
-        CGImageRelease(imageRef);
+    UIImage *decodedImage = [SDImageCoderHelper decodedImageWithImage:image];
+    if (!decodedImage) {
+        return image;
     }
-#if SD_MAC
-    UIImage *image = [[UIImage alloc] initWithCGImage:newImageRef scale:_scale orientation:kCGImagePropertyOrientationUp];
-#else
-    UIImage *image = [[UIImage alloc] initWithCGImage:newImageRef scale:_scale orientation:UIImageOrientationUp];
-#endif
-    CGImageRelease(newImageRef);
-    return image;
+    return decodedImage;
 }
 
 @end

From ae4aa3f848185be1ae6af9025aa1adbb79b46b20 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 20:39:44 +0800
Subject: [PATCH 065/181] Fix the animated image for sd_imageFormat

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 7451a712..eaa42688 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -499,12 +499,16 @@
 
 - (UIImage *)animatedImageFrameAtIndex:(NSUInteger)index {
     UIImage *image = [self.class createFrameAtIndex:index source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+    if (!image) {
+        return nil;
+    }
     // Image/IO create CGImage does not decode, so we do this because this is called background queue, this can avoid main queue block when rendering(especially when one more imageViews use the same image instance)
     UIImage *decodedImage = [SDImageCoderHelper decodedImageWithImage:image];
-    if (!decodedImage) {
-        return image;
+    if (decodedImage) {
+        image = decodedImage;
     }
-    return decodedImage;
+    image.sd_imageFormat = self.class.imageFormat;
+    return image;
 }
 
 @end

From 19af6b76e66ee63f7e060b6fb55ed3d1784a2339 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 21:04:19 +0800
Subject: [PATCH 066/181] Add the preserveAspectRatio and thumbnailPixelSize in
 the context options, update the usage

---
 SDWebImage/Core/SDImageCacheDefine.m | 16 ++++++++------
 SDWebImage/Core/SDImageCoder.h       |  2 +-
 SDWebImage/Core/SDImageLoader.m      | 32 +++++++++++++++++-----------
 SDWebImage/Core/SDWebImageDefine.h   | 12 +++++++++++
 SDWebImage/Core/SDWebImageDefine.m   |  2 ++
 5 files changed, 45 insertions(+), 19 deletions(-)

diff --git a/SDWebImage/Core/SDImageCacheDefine.m b/SDWebImage/Core/SDImageCacheDefine.m
index 99e57f1a..560a06eb 100644
--- a/SDWebImage/Core/SDImageCacheDefine.m
+++ b/SDWebImage/Core/SDImageCacheDefine.m
@@ -18,12 +18,16 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
     BOOL decodeFirstFrame = SD_OPTIONS_CONTAINS(options, SDWebImageDecodeFirstFrameOnly);
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
-    SDImageCoderOptions *coderOptions = @{SDImageCoderDecodeFirstFrameOnly : @(decodeFirstFrame), SDImageCoderDecodeScaleFactor : @(scale)};
-    if (context) {
-        SDImageCoderMutableOptions *mutableCoderOptions = [coderOptions mutableCopy];
-        [mutableCoderOptions setValue:context forKey:SDImageCoderWebImageContext];
-        coderOptions = [mutableCoderOptions copy];
-    }
+    NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
+    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    
+    SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
+    mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
+    mutableCoderOptions[SDImageCoderDecodeScaleFactor] = @(scale);
+    mutableCoderOptions[SDImageCoderDecodePreserveAspectRatio] = preserveAspectRatioValue;
+    mutableCoderOptions[SDImageCoderDecodeThumbnailPixelSize] = thumbnailSizeValue;
+    mutableCoderOptions[SDImageCoderWebImageContext] = context;
+    SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
     if (!decodeFirstFrame) {
         Class animatedImageClass = context[SDWebImageContextAnimatedImageClass];
diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 817ce825..801ca938 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -35,7 +35,7 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeScaleFacto
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodePreserveAspectRatio;
 
 /**
- A CGSize value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.generationRule`) the value size.
+ A CGSize value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.preserveAspectRatio`) the value size.
  Defaults to CGSizeZero, which means no thumbnail generation at all.
  @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
  */
diff --git a/SDWebImage/Core/SDImageLoader.m b/SDWebImage/Core/SDImageLoader.m
index 8cbbe4e0..aac7a93a 100644
--- a/SDWebImage/Core/SDImageLoader.m
+++ b/SDWebImage/Core/SDImageLoader.m
@@ -32,12 +32,16 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
     BOOL decodeFirstFrame = SD_OPTIONS_CONTAINS(options, SDWebImageDecodeFirstFrameOnly);
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
-    SDImageCoderOptions *coderOptions = @{SDImageCoderDecodeFirstFrameOnly : @(decodeFirstFrame), SDImageCoderDecodeScaleFactor : @(scale)};
-    if (context) {
-        SDImageCoderMutableOptions *mutableCoderOptions = [coderOptions mutableCopy];
-        [mutableCoderOptions setValue:context forKey:SDImageCoderWebImageContext];
-        coderOptions = [mutableCoderOptions copy];
-    }
+    NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
+    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    
+    SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
+    mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
+    mutableCoderOptions[SDImageCoderDecodeScaleFactor] = @(scale);
+    mutableCoderOptions[SDImageCoderDecodePreserveAspectRatio] = preserveAspectRatioValue;
+    mutableCoderOptions[SDImageCoderDecodeThumbnailPixelSize] = thumbnailSizeValue;
+    mutableCoderOptions[SDImageCoderWebImageContext] = context;
+    SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
     if (!decodeFirstFrame) {
         // check whether we should use `SDAnimatedImage`
@@ -99,12 +103,16 @@ UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull im
     BOOL decodeFirstFrame = SD_OPTIONS_CONTAINS(options, SDWebImageDecodeFirstFrameOnly);
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
-    SDImageCoderOptions *coderOptions = @{SDImageCoderDecodeFirstFrameOnly : @(decodeFirstFrame), SDImageCoderDecodeScaleFactor : @(scale)};
-    if (context) {
-        SDImageCoderMutableOptions *mutableCoderOptions = [coderOptions mutableCopy];
-        [mutableCoderOptions setValue:context forKey:SDImageCoderWebImageContext];
-        coderOptions = [mutableCoderOptions copy];
-    }
+    NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
+    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    
+    SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
+    mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
+    mutableCoderOptions[SDImageCoderDecodeScaleFactor] = @(scale);
+    mutableCoderOptions[SDImageCoderDecodePreserveAspectRatio] = preserveAspectRatioValue;
+    mutableCoderOptions[SDImageCoderDecodeThumbnailPixelSize] = thumbnailSizeValue;
+    mutableCoderOptions[SDImageCoderWebImageContext] = context;
+    SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
     id<SDProgressiveImageCoder> progressiveCoder = objc_getAssociatedObject(operation, SDImageLoaderProgressiveCoderKey);
     if (!progressiveCoder) {
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index a9a34367..03dd210c 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -217,6 +217,18 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageT
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageScaleFactor;
 
+/**
+ A Boolean value indicating whether to keep the original aspect ratio when generating thumbnail images (or bitmap images from vector format).
+ Defaults to YES. (NSNumber)
+ */
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImagePreserveAspectRatio;
+
+/**
+ A CGSize raw value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.imagePreserveAspectRatio`) the value size.
+ Defaults to CGSizeZero, which means no thumbnail generation at all. (NSValue)
+ */
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageThumbnailPixelSize;
+
 /**
  A SDImageCacheType raw value which specify the store cache type when the image has just been downloaded and will be stored to the cache. Specify `SDImageCacheTypeNone` to disable cache storage; `SDImageCacheTypeDisk` to store in disk cache only; `SDImageCacheTypeMemory` to store in memory only. And `SDImageCacheTypeAll` to store in both memory cache and disk cache.
  If you use image transformer feature, this actually apply for the transformed image, but not the original image itself. Use `SDWebImageContextOriginalStoreCacheType` if you want to control the original image's store cache type at the same time.
diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 496392c4..921e878a 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -122,6 +122,8 @@ SDWebImageContextOption const SDWebImageContextSetImageOperationKey = @"setImage
 SDWebImageContextOption const SDWebImageContextCustomManager = @"customManager";
 SDWebImageContextOption const SDWebImageContextImageTransformer = @"imageTransformer";
 SDWebImageContextOption const SDWebImageContextImageScaleFactor = @"imageScaleFactor";
+SDWebImageContextOption const SDWebImageContextImagePreserveAspectRatio = @"imagePreserveAspectRatio";
+SDWebImageContextOption const SDWebImageContextImageThumbnailPixelSize = @"imageThumbnailPixelSize";
 SDWebImageContextOption const SDWebImageContextStoreCacheType = @"storeCacheType";
 SDWebImageContextOption const SDWebImageContextOriginalStoreCacheType = @"originalStoreCacheType";
 SDWebImageContextOption const SDWebImageContextAnimatedImageClass = @"animatedImageClass";

From 6bb8641783a40ba6373bf7c61e27d94b3dc8a410 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 22:20:37 +0800
Subject: [PATCH 067/181] Bridge the exist options
 `SDWebImageScaleDownLargeImages`, to use the thumbnail decoding instead.
 Defaults use 60MB limit and thumbnail size is (3966, 3966)

---
 SDWebImage/Core/SDImageCacheDefine.m | 11 ++++++-
 SDWebImage/Core/SDImageCoderHelper.h |  6 ++++
 SDWebImage/Core/SDImageCoderHelper.m | 45 +++++++++++++---------------
 SDWebImage/Core/SDImageLoader.m      | 29 +++++++++++++-----
 SDWebImage/Core/SDWebImageDefine.h   |  9 ++++--
 5 files changed, 64 insertions(+), 36 deletions(-)

diff --git a/SDWebImage/Core/SDImageCacheDefine.m b/SDWebImage/Core/SDImageCacheDefine.m
index 560a06eb..0a3afbe5 100644
--- a/SDWebImage/Core/SDImageCacheDefine.m
+++ b/SDWebImage/Core/SDImageCacheDefine.m
@@ -19,7 +19,16 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
-    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    NSValue *thumbnailSizeValue;
+    BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
+    if (shouldScaleDown) {
+        CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
+        CGFloat dimension = ceil(sqrt(thumbnailPixels));
+        thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
+    }
+    if (context[SDWebImageContextImageThumbnailPixelSize]) {
+        thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    }
     
     SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
     mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
diff --git a/SDWebImage/Core/SDImageCoderHelper.h b/SDWebImage/Core/SDImageCoderHelper.h
index dcf1da2b..9df53e0c 100644
--- a/SDWebImage/Core/SDImageCoderHelper.h
+++ b/SDWebImage/Core/SDImageCoderHelper.h
@@ -90,6 +90,12 @@
 + (UIImage * _Nullable)decodedAndScaledDownImageWithImage:(UIImage * _Nullable)image limitBytes:(NSUInteger)bytes;
 
 #if SD_UIKIT || SD_WATCH
+/**
+ Control the default limit bytes to scale down larget images.
+ This value must be larger than or equal to 1MB. Defaults to 60MB.
+ */
+@property (class, readwrite) NSUInteger defaultScaleDownLimitBytes;
+
 /**
  Convert an EXIF image orientation to an iOS one.
 
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 3cc0c7ea..9e92dd60 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -18,26 +18,15 @@
 static const size_t kBytesPerPixel = 4;
 static const size_t kBitsPerComponent = 8;
 
+static const CGFloat kBytesPerMB = 1024.0f * 1024.0f;
+static const CGFloat kPixelsPerMB = kBytesPerMB / kBytesPerPixel;
 /*
  * Defines the maximum size in MB of the decoded image when the flag `SDWebImageScaleDownLargeImages` is set
  * Suggested value for iPad1 and iPhone 3GS: 60.
  * Suggested value for iPad2 and iPhone 4: 120.
  * Suggested value for iPhone 3G and iPod 2 and earlier devices: 30.
  */
-static const CGFloat kDestImageSizeMB = 60.f;
-
-/*
- * Defines the maximum size in MB of a tile used to decode image when the flag `SDWebImageScaleDownLargeImages` is set
- * Suggested value for iPad1 and iPhone 3GS: 20.
- * Suggested value for iPad2 and iPhone 4: 40.
- * Suggested value for iPhone 3G and iPod 2 and earlier devices: 10.
- */
-static const CGFloat kSourceImageTileSizeMB = 20.f;
-
-static const CGFloat kBytesPerMB = 1024.0f * 1024.0f;
-static const CGFloat kPixelsPerMB = kBytesPerMB / kBytesPerPixel;
-static const CGFloat kDestTotalPixels = kDestImageSizeMB * kPixelsPerMB;
-static const CGFloat kTileTotalPixels = kSourceImageTileSizeMB * kPixelsPerMB;
+static CGFloat kDestImageLimitBytes = 60.f * kBytesPerMB;
 
 static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to overlap the seems where tiles meet.
 #endif
@@ -311,13 +300,11 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     
     CGFloat destTotalPixels;
     CGFloat tileTotalPixels;
-    if (bytes > 0) {
-        destTotalPixels = bytes / kBytesPerPixel;
-        tileTotalPixels = destTotalPixels / 3;
-    } else {
-        destTotalPixels = kDestTotalPixels;
-        tileTotalPixels = kTileTotalPixels;
+    if (bytes == 0) {
+        bytes = kDestImageLimitBytes;
     }
+    destTotalPixels = bytes / kBytesPerPixel;
+    tileTotalPixels = destTotalPixels / 3;
     CGContextRef destContext;
     
     // autorelease the bitmap context and all vars to help system to free memory when there are memory warning.
@@ -433,6 +420,17 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
 }
 
 #if SD_UIKIT || SD_WATCH
++ (NSUInteger)defaultScaleDownLimitBytes {
+    return kDestImageLimitBytes;
+}
+
++ (void)setDefaultScaleDownLimitBytes:(NSUInteger)defaultScaleDownLimitBytes {
+    if (defaultScaleDownLimitBytes < kBytesPerMB) {
+        return;
+    }
+    kDestImageLimitBytes = defaultScaleDownLimitBytes;
+}
+
 // Convert an EXIF image orientation to an iOS one.
 + (UIImageOrientation)imageOrientationFromEXIFOrientation:(CGImagePropertyOrientation)exifOrientation {
     UIImageOrientation imageOrientation = UIImageOrientationUp;
@@ -533,11 +531,10 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         return NO;
     }
     CGFloat destTotalPixels;
-    if (bytes > 0) {
-        destTotalPixels = bytes / kBytesPerPixel;
-    } else {
-        destTotalPixels = kDestTotalPixels;
+    if (bytes == 0) {
+        bytes = kDestImageLimitBytes;
     }
+    destTotalPixels = bytes / kBytesPerPixel;
     if (destTotalPixels <= kPixelsPerMB) {
         // Too small to scale down
         return NO;
diff --git a/SDWebImage/Core/SDImageLoader.m b/SDWebImage/Core/SDImageLoader.m
index aac7a93a..4c831c59 100644
--- a/SDWebImage/Core/SDImageLoader.m
+++ b/SDWebImage/Core/SDImageLoader.m
@@ -33,7 +33,16 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
-    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    NSValue *thumbnailSizeValue;
+    BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
+    if (shouldScaleDown) {
+        CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
+        CGFloat dimension = ceil(sqrt(thumbnailPixels));
+        thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
+    }
+    if (context[SDWebImageContextImageThumbnailPixelSize]) {
+        thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    }
     
     SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
     mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
@@ -75,12 +84,7 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
         }
         
         if (shouldDecode) {
-            BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
-            if (shouldScaleDown) {
-                image = [SDImageCoderHelper decodedAndScaledDownImageWithImage:image limitBytes:0];
-            } else {
-                image = [SDImageCoderHelper decodedImageWithImage:image];
-            }
+            image = [SDImageCoderHelper decodedImageWithImage:image];
         }
     }
     
@@ -104,7 +108,16 @@ UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull im
     NSNumber *scaleValue = context[SDWebImageContextImageScaleFactor];
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
-    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    NSValue *thumbnailSizeValue;
+    BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
+    if (shouldScaleDown) {
+        CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
+        CGFloat dimension = ceil(sqrt(thumbnailPixels));
+        thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
+    }
+    if (context[SDWebImageContextImageThumbnailPixelSize]) {
+        thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    }
     
     SDImageCoderMutableOptions *mutableCoderOptions = [NSMutableDictionary dictionaryWithCapacity:2];
     mutableCoderOptions[SDImageCoderDecodeFirstFrameOnly] = @(decodeFirstFrame);
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 03dd210c..549c1da7 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -122,9 +122,12 @@ typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
     SDWebImageAvoidAutoSetImage = 1 << 10,
     
     /**
-     * By default, images are decoded respecting their original size. On iOS, this flag will scale down the
-     * images to a size compatible with the constrained memory of devices.
-     * This flag take no effect if `SDWebImageAvoidDecodeImage` is set. And it will be ignored if `SDWebImageProgressiveLoad` is set.
+     * By default, images are decoded respecting their original size.
+     * On iOS/tvOS/watchOS, this flag will scale down the images to a size compatible with the constrained memory of devices. On macOS, this does nothing.
+     * To control the limit bytes, check `SDImageCoderHelper.defaultScaleDownLimitBytes` (Defaults to 60MB)
+     * This will actually translate to use context option `.imageThumbnailPixelSize` from v5.5.0 (Defaults to (3966, 3966)). Previously does not.
+     * This flags effect the progressive and animated images as well from v5.5.0. Previously does not.
+     * @note If you need detail controls, it's better to use context option `imageThumbnailPixelSize` and `imagePreserveAspectRatio` instead.
      */
     SDWebImageScaleDownLargeImages = 1 << 11,
     

From c9dffc64dcd355a0ec7ae3bedb76e142a89a73f9 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Jan 2020 22:40:51 +0800
Subject: [PATCH 068/181] Fix the compile issue on macOS. Fix the animated
 frame force decode issue on macOS

---
 SDWebImage/Core/SDImageCacheDefine.m     |  2 ++
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 15 ++++++++++++---
 SDWebImage/Core/SDImageLoader.m          |  4 ++++
 3 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageCacheDefine.m b/SDWebImage/Core/SDImageCacheDefine.m
index 0a3afbe5..d13c3c39 100644
--- a/SDWebImage/Core/SDImageCacheDefine.m
+++ b/SDWebImage/Core/SDImageCacheDefine.m
@@ -20,12 +20,14 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
+#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
+#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index eaa42688..ea9a7c25 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -12,6 +12,7 @@
 #import "NSData+ImageContentType.h"
 #import "SDImageCoderHelper.h"
 #import "SDAnimatedImageRep.h"
+#import "UIImage+ForceDecode.h"
 
 @interface SDImageIOCoderFrame : NSObject
 
@@ -502,11 +503,19 @@
     if (!image) {
         return nil;
     }
+    image.sd_imageFormat = self.class.imageFormat;
     // Image/IO create CGImage does not decode, so we do this because this is called background queue, this can avoid main queue block when rendering(especially when one more imageViews use the same image instance)
-    UIImage *decodedImage = [SDImageCoderHelper decodedImageWithImage:image];
-    if (decodedImage) {
-        image = decodedImage;
+    CGImageRef imageRef = [SDImageCoderHelper CGImageCreateDecoded:image.CGImage];
+    if (!imageRef) {
+        return image;
     }
+#if SD_MAC
+    image = [[UIImage alloc] initWithCGImage:imageRef scale:_scale orientation:kCGImagePropertyOrientationUp];
+#else
+    image = [[UIImage alloc] initWithCGImage:imageRef scale:_scale orientation:image.imageOrientation];
+#endif
+    CGImageRelease(imageRef);
+    image.sd_isDecoded = YES;
     image.sd_imageFormat = self.class.imageFormat;
     return image;
 }
diff --git a/SDWebImage/Core/SDImageLoader.m b/SDWebImage/Core/SDImageLoader.m
index 4c831c59..2bd48b15 100644
--- a/SDWebImage/Core/SDImageLoader.m
+++ b/SDWebImage/Core/SDImageLoader.m
@@ -34,12 +34,14 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
+#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
+#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }
@@ -109,12 +111,14 @@ UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull im
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
+#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
+#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }

From ec620438b9f44ef9b6e26c91413e2ea0438204d6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 6 Jan 2020 18:45:38 +0800
Subject: [PATCH 069/181] Fix the edge case when
 incrementalDecodedImageWithOptions provide custom scale factor and override
 the one from init method

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 7 ++++++-
 SDWebImage/Core/SDImageIOCoder.m         | 7 ++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index ea9a7c25..03f3acc2 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -339,7 +339,12 @@
     
     if (_width + _height > 0) {
         // Create the image
-        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        CGFloat scale = _scale;
+        NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
+        if (scaleFactor != nil) {
+            scale = MAX([scaleFactor doubleValue], 1);
+        }
+        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
         if (image) {
             image.sd_imageFormat = self.class.imageFormat;
         }
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index 6e80d1a4..f5223887 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -185,7 +185,12 @@
     
     if (_width + _height > 0) {
         // Create the image
-        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        CGFloat scale = _scale;
+        NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
+        if (scaleFactor != nil) {
+            scale = MAX([scaleFactor doubleValue], 1);
+        }
+        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
         if (image) {
             CFStringRef uttype = CGImageSourceGetType(_imageSource);
             image.sd_imageFormat = [NSData sd_imageFormatFromUTType:uttype];

From 9e5ef8c0e9fef0c88513be257e511b45c7dc5dbf Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 6 Jan 2020 18:54:01 +0800
Subject: [PATCH 070/181] Change all the force decode method to be compatible
 with macOS. Update the documentation as well

---
 SDWebImage/Core/SDImageCacheDefine.m |  9 +--------
 SDWebImage/Core/SDImageCoderHelper.h |  2 +-
 SDWebImage/Core/SDImageCoderHelper.m | 25 +++++++++++--------------
 SDWebImage/Core/SDImageLoader.m      |  4 ----
 SDWebImage/Core/SDWebImageDefine.h   |  4 ++--
 5 files changed, 15 insertions(+), 29 deletions(-)

diff --git a/SDWebImage/Core/SDImageCacheDefine.m b/SDWebImage/Core/SDImageCacheDefine.m
index d13c3c39..75dfb4e6 100644
--- a/SDWebImage/Core/SDImageCacheDefine.m
+++ b/SDWebImage/Core/SDImageCacheDefine.m
@@ -20,14 +20,12 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
-#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
-#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }
@@ -71,12 +69,7 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
             shouldDecode = NO;
         }
         if (shouldDecode) {
-            BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
-            if (shouldScaleDown) {
-                image = [SDImageCoderHelper decodedAndScaledDownImageWithImage:image limitBytes:0];
-            } else {
-                image = [SDImageCoderHelper decodedImageWithImage:image];
-            }
+            image = [SDImageCoderHelper decodedImageWithImage:image];
         }
     }
     
diff --git a/SDWebImage/Core/SDImageCoderHelper.h b/SDWebImage/Core/SDImageCoderHelper.h
index 9df53e0c..353a8729 100644
--- a/SDWebImage/Core/SDImageCoderHelper.h
+++ b/SDWebImage/Core/SDImageCoderHelper.h
@@ -89,13 +89,13 @@
  */
 + (UIImage * _Nullable)decodedAndScaledDownImageWithImage:(UIImage * _Nullable)image limitBytes:(NSUInteger)bytes;
 
-#if SD_UIKIT || SD_WATCH
 /**
  Control the default limit bytes to scale down larget images.
  This value must be larger than or equal to 1MB. Defaults to 60MB.
  */
 @property (class, readwrite) NSUInteger defaultScaleDownLimitBytes;
 
+#if SD_UIKIT || SD_WATCH
 /**
  Convert an EXIF image orientation to an iOS one.
 
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 9e92dd60..ac671366 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -13,8 +13,8 @@
 #import "SDAnimatedImageRep.h"
 #import "UIImage+ForceDecode.h"
 #import "SDAssociatedObject.h"
+#import "UIImage+Metadata.h"
 
-#if SD_UIKIT || SD_WATCH
 static const size_t kBytesPerPixel = 4;
 static const size_t kBitsPerComponent = 8;
 
@@ -29,7 +29,6 @@ static const CGFloat kPixelsPerMB = kBytesPerMB / kBytesPerPixel;
 static CGFloat kDestImageLimitBytes = 60.f * kBytesPerMB;
 
 static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to overlap the seems where tiles meet.
-#endif
 
 @implementation SDImageCoderHelper
 
@@ -267,9 +266,6 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
 }
 
 + (UIImage *)decodedImageWithImage:(UIImage *)image {
-#if SD_MAC
-    return image;
-#else
     if (![self shouldDecodeImage:image]) {
         return image;
     }
@@ -278,18 +274,18 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     if (!imageRef) {
         return image;
     }
+#if SD_MAC
+    UIImage *decodedImage = [[UIImage alloc] initWithCGImage:imageRef scale:image.scale orientation:kCGImagePropertyOrientationUp];
+#else
     UIImage *decodedImage = [[UIImage alloc] initWithCGImage:imageRef scale:image.scale orientation:image.imageOrientation];
+#endif
     CGImageRelease(imageRef);
     SDImageCopyAssociatedObject(image, decodedImage);
     decodedImage.sd_isDecoded = YES;
     return decodedImage;
-#endif
 }
 
 + (UIImage *)decodedAndScaledDownImageWithImage:(UIImage *)image limitBytes:(NSUInteger)bytes {
-#if SD_MAC
-    return image;
-#else
     if (![self shouldDecodeImage:image]) {
         return image;
     }
@@ -407,7 +403,11 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         if (destImageRef == NULL) {
             return image;
         }
+#if SD_MAC
+        UIImage *destImage = [[UIImage alloc] initWithCGImage:destImageRef scale:image.scale orientation:kCGImagePropertyOrientationUp];
+#else
         UIImage *destImage = [[UIImage alloc] initWithCGImage:destImageRef scale:image.scale orientation:image.imageOrientation];
+#endif
         CGImageRelease(destImageRef);
         if (destImage == nil) {
             return image;
@@ -416,10 +416,8 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         destImage.sd_isDecoded = YES;
         return destImage;
     }
-#endif
 }
 
-#if SD_UIKIT || SD_WATCH
 + (NSUInteger)defaultScaleDownLimitBytes {
     return kDestImageLimitBytes;
 }
@@ -431,6 +429,7 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     kDestImageLimitBytes = defaultScaleDownLimitBytes;
 }
 
+#if SD_UIKIT || SD_WATCH
 // Convert an EXIF image orientation to an iOS one.
 + (UIImageOrientation)imageOrientationFromEXIFOrientation:(CGImagePropertyOrientation)exifOrientation {
     UIImageOrientation imageOrientation = UIImageOrientationUp;
@@ -501,7 +500,6 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
 #endif
 
 #pragma mark - Helper Fuction
-#if SD_UIKIT || SD_WATCH
 + (BOOL)shouldDecodeImage:(nullable UIImage *)image {
     // Avoid extra decode
     if (image.sd_isDecoded) {
@@ -512,7 +510,7 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         return NO;
     }
     // do not decode animated images
-    if (image.images != nil) {
+    if (image.sd_isAnimated) {
         return NO;
     }
     
@@ -548,7 +546,6 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     
     return shouldScaleDown;
 }
-#endif
 
 static inline CGAffineTransform SDCGContextTransformFromOrientation(CGImagePropertyOrientation orientation, CGSize size) {
     // Inspiration from @libfeihu
diff --git a/SDWebImage/Core/SDImageLoader.m b/SDWebImage/Core/SDImageLoader.m
index 2bd48b15..4c831c59 100644
--- a/SDWebImage/Core/SDImageLoader.m
+++ b/SDWebImage/Core/SDImageLoader.m
@@ -34,14 +34,12 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
-#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
-#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }
@@ -111,14 +109,12 @@ UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull im
     CGFloat scale = scaleValue.doubleValue >= 1 ? scaleValue.doubleValue : SDImageScaleFactorForKey(cacheKey);
     NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
     NSValue *thumbnailSizeValue;
-#if SD_UIKIT || SD_WATCH
     BOOL shouldScaleDown = SD_OPTIONS_CONTAINS(options, SDWebImageScaleDownLargeImages);
     if (shouldScaleDown) {
         CGFloat thumbnailPixels = SDImageCoderHelper.defaultScaleDownLimitBytes / 4;
         CGFloat dimension = ceil(sqrt(thumbnailPixels));
         thumbnailSizeValue = @(CGSizeMake(dimension, dimension));
     }
-#endif
     if (context[SDWebImageContextImageThumbnailPixelSize]) {
         thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     }
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 549c1da7..8c364844 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -123,8 +123,8 @@ typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
     
     /**
      * By default, images are decoded respecting their original size.
-     * On iOS/tvOS/watchOS, this flag will scale down the images to a size compatible with the constrained memory of devices. On macOS, this does nothing.
-     * To control the limit bytes, check `SDImageCoderHelper.defaultScaleDownLimitBytes` (Defaults to 60MB)
+     * This flag will scale down the images to a size compatible with the constrained memory of devices.
+     * To control the limit memory bytes, check `SDImageCoderHelper.defaultScaleDownLimitBytes` (Defaults to 60MB)
      * This will actually translate to use context option `.imageThumbnailPixelSize` from v5.5.0 (Defaults to (3966, 3966)). Previously does not.
      * This flags effect the progressive and animated images as well from v5.5.0. Previously does not.
      * @note If you need detail controls, it's better to use context option `imageThumbnailPixelSize` and `imagePreserveAspectRatio` instead.

From 03e63ede2538b43bf76bf16441d496542dbea4bf Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 6 Jan 2020 19:06:49 +0800
Subject: [PATCH 071/181] Change the default limit bytes 60MB on iOS/tvOS, 90MB
 on macOS, 30MB on watchOS

---
 SDWebImage/Core/SDImageCoderHelper.h | 2 +-
 SDWebImage/Core/SDImageCoderHelper.m | 6 ++++++
 SDWebImage/Core/SDWebImageDefine.h   | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoderHelper.h b/SDWebImage/Core/SDImageCoderHelper.h
index 353a8729..38085b7e 100644
--- a/SDWebImage/Core/SDImageCoderHelper.h
+++ b/SDWebImage/Core/SDImageCoderHelper.h
@@ -91,7 +91,7 @@
 
 /**
  Control the default limit bytes to scale down larget images.
- This value must be larger than or equal to 1MB. Defaults to 60MB.
+ This value must be larger than or equal to 1MB. Defaults to 60MB on iOS/tvOS, 90MB on macOS, 30MB on watchOS.
  */
 @property (class, readwrite) NSUInteger defaultScaleDownLimitBytes;
 
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index ac671366..b88f7068 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -26,7 +26,13 @@ static const CGFloat kPixelsPerMB = kBytesPerMB / kBytesPerPixel;
  * Suggested value for iPad2 and iPhone 4: 120.
  * Suggested value for iPhone 3G and iPod 2 and earlier devices: 30.
  */
+#if SD_MAC
+static CGFloat kDestImageLimitBytes = 90.f * kBytesPerMB;
+#elif SD_UIKIT
 static CGFloat kDestImageLimitBytes = 60.f * kBytesPerMB;
+#elif SD_WATCH
+static CGFloat kDestImageLimitBytes = 30.f * kBytesPerMB;
+#endif
 
 static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to overlap the seems where tiles meet.
 
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 8c364844..1e871ac0 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -124,8 +124,8 @@ typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
     /**
      * By default, images are decoded respecting their original size.
      * This flag will scale down the images to a size compatible with the constrained memory of devices.
-     * To control the limit memory bytes, check `SDImageCoderHelper.defaultScaleDownLimitBytes` (Defaults to 60MB)
-     * This will actually translate to use context option `.imageThumbnailPixelSize` from v5.5.0 (Defaults to (3966, 3966)). Previously does not.
+     * To control the limit memory bytes, check `SDImageCoderHelper.defaultScaleDownLimitBytes` (Defaults to 60MB on iOS)
+     * This will actually translate to use context option `.imageThumbnailPixelSize` from v5.5.0 (Defaults to (3966, 3966) on iOS). Previously does not.
      * This flags effect the progressive and animated images as well from v5.5.0. Previously does not.
      * @note If you need detail controls, it's better to use context option `imageThumbnailPixelSize` and `imagePreserveAspectRatio` instead.
      */

From fa124b4d11ea3a595f0bc9b17f67feecbedf01d4 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 11:55:01 +0800
Subject: [PATCH 072/181] Enable the force decode test case for macOS as well

---
 Tests/Tests/SDImageCoderTests.m | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 0320c2c2..88a02fdf 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -20,7 +20,6 @@
     expect([UIImage sd_decodedAndScaledDownImageWithImage:nil]).to.beNil();
 }
 
-#if SD_UIKIT
 - (void)test02ThatDecodedImageWithImageWorksWithARegularJPGImage {
     NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
@@ -34,7 +33,11 @@
 - (void)test03ThatDecodedImageWithImageDoesNotDecodeAnimatedImages {
     NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"gif"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
+#if SD_MAC
+    UIImage *animatedImage = image;
+#else
     UIImage *animatedImage = [UIImage animatedImageWithImages:@[image] duration:0];
+#endif
     UIImage *decodedImage = [UIImage sd_decodedImageWithImage:animatedImage];
     expect(decodedImage).toNot.beNil();
     expect(decodedImage).to.equal(animatedImage);
@@ -61,7 +64,7 @@
 - (void)test06ThatDecodeAndScaleDownImageWorks {
     NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
-    UIImage *decodedImage = [UIImage sd_decodedAndScaledDownImageWithImage:image];
+    UIImage *decodedImage = [UIImage sd_decodedAndScaledDownImageWithImage:image limitBytes:(60 * 1024 * 1024)];
     expect(decodedImage).toNot.beNil();
     expect(decodedImage).toNot.equal(image);
     expect(decodedImage.size.width).toNot.equal(image.size.width);
@@ -78,7 +81,6 @@
     expect(decodedImage.size.width).to.equal(image.size.width);
     expect(decodedImage.size.height).to.equal(image.size.height);
 }
-#endif
 
 - (void)test11ThatAPNGPCoderWorks {
     NSURL *APNGURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImageAnimated" withExtension:@"apng"];

From 77283f611688ec65992fa5d3a4ca2054d75d0a0f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 18:23:41 +0800
Subject: [PATCH 073/181] Update the test case, fix the behavior of thumbnail
 pixel size when aspect ratio is YES.

---
 SDWebImage/Core/SDImageCoder.h           |  1 +
 SDWebImage/Core/SDImageCoderHelper.h     | 10 +++++
 SDWebImage/Core/SDImageCoderHelper.m     | 53 ++++++++++++++++++++++++
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 19 ++++++++-
 SDWebImage/Core/SDWebImageDefine.h       |  1 +
 Tests/Tests/SDImageCoderTests.m          | 32 +++++++++++++-
 6 files changed, 113 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 801ca938..221246ac 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -37,6 +37,7 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodePreserveAs
 /**
  A CGSize value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.preserveAspectRatio`) the value size.
  Defaults to CGSizeZero, which means no thumbnail generation at all.
+ @note When you pass `.preserveAspectRatio == NO`, the thumbnail image is stretched to match each dimension. When `.preserveAspectRatio == YES`, the thumbnail image's width is limited to pixel size's width, the thumbnail image's height is limited to pixel size's height. For common cases, you can just pass a square size to limit both.
  @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeThumbnailPixelSize;
diff --git a/SDWebImage/Core/SDImageCoderHelper.h b/SDWebImage/Core/SDImageCoderHelper.h
index 38085b7e..5dbd523c 100644
--- a/SDWebImage/Core/SDImageCoderHelper.h
+++ b/SDWebImage/Core/SDImageCoderHelper.h
@@ -73,6 +73,16 @@
  */
 + (CGImageRef _Nullable)CGImageCreateDecoded:(_Nonnull CGImageRef)cgImage orientation:(CGImagePropertyOrientation)orientation CF_RETURNS_RETAINED;
 
+/**
+ Create a scaled CGImage by the provided CGImage and size. This follows The Create Rule and you are response to call release after usage.
+ It will detect whether the image size matching the scale size, if not, stretch the image to the target size.
+ 
+ @param cgImage The CGImage
+ @param size The scale size in pixel.
+ @return A new created scaled image
+ */
++ (CGImageRef _Nullable)CGImageCreateScaled:(_Nonnull CGImageRef)cgImage size:(CGSize)size CF_RETURNS_RETAINED;
+
 /**
  Return the decoded image by the provided image. This one unlike `CGImageCreateDecoded:`, will not decode the image which contains alpha channel or animated image
  @param image The image to be decoded
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index b88f7068..de3d0cfc 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -14,6 +14,12 @@
 #import "UIImage+ForceDecode.h"
 #import "SDAssociatedObject.h"
 #import "UIImage+Metadata.h"
+#import "SDInternalMacros.h"
+#import <Accelerate/Accelerate.h>
+
+static inline size_t SDByteAlign(size_t size, size_t alignment) {
+    return ((size + (alignment - 1)) / alignment) * alignment;
+}
 
 static const size_t kBytesPerPixel = 4;
 static const size_t kBitsPerComponent = 8;
@@ -271,6 +277,53 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     return newImageRef;
 }
 
++ (CGImageRef)CGImageCreateScaled:(CGImageRef)cgImage size:(CGSize)size {
+    if (!cgImage) {
+        return NULL;
+    }
+    size_t width = CGImageGetWidth(cgImage);
+    size_t height = CGImageGetHeight(cgImage);
+    if (width == size.width && height == size.height) {
+        CGImageRetain(cgImage);
+        return cgImage;
+    }
+    
+    __block vImage_Buffer input_buffer = {}, output_buffer = {};
+    @onExit {
+        if (input_buffer.data) free(input_buffer.data);
+        if (output_buffer.data) free(output_buffer.data);
+    };
+    
+    vImage_CGImageFormat format = (vImage_CGImageFormat) {
+        .bitsPerComponent = 8,
+        .bitsPerPixel = 32,
+        .colorSpace = NULL,
+        .bitmapInfo = kCGImageAlphaFirst | kCGBitmapByteOrderDefault,
+        .version = 0,
+        .decode = NULL,
+        .renderingIntent = kCGRenderingIntentDefault,
+    };
+    
+    vImage_Error a_ret = vImageBuffer_InitWithCGImage(&input_buffer, &format, NULL, cgImage, kvImageNoFlags);
+    if (a_ret != kvImageNoError) return NULL;
+    output_buffer.width = MAX(size.width, 0);
+    output_buffer.height = MAX(size.height, 0);
+    output_buffer.rowBytes = SDByteAlign(output_buffer.width * 4, 64);
+    output_buffer.data = malloc(output_buffer.rowBytes * output_buffer.height);
+    if (!output_buffer.data) return NULL;
+    
+    vImage_Error ret = vImageScale_ARGB8888(&input_buffer, &output_buffer, NULL, kvImageHighQualityResampling);
+    if (ret != kvImageNoError) return NULL;
+    
+    CGImageRef outputImage = vImageCreateCGImageFromBuffer(&output_buffer, &format, NULL, NULL, kvImageNoFlags, &ret);
+    if (ret != kvImageNoError) {
+        CGImageRelease(outputImage);
+        return NULL;
+    }
+    
+    return outputImage;
+}
+
 + (UIImage *)decodedImageWithImage:(UIImage *)image {
     if (![self shouldDecodeImage:image]) {
         return image;
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 03f3acc2..2f771455 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -164,12 +164,29 @@
     } else {
         NSMutableDictionary *thumbnailOptions = [NSMutableDictionary dictionary];
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
-        thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = preserveAspectRatio ? @(MAX(thumbnailSize.width, thumbnailSize.height)) : @(MIN(thumbnailSize.width, thumbnailSize.height));
+        CGFloat maxPixelSize;
+        if (preserveAspectRatio) {
+            if (pixelWidth > pixelHeight) {
+                maxPixelSize = thumbnailSize.width;
+            } else {
+                maxPixelSize = thumbnailSize.height;
+            }
+        } else {
+            maxPixelSize = MAX(thumbnailSize.width, thumbnailSize.height);
+        }
+        thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = @(maxPixelSize);
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
         imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)thumbnailOptions);
         if (preserveAspectRatio) {
             // kCGImageSourceCreateThumbnailWithTransform will apply EXIF transform as well, we should not apply twice
             exifOrientation = kCGImagePropertyOrientationUp;
+        } else {
+            // `CGImageSourceCreateThumbnailAtIndex` take only pixel dimension, if not `preserveAspectRatio`, we should manual scale to the target size
+            if (imageRef) {
+                CGImageRef scaledImageRef = [SDImageCoderHelper CGImageCreateScaled:imageRef size:thumbnailSize];
+                CGImageRelease(imageRef);
+                imageRef = scaledImageRef;
+            }
         }
     }
     if (!imageRef) {
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 1e871ac0..bd4d4e68 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -228,6 +228,7 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageP
 
 /**
  A CGSize raw value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.imagePreserveAspectRatio`) the value size.
+ @note When you pass `.preserveAspectRatio == NO`, the thumbnail image is stretched to match each dimension. When `.preserveAspectRatio == YES`, the thumbnail image's width is limited to pixel size's width, the thumbnail image's height is limited to pixel size's height. For common cases, you can just pass a square size to limit both.
  Defaults to CGSizeZero, which means no thumbnail generation at all. (NSValue)
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageThumbnailPixelSize;
diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 88a02fdf..e81f5373 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -199,14 +199,42 @@ withLocalImageURL:(NSURL *)imageUrl
 #endif
     }
     
+    // 3 - check thumbnail decoding
+    CGFloat pixelWidth = inputImage.size.width;
+    CGFloat pixelHeight = inputImage.size.height;
+    expect(pixelWidth).beGreaterThan(0);
+    expect(pixelHeight).beGreaterThan(0);
+    // check thumnail with scratch
+    UIImage *thumbImage = [coder decodedImageWithData:inputImageData options:@{
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(100, 100)),
+        SDImageCoderDecodePreserveAspectRatio : @(NO)
+    }];
+    expect(thumbImage).toNot.beNil();
+    expect(thumbImage.size).equal(CGSizeMake(100, 100));
+    // check thumnail with aspect ratio limit
+    thumbImage = [coder decodedImageWithData:inputImageData options:@{
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(100, 100)),
+        SDImageCoderDecodePreserveAspectRatio : @(YES)
+    }];
+    expect(thumbImage).toNot.beNil();
+    CGFloat ratio = pixelWidth / pixelHeight;
+    CGSize thumbnailPixelSize;
+    if (pixelWidth > pixelHeight) {
+        thumbnailPixelSize = CGSizeMake(100, floor(100 / ratio));
+    } else {
+        thumbnailPixelSize = CGSizeMake(floor(100 * ratio), 100);
+    }
+    expect(thumbImage.size).equal(thumbnailPixelSize);
+    
+    
     if (supportsEncoding) {
-        // 3 - check if we can encode to the original format
+        // 4 - check if we can encode to the original format
         if (encodingFormat == SDImageFormatUndefined) {
             encodingFormat = inputImageFormat;
         }
         expect([coder canEncodeToFormat:encodingFormat]).to.beTruthy();
         
-        // 4 - encode from UIImage to NSData using the inputImageFormat and check it
+        // 5 - encode from UIImage to NSData using the inputImageFormat and check it
         NSData *outputImageData = [coder encodedDataWithImage:inputImage format:encodingFormat options:nil];
         expect(outputImageData).toNot.beNil();
         UIImage *outputImage = [coder decodedImageWithData:outputImageData options:nil];

From cd1ae56f5f246cc851992a3119ced8e5f3d26ec1 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 19:28:39 +0800
Subject: [PATCH 074/181] Add one test case to ensure the
 `SDWebImageScaleDownLargeImages` is translated to thumbnail decoding

---
 Tests/Tests/SDWebImageManagerTests.m | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index 143dc504..c75fc950 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -247,6 +247,27 @@
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)test13ThatScaleDownLargeImageUseThumbnailDecoding {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"SDWebImageScaleDownLargeImages should translate to thumbnail decoding"];
+    NSURL *originalImageURL = [NSURL URLWithString:@"http://via.placeholder.com/3999x3999.png"]; // Max size for this API
+    NSUInteger defaultLimitBytes = SDImageCoderHelper.defaultScaleDownLimitBytes;
+    SDImageCoderHelper.defaultScaleDownLimitBytes = 1000 * 1000 * 4; // Limit 1000x1000 pixel
+    // From v5.5.0, the `SDWebImageScaleDownLargeImages` translate to `SDWebImageContextImageThumbnailPixelSize`, and works for progressive loading
+    [SDWebImageManager.sharedManager loadImageWithURL:originalImageURL options:SDWebImageScaleDownLargeImages | SDWebImageProgressiveLoad progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
+        expect(image).notTo.beNil();
+        expect(image.size).equal(CGSizeMake(1000, 1000));
+        if (finished) {
+            [expectation fulfill];
+        } else {
+            expect(image.sd_isIncremental).beTruthy();
+        }
+    }];
+    
+    [self waitForExpectationsWithCommonTimeoutUsingHandler:^(NSError * _Nullable error) {
+        SDImageCoderHelper.defaultScaleDownLimitBytes = defaultLimitBytes;
+    }];
+}
+
 - (NSString *)testJPEGPath {
     NSBundle *testBundle = [NSBundle bundleForClass:[self class]];
     return [testBundle pathForResource:@"TestImage" ofType:@"jpg"];

From d29dfda82a90981b630e1e30f862d21f6596998f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 19:30:17 +0800
Subject: [PATCH 075/181] Update the Example to use thumbnail decoding

---
 Examples/SDWebImage Demo/MasterViewController.m | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index 3a6c1780..d05b3c6d 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -115,7 +115,8 @@
     cell.customTextLabel.text = [NSString stringWithFormat:@"Image #%ld", (long)indexPath.row];
     [cell.customImageView sd_setImageWithURL:[NSURL URLWithString:self.objects[indexPath.row]]
                             placeholderImage:placeholderImage
-                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0];
+                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0
+                                     context:@{SDWebImageContextImageThumbnailPixelSize : @(CGSizeMake(100, 100))}];
     return cell;
 }
 

From 767ea255251a46ea9a6b01123531c9e40cfe1c3f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 19:44:35 +0800
Subject: [PATCH 076/181] Revert the example to use thumbnail

---
 Examples/SDWebImage Demo/MasterViewController.m | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index d05b3c6d..3a6c1780 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -115,8 +115,7 @@
     cell.customTextLabel.text = [NSString stringWithFormat:@"Image #%ld", (long)indexPath.row];
     [cell.customImageView sd_setImageWithURL:[NSURL URLWithString:self.objects[indexPath.row]]
                             placeholderImage:placeholderImage
-                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0
-                                     context:@{SDWebImageContextImageThumbnailPixelSize : @(CGSizeMake(100, 100))}];
+                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0];
     return cell;
 }
 

From 2e629f6c4637c93575e31877dfef3a76e3fc742e Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 19:46:37 +0800
Subject: [PATCH 077/181] Fix the issue that preserveAspectRatio default value,
 now it's YES

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 6 +++---
 SDWebImage/Core/SDImageIOCoder.m         | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 2f771455..5ba86f9c 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -228,7 +228,7 @@
 #endif
     }
     
-    BOOL preserveAspectRatio = NO;
+    BOOL preserveAspectRatio = YES;
     NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
     if (preserveAspectRatioValue != nil) {
         preserveAspectRatio = preserveAspectRatioValue.boolValue;
@@ -310,7 +310,7 @@
     #endif
         }
         _thumbnailSize = thumbnailSize;
-        BOOL preserveAspectRatio = NO;
+        BOOL preserveAspectRatio = YES;
         NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
         if (preserveAspectRatioValue != nil) {
             preserveAspectRatio = preserveAspectRatioValue.boolValue;
@@ -464,7 +464,7 @@
     #endif
         }
         _thumbnailSize = thumbnailSize;
-        BOOL preserveAspectRatio = NO;
+        BOOL preserveAspectRatio = YES;
         NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
         if (preserveAspectRatioValue != nil) {
             preserveAspectRatio = preserveAspectRatioValue.boolValue;
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index f5223887..f617f437 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -87,7 +87,7 @@
 #endif
     }
     
-    BOOL preserveAspectRatio = NO;
+    BOOL preserveAspectRatio = YES;
     NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
     if (preserveAspectRatioValue != nil) {
         preserveAspectRatio = preserveAspectRatioValue.boolValue;
@@ -134,7 +134,7 @@
     #endif
         }
         _thumbnailSize = thumbnailSize;
-        BOOL preserveAspectRatio = NO;
+        BOOL preserveAspectRatio = YES;
         NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
         if (preserveAspectRatioValue != nil) {
             preserveAspectRatio = preserveAspectRatioValue.boolValue;

From 72250f218233b925787175bcc31b557046219817 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 22:33:05 +0800
Subject: [PATCH 078/181] Fix the test case again

---
 Tests/Tests/SDImageCoderTests.m | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index e81f5373..96411f79 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -206,23 +206,23 @@ withLocalImageURL:(NSURL *)imageUrl
     expect(pixelHeight).beGreaterThan(0);
     // check thumnail with scratch
     UIImage *thumbImage = [coder decodedImageWithData:inputImageData options:@{
-        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(100, 100)),
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(50, 50)),
         SDImageCoderDecodePreserveAspectRatio : @(NO)
     }];
     expect(thumbImage).toNot.beNil();
-    expect(thumbImage.size).equal(CGSizeMake(100, 100));
+    expect(thumbImage.size).equal(CGSizeMake(50, 50));
     // check thumnail with aspect ratio limit
     thumbImage = [coder decodedImageWithData:inputImageData options:@{
-        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(100, 100)),
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(50, 50)),
         SDImageCoderDecodePreserveAspectRatio : @(YES)
     }];
     expect(thumbImage).toNot.beNil();
     CGFloat ratio = pixelWidth / pixelHeight;
     CGSize thumbnailPixelSize;
     if (pixelWidth > pixelHeight) {
-        thumbnailPixelSize = CGSizeMake(100, floor(100 / ratio));
+        thumbnailPixelSize = CGSizeMake(50, floor(50 / ratio));
     } else {
-        thumbnailPixelSize = CGSizeMake(floor(100 * ratio), 100);
+        thumbnailPixelSize = CGSizeMake(floor(50 * ratio), 50);
     }
     expect(thumbImage.size).equal(thumbnailPixelSize);
     

From f376b5da9a5a4d565c994582311aa65974a96fdb Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 23:34:55 +0800
Subject: [PATCH 079/181] Fix the behavior of limit width and height for
 thumbnail pixel size, should not be greater than the size

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 5ba86f9c..b72dc4e0 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -159,14 +159,16 @@
     }
     
     CGImageRef imageRef;
-    if (CGSizeEqualToSize(thumbnailSize, CGSizeZero) || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
+    if (thumbnailSize.width == 0 || thumbnailSize.height == 0 || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
         imageRef = CGImageSourceCreateImageAtIndex(source, index, NULL);
     } else {
         NSMutableDictionary *thumbnailOptions = [NSMutableDictionary dictionary];
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
         CGFloat maxPixelSize;
         if (preserveAspectRatio) {
-            if (pixelWidth > pixelHeight) {
+            CGFloat pixelRatio = pixelWidth / pixelHeight;
+            CGFloat thumbnailRatio = thumbnailSize.width / thumbnailSize.height;
+            if (pixelRatio > thumbnailRatio) {
                 maxPixelSize = thumbnailSize.width;
             } else {
                 maxPixelSize = thumbnailSize.height;
@@ -237,7 +239,7 @@
 #if SD_MAC
     // If don't use thumbnail, prefers the built-in generation of frames (GIF/APNG)
     // Which decode frames in time and reduce memory usage
-    if (CGSizeEqualToSize(thumbnailSize, CGSizeZero)) {
+    if (thumbnailSize.width == 0 || thumbnailSize.height == 0) {
         SDAnimatedImageRep *imageRep = [[SDAnimatedImageRep alloc] initWithData:data];
         NSSize size = NSMakeSize(imageRep.pixelsWide / scale, imageRep.pixelsHigh / scale);
         imageRep.size = size;

From 150ad1b104ee6e830489cfb22cead5ba5012e5b8 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Jan 2020 23:35:43 +0800
Subject: [PATCH 080/181] Apply a `Thumbnail-` prefix for the cache key for all
 the thumbnail images, this can avoid cache issue when you query the same URL
 with different thumbnail size

---
 .../SDWebImage Demo/MasterViewController.m    |  3 +-
 SDWebImage/Core/SDWebImageManager.m           | 49 ++++++++++++++-----
 2 files changed, 38 insertions(+), 14 deletions(-)

diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index 3a6c1780..f131f55f 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -115,7 +115,8 @@
     cell.customTextLabel.text = [NSString stringWithFormat:@"Image #%ld", (long)indexPath.row];
     [cell.customImageView sd_setImageWithURL:[NSURL URLWithString:self.objects[indexPath.row]]
                             placeholderImage:placeholderImage
-                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0];
+                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0
+                                     context:@{SDWebImageContextImageThumbnailPixelSize : @(CGSizeMake(180, 120))}];
     return cell;
 }
 
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 61c0a36c..97ffb488 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -95,19 +95,45 @@ static id<SDImageLoader> _defaultImageLoader;
 }
 
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url {
-    return [self cacheKeyForURL:url cacheKeyFilter:self.cacheKeyFilter];
+    return [self cacheKeyForURL:url context:nil];
 }
 
-- (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url cacheKeyFilter:(id<SDWebImageCacheKeyFilter>)cacheKeyFilter {
+- (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url context:(nullable SDWebImageContext *)context {
     if (!url) {
         return @"";
     }
-
-    if (cacheKeyFilter) {
-        return [cacheKeyFilter cacheKeyForURL:url];
-    } else {
-        return url.absoluteString;
+    
+    NSString *key;
+    // Cache Key Filter
+    id<SDWebImageCacheKeyFilter> cacheKeyFilter = self.cacheKeyFilter;
+    if (context[SDWebImageContextCacheKeyFilter]) {
+        cacheKeyFilter = context[SDWebImageContextCacheKeyFilter];
     }
+    if (cacheKeyFilter) {
+        key = [cacheKeyFilter cacheKeyForURL:url];
+    } else {
+        key = url.absoluteString;
+    }
+    // Thumbnail Key Appending
+    NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
+    if (thumbnailSizeValue != nil) {
+        CGSize thumbnailSize = CGSizeZero;
+#if SD_MAC
+        thumbnailSize = thumbnailSizeValue.sizeValue;
+#else
+        thumbnailSize = thumbnailSizeValue.CGSizeValue;
+#endif
+        
+        BOOL preserveAspectRatio = YES;
+        NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
+        if (preserveAspectRatioValue != nil) {
+            preserveAspectRatio = preserveAspectRatioValue.boolValue;
+        }
+        NSString *transformerKey = [NSString stringWithFormat:@"Thumbnail({%f,%f},%d)", thumbnailSize.width, thumbnailSize.height, preserveAspectRatio];
+        key = SDTransformedKeyForKey(key, transformerKey);
+    }
+    
+    return key;
 }
 
 - (SDWebImageCombinedOperation *)loadImageWithURL:(NSURL *)url options:(SDWebImageOptions)options progress:(SDImageLoaderProgressBlock)progressBlock completed:(SDInternalCompletionBlock)completedBlock {
@@ -188,8 +214,7 @@ static id<SDImageLoader> _defaultImageLoader;
     // Check whether we should query cache
     BOOL shouldQueryCache = !SD_OPTIONS_CONTAINS(options, SDWebImageFromLoaderOnly);
     if (shouldQueryCache) {
-        id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter];
-        NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
+        NSString *key = [self cacheKeyForURL:url context:context];
         @weakify(operation);
         operation.cacheOperation = [self.imageCache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable cachedImage, NSData * _Nullable cachedData, SDImageCacheType cacheType) {
             @strongify(operation);
@@ -303,8 +328,7 @@ static id<SDImageLoader> _defaultImageLoader;
     if (context[SDWebImageContextOriginalStoreCacheType]) {
         originalStoreCacheType = [context[SDWebImageContextOriginalStoreCacheType] integerValue];
     }
-    id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter];
-    NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
+    NSString *key = [self cacheKeyForURL:url context:context];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
     
@@ -353,8 +377,7 @@ static id<SDImageLoader> _defaultImageLoader;
     if (context[SDWebImageContextStoreCacheType]) {
         storeCacheType = [context[SDWebImageContextStoreCacheType] integerValue];
     }
-    id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter];
-    NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
+    NSString *key = [self cacheKeyForURL:url context:context];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
     BOOL shouldTransformImage = originalImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage)) && transformer;

From 7a8407d0be077fad363970a9f0faee85bd00dc0d Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 13 Jan 2020 22:02:52 +0800
Subject: [PATCH 081/181] Fix the test case again because of the behavior
 changes for aspect ratio rect limit

---
 Tests/Tests/SDImageCoderTests.m | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 96411f79..23dc6d56 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -205,26 +205,31 @@ withLocalImageURL:(NSURL *)imageUrl
     expect(pixelWidth).beGreaterThan(0);
     expect(pixelHeight).beGreaterThan(0);
     // check thumnail with scratch
+    CGFloat thumbnailWidth = 50;
+    CGFloat thumbnailHeight = 50;
     UIImage *thumbImage = [coder decodedImageWithData:inputImageData options:@{
-        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(50, 50)),
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(thumbnailWidth, thumbnailHeight)),
         SDImageCoderDecodePreserveAspectRatio : @(NO)
     }];
     expect(thumbImage).toNot.beNil();
-    expect(thumbImage.size).equal(CGSizeMake(50, 50));
+    expect(thumbImage.size).equal(CGSizeMake(thumbnailWidth, thumbnailHeight));
     // check thumnail with aspect ratio limit
     thumbImage = [coder decodedImageWithData:inputImageData options:@{
-        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(50, 50)),
+        SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(thumbnailWidth, thumbnailHeight)),
         SDImageCoderDecodePreserveAspectRatio : @(YES)
     }];
     expect(thumbImage).toNot.beNil();
     CGFloat ratio = pixelWidth / pixelHeight;
+    CGFloat thumbnailRatio = thumbnailWidth / thumbnailHeight;
     CGSize thumbnailPixelSize;
-    if (pixelWidth > pixelHeight) {
-        thumbnailPixelSize = CGSizeMake(50, floor(50 / ratio));
+    if (ratio > thumbnailRatio) {
+        thumbnailPixelSize = CGSizeMake(thumbnailWidth, round(thumbnailWidth / ratio));
     } else {
-        thumbnailPixelSize = CGSizeMake(floor(50 * ratio), 50);
+        thumbnailPixelSize = CGSizeMake(round(thumbnailHeight * ratio), thumbnailHeight);
     }
-    expect(thumbImage.size).equal(thumbnailPixelSize);
+    // Image/IO's thumbnail API does not always use round to preserve precision, we check ABS <= 1
+    expect(ABS(thumbImage.size.width - thumbnailPixelSize.width) <= 1);
+    expect(ABS(thumbImage.size.height - thumbnailPixelSize.height) <= 1);
     
     
     if (supportsEncoding) {

From 7e3482d4fc43e63116254b98f4f49dec34f94266 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 15 Jan 2020 11:56:19 +0800
Subject: [PATCH 082/181] Fix the issue of `CGImageCreateScaled`, which should
 use BGRX8888 on non-alpha image, BGRA8888 on alpha image

---
 SDWebImage/Core/SDImageCoderHelper.m | 7 +++++--
 SDWebImage/Core/UIImage+Transform.m  | 2 +-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index de3d0cfc..c29685a9 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -293,12 +293,15 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
         if (input_buffer.data) free(input_buffer.data);
         if (output_buffer.data) free(output_buffer.data);
     };
-    
+    BOOL hasAlpha = [self CGImageContainsAlpha:cgImage];
+    // iOS display alpha info (BGRA8888/BGRX8888)
+    CGBitmapInfo bitmapInfo = kCGBitmapByteOrder32Host;
+    bitmapInfo |= hasAlpha ? kCGImageAlphaPremultipliedFirst : kCGImageAlphaNoneSkipFirst;
     vImage_CGImageFormat format = (vImage_CGImageFormat) {
         .bitsPerComponent = 8,
         .bitsPerPixel = 32,
         .colorSpace = NULL,
-        .bitmapInfo = kCGImageAlphaFirst | kCGBitmapByteOrderDefault,
+        .bitmapInfo = bitmapInfo,
         .version = 0,
         .decode = NULL,
         .renderingIntent = kCGRenderingIntentDefault,
diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 53fc334c..b1c3fc13 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -606,7 +606,7 @@ static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull
         .bitsPerComponent = 8,
         .bitsPerPixel = 32,
         .colorSpace = NULL,
-        .bitmapInfo = kCGImageAlphaPremultipliedFirst | kCGBitmapByteOrder32Little, //requests a BGRA buffer.
+        .bitmapInfo = kCGImageAlphaPremultipliedFirst | kCGBitmapByteOrder32Host, //requests a BGRA buffer.
         .version = 0,
         .decode = NULL,
         .renderingIntent = kCGRenderingIntentDefault

From e376dad5f61f6f44620bf6d98885323883a96735 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 15 Jan 2020 12:34:57 +0800
Subject: [PATCH 083/181] Update some wrong code comments

---
 SDWebImage/Core/SDAnimatedImage.m   | 2 +-
 SDWebImage/Core/UIImage+Transform.m | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDAnimatedImage.m b/SDWebImage/Core/SDAnimatedImage.m
index 422d6578..ce5d5d29 100644
--- a/SDWebImage/Core/SDAnimatedImage.m
+++ b/SDWebImage/Core/SDAnimatedImage.m
@@ -237,7 +237,7 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
     return YES;
 }
 
-#pragma mark - SDAnimatedImage
+#pragma mark - SDAnimatedImageProvider
 
 - (NSData *)animatedImageData {
     return [self.animatedCoder animatedImageData];
diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index b1c3fc13..469e6949 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -559,7 +559,7 @@ static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull
 
 #pragma mark - Image Effect
 
-// We use vImage to do box convolve for performance and support for watchOS. However, you can just use `CIFilter.CIBoxBlur`. For other blur effect, use any filter in `CICategoryBlur`
+// We use vImage to do box convolve for performance and support for watchOS. However, you can just use `CIFilter.CIGaussianBlur`. For other blur effect, use any filter in `CICategoryBlur`
 - (nullable UIImage *)sd_blurredImageWithRadius:(CGFloat)blurRadius {
     if (self.size.width < 1 || self.size.height < 1) {
         return nil;

From b8b7438ce97eb5983d92e75c4b4820a623601c12 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 15 Jan 2020 21:35:15 +0800
Subject: [PATCH 084/181] Fix the wrong behavior of current
 sd_blurredImageWithRadius, which calculate the wrong box size for consolve

---
 SDWebImage/Core/UIImage+Transform.m   | 9 ++++-----
 Tests/Tests/SDImageTransformerTests.m | 2 +-
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index 469e6949..a01cf12a 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -569,12 +569,13 @@ static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull
         return self;
     }
     
+    CGFloat scale = self.scale;
+    CGFloat inputRadius = blurRadius * scale;
 #if SD_UIKIT || SD_MAC
     if (self.CIImage) {
         CIFilter *filter = [CIFilter filterWithName:@"CIGaussianBlur"];
         [filter setValue:self.CIImage forKey:kCIInputImageKey];
-        // Blur Radius use pixel count
-        [filter setValue:@(blurRadius / 2) forKey:kCIInputRadiusKey];
+        [filter setValue:@(inputRadius) forKey:kCIInputRadiusKey];
         CIImage *ciImage = filter.outputImage;
         ciImage = [ciImage imageByCroppingToRect:CGRectMake(0, 0, self.size.width, self.size.height)];
 #if SD_UIKIT
@@ -586,7 +587,6 @@ static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull
     }
 #endif
     
-    CGFloat scale = self.scale;
     CGImageRef imageRef = self.CGImage;
     
     //convert to BGRA if it isn't
@@ -640,9 +640,8 @@ static inline CGImageRef _Nullable SDCreateCGImageFromCIImage(CIImage * _Nonnull
         //
         // ... if d is odd, use three box-blurs of size 'd', centered on the output pixel.
         //
-        CGFloat inputRadius = blurRadius * scale;
         if (inputRadius - 2.0 < __FLT_EPSILON__) inputRadius = 2.0;
-        uint32_t radius = floor((inputRadius * 3.0 * sqrt(2 * M_PI) / 4 + 0.5) / 2);
+        uint32_t radius = floor(inputRadius * 3.0 * sqrt(2 * M_PI) / 4 + 0.5);
         radius |= 1; // force radius to be odd so that the three box-blur methodology works.
         int iterations;
         if (blurRadius * scale < 0.5) iterations = 1;
diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index 9bc28ea5..18ab60ac 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -172,7 +172,7 @@
 }
 
 - (void)test07UIImageTransformBlurWithImage:(UIImage *)testImage {
-    CGFloat radius = 50;
+    CGFloat radius = 25;
     UIImage *blurredImage = [testImage sd_blurredImageWithRadius:radius];
     expect(CGSizeEqualToSize(blurredImage.size, testImage.size)).beTruthy();
     // Check left color, should be blurred

From 3ed7d74e09b8d1ad6c82e0d4527c4e772d0a42c5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 16 Jan 2020 19:03:04 +0800
Subject: [PATCH 085/181] Update the readme about thumbnail decoding

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f18658fb..99e9dc0a 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,9 @@ This library provides an async image downloader with cache support. For convenie
 - [x] Categories for `UIImageView`, `UIButton`, `MKAnnotationView` adding web image and cache management
 - [x] An asynchronous image downloader
 - [x] An asynchronous memory + disk image caching with automatic cache expiration handling
-- [x] A background image decompression
+- [x] A background image decompression to avoid frame rate drop
 - [x] Progressive image loading (including animated image, like GIF showing in Web browser)
+- [x] [Thumbnail image decoding](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#thumbnail-decoding-550) to save CPU && Memory for large images
 - [x] [Extendable image coder](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#custom-coder-420) to support massive image format, like WebP
 - [x] [Full-stack solution for animated images](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-image-50) which keep a balance between CPU && Memory
 - [x] [Customizable and composable transformations](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#transformer-50) can be applied to the images right after download

From 966e6c3ee4569227ce67434d890bb22073ead2d6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 16 Jan 2020 19:22:07 +0800
Subject: [PATCH 086/181] Bumped version to 5.5.0

Update the CHANGELOG
---
 CHANGELOG.md        | 25 +++++++++++++++++++++++++
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7f82b05c..5d84a58f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,28 @@
+## [5.5.0 - Thumbnail Decoding && Core Image, onJan, 16th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.0)
+See [all tickets marked for the 5.5.0 release](https://github.com/SDWebImage/SDWebImage/milestone/55)
+
+### Features
+
+#### Thumbnail Decoding
+- Supports to load the large web image with thumbnail, control the limit size and aspect ratio #2922 #2810
+- Better than resize transformer, which does not allocate full pixel RAM and faster on CPU. If you've already use transformer to generate thumbnail, you'd better have a try
+- Works for both animated images and progressive images, each frame using the thumbnail decoding
+- Applies for Vector Format like SVG/PDF as well, see more in [Coder Plugin List](https://github.com/SDWebImage/SDWebImage/wiki/Coder-Plugin-List)
+
+#### Core Image
+- Support all transformer method on CIImage based UIImage/NSImage #2918
+- For CIImage based UIImage/NSImage, using the CIFilter to take shortcut, which is faster and lazy (rasterize on demand)
+
+#### Cache
+- Support to use the creation date and the change date to determine the disk cache expire date compare #2915
+
+### Performances
+- Using UIGraphicsImageRenderer on iOS 10+, save memory when image bitmap is RGB(-25%) or Grayscale(-75%) #2907
+- Provide the polyfill APIs for firmware iOS 10- and macOS. If you already use `SDGraphicsBeginImageContext` for drawing, you'd better replace that instead.
+
+### Fixes
+- Fix Gaussian Blur's bug which take half of the blur radius compared to the standard, should match Core Image's behavior #2927
+
 ## [5.4.2 - 5.4 Patch, on Jan 7th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.4.2)
 See [all tickets marked for the 5.4.2 release](https://github.com/SDWebImage/SDWebImage/milestone/58)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 446b443a..990ab9ab 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.4.2'
+  s.version = '5.5.0'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index d243db93..e1f66d4e 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.4.2</string>
+	<string>5.5.0</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.4.2</string>
+	<string>5.5.0</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 649665e1b0f41c4bc7de7cf945d88763c3106ebf Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 18 Jan 2020 14:58:52 +0800
Subject: [PATCH 087/181] Fix the SDAnimatedImageView's progressive animation
 bug, which reset the frame index to 0 each time new frames available

---
 SDWebImage/Core/SDAnimatedImageView.m | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index 78f1cb8b..efd2362d 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -169,7 +169,7 @@
             self.currentLoopCount = loopCount;
             // Progressive image reach the current last frame index. Keep the state and pause animating. Wait for later restart
             if (self.isProgressive) {
-                NSUInteger lastFrameIndex = self.player.totalFrameCount;
+                NSUInteger lastFrameIndex = self.player.totalFrameCount - 1;
                 [self.player seekToFrameAtIndex:lastFrameIndex loopCount:0];
                 [self.player pausePlaying];
             }

From bce101d112772a7124571e905fe03e1675c801d5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 18 Jan 2020 15:38:02 +0800
Subject: [PATCH 088/181] The progressive animation should not update the loop
 count to 1 when automatically stopped at last index.

---
 SDWebImage/Core/SDAnimatedImageView.m | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index efd2362d..f0b811c4 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -166,12 +166,13 @@
         };
         self.player.animationLoopHandler = ^(NSUInteger loopCount) {
             @strongify(self);
-            self.currentLoopCount = loopCount;
             // Progressive image reach the current last frame index. Keep the state and pause animating. Wait for later restart
             if (self.isProgressive) {
                 NSUInteger lastFrameIndex = self.player.totalFrameCount - 1;
                 [self.player seekToFrameAtIndex:lastFrameIndex loopCount:0];
                 [self.player pausePlaying];
+            } else {
+                self.currentLoopCount = loopCount;
             }
         };
         

From cde0e48a6d11a909fc3bd8fa536290f149069996 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 18 Jan 2020 16:46:00 +0800
Subject: [PATCH 089/181] Add one progressive animation test case to avoid this
 regression bug in the future

---
 Tests/Tests/SDAnimatedImageTest.m | 71 +++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/Tests/Tests/SDAnimatedImageTest.m b/Tests/Tests/SDAnimatedImageTest.m
index b3fb53f2..0640e3dc 100644
--- a/Tests/Tests/SDAnimatedImageTest.m
+++ b/Tests/Tests/SDAnimatedImageTest.m
@@ -8,6 +8,7 @@
  */
 
 #import "SDTestCase.h"
+#import "SDInternalMacros.h"
 #import <KVOController/KVOController.h>
 
 static const NSUInteger kTestGIFFrameCount = 5; // local TestImage.gif loop count
@@ -397,6 +398,76 @@ static const NSUInteger kTestGIFFrameCount = 5; // local TestImage.gif loop coun
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)test27AnimatedImageProgressiveAnimation {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"test SDAnimatedImageView progressive animation rendering"];
+    
+    // Simulate progressive download
+    NSData *fullData = [self testAPNGPData];
+    NSUInteger length = fullData.length;
+    
+    SDAnimatedImageView *imageView = [SDAnimatedImageView new];
+#if SD_UIKIT
+    [self.window addSubview:imageView];
+#else
+    [self.window.contentView addSubview:imageView];
+#endif
+    
+    __block NSUInteger previousFrameIndex = 0;
+    @weakify(imageView);
+    // Observe to check rendering behavior using frame index
+    [self.KVOController observe:imageView keyPath:NSStringFromSelector(@selector(currentFrameIndex)) options:NSKeyValueObservingOptionNew block:^(id  _Nullable observer, id  _Nonnull object, NSDictionary<NSString *,id> * _Nonnull change) {
+        @strongify(imageView);
+        NSUInteger currentFrameIndex = [change[NSKeyValueChangeNewKey] unsignedIntegerValue];
+        printf("Animation Frame Index: %lu\n", (unsigned long)currentFrameIndex);
+        
+        // The last time should not be progressive
+        if (currentFrameIndex == 0 && !imageView.isProgressive) {
+            [self.KVOController unobserve:imageView];
+            [expectation fulfill];
+        } else {
+            // Each progressive rendering should render new frame index, no backward and should stop at last frame index
+            expect(currentFrameIndex - previousFrameIndex).beGreaterThanOrEqualTo(0);
+            previousFrameIndex = currentFrameIndex;
+        }
+    }];
+    
+    SDImageAPNGCoder *coder = [[SDImageAPNGCoder alloc] initIncrementalWithOptions:nil];
+    // Setup Data
+    NSData *setupData = [fullData subdataWithRange:NSMakeRange(0, length / 3.0)];
+    [coder updateIncrementalData:setupData finished:NO];
+    imageView.shouldIncrementalLoad = YES;
+    __block SDAnimatedImage *progressiveImage = [[SDAnimatedImage alloc] initWithAnimatedCoder:coder scale:1];
+    progressiveImage.sd_isIncremental = YES;
+    imageView.image = progressiveImage;
+    expect(imageView.isProgressive).beTruthy();
+    
+    __block NSUInteger partialFrameCount;
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
+        // Partial Data
+        NSData *partialData = [fullData subdataWithRange:NSMakeRange(0, length * 2.0 / 3.0)];
+        [coder updateIncrementalData:partialData finished:NO];
+        partialFrameCount = [coder animatedImageFrameCount];
+        expect(partialFrameCount).beGreaterThan(1);
+        progressiveImage = [[SDAnimatedImage alloc] initWithAnimatedCoder:coder scale:1];
+        progressiveImage.sd_isIncremental = YES;
+        imageView.image = progressiveImage;
+        expect(imageView.isProgressive).beTruthy();
+    });
+    
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(4 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
+        // Full Data
+        [coder updateIncrementalData:fullData finished:YES];
+        progressiveImage = [[SDAnimatedImage alloc] initWithAnimatedCoder:coder scale:1];
+        progressiveImage.sd_isIncremental = NO;
+        imageView.image = progressiveImage;
+        NSUInteger fullFrameCount = [coder animatedImageFrameCount];
+        expect(fullFrameCount).beGreaterThan(partialFrameCount);
+        expect(imageView.isProgressive).beFalsy();
+    });
+    
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 #pragma mark - Helper
 - (UIWindow *)window {
     if (!_window) {

From bfa6314732e7fc7817605de44cec1092229bedc5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 18 Jan 2020 20:01:45 +0800
Subject: [PATCH 090/181] Update the readme with progressive loading wiki link

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 99e9dc0a..58c85e8b 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ This library provides an async image downloader with cache support. For convenie
 - [x] An asynchronous image downloader
 - [x] An asynchronous memory + disk image caching with automatic cache expiration handling
 - [x] A background image decompression to avoid frame rate drop
-- [x] Progressive image loading (including animated image, like GIF showing in Web browser)
+- [x] [Progressive image loading](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#progressive-animation) (including animated image, like GIF showing in Web browser)
 - [x] [Thumbnail image decoding](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#thumbnail-decoding-550) to save CPU && Memory for large images
 - [x] [Extendable image coder](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#custom-coder-420) to support massive image format, like WebP
 - [x] [Full-stack solution for animated images](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-image-50) which keep a balance between CPU && Memory

From 443bf50b58c0161efe7a6da841524dde1815792d Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 18 Jan 2020 20:17:05 +0800
Subject: [PATCH 091/181] Bumped version to 5.5.1

Update the CHANGELOG
---
 CHANGELOG.md        | 18 ++++++++++++++++++
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d84a58f..ea0ad1d5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.5.1 - 5.0 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.1)
+See [all tickets marked for the 5.5.1 release](https://github.com/SDWebImage/SDWebImage/milestone/59)
+
+### Fixes
+- Fix the SDAnimatedImageView's progressive animation bug, which reset the frame index to 0 each time new frames available #2931
+
 ## [5.5.0 - Thumbnail Decoding && Core Image, onJan, 16th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.0)
 See [all tickets marked for the 5.5.0 release](https://github.com/SDWebImage/SDWebImage/milestone/55)
 
@@ -23,6 +29,12 @@ See [all tickets marked for the 5.5.0 release](https://github.com/SDWebImage/SDW
 ### Fixes
 - Fix Gaussian Blur's bug which take half of the blur radius compared to the standard, should match Core Image's behavior #2927
 
+## [5.4 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.4.3)
+See [all tickets marked for the 5.4.3 release](https://github.com/SDWebImage/SDWebImage/milestone/61)
+
+### Fixes
+- Fix the SDAnimatedImageView's progressive animation bug, which reset the frame index to 0 each time new frames available #2931
+
 ## [5.4.2 - 5.4 Patch, on Jan 7th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.4.2)
 See [all tickets marked for the 5.4.2 release](https://github.com/SDWebImage/SDWebImage/milestone/58)
 
@@ -51,6 +63,12 @@ See [all tickets marked for the 5.4.0 release](https://github.com/SDWebImage/SDW
 - Using one global function to ensure we always sync all the UIImage category associated object status correctly inside our framework #2902
 - Fix the thread safe issue with Downloader and DownloaderOperation during cancel #2903
 
+## [5.3 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.3.4)
+See [all tickets marked for the 5.3.4 release](https://github.com/SDWebImage/SDWebImage/milestone/60)
+
+### Fixes
+- Fix the SDAnimatedImageView's progressive animation bug, which reset the frame index to 0 each time new frames available #2931
+
 ## [5.3 Patch, on Dec 3rd, 2019](https://github.com/rs/SDWebImage/releases/tag/5.3.3)
 See [all tickets marked for the 5.3.3 release](https://github.com/SDWebImage/SDWebImage/milestone/54)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 990ab9ab..40b17178 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.5.0'
+  s.version = '5.5.1'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index e1f66d4e..80a6b573 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.5.0</string>
+	<string>5.5.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.5.0</string>
+	<string>5.5.1</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 25fe6e97f9ed3d2e578b2a0e1b428fdead522ec2 Mon Sep 17 00:00:00 2001
From: Ben Govero <ben.govero@gmail.com>
Date: Thu, 23 Jan 2020 17:53:14 -0600
Subject: [PATCH 092/181] Update docs to show correct arguments for
 SDInternalCompletionBlock

---
 SDWebImage/Core/SDWebImageManager.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageManager.h b/SDWebImage/Core/SDWebImageManager.h
index d1ab013e..d940f742 100644
--- a/SDWebImage/Core/SDWebImageManager.h
+++ b/SDWebImage/Core/SDWebImageManager.h
@@ -87,7 +87,7 @@ SDWebImageManager *manager = [SDWebImageManager sharedManager];
 [manager loadImageWithURL:imageURL
                   options:0
                  progress:nil
-                completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
+                completed:^(UIImage *image, NSData *data, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
                     if (image) {
                         // do something with image
                     }

From d565a3752930dcfc29a47e7b8daf666939d4f219 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 26 Jan 2020 18:05:39 +0800
Subject: [PATCH 093/181] Fix the issue that `maxBufferSize` property does not
 correctlly works for `SDAnimatedImageView`, should setup the player's
 property

---
 SDWebImage/Core/SDAnimatedImageView.m | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index f0b811c4..e9734383 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -19,6 +19,7 @@
 @interface SDAnimatedImageView () <CALayerDelegate> {
     BOOL _initFinished; // Extra flag to mark the `commonInit` is called
     NSRunLoopMode _runLoopMode;
+    NSUInteger _maxBufferSize;
     double _playbackRate;
 }
 
@@ -153,6 +154,9 @@
         // RunLoop Mode
         self.player.runLoopMode = self.runLoopMode;
         
+        // Max Buffer Size
+        self.player.maxBufferSize = self.maxBufferSize;
+        
         // Play Rate
         self.player.playbackRate = self.playbackRate;
         
@@ -207,6 +211,16 @@
     return [NSProcessInfo processInfo].activeProcessorCount > 1 ? NSRunLoopCommonModes : NSDefaultRunLoopMode;
 }
 
+- (void)setMaxBufferSize:(NSUInteger)maxBufferSize
+{
+    _maxBufferSize = maxBufferSize;
+    self.player.maxBufferSize = maxBufferSize;
+}
+
+- (NSUInteger)maxBufferSize {
+    return _maxBufferSize; // Defaults to 0
+}
+
 - (void)setPlaybackRate:(double)playbackRate
 {
     _playbackRate = playbackRate;

From aa7ff6f060d8f34d2c66a716aefff1a3bc9ef816 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 26 Jan 2020 20:20:32 +0800
Subject: [PATCH 094/181] Bumped version to 5.5.2

Update the CHANGELOG
---
 CHANGELOG.md        | 8 +++++++-
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ea0ad1d5..33987189 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,10 @@
-## [5.5.1 - 5.0 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.1)
+## [5.5.2 - 5.5 Patch, on Jan 26th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.2)
+See [all tickets marked for the 5.5.2 release](https://github.com/SDWebImage/SDWebImage/milestone/62)
+
+### Fixes
+- Fix the issue that `maxBufferSize` property does not correctlly works for `SDAnimatedImageView` #2934
+
+## [5.5.1 - 5.5 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.1)
 See [all tickets marked for the 5.5.1 release](https://github.com/SDWebImage/SDWebImage/milestone/59)
 
 ### Fixes
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 40b17178..0ae96891 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.5.1'
+  s.version = '5.5.2'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 80a6b573..7163374f 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.5.1</string>
+	<string>5.5.2</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.5.1</string>
+	<string>5.5.2</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From cb84dbb273de89ba6e984079097339a474a01c08 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 13:31:57 +0800
Subject: [PATCH 095/181] Added the PDF/SVG image type define

---
 SDWebImage/Core/NSData+ImageContentType.h |  2 ++
 SDWebImage/Core/NSData+ImageContentType.m | 10 ++++++++++
 2 files changed, 12 insertions(+)

diff --git a/SDWebImage/Core/NSData+ImageContentType.h b/SDWebImage/Core/NSData+ImageContentType.h
index 5bbb4ae6..8c2f97e8 100644
--- a/SDWebImage/Core/NSData+ImageContentType.h
+++ b/SDWebImage/Core/NSData+ImageContentType.h
@@ -23,6 +23,8 @@ static const SDImageFormat SDImageFormatTIFF      = 3;
 static const SDImageFormat SDImageFormatWebP      = 4;
 static const SDImageFormat SDImageFormatHEIC      = 5;
 static const SDImageFormat SDImageFormatHEIF      = 6;
+static const SDImageFormat SDImageFormatPDF       = 7;
+static const SDImageFormat SDImageFormatSVG       = 8;
 
 /**
  NSData category about the image content type and UTI.
diff --git a/SDWebImage/Core/NSData+ImageContentType.m b/SDWebImage/Core/NSData+ImageContentType.m
index 34dd4aa0..b3b8e22b 100644
--- a/SDWebImage/Core/NSData+ImageContentType.m
+++ b/SDWebImage/Core/NSData+ImageContentType.m
@@ -93,6 +93,12 @@
         case SDImageFormatHEIF:
             UTType = kSDUTTypeHEIF;
             break;
+        case SDImageFormatPDF:
+            UTType = kUTTypePDF;
+            break;
+        case SDImageFormatSVG:
+            UTType = kUTTypeScalableVectorGraphics;
+            break;
         default:
             // default is kUTTypePNG
             UTType = kUTTypePNG;
@@ -120,6 +126,10 @@
         imageFormat = SDImageFormatHEIC;
     } else if (CFStringCompare(uttype, kSDUTTypeHEIF, 0) == kCFCompareEqualTo) {
         imageFormat = SDImageFormatHEIF;
+    } else if (CFStringCompare(uttype, kUTTypePDF, 0) == kCFCompareEqualTo) {
+        imageFormat = SDImageFormatPDF;
+    } else if (CFStringCompare(uttype, kUTTypeScalableVectorGraphics, 0) == kCFCompareEqualTo) {
+        imageFormat = SDImageFormatSVG;
     } else {
         imageFormat = SDImageFormatUndefined;
     }

From 8ca455606655a9f57d9e315f91595eb9235107cf Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 13:50:53 +0800
Subject: [PATCH 096/181] Added the `sd_isVector` API on UIImage+Metadata,
 useful for case when we want to filter the vector/bitmap images. Vector
 currently only sipports PDF/SVG

---
 SDWebImage/Core/UIImage+Metadata.h | 10 +++++++-
 SDWebImage/Core/UIImage+Metadata.m | 41 +++++++++++++++++++++++++++---
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/SDWebImage/Core/UIImage+Metadata.h b/SDWebImage/Core/UIImage+Metadata.h
index e42ff697..8328c261 100644
--- a/SDWebImage/Core/UIImage+Metadata.h
+++ b/SDWebImage/Core/UIImage+Metadata.h
@@ -28,12 +28,20 @@
 
 /**
  * UIKit:
- * Check the `images` array property
+ * Check the `images` array property.
  * AppKit:
  * NSImage currently only support animated via GIF imageRep unlike UIImage. It will check the imageRep's frame count.
  */
 @property (nonatomic, assign, readonly) BOOL sd_isAnimated;
 
+/**
+ * UIKit:
+ * Check the `isSymbolImage` property. Also check the system PDF(iOS 11+) && SVG(iOS 13+) support.
+ * AppKit:
+ * NSImage supports PDF && SVG && EPS imageRep, check the imageRep class.
+ */
+@property (nonatomic, assign, readonly) BOOL sd_isVector;
+
 /**
  * The image format represent the original compressed image data format.
  * If you don't manually specify a format, this information is retrieve from CGImage using `CGImageGetUTType`, which may return nil for non-CG based image. At this time it will return `SDImageFormatUndefined` as default value.
diff --git a/SDWebImage/Core/UIImage+Metadata.m b/SDWebImage/Core/UIImage+Metadata.m
index 3c9bf929..ef63c41f 100644
--- a/SDWebImage/Core/UIImage+Metadata.m
+++ b/SDWebImage/Core/UIImage+Metadata.m
@@ -32,6 +32,26 @@
     return (self.images != nil);
 }
 
+- (BOOL)sd_isVector {
+    if (@available(iOS 13.0, tvOS 13.0, watchOS 6.0, *)) {
+        if (self.isSymbolImage) {
+            return YES;
+        }
+    }
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+    SEL SVGSelector = NSSelectorFromString(@"_CGSVGDocument");
+    if ([self respondsToSelector:SVGSelector] && [self performSelector:SVGSelector] != nil) {
+        return YES;
+    }
+    SEL PDFSelector = NSSelectorFromString(@"_CGPDFPage");
+    if ([self respondsToSelector:PDFSelector] && [self performSelector:PDFSelector] != nil) {
+        return YES;
+    }
+#pragma clang diagnostic pop
+    return NO;
+}
+
 #else
 
 - (NSUInteger)sd_imageLoopCount {
@@ -61,7 +81,7 @@
 }
 
 - (BOOL)sd_isAnimated {
-    BOOL isGIF = NO;
+    BOOL isAnimated = NO;
     NSRect imageRect = NSMakeRect(0, 0, self.size.width, self.size.height);
     NSImageRep *imageRep = [self bestRepresentationForRect:imageRect context:nil hints:nil];
     NSBitmapImageRep *bitmapImageRep;
@@ -70,9 +90,24 @@
     }
     if (bitmapImageRep) {
         NSUInteger frameCount = [[bitmapImageRep valueForProperty:NSImageFrameCount] unsignedIntegerValue];
-        isGIF = frameCount > 1 ? YES : NO;
+        isAnimated = frameCount > 1 ? YES : NO;
     }
-    return isGIF;
+    return isAnimated;
+}
+
+- (BOOL)sd_isVector {
+    NSRect imageRect = NSMakeRect(0, 0, self.size.width, self.size.height);
+    NSImageRep *imageRep = [self bestRepresentationForRect:imageRect context:nil hints:nil];
+    if ([imageRep isKindOfClass:[NSPDFImageRep class]]) {
+        return YES;
+    }
+    if ([imageRep isKindOfClass:[NSEPSImageRep class]]) {
+        return YES;
+    }
+    if ([NSStringFromClass(imageRep.class) hasSuffix:@"NSSVGImageRep"]) {
+        return YES;
+    }
+    return NO;
 }
 
 #endif

From 08aab785db3ac135e3e3e243bfd81518d75d738e Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 14:04:12 +0800
Subject: [PATCH 097/181] Added the case to detect PDF format from file
 signature

---
 SDWebImage/Core/NSData+ImageContentType.m | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/SDWebImage/Core/NSData+ImageContentType.m b/SDWebImage/Core/NSData+ImageContentType.m
index b3b8e22b..6bce90b5 100644
--- a/SDWebImage/Core/NSData+ImageContentType.m
+++ b/SDWebImage/Core/NSData+ImageContentType.m
@@ -65,6 +65,15 @@
             }
             break;
         }
+        case 0x25: {
+            if (data.length >= 4) {
+                //%PDF
+                NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(1, 4)] encoding:NSASCIIStringEncoding];
+                if ([testString isEqualToString:@"PDF"]) {
+                    return SDImageFormatPDF;
+                }
+            }
+        }
     }
     return SDImageFormatUndefined;
 }

From 96b0a2e0316111e0967ebe557fbb2e513f44cf45 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 15:11:42 +0800
Subject: [PATCH 098/181] Added the default ImageIO coder with PDF support, use
 the screen size if user does not provide any explict pixel size

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 50 ++++++++++++++++++------
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index b72dc4e0..1db7a495 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -14,6 +14,9 @@
 #import "SDAnimatedImageRep.h"
 #import "UIImage+ForceDecode.h"
 
+// Specify DPI for vector format in CGImageSource, like PDF
+static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizationDPI";
+
 @interface SDImageIOCoderFrame : NSObject
 
 @property (nonatomic, assign) NSUInteger index; // Frame index (zero based)
@@ -158,9 +161,33 @@
         exifOrientation = kCGImagePropertyOrientationUp;
     }
     
+    CFStringRef uttype = CGImageSourceGetType(source);
+    // Check vector format
+    BOOL isVector = NO;
+    if ([NSData sd_imageFormatFromUTType:uttype] == SDImageFormatPDF) {
+        isVector = YES;
+    }
+    
     CGImageRef imageRef;
-    if (thumbnailSize.width == 0 || thumbnailSize.height == 0 || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
-        imageRef = CGImageSourceCreateImageAtIndex(source, index, NULL);
+    if (thumbnailSize.width == 0 || thumbnailSize.height == 0 || pixelWidth == 0 || pixelHeight == 0 || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
+        NSDictionary *options;
+        if (isVector) {
+            if (thumbnailSize.width == 0 || thumbnailSize.height == 0) {
+                // Provide the default pixel count for vector images, simply just use the screen size
+#if SD_WATCH
+                thumbnailSize = WKInterfaceDevice.currentDevice.screenBounds.size;
+#elif SD_UIKIT
+                thumbnailSize = UIScreen.mainScreen.bounds.size;
+#elif SD_MAC
+                thumbnailSize = NSScreen.mainScreen.frame.size;
+#endif
+            }
+            CGFloat maxPixelSize = MAX(thumbnailSize.width, thumbnailSize.height);
+            NSUInteger DPIPerPixel = 2;
+            NSUInteger rasterizationDPI = maxPixelSize * DPIPerPixel;
+            options = @{kSDCGImageSourceRasterizationDPI : @(rasterizationDPI)};
+        }
+        imageRef = CGImageSourceCreateImageAtIndex(source, index, (__bridge CFDictionaryRef)options);
     } else {
         NSMutableDictionary *thumbnailOptions = [NSMutableDictionary dictionary];
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
@@ -179,21 +206,22 @@
         thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = @(maxPixelSize);
         thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
         imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)thumbnailOptions);
+    }
+    if (!imageRef) {
+        return nil;
+    }
+    
+    if (thumbnailSize.width > 0 && thumbnailSize.height > 0) {
         if (preserveAspectRatio) {
             // kCGImageSourceCreateThumbnailWithTransform will apply EXIF transform as well, we should not apply twice
             exifOrientation = kCGImagePropertyOrientationUp;
         } else {
             // `CGImageSourceCreateThumbnailAtIndex` take only pixel dimension, if not `preserveAspectRatio`, we should manual scale to the target size
-            if (imageRef) {
-                CGImageRef scaledImageRef = [SDImageCoderHelper CGImageCreateScaled:imageRef size:thumbnailSize];
-                CGImageRelease(imageRef);
-                imageRef = scaledImageRef;
-            }
+            CGImageRef scaledImageRef = [SDImageCoderHelper CGImageCreateScaled:imageRef size:thumbnailSize];
+            CGImageRelease(imageRef);
+            imageRef = scaledImageRef;
         }
     }
-    if (!imageRef) {
-        return nil;
-    }
     
 #if SD_UIKIT || SD_WATCH
     UIImageOrientation imageOrientation = [SDImageCoderHelper imageOrientationFromEXIFOrientation:exifOrientation];
@@ -363,7 +391,7 @@
         if (scaleFactor != nil) {
             scale = MAX([scaleFactor doubleValue], 1);
         }
-        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        image = [self.class createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
         if (image) {
             image.sd_imageFormat = self.class.imageFormat;
         }

From 8c6556e835386199af0cbf80b55a891bda92dbab Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 15:29:15 +0800
Subject: [PATCH 099/181] Fix the PDF data detection

---
 SDWebImage/Core/NSData+ImageContentType.m | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/NSData+ImageContentType.m b/SDWebImage/Core/NSData+ImageContentType.m
index 6bce90b5..4db1ff5b 100644
--- a/SDWebImage/Core/NSData+ImageContentType.m
+++ b/SDWebImage/Core/NSData+ImageContentType.m
@@ -68,7 +68,7 @@
         case 0x25: {
             if (data.length >= 4) {
                 //%PDF
-                NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(1, 4)] encoding:NSASCIIStringEncoding];
+                NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(1, 3)] encoding:NSASCIIStringEncoding];
                 if ([testString isEqualToString:@"PDF"]) {
                     return SDImageFormatPDF;
                 }

From eeec6de69840767bdff8fac6299d10b6fc469836 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 15:29:57 +0800
Subject: [PATCH 100/181] Update the PDF demo and test cases

---
 .../SDWebImage Demo/MasterViewController.m    |   1 +
 .../project.pbxproj                           |   8 +++++
 Tests/Tests/Images/TestImage.pdf              | Bin 0 -> 1018 bytes
 Tests/Tests/SDImageCoderTests.m               |  33 +++++++++++++++---
 4 files changed, 37 insertions(+), 5 deletions(-)
 create mode 100644 Tests/Tests/Images/TestImage.pdf

diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index f131f55f..b82b17c0 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -75,6 +75,7 @@
                     @"https://nokiatech.github.io/heif/content/images/ski_jump_1440x960.heic",
                     @"https://nokiatech.github.io/heif/content/image_sequences/starfield_animation.heic",
                     @"https://s2.ax1x.com/2019/11/01/KHYIgJ.gif",
+                    @"https://raw.githubusercontent.com/icons8/flat-color-icons/master/pdf/stack_of_photos.pdf",
                     @"https://nr-platform.s3.amazonaws.com/uploads/platform/published_extension/branding_icon/275/AmazonS3.png",
                     @"http://via.placeholder.com/200x200.jpg",
                     nil];
diff --git a/Tests/SDWebImage Tests.xcodeproj/project.pbxproj b/Tests/SDWebImage Tests.xcodeproj/project.pbxproj
index c98bbde1..ac80009d 100644
--- a/Tests/SDWebImage Tests.xcodeproj/project.pbxproj	
+++ b/Tests/SDWebImage Tests.xcodeproj/project.pbxproj	
@@ -14,6 +14,9 @@
 		322241802272F808002429DB /* SDUtilsTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 3222417E2272F808002429DB /* SDUtilsTests.m */; };
 		3226ECBB20754F7700FAFACF /* SDWebImageTestDownloadOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = 3226ECBA20754F7700FAFACF /* SDWebImageTestDownloadOperation.m */; };
 		3226ECBC20754F7700FAFACF /* SDWebImageTestDownloadOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = 3226ECBA20754F7700FAFACF /* SDWebImageTestDownloadOperation.m */; };
+		3234306223E2BAC800C290C8 /* TestImage.pdf in Resources */ = {isa = PBXBuildFile; fileRef = 3234306123E2BAC800C290C8 /* TestImage.pdf */; };
+		3234306323E2BAC800C290C8 /* TestImage.pdf in Resources */ = {isa = PBXBuildFile; fileRef = 3234306123E2BAC800C290C8 /* TestImage.pdf */; };
+		3234306423E2BAC800C290C8 /* TestImage.pdf in Resources */ = {isa = PBXBuildFile; fileRef = 3234306123E2BAC800C290C8 /* TestImage.pdf */; };
 		323B8E1F20862322008952BE /* SDWebImageTestLoader.m in Sources */ = {isa = PBXBuildFile; fileRef = 323B8E1E20862322008952BE /* SDWebImageTestLoader.m */; };
 		323B8E2020862322008952BE /* SDWebImageTestLoader.m in Sources */ = {isa = PBXBuildFile; fileRef = 323B8E1E20862322008952BE /* SDWebImageTestLoader.m */; };
 		324047442271956F007C53E1 /* TestEXIF.png in Resources */ = {isa = PBXBuildFile; fileRef = 324047432271956F007C53E1 /* TestEXIF.png */; };
@@ -107,6 +110,7 @@
 		3222417E2272F808002429DB /* SDUtilsTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDUtilsTests.m; sourceTree = "<group>"; };
 		3226ECB920754F7700FAFACF /* SDWebImageTestDownloadOperation.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDWebImageTestDownloadOperation.h; sourceTree = "<group>"; };
 		3226ECBA20754F7700FAFACF /* SDWebImageTestDownloadOperation.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDWebImageTestDownloadOperation.m; sourceTree = "<group>"; };
+		3234306123E2BAC800C290C8 /* TestImage.pdf */ = {isa = PBXFileReference; lastKnownFileType = image.pdf; path = TestImage.pdf; sourceTree = "<group>"; };
 		323B8E1D20862322008952BE /* SDWebImageTestLoader.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDWebImageTestLoader.h; sourceTree = "<group>"; };
 		323B8E1E20862322008952BE /* SDWebImageTestLoader.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDWebImageTestLoader.m; sourceTree = "<group>"; };
 		324047432271956F007C53E1 /* TestEXIF.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = TestEXIF.png; sourceTree = "<group>"; };
@@ -238,6 +242,7 @@
 				433BBBB81D7EF8260086B6E9 /* TestImage.png */,
 				327A418B211D660600495442 /* TestImage.heic */,
 				32905E63211D786E00460FCF /* TestImage.heif */,
+				3234306123E2BAC800C290C8 /* TestImage.pdf */,
 				327054E1206CEFF3006EA328 /* TestImageAnimated.apng */,
 				3297A09E23374D1600814590 /* TestImageAnimated.heic */,
 			);
@@ -443,6 +448,7 @@
 				3299228B2365DC6C00EAFD97 /* TestImage.heic in Resources */,
 				329922872365DC6C00EAFD97 /* TestLoopCount.gif in Resources */,
 				3299228C2365DC6C00EAFD97 /* TestImage.heif in Resources */,
+				3234306423E2BAC800C290C8 /* TestImage.pdf in Resources */,
 				329922892365DC6C00EAFD97 /* TestImageLarge.jpg in Resources */,
 				3299228A2365DC6C00EAFD97 /* TestImage.png in Resources */,
 				329922842365DC6C00EAFD97 /* MonochromeTestImage.jpg in Resources */,
@@ -461,6 +467,7 @@
 				32B99EA3203B31360017FD66 /* TestImage.gif in Resources */,
 				324047452271956F007C53E1 /* TestEXIF.png in Resources */,
 				32B99EA4203B31360017FD66 /* TestImage.jpg in Resources */,
+				3234306323E2BAC800C290C8 /* TestImage.pdf in Resources */,
 				32B99EA6203B31360017FD66 /* TestImage.png in Resources */,
 				3297A0A023374D1700814590 /* TestImageAnimated.heic in Resources */,
 				32B99EA2203B31360017FD66 /* MonochromeTestImage.jpg in Resources */,
@@ -479,6 +486,7 @@
 				5F7F38AD1AE2A77A00B0E330 /* TestImage.jpg in Resources */,
 				32905E64211D786E00460FCF /* TestImage.heif in Resources */,
 				43828A451DA67F9900000E62 /* TestImageLarge.jpg in Resources */,
+				3234306223E2BAC800C290C8 /* TestImage.pdf in Resources */,
 				433BBBB71D7EF8200086B6E9 /* TestImage.gif in Resources */,
 				433BBBB91D7EF8260086B6E9 /* TestImage.png in Resources */,
 				3297A09F23374D1700814590 /* TestImageAnimated.heic in Resources */,
diff --git a/Tests/Tests/Images/TestImage.pdf b/Tests/Tests/Images/TestImage.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..132681b067d4be6b5415f062924037811b926d9a
GIT binary patch
literal 1018
zcma)5O=uHA6c!I6>kmb-t$KMvqb+E5lkFyH357OIg1-$LMZ^{zH`8P#-HEf4k}6(2
zhzhnK>Y>!1s#HAGqTofL2t9~+5PA_24;H)#MGt}pf8T6=8rqA)FthW`oA<u&y|=zp
zZ(>itZz#TJi;sUQI%vR7omQezP!CWiD{|0|kf{KGny~YNa@_Mo&|Ye>3{|?i6jyLc
zhLqC8k+JTLt9PuA|Cm^~b9a8eF>*1fwTy0W`to}-Y2NvK;l`iYshNgH<4t{+TKva`
zR=LA-=jJ{)J~@A(dFz8~&9@sSGyHo0>!&@zk>Nu37@y9a+_mMzt(TYk-;7^*I5YX;
z>QU=g-`wb##2P)lY4M)_{ry)T4(;o-*1h|_d&-EL(`((2ZwEGv{nfvI+BSRhTR5pu
zCsW~vUs9QrBX<-OXz!5s@)WG;_LRm;BAFJb5~5KF;82N%2T)_(5CGL8xT1Evz!hi3
zk5Tgj>fw<B1vN#o)bp7loH_!ZRnvKpW^B^KN^l$@4fK$l1D<V+IRcGcko71hKgn6K
zP)Dci-9xJk(-@Nz$1TW6)<_kOA>K=eZHt=89toCtt0r|>kz3RSsotzpAvspNU`d7R
zQQL24Tx2YTnl-jXDXh*xsLnwQyF)MztroF4gMdGv`Ge4!6Qa<mVj>aDa#G0Img{Fc
z+t%iVNpY4bTG(y>|7@uW;kxi;{xKp*o@L9fu_A7z4oh!JoDM1)L=>$yAY>T20fSJ*
z3?1ts2RJn>7+Q&G0Zh+wyLQa#GE7JB%Q2%PvH}YS>+A$4cAj$Y7fst|DN>g0X)-22
e3NN?IUT2VjEQ429R}d~dh2d~m@%iF?3FRM0)gsma

literal 0
HcmV?d00001

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 23dc6d56..95b8b5a2 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -156,22 +156,34 @@
         withLocalImageURL:heicURL
          supportsEncoding:supportsEncoding
            encodingFormat:SDImageFormatHEIC
-          isAnimatedImage:isAnimatedImage];
+          isAnimatedImage:isAnimatedImage
+            isVectorImage:NO];
     }
 }
 
+- (void)test17ThatPDFWorks {
+    NSURL *pdfURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImage" withExtension:@"pdf"];
+    [self verifyCoder:[SDImageIOCoder sharedCoder]
+    withLocalImageURL:pdfURL
+     supportsEncoding:NO
+       encodingFormat:SDImageFormatUndefined
+      isAnimatedImage:NO
+        isVectorImage:YES];
+}
+
 - (void)verifyCoder:(id<SDImageCoder>)coder
 withLocalImageURL:(NSURL *)imageUrl
  supportsEncoding:(BOOL)supportsEncoding
   isAnimatedImage:(BOOL)isAnimated {
-    [self verifyCoder:coder withLocalImageURL:imageUrl supportsEncoding:supportsEncoding encodingFormat:SDImageFormatUndefined isAnimatedImage:isAnimated];
+    [self verifyCoder:coder withLocalImageURL:imageUrl supportsEncoding:supportsEncoding encodingFormat:SDImageFormatUndefined isAnimatedImage:isAnimated isVectorImage:NO];
 }
 
 - (void)verifyCoder:(id<SDImageCoder>)coder
   withLocalImageURL:(NSURL *)imageUrl
    supportsEncoding:(BOOL)supportsEncoding
      encodingFormat:(SDImageFormat)encodingFormat
-    isAnimatedImage:(BOOL)isAnimated {
+    isAnimatedImage:(BOOL)isAnimated
+      isVectorImage:(BOOL)isVector {
     NSData *inputImageData = [NSData dataWithContentsOfURL:imageUrl];
     expect(inputImageData).toNot.beNil();
     SDImageFormat inputImageFormat = [NSData sd_imageFormatForImageData:inputImageData];
@@ -204,7 +216,18 @@ withLocalImageURL:(NSURL *)imageUrl
     CGFloat pixelHeight = inputImage.size.height;
     expect(pixelWidth).beGreaterThan(0);
     expect(pixelHeight).beGreaterThan(0);
-    // check thumnail with scratch
+    // check vector format supports thumbnail with screen size
+    if (isVector) {
+#if SD_UIKIT
+        CGFloat maxScreenSize = MAX(UIScreen.mainScreen.bounds.size.width, UIScreen.mainScreen.bounds.size.height);
+#else
+        CGFloat maxScreenSize = MAX(NSScreen.mainScreen.frame.size.width, NSScreen.mainScreen.frame.size.height);
+#endif
+        expect(pixelWidth).equal(maxScreenSize);
+        expect(pixelHeight).equal(maxScreenSize);
+    }
+    
+    // check thumbnail with scratch
     CGFloat thumbnailWidth = 50;
     CGFloat thumbnailHeight = 50;
     UIImage *thumbImage = [coder decodedImageWithData:inputImageData options:@{
@@ -213,7 +236,7 @@ withLocalImageURL:(NSURL *)imageUrl
     }];
     expect(thumbImage).toNot.beNil();
     expect(thumbImage.size).equal(CGSizeMake(thumbnailWidth, thumbnailHeight));
-    // check thumnail with aspect ratio limit
+    // check thumbnail with aspect ratio limit
     thumbImage = [coder decodedImageWithData:inputImageData options:@{
         SDImageCoderDecodeThumbnailPixelSize : @(CGSizeMake(thumbnailWidth, thumbnailHeight)),
         SDImageCoderDecodePreserveAspectRatio : @(YES)

From ef2373668e1db302502aa23c9d43291d38b41fe6 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 15:56:25 +0800
Subject: [PATCH 101/181] Fix the Xcode 10 support using runtime selector, the
 force decode feature does not process on vector image format

---
 SDWebImage/Core/SDImageCoderHelper.m |  4 ++++
 SDWebImage/Core/UIImage+Metadata.m   | 28 +++++++++++++++++-----------
 2 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index c29685a9..7bba1025 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -575,6 +575,10 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
     if (image.sd_isAnimated) {
         return NO;
     }
+    // do not decode vector images
+    if (image.sd_isVector) {
+        return NO;
+    }
     
     return YES;
 }
diff --git a/SDWebImage/Core/UIImage+Metadata.m b/SDWebImage/Core/UIImage+Metadata.m
index ef63c41f..2d24c4e2 100644
--- a/SDWebImage/Core/UIImage+Metadata.m
+++ b/SDWebImage/Core/UIImage+Metadata.m
@@ -32,25 +32,31 @@
     return (self.images != nil);
 }
 
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
 - (BOOL)sd_isVector {
     if (@available(iOS 13.0, tvOS 13.0, watchOS 6.0, *)) {
-        if (self.isSymbolImage) {
+        // Xcode 11 supports symbol image, keep Xcode 10 compatible currently
+        SEL SymbolSelector = NSSelectorFromString(@"isSymbolImage");
+        if ([self respondsToSelector:SymbolSelector] && [self performSelector:SymbolSelector]) {
+            return YES;
+        }
+        // SVG
+        SEL SVGSelector = NSSelectorFromString(@"_CGSVGDocument");
+        if ([self respondsToSelector:SVGSelector] && [self performSelector:SVGSelector]) {
             return YES;
         }
     }
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
-    SEL SVGSelector = NSSelectorFromString(@"_CGSVGDocument");
-    if ([self respondsToSelector:SVGSelector] && [self performSelector:SVGSelector] != nil) {
-        return YES;
+    if (@available(iOS 11.0, tvOS 11.0, watchOS 4.0, *)) {
+        // PDF
+        SEL PDFSelector = NSSelectorFromString(@"_CGPDFPage");
+        if ([self respondsToSelector:PDFSelector] && [self performSelector:PDFSelector]) {
+            return YES;
+        }
     }
-    SEL PDFSelector = NSSelectorFromString(@"_CGPDFPage");
-    if ([self respondsToSelector:PDFSelector] && [self performSelector:PDFSelector] != nil) {
-        return YES;
-    }
-#pragma clang diagnostic pop
     return NO;
 }
+#pragma clang diagnostic pop
 
 #else
 

From 5629af83303e6d4c219a4a97a1ec4cfae111df91 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 16:09:46 +0800
Subject: [PATCH 102/181] Added `SDWebImageTransformVectorImage`, which can
 allows the transformer to transform the vector image format, although most
 coders works for vector format (if you don't grab CGImage), some are not

---
 SDWebImage/Core/SDWebImageDefine.h  | 6 ++++++
 SDWebImage/Core/SDWebImageManager.m | 8 ++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index bd4d4e68..568de147 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -195,6 +195,12 @@ typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {
      * Note if you use this when using the custom cache serializer, or using the transformer, we will also wait until the output image data written is finished.
      */
     SDWebImageWaitStoreCache = 1 << 22,
+    
+    /**
+     * We usually don't apply transform on vector images, because vector images supports dynamically changing to any size, rasterize to a fixed size will loss details. To modify vector images, you can process the vector data at runtime (such as modifying PDF tag / SVG element).
+     * Use this flag to transform them anyway.
+     */
+    SDWebImageTransformVectorImage = 1 << 23,
 };
 
 
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 97ffb488..4fcb0ab1 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -332,7 +332,9 @@ static id<SDImageLoader> _defaultImageLoader;
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
     
-    BOOL shouldTransformImage = downloadedImage && (!downloadedImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage)) && transformer;
+    BOOL shouldTransformImage = downloadedImage && transformer;
+    shouldTransformImage = shouldTransformImage && (!downloadedImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage));
+    shouldTransformImage = shouldTransformImage && (!downloadedImage.sd_isVector || (options & SDWebImageTransformVectorImage));
     BOOL shouldCacheOriginal = downloadedImage && finished;
     BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     
@@ -380,7 +382,9 @@ static id<SDImageLoader> _defaultImageLoader;
     NSString *key = [self cacheKeyForURL:url context:context];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
-    BOOL shouldTransformImage = originalImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage)) && transformer;
+    BOOL shouldTransformImage = originalImage && transformer;
+    shouldTransformImage = shouldTransformImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage));
+    shouldTransformImage = shouldTransformImage && (!originalImage.sd_isVector || (options & SDWebImageTransformVectorImage));
     BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     // if available, store transformed image to cache
     if (shouldTransformImage) {

From bb424d44fdd8a4d41c43c86387de3b32e1941cf8 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 16:52:55 +0800
Subject: [PATCH 103/181] Added the URLSessionTaskMetrics support for
 downloader && operation, which can be used for network metrics

---
 SDWebImage/Core/SDWebImageDownloader.m          | 9 +++++++++
 SDWebImage/Core/SDWebImageDownloaderOperation.h | 7 +++++++
 SDWebImage/Core/SDWebImageDownloaderOperation.m | 6 ++++++
 3 files changed, 22 insertions(+)

diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index 94bfa049..c836cc59 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -498,6 +498,15 @@ didReceiveResponse:(NSURLResponse *)response
     }
 }
 
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0)) {
+    
+    // Identify the operation that runs this task and pass it the delegate method
+    NSOperation<SDWebImageDownloaderOperation> *dataOperation = [self operationWithTask:task];
+    if ([dataOperation respondsToSelector:@selector(URLSession:task:didFinishCollectingMetrics:)]) {
+        [dataOperation URLSession:session task:task didFinishCollectingMetrics:metrics];
+    }
+}
+
 @end
 
 @implementation SDWebImageDownloadToken
diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.h b/SDWebImage/Core/SDWebImageDownloaderOperation.h
index e987ba42..3b93aa71 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.h
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.h
@@ -36,6 +36,7 @@
 
 @optional
 @property (strong, nonatomic, readonly, nullable) NSURLSessionTask *dataTask;
+@property (strong, nonatomic, readonly, nullable) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
 @property (strong, nonatomic, nullable) NSURLCredential *credential;
 @property (assign, nonatomic) double minimumProgressInterval;
 
@@ -62,6 +63,12 @@
  */
 @property (strong, nonatomic, readonly, nullable) NSURLSessionTask *dataTask;
 
+/**
+ * The collected metrics from `-URLSession:task:didFinishCollectingMetrics:`.
+ * This can be used to collect the network metrics like download duration, DNS lookup duration, SSL handshake dureation, etc. See Apple's documentation: https://developer.apple.com/documentation/foundation/urlsessiontaskmetrics
+ */
+@property (strong, nonatomic, readonly, nullable) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
+
 /**
  * The credential used for authentication challenges in `-URLSession:task:didReceiveChallenge:completionHandler:`.
  *
diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.m b/SDWebImage/Core/SDWebImageDownloaderOperation.m
index 6527eddd..355e207e 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.m
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.m
@@ -52,6 +52,8 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
 
 @property (strong, nonatomic, readwrite, nullable) NSURLSessionTask *dataTask;
 
+@property (strong, nonatomic, readwrite, nullable) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
+
 @property (strong, nonatomic, nonnull) dispatch_queue_t coderQueue; // the queue to do image decoding
 #if SD_UIKIT
 @property (assign, nonatomic) UIBackgroundTaskIdentifier backgroundTaskId;
@@ -512,6 +514,10 @@ didReceiveResponse:(NSURLResponse *)response
     }
 }
 
+- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0)) {
+    self.metrics = metrics;
+}
+
 #pragma mark Helper methods
 + (SDWebImageOptions)imageOptionsFromDownloaderOptions:(SDWebImageDownloaderOptions)downloadOptions {
     SDWebImageOptions options = 0;

From ed894ecff59aa5acb3a11dfb21490f974a76066f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 17:32:46 +0800
Subject: [PATCH 104/181] Added the metrics in the download token, make it easy
 to grab the information right in completion block (is this useful ?)

---
 SDWebImage/Core/SDWebImageDownloader.h |  5 +++++
 SDWebImage/Core/SDWebImageDownloader.m | 17 +++++++++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDownloader.h b/SDWebImage/Core/SDWebImageDownloader.h
index 571b72a2..a365395c 100644
--- a/SDWebImage/Core/SDWebImageDownloader.h
+++ b/SDWebImage/Core/SDWebImageDownloader.h
@@ -128,6 +128,11 @@ typedef SDImageLoaderCompletedBlock SDWebImageDownloaderCompletedBlock;
  */
 @property (nonatomic, strong, nullable, readonly) NSURLResponse *response;
 
+/**
+ The download's metrics. This will be nil if download operation does not support metrics.
+ */
+@property (nonatomic, strong, nullable, readonly) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
+
 @end
 
 
diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index c836cc59..d7deee95 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -24,6 +24,7 @@ static void * SDWebImageDownloaderContext = &SDWebImageDownloaderContext;
 @property (nonatomic, strong, nullable, readwrite) NSURL *url;
 @property (nonatomic, strong, nullable, readwrite) NSURLRequest *request;
 @property (nonatomic, strong, nullable, readwrite) NSURLResponse *response;
+@property (nonatomic, strong, nullable, readwrite) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
 @property (nonatomic, weak, nullable, readwrite) id downloadOperationCancelToken;
 @property (nonatomic, weak, nullable) NSOperation<SDWebImageDownloaderOperation> *downloadOperation;
 @property (nonatomic, assign, getter=isCancelled) BOOL cancelled;
@@ -519,18 +520,30 @@ didReceiveResponse:(NSURLResponse *)response
     self = [super init];
     if (self) {
         _downloadOperation = downloadOperation;
-        [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(downloadReceiveResponse:) name:SDWebImageDownloadReceiveResponseNotification object:downloadOperation];
+        [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(downloadDidReceiveResponse:) name:SDWebImageDownloadReceiveResponseNotification object:downloadOperation];
+        [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(downloadDidStop:) name:SDWebImageDownloadStopNotification object:downloadOperation];
     }
     return self;
 }
 
-- (void)downloadReceiveResponse:(NSNotification *)notification {
+- (void)downloadDidReceiveResponse:(NSNotification *)notification {
     NSOperation<SDWebImageDownloaderOperation> *downloadOperation = notification.object;
     if (downloadOperation && downloadOperation == self.downloadOperation) {
         self.response = downloadOperation.response;
     }
 }
 
+- (void)downloadDidStop:(NSNotification *)notification {
+    NSOperation<SDWebImageDownloaderOperation> *downloadOperation = notification.object;
+    if (downloadOperation && downloadOperation == self.downloadOperation) {
+        if ([downloadOperation respondsToSelector:@selector(metrics)]) {
+            if (@available(iOS 10.0, tvOS 10.0, macOS 10.12, watchOS 3.0, *)) {
+                self.metrics = downloadOperation.metrics;
+            }
+        }
+    }
+}
+
 - (void)cancel {
     @synchronized (self) {
         if (self.isCancelled) {

From d56636e15b2d106f275ae9ea0887a0da04b7024d Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 30 Jan 2020 18:33:16 +0800
Subject: [PATCH 105/181] Update the Example and Test case about
 URLSessionMetrics, expose the API in UIVIew+WebCache to make it easy to write
 code (or user have to write NSStringFromClass)

---
 .../SDWebImage Demo/MasterViewController.m    | 20 +++++++++---
 SDWebImage/Core/UIView+WebCache.h             |  7 +++++
 Tests/Tests/SDWebImageDownloaderTests.m       | 31 +++++++++++++++++++
 3 files changed, 54 insertions(+), 4 deletions(-)

diff --git a/Examples/SDWebImage Demo/MasterViewController.m b/Examples/SDWebImage Demo/MasterViewController.m
index f131f55f..f3aecbea 100644
--- a/Examples/SDWebImage Demo/MasterViewController.m	
+++ b/Examples/SDWebImage Demo/MasterViewController.m	
@@ -113,10 +113,22 @@
     }
     
     cell.customTextLabel.text = [NSString stringWithFormat:@"Image #%ld", (long)indexPath.row];
-    [cell.customImageView sd_setImageWithURL:[NSURL URLWithString:self.objects[indexPath.row]]
-                            placeholderImage:placeholderImage
-                                     options:indexPath.row == 0 ? SDWebImageRefreshCached : 0
-                                     context:@{SDWebImageContextImageThumbnailPixelSize : @(CGSizeMake(180, 120))}];
+    __weak SDAnimatedImageView *imageView = cell.customImageView;
+    [imageView sd_setImageWithURL:[NSURL URLWithString:self.objects[indexPath.row]]
+                 placeholderImage:placeholderImage
+                          options:indexPath.row == 0 ? SDWebImageRefreshCached : 0
+                          context:@{SDWebImageContextImageThumbnailPixelSize : @(CGSizeMake(180, 120))}
+                         progress:nil
+                        completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
+        SDWebImageCombinedOperation *operation = [imageView sd_imageLoadOperationForKey:imageView.sd_latestOperationKey];
+        SDWebImageDownloadToken *token = operation.loaderOperation;
+        if (@available(iOS 10.0, *)) {
+            NSURLSessionTaskMetrics *metrics = token.metrics;
+            if (metrics) {
+                printf("Metrics: %s download in (%f) seconds\n", [imageURL.absoluteString cStringUsingEncoding:NSUTF8StringEncoding], metrics.taskInterval.duration);
+            }
+        }
+    }];
     return cell;
 }
 
diff --git a/SDWebImage/Core/UIView+WebCache.h b/SDWebImage/Core/UIView+WebCache.h
index d0a7966f..c7e12a47 100644
--- a/SDWebImage/Core/UIView+WebCache.h
+++ b/SDWebImage/Core/UIView+WebCache.h
@@ -31,6 +31,13 @@ typedef void(^SDSetImageBlock)(UIImage * _Nullable image, NSData * _Nullable ima
  */
 @property (nonatomic, strong, readonly, nullable) NSURL *sd_imageURL;
 
+/**
+ * Get the current image operation key. Operation key is used to identify the different queries for one view instance (like UIButton).
+ * See more about this in `SDWebImageContextSetImageOperationKey`.
+ * @note You can use method `UIView+WebCacheOperation` to invesigate different queries' operation.
+ */
+@property (nonatomic, strong, readonly, nullable) NSString *sd_latestOperationKey;
+
 /**
  * The current image loading progress associated to the view. The unit count is the received size and excepted size of download.
  * The `totalUnitCount` and `completedUnitCount` will be reset to 0 after a new image loading start (change from current queue). And they will be set to `SDWebImageProgressUnitCountUnknown` if the progressBlock not been called but the image loading success to mark the progress finished (change from main queue).
diff --git a/Tests/Tests/SDWebImageDownloaderTests.m b/Tests/Tests/SDWebImageDownloaderTests.m
index e5f0a2b5..467623ac 100644
--- a/Tests/Tests/SDWebImageDownloaderTests.m
+++ b/Tests/Tests/SDWebImageDownloaderTests.m
@@ -642,6 +642,37 @@
     }];
 }
 
+- (void)test26DownloadURLSessionMetrics {
+    XCTestExpectation *expectation1 = [self expectationWithDescription:@"Download URLSessionMetrics works"];
+    
+    SDWebImageDownloader *downloader = [[SDWebImageDownloader alloc] init];
+    
+    __block SDWebImageDownloadToken *token;
+    token = [downloader downloadImageWithURL:[NSURL URLWithString:kTestJPEGURL] completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, BOOL finished) {
+        expect(error).beNil();
+        if (@available(iOS 10.0, tvOS 10.0, macOS 10.12, *)) {
+            NSURLSessionTaskMetrics *metrics = token.metrics;
+            expect(metrics).notTo.beNil();
+            expect(metrics.redirectCount).equal(0);
+            expect(metrics.transactionMetrics.count).equal(1);
+            NSURLSessionTaskTransactionMetrics *metric = metrics.transactionMetrics.firstObject;
+            // Metrcis Test
+            expect(metric.fetchStartDate).notTo.beNil();
+            expect(metric.connectStartDate).notTo.beNil();
+            expect(metric.connectEndDate).notTo.beNil();
+            expect(metric.networkProtocolName).equal(@"http/1.1");
+            expect(metric.resourceFetchType).equal(NSURLSessionTaskMetricsResourceFetchTypeNetworkLoad);
+            expect(metric.isProxyConnection).beFalsy();
+            expect(metric.isReusedConnection).beFalsy();
+        }
+        [expectation1 fulfill];
+    }];
+    
+    [self waitForExpectationsWithCommonTimeoutUsingHandler:^(NSError * _Nullable error) {
+        [downloader invalidateSessionAndCancel:YES];
+    }];
+}
+
 #pragma mark - SDWebImageLoader
 - (void)test30CustomImageLoaderWorks {
     XCTestExpectation *expectation = [self expectationWithDescription:@"Custom image not works"];

From 4d354c4acdc0ba8e3db1af8fc687a8bf450a46ee Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 12 Feb 2020 12:13:04 +0800
Subject: [PATCH 106/181] Make the SDAniamtedImage response to the
 UIImage+Metadata category method, which should return the status matching the
 behavior

---
 SDWebImage/Core/SDAnimatedImage.m | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/SDWebImage/Core/SDAnimatedImage.m b/SDWebImage/Core/SDAnimatedImage.m
index ce5d5d29..d27e2c4b 100644
--- a/SDWebImage/Core/SDAnimatedImage.m
+++ b/SDWebImage/Core/SDAnimatedImage.m
@@ -12,6 +12,7 @@
 #import "SDImageCodersManager.h"
 #import "SDImageFrame.h"
 #import "UIImage+MemoryCacheCost.h"
+#import "UIImage+Metadata.h"
 #import "SDImageAssetManager.h"
 #import "objc/runtime.h"
 
@@ -298,3 +299,31 @@ static CGFloat SDImageScaleFromPath(NSString *string) {
 }
 
 @end
+
+@implementation SDAnimatedImage (Metadata)
+
+- (BOOL)sd_isAnimated {
+    return YES;
+}
+
+- (NSUInteger)sd_imageLoopCount {
+    return self.animatedImageLoopCount;
+}
+
+- (void)setSd_imageLoopCount:(NSUInteger)sd_imageLoopCount {
+    return;
+}
+
+- (SDImageFormat)sd_imageFormat {
+    return self.animatedImageFormat;
+}
+
+- (void)setSd_imageFormat:(SDImageFormat)sd_imageFormat {
+    return;
+}
+
+- (BOOL)sd_isVector {
+    return NO;
+}
+
+@end

From 4acd81177bc5d906ab9fad6e48f194ca6ec02b57 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 12 Feb 2020 12:35:48 +0800
Subject: [PATCH 107/181] Added macros to expand SPI symbol to Selector, which
 can make it easy to distinguish and maintain in the future

---
 SDWebImage/Core/SDAnimatedImageView.m |  4 ++--
 SDWebImage/Core/UIImage+Metadata.m    |  5 +++--
 SDWebImage/Private/SDInternalMacros.h | 12 ++++++++++++
 3 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index e9734383..71ee7e34 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -470,10 +470,10 @@
 // NSImageView use a subview. We need this subview's layer for actual rendering.
 // Why using this design may because of properties like `imageAlignment` and `imageScaling`, which it's not available for UIImageView.contentMode (it's impossible to align left and keep aspect ratio at the same time)
 - (NSView *)imageView {
-    NSImageView *imageView = imageView = objc_getAssociatedObject(self, NSSelectorFromString(@"_imageView"));
+    NSImageView *imageView = imageView = objc_getAssociatedObject(self, SD_SEL_SPI(imageView));
     if (!imageView) {
         // macOS 10.14
-        imageView = objc_getAssociatedObject(self, NSSelectorFromString(@"_imageSubview"));
+        imageView = objc_getAssociatedObject(self, SD_SEL_SPI(imageSubview));
     }
     return imageView;
 }
diff --git a/SDWebImage/Core/UIImage+Metadata.m b/SDWebImage/Core/UIImage+Metadata.m
index 2d24c4e2..09724236 100644
--- a/SDWebImage/Core/UIImage+Metadata.m
+++ b/SDWebImage/Core/UIImage+Metadata.m
@@ -8,6 +8,7 @@
 
 #import "UIImage+Metadata.h"
 #import "NSImage+Compatibility.h"
+#import "SDInternalMacros.h"
 #import "objc/runtime.h"
 
 @implementation UIImage (Metadata)
@@ -42,14 +43,14 @@
             return YES;
         }
         // SVG
-        SEL SVGSelector = NSSelectorFromString(@"_CGSVGDocument");
+        SEL SVGSelector = SD_SEL_SPI(CGSVGDocument);
         if ([self respondsToSelector:SVGSelector] && [self performSelector:SVGSelector]) {
             return YES;
         }
     }
     if (@available(iOS 11.0, tvOS 11.0, watchOS 4.0, *)) {
         // PDF
-        SEL PDFSelector = NSSelectorFromString(@"_CGPDFPage");
+        SEL PDFSelector = SD_SEL_SPI(CGPDFPage);
         if ([self respondsToSelector:PDFSelector] && [self performSelector:PDFSelector]) {
             return YES;
         }
diff --git a/SDWebImage/Private/SDInternalMacros.h b/SDWebImage/Private/SDInternalMacros.h
index 837d77b0..aad700f8 100644
--- a/SDWebImage/Private/SDInternalMacros.h
+++ b/SDWebImage/Private/SDInternalMacros.h
@@ -21,6 +21,18 @@
 #define SD_OPTIONS_CONTAINS(options, value) (((options) & (value)) == (value))
 #endif
 
+#ifndef SD_CSTRING
+#define SD_CSTRING(str) #str
+#endif
+
+#ifndef SD_NSSTRING
+#define SD_NSSTRING(str) @(SD_CSTRING(str))
+#endif
+
+#ifndef SD_SEL_SPI
+#define SD_SEL_SPI(name) NSSelectorFromString([NSString stringWithFormat:@"_%@", SD_NSSTRING(name)])
+#endif
+
 #ifndef weakify
 #define weakify(...) \
 sd_keywordify \

From ac4dcbe316a91d1cc9f06d2687f88790eaa4bbb4 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 26 Feb 2020 12:14:50 +0800
Subject: [PATCH 108/181] Copy the SVG detection from SVGCoder to the utils

---
 SDWebImage/Core/NSData+ImageContentType.m | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/SDWebImage/Core/NSData+ImageContentType.m b/SDWebImage/Core/NSData+ImageContentType.m
index 4db1ff5b..f9014480 100644
--- a/SDWebImage/Core/NSData+ImageContentType.m
+++ b/SDWebImage/Core/NSData+ImageContentType.m
@@ -17,6 +17,7 @@
 
 // Currently Image/IO does not support WebP
 #define kSDUTTypeWebP ((__bridge CFStringRef)@"public.webp")
+#define kSVGTagEnd @"</svg>"
 
 @implementation NSData (ImageContentType)
 
@@ -74,6 +75,15 @@
                 }
             }
         }
+        case 0x3C: {
+            if (data.length > 100) {
+                // Check end with SVG tag
+                NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(data.length - 100, 100)] encoding:NSASCIIStringEncoding];
+                if ([testString containsString:kSVGTagEnd]) {
+                    return SDImageFormatSVG;
+                }
+            }
+        }
     }
     return SDImageFormatUndefined;
 }

From c0f796aa779e5e016be9a81bf96f8baca699c552 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 27 Feb 2020 11:20:52 +0800
Subject: [PATCH 109/181] Try to fix the issue caused by Swift PM 5.2, the
 `sources` DSL only matches the individual source files, but not folder

---
 Package.swift                                 | 18 ++++--------------
 SDWebImage/MapKit/MKAnnotationView+WebCache.m |  8 ++------
 2 files changed, 6 insertions(+), 20 deletions(-)

diff --git a/Package.swift b/Package.swift
index 55da4f0b..50390b74 100644
--- a/Package.swift
+++ b/Package.swift
@@ -30,24 +30,14 @@ let package = Package(
         .target(
             name: "SDWebImage",
             dependencies: [],
-            path: ".",
-            sources: ["SDWebImage/Core", "SDWebImage/Private"],
-            publicHeadersPath: "SDWebImage/Core",
-            cSettings: [
-                .headerSearchPath("SDWebImage/Core"),
-                .headerSearchPath("SDWebImage/Private")
-            ]
+            path: "SDWebImage",
+            exclude: ["MapKit"],
+            publicHeadersPath: "Core"
         ),
         .target(
             name: "SDWebImageMapKit",
             dependencies: ["SDWebImage"],
-            path: ".",
-            sources: ["SDWebImage/MapKit"],
-            publicHeadersPath: "SDWebImage/MapKit",
-            cSettings: [
-                .headerSearchPath("SDWebImage/Core"),
-                .headerSearchPath("SDWebImage/Private")
-            ]
+            path: "SDWebImage/MapKit"
         )
     ]
 )
diff --git a/SDWebImage/MapKit/MKAnnotationView+WebCache.m b/SDWebImage/MapKit/MKAnnotationView+WebCache.m
index adc02a92..11b91b19 100644
--- a/SDWebImage/MapKit/MKAnnotationView+WebCache.m
+++ b/SDWebImage/MapKit/MKAnnotationView+WebCache.m
@@ -10,10 +10,7 @@
 
 #if SD_UIKIT || SD_MAC
 
-#import "objc/runtime.h"
-#import "UIView+WebCacheOperation.h"
 #import "UIView+WebCache.h"
-#import "SDInternalMacros.h"
 
 @implementation MKAnnotationView (WebCache)
 
@@ -55,14 +52,13 @@
                    context:(nullable SDWebImageContext *)context
                   progress:(nullable SDImageLoaderProgressBlock)progressBlock
                  completed:(nullable SDExternalCompletionBlock)completedBlock {
-    @weakify(self);
+    __weak typeof(self) wself = self;
     [self sd_internalSetImageWithURL:url
                     placeholderImage:placeholder
                              options:options
                              context:context
                        setImageBlock:^(UIImage * _Nullable image, NSData * _Nullable imageData, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
-                           @strongify(self);
-                           self.image = image;
+                           wself.image = image;
                        }
                             progress:progressBlock
                            completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {

From faf82c1e1a1d987f6beb6c93fe3011d1534bc138 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 27 Feb 2020 15:39:37 +0800
Subject: [PATCH 110/181] Complete all the SDWebImage error code with the
 localized description, make it easy for debugging

---
 SDWebImage/Core/SDWebImageDownloaderOperation.m | 16 ++++++++--------
 SDWebImage/Core/SDWebImageError.h               |  2 +-
 SDWebImage/Core/SDWebImageManager.m             |  4 ++--
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.m b/SDWebImage/Core/SDWebImageDownloaderOperation.m
index 355e207e..9411dcac 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.m
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.m
@@ -140,7 +140,7 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
         SDWebImageDownloaderCompletedBlock completedBlock = [token valueForKey:kCompletedCallbackKey];
         dispatch_main_async_safe(^{
             if (completedBlock) {
-                completedBlock(nil, nil, [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:nil], YES);
+                completedBlock(nil, nil, [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during sending the request"}], YES);
             }
         });
     }
@@ -152,7 +152,7 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
         if (self.isCancelled) {
             self.finished = YES;
             // Operation cancelled by user before sending the request
-            [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:nil]];
+            [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user before sending the request"}]];
             [self reset];
             return;
         }
@@ -246,8 +246,8 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
         if (self.isExecuting) self.executing = NO;
         if (!self.isFinished) self.finished = YES;
     }
-    // Operation cancelled by user before sending the request
-    [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:nil]];
+    // Operation cancelled by user during sending the request
+    [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during sending the request"}]];
 
     [self reset];
 }
@@ -309,7 +309,7 @@ didReceiveResponse:(NSURLResponse *)response
         response = [self.responseModifier modifiedResponseWithResponse:response];
         if (!response) {
             valid = NO;
-            self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorInvalidDownloadResponse userInfo:nil];
+            self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorInvalidDownloadResponse userInfo:@{NSLocalizedDescriptionKey : @"Download marked as failed because response is nil"}];
         }
     }
     
@@ -323,13 +323,13 @@ didReceiveResponse:(NSURLResponse *)response
     BOOL statusCodeValid = statusCode >= 200 && statusCode < 400;
     if (!statusCodeValid) {
         valid = NO;
-        self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorInvalidDownloadStatusCode userInfo:@{SDWebImageErrorDownloadStatusCodeKey : @(statusCode)}];
+        self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorInvalidDownloadStatusCode userInfo:@{NSLocalizedDescriptionKey : @"Download marked as failed because response status code is not in 200-400", SDWebImageErrorDownloadStatusCodeKey : @(statusCode)}];
     }
     //'304 Not Modified' is an exceptional one
     //URLSession current behavior will return 200 status code when the server respond 304 and URLCache hit. But this is not a standard behavior and we just add a check
     if (statusCode == 304 && !self.cachedData) {
         valid = NO;
-        self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCacheNotModified userInfo:nil];
+        self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCacheNotModified userInfo:@{NSLocalizedDescriptionKey : @"Download response status code is 304 not modified and ignored"}];
     }
     
     if (valid) {
@@ -455,7 +455,7 @@ didReceiveResponse:(NSURLResponse *)response
                  *  then we should check if the cached data is equal to image data
                  */
                 if (self.options & SDWebImageDownloaderIgnoreCachedResponse && [self.cachedData isEqualToData:imageData]) {
-                    self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCacheNotModified userInfo:nil];
+                    self.responseError = [NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCacheNotModified userInfo:@{NSLocalizedDescriptionKey : @"Downloaded image is not modified and ignored"}];
                     // call completion block with not modified error
                     [self callCompletionBlocksWithError:self.responseError];
                     [self done];
diff --git a/SDWebImage/Core/SDWebImageError.h b/SDWebImage/Core/SDWebImageError.h
index 3c08cc9d..e935ac97 100644
--- a/SDWebImage/Core/SDWebImageError.h
+++ b/SDWebImage/Core/SDWebImageError.h
@@ -22,5 +22,5 @@ typedef NS_ERROR_ENUM(SDWebImageErrorDomain, SDWebImageError) {
     SDWebImageErrorInvalidDownloadOperation = 2000, // The image download operation is invalid, such as nil operation or unexpected error occur when operation initialized
     SDWebImageErrorInvalidDownloadStatusCode = 2001, // The image download response a invalid status code. You can check the status code in error's userInfo under `SDWebImageErrorDownloadStatusCodeKey`
     SDWebImageErrorCancelled = 2002, // The image loading operation is cancelled before finished, during either async disk cache query, or waiting before actual network request. For actual network request error, check `NSURLErrorDomain` error domain and code.
-    SDWebImageErrorInvalidDownloadResponse = 2003, // When using response modifier, the modified download response is nil and marked as cancelled.
+    SDWebImageErrorInvalidDownloadResponse = 2003, // When using response modifier, the modified download response is nil and marked as failed.
 };
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 4fcb0ab1..c5502cc3 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -220,7 +220,7 @@ static id<SDImageLoader> _defaultImageLoader;
             @strongify(operation);
             if (!operation || operation.isCancelled) {
                 // Image combined operation cancelled by user
-                [self callCompletionBlockForOperation:operation completion:completedBlock error:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:nil] url:url];
+                [self callCompletionBlockForOperation:operation completion:completedBlock error:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during querying the cache"}] url:url];
                 [self safelyRemoveOperationFromRunning:operation];
                 return;
             }
@@ -269,7 +269,7 @@ static id<SDImageLoader> _defaultImageLoader;
             @strongify(operation);
             if (!operation || operation.isCancelled) {
                 // Image combined operation cancelled by user
-                [self callCompletionBlockForOperation:operation completion:completedBlock error:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:nil] url:url];
+                [self callCompletionBlockForOperation:operation completion:completedBlock error:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during sending the request"}] url:url];
             } else if (cachedImage && options & SDWebImageRefreshCached && [error.domain isEqualToString:SDWebImageErrorDomain] && error.code == SDWebImageErrorCacheNotModified) {
                 // Image refresh hit the NSURLCache cache, do not call the completion block
             } else if ([error.domain isEqualToString:SDWebImageErrorDomain] && error.code == SDWebImageErrorCancelled) {

From b395243d378c5193088d38fd6333dba490085585 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 27 Feb 2020 15:55:53 +0800
Subject: [PATCH 111/181] Garden all the private headers with description and
 null-ability annotation

---
 SDWebImage/Private/SDAsyncBlockOperation.h         |  1 +
 SDWebImage/Private/SDDeviceHelper.h                |  1 +
 SDWebImage/Private/SDDisplayLink.h                 |  5 ++---
 SDWebImage/Private/SDFileAttributeHelper.h         | 11 ++++++-----
 SDWebImage/Private/SDImageAssetManager.h           |  4 ++--
 SDWebImage/Private/SDImageCachesManagerOperation.h |  2 +-
 SDWebImage/Private/SDWeakProxy.h                   |  1 +
 7 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Private/SDAsyncBlockOperation.h b/SDWebImage/Private/SDAsyncBlockOperation.h
index ecc68be8..a3480deb 100644
--- a/SDWebImage/Private/SDAsyncBlockOperation.h
+++ b/SDWebImage/Private/SDAsyncBlockOperation.h
@@ -11,6 +11,7 @@
 @class SDAsyncBlockOperation;
 typedef void (^SDAsyncBlock)(SDAsyncBlockOperation * __nonnull asyncOperation);
 
+/// A async block operation, success after you call `completer` (not like `NSBlockOperation` which is for sync block, success on return)
 @interface SDAsyncBlockOperation : NSOperation
 
 - (nonnull instancetype)initWithBlock:(nonnull SDAsyncBlock)block;
diff --git a/SDWebImage/Private/SDDeviceHelper.h b/SDWebImage/Private/SDDeviceHelper.h
index 740fb2e3..5d5676b1 100644
--- a/SDWebImage/Private/SDDeviceHelper.h
+++ b/SDWebImage/Private/SDDeviceHelper.h
@@ -9,6 +9,7 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
+/// Device information helper methods
 @interface SDDeviceHelper : NSObject
 
 + (NSUInteger)totalMemory;
diff --git a/SDWebImage/Private/SDDisplayLink.h b/SDWebImage/Private/SDDisplayLink.h
index 60d4e80e..3ee8c6fd 100644
--- a/SDWebImage/Private/SDDisplayLink.h
+++ b/SDWebImage/Private/SDDisplayLink.h
@@ -9,9 +9,8 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
-// Cross-platform display link wrapper. Do not retain the target
-// Use `CADisplayLink` on iOS/tvOS, `CVDisplayLink` on macOS, `NSTimer` on watchOS
-
+/// Cross-platform display link wrapper. Do not retain the target
+/// Use `CADisplayLink` on iOS/tvOS, `CVDisplayLink` on macOS, `NSTimer` on watchOS
 @interface SDDisplayLink : NSObject
 
 @property (readonly, nonatomic, weak, nullable) id target;
diff --git a/SDWebImage/Private/SDFileAttributeHelper.h b/SDWebImage/Private/SDFileAttributeHelper.h
index 1e66ded7..b5594e95 100644
--- a/SDWebImage/Private/SDFileAttributeHelper.h
+++ b/SDWebImage/Private/SDFileAttributeHelper.h
@@ -7,12 +7,13 @@
 
 #import <Foundation/Foundation.h>
 
+/// File Extended Attribute (xattr) helper methods
 @interface SDFileAttributeHelper : NSObject
 
-+ (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-+ (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-+ (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
-+ (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err;
-+ (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err;
++ (nullable NSArray<NSString *> *)extendedAttributeNamesAtPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)hasExtendedAttribute:(nonnull NSString *)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (nullable NSData *)extendedAttribute:(nonnull NSString*)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)setExtendedAttribute:(nonnull NSString*)name value:(nonnull NSData *)value atPath:(nonnull NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)removeExtendedAttribute:(nonnull NSString*)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
 
 @end
diff --git a/SDWebImage/Private/SDImageAssetManager.h b/SDWebImage/Private/SDImageAssetManager.h
index 68184187..88dee489 100644
--- a/SDWebImage/Private/SDImageAssetManager.h
+++ b/SDWebImage/Private/SDImageAssetManager.h
@@ -9,8 +9,8 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
-// Apple parse the Asset Catalog compiled file(`Assets.car`) by CoreUI.framework, however it's a private framework and there are no other ways to directly get the data. So we just process the normal bundle files :)
-
+/// A Image-Asset manager to work like UIKit/AppKit's image cache behavior
+/// Apple parse the Asset Catalog compiled file(`Assets.car`) by CoreUI.framework, however it's a private framework and there are no other ways to directly get the data. So we just process the normal bundle files :)
 @interface SDImageAssetManager : NSObject
 
 @property (nonatomic, strong, nonnull) NSMapTable<NSString *, UIImage *> *imageTable;
diff --git a/SDWebImage/Private/SDImageCachesManagerOperation.h b/SDWebImage/Private/SDImageCachesManagerOperation.h
index fddf78c1..0debe6ca 100644
--- a/SDWebImage/Private/SDImageCachesManagerOperation.h
+++ b/SDWebImage/Private/SDImageCachesManagerOperation.h
@@ -9,7 +9,7 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
-// This is used for operation management, but not for operation queue execute
+/// This is used for operation management, but not for operation queue execute
 @interface SDImageCachesManagerOperation : NSOperation
 
 @property (nonatomic, assign, readonly) NSUInteger pendingCount;
diff --git a/SDWebImage/Private/SDWeakProxy.h b/SDWebImage/Private/SDWeakProxy.h
index 4fd16228..d92c682b 100644
--- a/SDWebImage/Private/SDWeakProxy.h
+++ b/SDWebImage/Private/SDWeakProxy.h
@@ -9,6 +9,7 @@
 #import <Foundation/Foundation.h>
 #import "SDWebImageCompat.h"
 
+/// A weak proxy which forward all the message to the target
 @interface SDWeakProxy : NSProxy
 
 @property (nonatomic, weak, readonly, nullable) id target;

From f607e909bce79708cb7b5606c7f11e44574f4bfd Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 27 Feb 2020 16:31:54 +0800
Subject: [PATCH 112/181] Fix the SDWebImageDownloadStopNotification does not
 get removed on dealloc

---
 SDWebImage/Core/SDWebImageDownloader.m | 1 +
 1 file changed, 1 insertion(+)

diff --git a/SDWebImage/Core/SDWebImageDownloader.m b/SDWebImage/Core/SDWebImageDownloader.m
index d7deee95..3d354add 100644
--- a/SDWebImage/Core/SDWebImageDownloader.m
+++ b/SDWebImage/Core/SDWebImageDownloader.m
@@ -514,6 +514,7 @@ didReceiveResponse:(NSURLResponse *)response
 
 - (void)dealloc {
     [[NSNotificationCenter defaultCenter] removeObserver:self name:SDWebImageDownloadReceiveResponseNotification object:nil];
+    [[NSNotificationCenter defaultCenter] removeObserver:self name:SDWebImageDownloadStopNotification object:nil];
 }
 
 - (instancetype)initWithDownloadOperation:(NSOperation<SDWebImageDownloaderOperation> *)downloadOperation {

From eea85faaa5bb78b5b2e1ae8e92138790e92bba12 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 1 Mar 2020 15:44:06 +0800
Subject: [PATCH 113/181] Update the readme with SDWebImageLottiePlugin

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 58c85e8b..2ab5371a 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,7 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
 #### Integration with 3rd party libraries
+- [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie](https://github.com/airbnb/lottie-ios) animation with remote JSON files
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs
 - [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to integrate [YYImage](https://github.com/ibireme/YYImage) & [YYCache](https://github.com/ibireme/YYCache) for image rendering & caching
 

From 692f01b84b2f4e528514c3b1513c88585c8a1afe Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 2 Mar 2020 13:06:09 +0800
Subject: [PATCH 114/181] Fix the rare case when call
 `SDWebImageDownloaderOperation.cancel`, the completion block will callback
 twice

---
 SDWebImage/Core/SDWebImageDownloaderOperation.m | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.m b/SDWebImage/Core/SDWebImageDownloaderOperation.m
index 9411dcac..67d1a8e2 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.m
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.m
@@ -245,9 +245,10 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
         // maintain the isFinished and isExecuting flags.
         if (self.isExecuting) self.executing = NO;
         if (!self.isFinished) self.finished = YES;
+    } else {
+        // Operation cancelled by user during sending the request
+        [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during sending the request"}]];
     }
-    // Operation cancelled by user during sending the request
-    [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorCancelled userInfo:@{NSLocalizedDescriptionKey : @"Operation cancelled by user during sending the request"}]];
 
     [self reset];
 }

From 3df399508e38698cc115583ebfc03c353908921a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 1 Mar 2020 18:38:40 +0800
Subject: [PATCH 115/181] Add a better check to handle the cases when call
 `storeImage` without imageData. Firstly check SDAnimatedImage, then check
 sd_imageFormat.

---
 SDWebImage/Core/SDImageCache.m | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 362a299b..06bc49a5 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -187,13 +187,20 @@
         dispatch_async(self.ioQueue, ^{
             @autoreleasepool {
                 NSData *data = imageData;
+                if (!data && [image conformsToProtocol:@protocol(SDAnimatedImage)]) {
+                    // If image is custom animated image class, prefer its original animated data
+                    data = [((id<SDAnimatedImage>)image) animatedImageData];
+                }
                 if (!data && image) {
-                    // If we do not have any data to detect image format, check whether it contains alpha channel to use PNG or JPEG format
-                    SDImageFormat format;
-                    if ([SDImageCoderHelper CGImageContainsAlpha:image.CGImage]) {
-                        format = SDImageFormatPNG;
-                    } else {
-                        format = SDImageFormatJPEG;
+                    // Check image's associated image format, may return .undefined
+                    SDImageFormat format = image.sd_imageFormat;
+                    if (format == SDImageFormatUndefined) {
+                        // If we do not have any data to detect image format, check whether it contains alpha channel to use PNG or JPEG format
+                        if ([SDImageCoderHelper CGImageContainsAlpha:image.CGImage]) {
+                            format = SDImageFormatPNG;
+                        } else {
+                            format = SDImageFormatJPEG;
+                        }
                     }
                     data = [[SDImageCodersManager sharedManager] encodedDataWithImage:image format:format options:nil];
                 }

From 12bdd57f31cb041434705340997aa5d2557934a9 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 1 Mar 2020 18:51:48 +0800
Subject: [PATCH 116/181] Added the test case
 `test42StoreCacheWithImageAndFormatWithoutImageData` to ensure this behavior

---
 Tests/Tests/SDImageCacheTests.m | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index 516a7f36..f35d0c97 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -391,6 +391,36 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)test42StoreCacheWithImageAndFormatWithoutImageData {
+    XCTestExpectation *expectation1 = [self expectationWithDescription:@"StoreImage with sd_imageFormat should use that format"];
+    XCTestExpectation *expectation2 = [self expectationWithDescription:@"StoreImage with SDAnimatedImage should use animatedImageData"];
+    NSData *gifData = [NSData dataWithContentsOfFile:[self testGIFPath]];
+    
+    UIImage *gifImage = [UIImage sd_imageWithData:gifData]; // UIAnimatedImage
+    expect(gifImage.sd_isAnimated).beTruthy();
+    expect(gifImage.sd_imageFormat).equal(SDImageFormatGIF);
+    
+    NSString *kAnimatedImageKey1 = @"kAnimatedImageKey1";
+    NSString *kAnimatedImageKey2 = @"kAnimatedImageKey2";
+    [SDImageCache.sharedImageCache storeImage:gifImage forKey:kAnimatedImageKey1 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey1];
+        // Should save to GIF
+        expect(diskImage.sd_isAnimated).beTruthy();
+        expect(diskImage.sd_imageFormat).equal(SDImageFormatGIF);
+        [expectation1 fulfill];
+    }];
+    
+    SDAnimatedImage *animatedImage = [SDAnimatedImage imageWithData:gifData];
+    expect(animatedImage.animatedImageData).notTo.beNil();
+    [SDImageCache.sharedImageCache storeImage:animatedImage forKey:kAnimatedImageKey2 toDisk:YES completion:^{
+        NSData *data = [SDImageCache.sharedImageCache diskImageDataForKey:kAnimatedImageKey2];
+        // Should save with animatedImageData
+        expect(data).equal(animatedImage.animatedImageData);
+        [expectation2 fulfill];
+    }];
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 #pragma mark - SDMemoryCache & SDDiskCache
 - (void)test42CustomMemoryCache {
     SDImageCacheConfig *config = [[SDImageCacheConfig alloc] init];

From 6f8d83b2f29884fa88c7c85b783033155ee13951 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 2 Mar 2020 11:21:26 +0800
Subject: [PATCH 117/181] Add another logic. to check UIAnimatedImage when
 there are no image format to detect, this should use GIF to encode

---
 SDWebImage/Core/SDImageCache.h |  2 ++
 SDWebImage/Core/SDImageCache.m | 13 +++++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index 688d3fc2..1b1afd47 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -162,6 +162,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  * @param key             The unique image cache key, usually it's image absolute URL
  * @param toDisk          Store the image to disk cache if YES. If NO, the completion block is called synchronously
  * @param completionBlock A block executed after the operation is finished
+ * @note If no image data is provided and encode to disk, we will try to detect the image format (using either `sd_imageFormat` or `SDAnimatedImage` protocol method) and animation status, to choose the best matched format, including GIF, JPEG or PNG.
  */
 - (void)storeImage:(nullable UIImage *)image
             forKey:(nullable NSString *)key
@@ -178,6 +179,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  * @param key             The unique image cache key, usually it's image absolute URL
  * @param toDisk          Store the image to disk cache if YES. If NO, the completion block is called synchronously
  * @param completionBlock A block executed after the operation is finished
+ * @note If no image data is provided and encode to disk, we will try to detect the image format (using either `sd_imageFormat` or `SDAnimatedImage` protocol method) and animation status, to choose the best matched format, including GIF, JPEG or PNG.
  */
 - (void)storeImage:(nullable UIImage *)image
          imageData:(nullable NSData *)imageData
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 06bc49a5..17403997 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -195,11 +195,16 @@
                     // Check image's associated image format, may return .undefined
                     SDImageFormat format = image.sd_imageFormat;
                     if (format == SDImageFormatUndefined) {
-                        // If we do not have any data to detect image format, check whether it contains alpha channel to use PNG or JPEG format
-                        if ([SDImageCoderHelper CGImageContainsAlpha:image.CGImage]) {
-                            format = SDImageFormatPNG;
+                        // If image is animated, use GIF (APNG may be better, but has bugs before macOS 10.14)
+                        if (image.sd_isAnimated) {
+                            format = SDImageFormatGIF;
                         } else {
-                            format = SDImageFormatJPEG;
+                            // If we do not have any data to detect image format, check whether it contains alpha channel to use PNG or JPEG format
+                            if ([SDImageCoderHelper CGImageContainsAlpha:image.CGImage]) {
+                                format = SDImageFormatPNG;
+                            } else {
+                                format = SDImageFormatJPEG;
+                            }
                         }
                     }
                     data = [[SDImageCodersManager sharedManager] encodedDataWithImage:image format:format options:nil];

From d88b7d81db9ab5ffb976972cfd85a9a59df779f2 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 2 Mar 2020 11:28:07 +0800
Subject: [PATCH 118/181] Update the test case with Case 3: UIAnimatedImage
 without sd_imageFormat should use GIF not APNG

---
 Tests/Tests/SDImageCacheTests.m | 38 ++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index f35d0c97..701dd411 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -394,14 +394,18 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
 - (void)test42StoreCacheWithImageAndFormatWithoutImageData {
     XCTestExpectation *expectation1 = [self expectationWithDescription:@"StoreImage with sd_imageFormat should use that format"];
     XCTestExpectation *expectation2 = [self expectationWithDescription:@"StoreImage with SDAnimatedImage should use animatedImageData"];
-    NSData *gifData = [NSData dataWithContentsOfFile:[self testGIFPath]];
+    XCTestExpectation *expectation3 = [self expectationWithDescription:@"StoreImage with UIAnimatedImage without sd_imageFormat should use GIF"];
     
+    NSData *gifData = [NSData dataWithContentsOfFile:[self testGIFPath]];
     UIImage *gifImage = [UIImage sd_imageWithData:gifData]; // UIAnimatedImage
     expect(gifImage.sd_isAnimated).beTruthy();
     expect(gifImage.sd_imageFormat).equal(SDImageFormatGIF);
     
     NSString *kAnimatedImageKey1 = @"kAnimatedImageKey1";
     NSString *kAnimatedImageKey2 = @"kAnimatedImageKey2";
+    NSString *kAnimatedImageKey3 = @"kAnimatedImageKey3";
+    
+    // Case 1: UIImage with `sd_imageFormat` should use that format
     [SDImageCache.sharedImageCache storeImage:gifImage forKey:kAnimatedImageKey1 toDisk:YES completion:^{
         UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey1];
         // Should save to GIF
@@ -410,6 +414,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
         [expectation1 fulfill];
     }];
     
+    // Case 2: SDAnimatedImage should use `animatedImageData`
     SDAnimatedImage *animatedImage = [SDAnimatedImage imageWithData:gifData];
     expect(animatedImage.animatedImageData).notTo.beNil();
     [SDImageCache.sharedImageCache storeImage:animatedImage forKey:kAnimatedImageKey2 toDisk:YES completion:^{
@@ -418,6 +423,22 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
         expect(data).equal(animatedImage.animatedImageData);
         [expectation2 fulfill];
     }];
+    
+    // Case 3: UIAnimatedImage without sd_imageFormat should use GIF not APNG
+    NSData *apngData = [NSData dataWithContentsOfFile:[self testAPNGPath]];
+    UIImage *apngImage = [UIImage sd_imageWithData:apngData];
+    expect(apngImage.sd_isAnimated).beTruthy();
+    expect(apngImage.sd_imageFormat).equal(SDImageFormatPNG);
+    // Remove sd_imageFormat
+    apngImage.sd_imageFormat = SDImageFormatUndefined;
+    [SDImageCache.sharedImageCache storeImage:apngImage forKey:kAnimatedImageKey3 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey3];
+        // Should save to GIF
+        expect(diskImage.sd_isAnimated).beTruthy();
+        expect(diskImage.sd_imageFormat).equal(SDImageFormatGIF);
+        [expectation3 fulfill];
+    }];
+    
     [self waitForExpectationsWithCommonTimeout];
 }
 
@@ -757,6 +778,15 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     return reusableImage;
 }
 
+- (UIImage *)testAPNGImage {
+    static UIImage *reusableImage = nil;
+    if (!reusableImage) {
+        NSData *data = [NSData dataWithContentsOfFile:[self testAPNGPath]];
+        reusableImage = [UIImage sd_imageWithData:data];
+    }
+    return reusableImage;
+}
+
 - (NSString *)testJPEGPath {
     NSBundle *testBundle = [NSBundle bundleForClass:[self class]];
     return [testBundle pathForResource:@"TestImage" ofType:@"jpg"];
@@ -773,6 +803,12 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     return testPath;
 }
 
+- (NSString *)testAPNGPath {
+    NSBundle *testBundle = [NSBundle bundleForClass:[self class]];
+    NSString *testPath = [testBundle pathForResource:@"TestImageAnimated" ofType:@"apng"];
+    return testPath;
+}
+
 - (nullable NSString *)userCacheDirectory {
     NSArray<NSString *> *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
     return paths.firstObject;

From cc8e80ff84305122b6182ec1d7359670319782e0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 2 Mar 2020 12:02:19 +0800
Subject: [PATCH 119/181] Try to fix the test case
 `test11ThatCancelAllDownloadWorks` to make it stable

---
 Tests/Tests/SDWebImageDownloaderTests.m | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Tests/Tests/SDWebImageDownloaderTests.m b/Tests/Tests/SDWebImageDownloaderTests.m
index 467623ac..da0ee89b 100644
--- a/Tests/Tests/SDWebImageDownloaderTests.m
+++ b/Tests/Tests/SDWebImageDownloaderTests.m
@@ -187,10 +187,13 @@
 
 - (void)test11ThatCancelAllDownloadWorks {
     XCTestExpectation *expectation = [self expectationWithDescription:@"CancelAllDownloads"];
+    // Previous test case download may not finished, so we just check the download count should + 1 after new request
+    NSUInteger currentDownloadCount = [SDWebImageDownloader sharedDownloader].currentDownloadCount;
     
-    NSURL *imageURL = [NSURL URLWithString:@"http://via.placeholder.com/1100x1100.png"];
+    // Choose a large image to avoid download too fast
+    NSURL *imageURL = [NSURL URLWithString:@"https://www.sample-videos.com/img/Sample-png-image-1mb.png"];
     [[SDWebImageDownloader sharedDownloader] downloadImageWithURL:imageURL completed:nil];
-    expect([SDWebImageDownloader sharedDownloader].currentDownloadCount).to.equal(1);
+    expect([SDWebImageDownloader sharedDownloader].currentDownloadCount).to.equal(currentDownloadCount + 1);
     
     [[SDWebImageDownloader sharedDownloader] cancelAllDownloads];
     

From f415e51508bfaef46e515bfdab6bdf41c953d389 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 2 Mar 2020 12:21:15 +0800
Subject: [PATCH 120/181] Update the test case, because previouslly we have no
 test case about the storeImage behavior when imageData is nil

---
 Tests/Tests/SDImageCacheTests.m | 80 +++++++++++++++++++++++++--------
 1 file changed, 61 insertions(+), 19 deletions(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index 701dd411..93adcd47 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -392,51 +392,93 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
 }
 
 - (void)test42StoreCacheWithImageAndFormatWithoutImageData {
-    XCTestExpectation *expectation1 = [self expectationWithDescription:@"StoreImage with sd_imageFormat should use that format"];
-    XCTestExpectation *expectation2 = [self expectationWithDescription:@"StoreImage with SDAnimatedImage should use animatedImageData"];
-    XCTestExpectation *expectation3 = [self expectationWithDescription:@"StoreImage with UIAnimatedImage without sd_imageFormat should use GIF"];
+    XCTestExpectation *expectation1 = [self expectationWithDescription:@"StoreImage UIImage without sd_imageFormat should use PNG for alpha channel"];
+    XCTestExpectation *expectation2 = [self expectationWithDescription:@"StoreImage UIImage without sd_imageFormat should use JPEG for non-alpha channel"];
+    XCTestExpectation *expectation3 = [self expectationWithDescription:@"StoreImage UIImage/UIAnimatedImage with sd_imageFormat should use that format"];
+    XCTestExpectation *expectation4 = [self expectationWithDescription:@"StoreImage SDAnimatedImage should use animatedImageData"];
+    XCTestExpectation *expectation5 = [self expectationWithDescription:@"StoreImage UIAnimatedImage without sd_imageFormat should use GIF"];
+    
+    NSString *kAnimatedImageKey1 = @"kAnimatedImageKey1";
+    NSString *kAnimatedImageKey2 = @"kAnimatedImageKey2";
+    NSString *kAnimatedImageKey3 = @"kAnimatedImageKey3";
+    NSString *kAnimatedImageKey4 = @"kAnimatedImageKey4";
+    NSString *kAnimatedImageKey5 = @"kAnimatedImageKey5";
+    
+    // Case 1: UIImage without `sd_imageFormat` should use PNG for alpha channel
+    NSData *pngData = [NSData dataWithContentsOfFile:[self testPNGPath]];
+    UIImage *pngImage = [UIImage sd_imageWithData:pngData];
+    expect(pngImage.sd_isAnimated).beFalsy();
+    expect(pngImage.sd_imageFormat).equal(SDImageFormatPNG);
+    // Remove sd_imageFormat
+    pngImage.sd_imageFormat = SDImageFormatUndefined;
+    // Check alpha channel
+    expect([SDImageCoderHelper CGImageContainsAlpha:pngImage.CGImage]).beTruthy();
+    
+    [SDImageCache.sharedImageCache storeImage:pngImage forKey:kAnimatedImageKey1 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey1];
+        // Should save to PNG
+        expect(diskImage.sd_isAnimated).beFalsy();
+        expect(diskImage.sd_imageFormat).equal(SDImageFormatPNG);
+        [expectation1 fulfill];
+    }];
+    
+    // Case 2: UIImage without `sd_imageFormat` should use JPEG for non-alpha channel
+    SDGraphicsImageRendererFormat *format = [SDGraphicsImageRendererFormat preferredFormat];
+    format.opaque = YES;
+    SDGraphicsImageRenderer *renderer = [[SDGraphicsImageRenderer alloc] initWithSize:pngImage.size format:format];
+    // Non-alpha image, also test `SDGraphicsImageRenderer` behavior here :)
+    UIImage *nonAlphaImage = [renderer imageWithActions:^(CGContextRef  _Nonnull context) {
+        [pngImage drawInRect:CGRectMake(0, 0, pngImage.size.width, pngImage.size.height)];
+    }];
+    expect(nonAlphaImage).notTo.beNil();
+    expect([SDImageCoderHelper CGImageContainsAlpha:nonAlphaImage.CGImage]).beFalsy();
+    
+    [SDImageCache.sharedImageCache storeImage:nonAlphaImage forKey:kAnimatedImageKey2 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey2];
+        // Should save to JPEG
+        expect(diskImage.sd_isAnimated).beFalsy();
+        expect(diskImage.sd_imageFormat).equal(SDImageFormatJPEG);
+        [expectation2 fulfill];
+    }];
     
     NSData *gifData = [NSData dataWithContentsOfFile:[self testGIFPath]];
     UIImage *gifImage = [UIImage sd_imageWithData:gifData]; // UIAnimatedImage
     expect(gifImage.sd_isAnimated).beTruthy();
     expect(gifImage.sd_imageFormat).equal(SDImageFormatGIF);
     
-    NSString *kAnimatedImageKey1 = @"kAnimatedImageKey1";
-    NSString *kAnimatedImageKey2 = @"kAnimatedImageKey2";
-    NSString *kAnimatedImageKey3 = @"kAnimatedImageKey3";
-    
-    // Case 1: UIImage with `sd_imageFormat` should use that format
-    [SDImageCache.sharedImageCache storeImage:gifImage forKey:kAnimatedImageKey1 toDisk:YES completion:^{
-        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey1];
+    // Case 3: UIImage with `sd_imageFormat` should use that format
+    [SDImageCache.sharedImageCache storeImage:gifImage forKey:kAnimatedImageKey3 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey3];
         // Should save to GIF
         expect(diskImage.sd_isAnimated).beTruthy();
         expect(diskImage.sd_imageFormat).equal(SDImageFormatGIF);
-        [expectation1 fulfill];
+        [expectation3 fulfill];
     }];
     
-    // Case 2: SDAnimatedImage should use `animatedImageData`
+    // Case 4: SDAnimatedImage should use `animatedImageData`
     SDAnimatedImage *animatedImage = [SDAnimatedImage imageWithData:gifData];
     expect(animatedImage.animatedImageData).notTo.beNil();
-    [SDImageCache.sharedImageCache storeImage:animatedImage forKey:kAnimatedImageKey2 toDisk:YES completion:^{
-        NSData *data = [SDImageCache.sharedImageCache diskImageDataForKey:kAnimatedImageKey2];
+    [SDImageCache.sharedImageCache storeImage:animatedImage forKey:kAnimatedImageKey4 toDisk:YES completion:^{
+        NSData *data = [SDImageCache.sharedImageCache diskImageDataForKey:kAnimatedImageKey4];
         // Should save with animatedImageData
         expect(data).equal(animatedImage.animatedImageData);
-        [expectation2 fulfill];
+        [expectation4 fulfill];
     }];
     
-    // Case 3: UIAnimatedImage without sd_imageFormat should use GIF not APNG
+    // Case 5: UIAnimatedImage without sd_imageFormat should use GIF not APNG
     NSData *apngData = [NSData dataWithContentsOfFile:[self testAPNGPath]];
     UIImage *apngImage = [UIImage sd_imageWithData:apngData];
     expect(apngImage.sd_isAnimated).beTruthy();
     expect(apngImage.sd_imageFormat).equal(SDImageFormatPNG);
     // Remove sd_imageFormat
     apngImage.sd_imageFormat = SDImageFormatUndefined;
-    [SDImageCache.sharedImageCache storeImage:apngImage forKey:kAnimatedImageKey3 toDisk:YES completion:^{
-        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey3];
+    
+    [SDImageCache.sharedImageCache storeImage:apngImage forKey:kAnimatedImageKey5 toDisk:YES completion:^{
+        UIImage *diskImage = [SDImageCache.sharedImageCache imageFromDiskCacheForKey:kAnimatedImageKey5];
         // Should save to GIF
         expect(diskImage.sd_isAnimated).beTruthy();
         expect(diskImage.sd_imageFormat).equal(SDImageFormatGIF);
-        [expectation3 fulfill];
+        [expectation5 fulfill];
     }];
     
     [self waitForExpectationsWithCommonTimeout];

From 412269368ea7f80c63cad28f4f896afc0de3b6e0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 4 Mar 2020 12:16:34 +0800
Subject: [PATCH 121/181] Fix the SwiftPM Package.swift declaration for Xcode
 11.4-Beta 3 and old versions

---
 Package.swift | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/Package.swift b/Package.swift
index 50390b74..7dd16986 100644
--- a/Package.swift
+++ b/Package.swift
@@ -32,12 +32,16 @@ let package = Package(
             dependencies: [],
             path: "SDWebImage",
             exclude: ["MapKit"],
-            publicHeadersPath: "Core"
+            publicHeadersPath: "Core",
+            cSettings: [
+                .headerSearchPath("Private")
+            ]
         ),
         .target(
             name: "SDWebImageMapKit",
             dependencies: ["SDWebImage"],
-            path: "SDWebImage/MapKit"
+            path: "SDWebImage/MapKit",
+            publicHeadersPath: "."
         )
     ]
 )

From f0388739b6421f653d5adc20bb8f9818821c0633 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 4 Mar 2020 11:37:43 +0800
Subject: [PATCH 122/181] Add the new context option, including the cache,
 loader and coder. They can be used to use custom cache/loader in a more
 convenient way, instead of creating dummy SDWebImageManager

---
 SDWebImage/Core/SDImageCacheDefine.m | 10 ++++-
 SDWebImage/Core/SDImageLoader.m      | 29 ++++++++++----
 SDWebImage/Core/SDWebImageDefine.h   | 20 ++++++++++
 SDWebImage/Core/SDWebImageDefine.m   |  3 ++
 SDWebImage/Core/SDWebImageManager.m  | 57 +++++++++++++++++++++-------
 5 files changed, 98 insertions(+), 21 deletions(-)

diff --git a/SDWebImage/Core/SDImageCacheDefine.m b/SDWebImage/Core/SDImageCacheDefine.m
index 75dfb4e6..19db161a 100644
--- a/SDWebImage/Core/SDImageCacheDefine.m
+++ b/SDWebImage/Core/SDImageCacheDefine.m
@@ -38,6 +38,14 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
     mutableCoderOptions[SDImageCoderWebImageContext] = context;
     SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
+    // Grab the image coder
+    id<SDImageCoder> imageCoder;
+    if ([context[SDWebImageContextImageCoder] conformsToProtocol:@protocol(SDImageCoder)]) {
+        imageCoder = context[SDWebImageContextImageCoder];
+    } else {
+        imageCoder = [SDImageCodersManager sharedManager];
+    }
+    
     if (!decodeFirstFrame) {
         Class animatedImageClass = context[SDWebImageContextAnimatedImageClass];
         // check whether we should use `SDAnimatedImage`
@@ -57,7 +65,7 @@ UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonnull imageData, NSS
         }
     }
     if (!image) {
-        image = [[SDImageCodersManager sharedManager] decodedImageWithData:imageData options:coderOptions];
+        image = [imageCoder decodedImageWithData:imageData options:coderOptions];
     }
     if (image) {
         BOOL shouldDecode = !SD_OPTIONS_CONTAINS(options, SDWebImageAvoidDecodeImage);
diff --git a/SDWebImage/Core/SDImageLoader.m b/SDWebImage/Core/SDImageLoader.m
index 4c831c59..c529954e 100644
--- a/SDWebImage/Core/SDImageLoader.m
+++ b/SDWebImage/Core/SDImageLoader.m
@@ -52,6 +52,14 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
     mutableCoderOptions[SDImageCoderWebImageContext] = context;
     SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
+    // Grab the image coder
+    id<SDImageCoder> imageCoder;
+    if ([context[SDWebImageContextImageCoder] conformsToProtocol:@protocol(SDImageCoder)]) {
+        imageCoder = context[SDWebImageContextImageCoder];
+    } else {
+        imageCoder = [SDImageCodersManager sharedManager];
+    }
+    
     if (!decodeFirstFrame) {
         // check whether we should use `SDAnimatedImage`
         Class animatedImageClass = context[SDWebImageContextAnimatedImageClass];
@@ -71,7 +79,7 @@ UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NS
         }
     }
     if (!image) {
-        image = [[SDImageCodersManager sharedManager] decodedImageWithData:imageData options:coderOptions];
+        image = [imageCoder decodedImageWithData:imageData options:coderOptions];
     }
     if (image) {
         BOOL shouldDecode = !SD_OPTIONS_CONTAINS(options, SDWebImageAvoidDecodeImage);
@@ -127,14 +135,21 @@ UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull im
     mutableCoderOptions[SDImageCoderWebImageContext] = context;
     SDImageCoderOptions *coderOptions = [mutableCoderOptions copy];
     
+    // Grab the progressive image coder
     id<SDProgressiveImageCoder> progressiveCoder = objc_getAssociatedObject(operation, SDImageLoaderProgressiveCoderKey);
     if (!progressiveCoder) {
-        // We need to create a new instance for progressive decoding to avoid conflicts
-        for (id<SDImageCoder>coder in [SDImageCodersManager sharedManager].coders.reverseObjectEnumerator) {
-            if ([coder conformsToProtocol:@protocol(SDProgressiveImageCoder)] &&
-                [((id<SDProgressiveImageCoder>)coder) canIncrementalDecodeFromData:imageData]) {
-                progressiveCoder = [[[coder class] alloc] initIncrementalWithOptions:coderOptions];
-                break;
+        id<SDProgressiveImageCoder> imageCoder = context[SDWebImageContextImageCoder];
+        // Check the progressive coder if provided
+        if ([imageCoder conformsToProtocol:@protocol(SDProgressiveImageCoder)]) {
+            progressiveCoder = [[[imageCoder class] alloc] initIncrementalWithOptions:coderOptions];
+        } else {
+            // We need to create a new instance for progressive decoding to avoid conflicts
+            for (id<SDImageCoder> coder in [SDImageCodersManager sharedManager].coders.reverseObjectEnumerator) {
+                if ([coder conformsToProtocol:@protocol(SDProgressiveImageCoder)] &&
+                    [((id<SDProgressiveImageCoder>)coder) canIncrementalDecodeFromData:imageData]) {
+                    progressiveCoder = [[[coder class] alloc] initIncrementalWithOptions:coderOptions];
+                    break;
+                }
             }
         }
         objc_setAssociatedObject(operation, SDImageLoaderProgressiveCoderKey, progressiveCoder, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 568de147..4ad3aca9 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -213,9 +213,29 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextSetIma
 
 /**
  A SDWebImageManager instance to control the image download and cache process using in UIImageView+WebCache category and likes. If not provided, use the shared manager (SDWebImageManager *)
+ @note Consider deprecated. This context options can be replaced by other context option control like `.imageCache`, `.imageLoader`, `.imageTransofmer` (See below), which already matches all the properties in SDWebImageManager.
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextCustomManager;
 
+/**
+ A id<SDImageCache> instance which conforms to `SDImageCache` protocol. It's used to override the image mananger's cache during the image loading pipeline.
+ In other word, if you just want to specify a custom cache during image loading, you don't need to re-create a dummy SDWebImageManager instance with the cache. If not provided, use the image manager's cache (id<SDImageCache>)
+ */
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageCache;
+
+/**
+ A id<SDImageLoader> instance which conforms to `SDImageLoader` protocol. It's used to override the image mananger's loader during the image loading pipeline.
+ In other word, if you just want to specify a custom loader during image loading, you don't need to re-create a dummy SDWebImageManager instance with the loader. If not provided, use the image manager's cache (id<SDImageLoader>)
+*/
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageLoader;
+
+/**
+ A id<SDImageCoder> instance which conforms to `SDImageCoder` protocol. It's used to override the default image codre for image decoding(including progressive) and encoding during the image loading process.
+ If you use this context option, we will not always use `SDImageCodersManager.shared` to loop through all registered coders and find the suitable one. Instead, we will arbitrarily use the exact provided coder without extra checking (We may not call `canDecodeFromData:`).
+ @note This is only useful for cases which you can ensure the loading url matches your coder, or you find it's too hard to write a common coder which can used for generic usage. This will bind the loading url with the coder logic, which is not always a good design, but possible. (id<SDImageCache>)
+*/
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageCoder;
+
 /**
  A id<SDImageTransformer> instance which conforms `SDImageTransformer` protocol. It's used for image transform after the image load finished and store the transformed image to cache. If you provide one, it will ignore the `transformer` in manager and use provided one instead. (id<SDImageTransformer>)
  */
diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 921e878a..866b164d 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -120,6 +120,9 @@ inline UIImage * _Nullable SDScaledImageForScaleFactor(CGFloat scale, UIImage *
 
 SDWebImageContextOption const SDWebImageContextSetImageOperationKey = @"setImageOperationKey";
 SDWebImageContextOption const SDWebImageContextCustomManager = @"customManager";
+SDWebImageContextOption const SDWebImageContextImageCache = @"imageCache";
+SDWebImageContextOption const SDWebImageContextImageLoader = @"imageLoader";
+SDWebImageContextOption const SDWebImageContextImageCoder = @"imageCoder";
 SDWebImageContextOption const SDWebImageContextImageTransformer = @"imageTransformer";
 SDWebImageContextOption const SDWebImageContextImageScaleFactor = @"imageScaleFactor";
 SDWebImageContextOption const SDWebImageContextImagePreserveAspectRatio = @"imagePreserveAspectRatio";
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index c5502cc3..c4aff6ac 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -211,12 +211,19 @@ static id<SDImageLoader> _defaultImageLoader;
                              context:(nullable SDWebImageContext *)context
                             progress:(nullable SDImageLoaderProgressBlock)progressBlock
                            completed:(nullable SDInternalCompletionBlock)completedBlock {
+    // Grab the image cache to use
+    id<SDImageCache> imageCache;
+    if ([context[SDWebImageContextImageCache] conformsToProtocol:@protocol(SDImageCache)]) {
+        imageCache = context[SDWebImageContextImageCache];
+    } else {
+        imageCache = self.imageCache;
+    }
     // Check whether we should query cache
     BOOL shouldQueryCache = !SD_OPTIONS_CONTAINS(options, SDWebImageFromLoaderOnly);
     if (shouldQueryCache) {
         NSString *key = [self cacheKeyForURL:url context:context];
         @weakify(operation);
-        operation.cacheOperation = [self.imageCache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable cachedImage, NSData * _Nullable cachedData, SDImageCacheType cacheType) {
+        operation.cacheOperation = [imageCache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable cachedImage, NSData * _Nullable cachedData, SDImageCacheType cacheType) {
             @strongify(operation);
             if (!operation || operation.isCancelled) {
                 // Image combined operation cancelled by user
@@ -243,11 +250,18 @@ static id<SDImageLoader> _defaultImageLoader;
                               cacheType:(SDImageCacheType)cacheType
                                progress:(nullable SDImageLoaderProgressBlock)progressBlock
                               completed:(nullable SDInternalCompletionBlock)completedBlock {
+    // Grab the image loader to use
+    id<SDImageLoader> imageLoader;
+    if ([context[SDWebImageContextImageLoader] conformsToProtocol:@protocol(SDImageLoader)]) {
+        imageLoader = context[SDWebImageContextImageLoader];
+    } else {
+        imageLoader = self.imageLoader;
+    }
     // Check whether we should download image from network
     BOOL shouldDownload = !SD_OPTIONS_CONTAINS(options, SDWebImageFromCacheOnly);
     shouldDownload &= (!cachedImage || options & SDWebImageRefreshCached);
     shouldDownload &= (![self.delegate respondsToSelector:@selector(imageManager:shouldDownloadImageForURL:)] || [self.delegate imageManager:self shouldDownloadImageForURL:url]);
-    shouldDownload &= [self.imageLoader canRequestImageForURL:url];
+    shouldDownload &= [imageLoader canRequestImageForURL:url];
     if (shouldDownload) {
         if (cachedImage && options & SDWebImageRefreshCached) {
             // If image was found in the cache but SDWebImageRefreshCached is provided, notify about the cached image
@@ -265,7 +279,7 @@ static id<SDImageLoader> _defaultImageLoader;
         }
         
         @weakify(operation);
-        operation.loaderOperation = [self.imageLoader requestImageWithURL:url options:options context:context progress:progressBlock completed:^(UIImage *downloadedImage, NSData *downloadedData, NSError *error, BOOL finished) {
+        operation.loaderOperation = [imageLoader requestImageWithURL:url options:options context:context progress:progressBlock completed:^(UIImage *downloadedImage, NSData *downloadedData, NSError *error, BOOL finished) {
             @strongify(operation);
             if (!operation || operation.isCancelled) {
                 // Image combined operation cancelled by user
@@ -277,7 +291,7 @@ static id<SDImageLoader> _defaultImageLoader;
                 [self callCompletionBlockForOperation:operation completion:completedBlock error:error url:url];
             } else if (error) {
                 [self callCompletionBlockForOperation:operation completion:completedBlock error:error url:url];
-                BOOL shouldBlockFailedURL = [self shouldBlockFailedURLWithURL:url error:error];
+                BOOL shouldBlockFailedURL = [self shouldBlockFailedURLWithURL:url error:error options:options context:context];
                 
                 if (shouldBlockFailedURL) {
                     SD_LOCK(self.failedURLsLock);
@@ -336,7 +350,6 @@ static id<SDImageLoader> _defaultImageLoader;
     shouldTransformImage = shouldTransformImage && (!downloadedImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage));
     shouldTransformImage = shouldTransformImage && (!downloadedImage.sd_isVector || (options & SDWebImageTransformVectorImage));
     BOOL shouldCacheOriginal = downloadedImage && finished;
-    BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     
     // if available, store original image to cache
     if (shouldCacheOriginal) {
@@ -346,14 +359,14 @@ static id<SDImageLoader> _defaultImageLoader;
             dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0), ^{
                 @autoreleasepool {
                     NSData *cacheData = [cacheSerializer cacheDataWithImage:downloadedImage originalData:downloadedData imageURL:url];
-                    [self storeImage:downloadedImage imageData:cacheData forKey:key cacheType:targetStoreCacheType waitStoreCache:waitStoreCache completion:^{
+                    [self storeImage:downloadedImage imageData:cacheData forKey:key cacheType:targetStoreCacheType options:options context:context completion:^{
                         // Continue transform process
                         [self callTransformProcessForOperation:operation url:url options:options context:context originalImage:downloadedImage originalData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
                     }];
                 }
             });
         } else {
-            [self storeImage:downloadedImage imageData:downloadedData forKey:key cacheType:targetStoreCacheType waitStoreCache:waitStoreCache completion:^{
+            [self storeImage:downloadedImage imageData:downloadedData forKey:key cacheType:targetStoreCacheType options:options context:context completion:^{
                 // Continue transform process
                 [self callTransformProcessForOperation:operation url:url options:options context:context originalImage:downloadedImage originalData:downloadedData finished:finished progress:progressBlock completed:completedBlock];
             }];
@@ -385,7 +398,6 @@ static id<SDImageLoader> _defaultImageLoader;
     BOOL shouldTransformImage = originalImage && transformer;
     shouldTransformImage = shouldTransformImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage));
     shouldTransformImage = shouldTransformImage && (!originalImage.sd_isVector || (options & SDWebImageTransformVectorImage));
-    BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     // if available, store transformed image to cache
     if (shouldTransformImage) {
         dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_HIGH, 0), ^{
@@ -404,7 +416,7 @@ static id<SDImageLoader> _defaultImageLoader;
                     }
                     // keep the original image format and extended data
                     SDImageCopyAssociatedObject(originalImage, transformedImage);
-                    [self storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType waitStoreCache:waitStoreCache completion:^{
+                    [self storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType options:options context:context completion:^{
                         [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
                     }];
                 } else {
@@ -432,10 +444,18 @@ static id<SDImageLoader> _defaultImageLoader;
          imageData:(nullable NSData *)data
             forKey:(nullable NSString *)key
          cacheType:(SDImageCacheType)cacheType
-    waitStoreCache:(BOOL)waitStoreCache
+           options:(SDWebImageOptions)options
+           context:(nullable SDWebImageContext *)context
         completion:(nullable SDWebImageNoParamsBlock)completion {
+    id<SDImageCache> imageCache;
+    if ([context[SDWebImageContextImageCache] conformsToProtocol:@protocol(SDImageCache)]) {
+        imageCache = context[SDWebImageContextImageCache];
+    } else {
+        imageCache = self.imageCache;
+    }
+    BOOL waitStoreCache = SD_OPTIONS_CONTAINS(options, SDWebImageWaitStoreCache);
     // Check whether we should wait the store cache finished. If not, callback immediately
-    [self.imageCache storeImage:image imageData:data forKey:key cacheType:cacheType completion:^{
+    [imageCache storeImage:image imageData:data forKey:key cacheType:cacheType completion:^{
         if (waitStoreCache) {
             if (completion) {
                 completion();
@@ -472,13 +492,24 @@ static id<SDImageLoader> _defaultImageLoader;
 }
 
 - (BOOL)shouldBlockFailedURLWithURL:(nonnull NSURL *)url
-                              error:(nonnull NSError *)error {
+                              error:(nonnull NSError *)error
+                            options:(SDWebImageOptions)options
+                            context:(nullable SDWebImageContext *)context {
+    if ((options & SDWebImageRetryFailed)) {
+        return NO;
+    }
+    id<SDImageLoader> imageLoader;
+    if ([context[SDWebImageContextImageLoader] conformsToProtocol:@protocol(SDImageLoader)]) {
+        imageLoader = context[SDWebImageContextImageLoader];
+    } else {
+        imageLoader = self.imageLoader;
+    }
     // Check whether we should block failed url
     BOOL shouldBlockFailedURL;
     if ([self.delegate respondsToSelector:@selector(imageManager:shouldBlockFailedURL:withError:)]) {
         shouldBlockFailedURL = [self.delegate imageManager:self shouldBlockFailedURL:url withError:error];
     } else {
-        shouldBlockFailedURL = [self.imageLoader shouldBlockFailedURLWithURL:url error:error];
+        shouldBlockFailedURL = [imageLoader shouldBlockFailedURLWithURL:url error:error];
     }
     
     return shouldBlockFailedURL;

From 2abb8d06281ed22df747d9f8d24110850dfcf4e8 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 4 Mar 2020 12:25:59 +0800
Subject: [PATCH 123/181] Formal deprecate the SDWebImageContextCustomManager
 context option

---
 SDWebImage/Core/SDWebImageDefine.h | 4 ++--
 SDWebImage/Core/UIView+WebCache.m  | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 4ad3aca9..52d79674 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -213,9 +213,9 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextSetIma
 
 /**
  A SDWebImageManager instance to control the image download and cache process using in UIImageView+WebCache category and likes. If not provided, use the shared manager (SDWebImageManager *)
- @note Consider deprecated. This context options can be replaced by other context option control like `.imageCache`, `.imageLoader`, `.imageTransofmer` (See below), which already matches all the properties in SDWebImageManager.
+ @deprecated Deprecated. This context options can be replaced by other context option control like `.imageCache`, `.imageLoader`, `.imageTransofmer` (See below), which already matches all the properties in SDWebImageManager.
  */
-FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextCustomManager;
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextCustomManager __deprecated_msg("Use individual context option like .imageCache, .imageLoader and .imageTransformer instead");
 
 /**
  A id<SDImageCache> instance which conforms to `SDImageCache` protocol. It's used to override the image mananger's cache during the image loading pipeline.
diff --git a/SDWebImage/Core/UIView+WebCache.m b/SDWebImage/Core/UIView+WebCache.m
index 311dd1ba..7a3ffa6d 100644
--- a/SDWebImage/Core/UIView+WebCache.m
+++ b/SDWebImage/Core/UIView+WebCache.m
@@ -80,11 +80,13 @@ const int64_t SDWebImageProgressUnitCountUnknown = 1LL;
         [self sd_startImageIndicator];
         id<SDWebImageIndicator> imageIndicator = self.sd_imageIndicator;
 #endif
-        
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
         SDWebImageManager *manager = context[SDWebImageContextCustomManager];
         if (!manager) {
             manager = [SDWebImageManager sharedManager];
         }
+#pragma clang diagnostic pop
         
         SDImageLoaderProgressBlock combinedProgressBlock = ^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {
             if (imageProgress) {

From 8736d98f850ab1cceb9629d8270a48546ee8e382 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 4 Mar 2020 12:52:02 +0800
Subject: [PATCH 124/181] Fix the compatible with Xcode 11.0~Xcode 11.3 on
 SwiftPM, the `exclude` arg does not treat the source code in the
 publicHeadersPath.

---
 Package.swift | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Package.swift b/Package.swift
index 7dd16986..b8f49233 100644
--- a/Package.swift
+++ b/Package.swift
@@ -31,7 +31,7 @@ let package = Package(
             name: "SDWebImage",
             dependencies: [],
             path: "SDWebImage",
-            exclude: ["MapKit"],
+            sources: ["Core", "Private"],
             publicHeadersPath: "Core",
             cSettings: [
                 .headerSearchPath("Private")

From cf79d1c3aefb0dff7f5a8c806da9ff787a65ea9a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Mar 2020 17:00:04 +0800
Subject: [PATCH 125/181] Revert the changes to check `SDWebImageRetryFailed`
 before adding the black list. This is the previous version behavior.

---
 SDWebImage/Core/SDWebImageManager.m | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index c4aff6ac..4d33e6d7 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -495,9 +495,6 @@ static id<SDImageLoader> _defaultImageLoader;
                               error:(nonnull NSError *)error
                             options:(SDWebImageOptions)options
                             context:(nullable SDWebImageContext *)context {
-    if ((options & SDWebImageRetryFailed)) {
-        return NO;
-    }
     id<SDImageLoader> imageLoader;
     if ([context[SDWebImageContextImageLoader] conformsToProtocol:@protocol(SDImageLoader)]) {
         imageLoader = context[SDWebImageContextImageLoader];

From b54cdcc4bbbd47342634566b3df0682a90a40336 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Mar 2020 17:55:39 +0800
Subject: [PATCH 126/181] Change the deprecatation into the soft deprecation,
 which still works but will be removed in SDWebImage 6.0.0

---
 SDWebImage/Core/SDWebImageDefine.h | 4 ++--
 SDWebImage/Core/UIView+WebCache.m  | 3 ---
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 52d79674..1be59810 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -213,9 +213,9 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextSetIma
 
 /**
  A SDWebImageManager instance to control the image download and cache process using in UIImageView+WebCache category and likes. If not provided, use the shared manager (SDWebImageManager *)
- @deprecated Deprecated. This context options can be replaced by other context option control like `.imageCache`, `.imageLoader`, `.imageTransofmer` (See below), which already matches all the properties in SDWebImageManager.
+ @deprecated Deprecated in the future. This context options can be replaced by other context option control like `.imageCache`, `.imageLoader`, `.imageTransofmer` (See below), which already matches all the properties in SDWebImageManager.
  */
-FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextCustomManager __deprecated_msg("Use individual context option like .imageCache, .imageLoader and .imageTransformer instead");
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextCustomManager API_DEPRECATED("Use individual context option like .imageCache, .imageLoader and .imageTransformer instead", macos(10.10, API_TO_BE_DEPRECATED), ios(8.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED), watchos(2.0, API_TO_BE_DEPRECATED));
 
 /**
  A id<SDImageCache> instance which conforms to `SDImageCache` protocol. It's used to override the image mananger's cache during the image loading pipeline.
diff --git a/SDWebImage/Core/UIView+WebCache.m b/SDWebImage/Core/UIView+WebCache.m
index 7a3ffa6d..5e9f030a 100644
--- a/SDWebImage/Core/UIView+WebCache.m
+++ b/SDWebImage/Core/UIView+WebCache.m
@@ -80,13 +80,10 @@ const int64_t SDWebImageProgressUnitCountUnknown = 1LL;
         [self sd_startImageIndicator];
         id<SDWebImageIndicator> imageIndicator = self.sd_imageIndicator;
 #endif
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Wdeprecated-declarations"
         SDWebImageManager *manager = context[SDWebImageContextCustomManager];
         if (!manager) {
             manager = [SDWebImageManager sharedManager];
         }
-#pragma clang diagnostic pop
         
         SDImageLoaderProgressBlock combinedProgressBlock = ^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {
             if (imageProgress) {

From bd33f4179ddc9fff5ad8f6de3a94623f3446b8c9 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Mar 2020 18:44:50 +0800
Subject: [PATCH 127/181] Supresss the deprecation warning when min deployment
 target version set to iOS 13+ or macCatalyst

---
 SDWebImage/Core/SDGraphicsImageRenderer.m | 3 +++
 SDWebImage/Core/SDImageCache.m            | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/SDWebImage/Core/SDGraphicsImageRenderer.m b/SDWebImage/Core/SDGraphicsImageRenderer.m
index 869de2ca..03aef3a5 100644
--- a/SDWebImage/Core/SDGraphicsImageRenderer.m
+++ b/SDWebImage/Core/SDGraphicsImageRenderer.m
@@ -69,6 +69,8 @@
 #endif
 }
 
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
 - (SDGraphicsImageRendererFormatRange)preferredRange {
 #if SD_UIKIT
     if (@available(iOS 10.0, tvOS 10.10, *)) {
@@ -114,6 +116,7 @@
     _preferredRange = preferredRange;
 #endif
 }
+#pragma clang diagnostic pop
 
 - (instancetype)init {
     self = [super init];
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 17403997..f7585895 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -223,7 +223,10 @@
                             }
                         } else {
                             @try {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
                                 extendedData = [NSKeyedArchiver archivedDataWithRootObject:extendedObject];
+#pragma clang diagnostic pop
                             } @catch (NSException *exception) {
                                 NSLog(@"NSKeyedArchiver archive failed with exception: %@", exception);
                             }
@@ -397,7 +400,10 @@
                     }
                 } else {
                     @try {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
                         extendedObject = [NSKeyedUnarchiver unarchiveObjectWithData:extendedData];
+#pragma clang diagnostic pop
                     } @catch (NSException *exception) {
                         NSLog(@"NSKeyedUnarchiver unarchive failed with exception: %@", exception);
                     }

From aa7cc070ccf01ce6ea85dd0b3176f712ac23ea1a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 5 Mar 2020 18:48:43 +0800
Subject: [PATCH 128/181] Bumped version to 5.6.0

Update the CHANGELOG
---
 CHANGELOG.md        | 34 ++++++++++++++++++++++++++++++++--
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 35 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 33987189..c56f967b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,38 @@
+## [5.6.0 - URLSession Metrics && Vector Format, on Mar 5th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.6.0)
+See [all tickets marked for the 5.6.0 release](https://github.com/SDWebImage/SDWebImage/milestone/63)
+
+### Features
+
+#### URLSession Metrics
+- Added the URLSessionTaskMetrics support for downloader && operation, which can be used for network metrics #2937
+- Typically you use custom operation class to collect all metrics in your app. You can also collect metrics for single url request level. Check the #2937 example code to grab the download token and check metrics.
+
+#### Vector Image
+- Feature - better support for vector format detection, now PDF rasterized bitmap is built-in #2936
+- Pass `.thumbnailPixelSize` to control the PDF bitmap size. If you want vector PDF rendering, you still need to use [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder).
+- Vector image like SVG (via [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder)) and PDF (via [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder)), or system symbol images, can be detected by new API `sd_isVector`.
+- Vector image does not pass to transformer by default, because they support dynamic size changing. Pass `.transformVectorImage` option to allow transformation.
+
+#### Cache
+- Add a better check to handle the cases when call `storeImage` without imageData #2953
+- Which means, if you store image to disk without data, we will use extra information via `sd_imageFormat` or custom image class, to choose the the image format (including GIF and PDF) for encoding. Previously we only encode it into PNG or JPEG.
+
+#### Context Option
+- Feature add context option for cache, loader and coder, deprecated SDWebImageContextCustomManager #2955
+- This makes it easy to use custom loader, cache, and decoder, without need to create a dummy SDWebImageManager instance.
+
+### Fixes
+- Fix the rare case when call `SDWebImageDownloaderOperation.cancel`, the completion block may callback twice #2954
+
+### Warnings
+- Suppress the deprecation warning when min deployment target version set to iOS 13+ or macCatalyst
+- Complete all the SDWebImage error code with the localized description, make it easy for debugging #2948
+
 ## [5.5.2 - 5.5 Patch, on Jan 26th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.2)
 See [all tickets marked for the 5.5.2 release](https://github.com/SDWebImage/SDWebImage/milestone/62)
 
 ### Fixes
-- Fix the issue that `maxBufferSize` property does not correctlly works for `SDAnimatedImageView` #2934
+- Fix the issue that `maxBufferSize` property does not correctly works for `SDAnimatedImageView` #2934
 
 ## [5.5.1 - 5.5 Patch, on Jan 18th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.1)
 See [all tickets marked for the 5.5.1 release](https://github.com/SDWebImage/SDWebImage/milestone/59)
@@ -10,7 +40,7 @@ See [all tickets marked for the 5.5.1 release](https://github.com/SDWebImage/SDW
 ### Fixes
 - Fix the SDAnimatedImageView's progressive animation bug, which reset the frame index to 0 each time new frames available #2931
 
-## [5.5.0 - Thumbnail Decoding && Core Image, onJan, 16th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.0)
+## [5.5.0 - Thumbnail Decoding && Core Image, on Jan 16th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.5.0)
 See [all tickets marked for the 5.5.0 release](https://github.com/SDWebImage/SDWebImage/milestone/55)
 
 ### Features
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 0ae96891..919e806f 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.5.2'
+  s.version = '5.6.0'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 7163374f..94bc5516 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.5.2</string>
+	<string>5.6.0</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.5.2</string>
+	<string>5.6.0</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 4b0c4c7d8ca1038b0c72a957f53a016af0856e8b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 9 Mar 2020 20:05:33 +0800
Subject: [PATCH 129/181] Update the readme about Lottie animation coder,
 describe the coder's base codec as well.

---
 README.md | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 2ab5371a..7f9c5df9 100644
--- a/README.md
+++ b/README.md
@@ -52,13 +52,14 @@ As such, we have moved/built new modules to [SDWebImage org](https://github.com/
 We support SwiftUI by building with the functions (caching, loading and animation) powered by SDWebImage. You can have a try with [SDWebImageSwiftUI](https://github.com/SDWebImage/SDWebImageSwiftUI)
 
 #### Coders for additional image formats
-- [SDWebImageWebPCoder](https://github.com/SDWebImage/SDWebImageWebPCoder) - coder for WebP image format. Based on [libwebp](https://chromium.googlesource.com/webm/libwebp)
-- [SDWebImageHEIFCoder](https://github.com/SDWebImage/SDWebImageHEIFCoder) - coder to support HEIF image without Apple's `Image/IO framework`, iOS 8+/macOS 10.10+ support.
-- [SDWebImageBPGCoder](https://github.com/SDWebImage/SDWebImageBPGCoder) - coder for BPG format
-- [SDWebImageFLIFCoder](https://github.com/SDWebImage/SDWebImageFLIFCoder) - coder for FLIF format
-- [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder) - coder for AVIF (AV1-based) format
-- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format image
-- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format image
+- [SDWebImageWebPCoder](https://github.com/SDWebImage/SDWebImageWebPCoder) - coder for WebP format. Based on [libwebp](https://chromium.googlesource.com/webm/libwebp)
+- [SDWebImageHEIFCoder](https://github.com/SDWebImage/SDWebImageHEIFCoder) - coder for HEIF format, iOS 8+/macOS 10.10+ support. Based on [libheif](https://github.com/strukturag/libheif)
+- [SDWebImageBPGCoder](https://github.com/SDWebImage/SDWebImageBPGCoder) - coder for BPG format. Based on [libbpg](https://github.com/mirrorer/libbpg)
+- [SDWebImageFLIFCoder](https://github.com/SDWebImage/SDWebImageFLIFCoder) - coder for FLIF format. Based on [libflif](https://github.com/FLIF-hub/FLIF)
+- [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder) - coder for AVIF (AV1-based) format. Based on [libavif](https://github.com/AOMediaCodec/libavif)
+- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format.
+- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format.
+- [SDWebImageLottieCoder](https://github.com/SDWebImage/SDWebImageLottieCoder) - coder for Lottie animation format. Based on [rlottie](https://github.com/Samsung/rlottie)
 - and more from community!
 
 #### Loaders
@@ -66,7 +67,8 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
 #### Integration with 3rd party libraries
-- [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie](https://github.com/airbnb/lottie-ios) animation with remote JSON files
+- [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie-iOS](https://github.com/airbnb/lottie-ios), vector animation rending with JSON files
+- [SDWebImageSVGKitPlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [SVGKit](https://github.com/SDWebImage/SDWebImageSVGKitPlugin), SVG using Core Animation rendering
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs
 - [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to integrate [YYImage](https://github.com/ibireme/YYImage) & [YYCache](https://github.com/ibireme/YYCache) for image rendering & caching
 

From b080a4c5a240654c0537d92176bbb3f6226a3a11 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 9 Mar 2020 20:11:23 +0800
Subject: [PATCH 130/181] Update the readme again about the coder plugins's
 framework and Animated Image

---
 README.md | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 7f9c5df9..0b65b8ef 100644
--- a/README.md
+++ b/README.md
@@ -57,8 +57,8 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageBPGCoder](https://github.com/SDWebImage/SDWebImageBPGCoder) - coder for BPG format. Based on [libbpg](https://github.com/mirrorer/libbpg)
 - [SDWebImageFLIFCoder](https://github.com/SDWebImage/SDWebImageFLIFCoder) - coder for FLIF format. Based on [libflif](https://github.com/FLIF-hub/FLIF)
 - [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder) - coder for AVIF (AV1-based) format. Based on [libavif](https://github.com/AOMediaCodec/libavif)
-- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format.
-- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format.
+- [SDWebImagePDFCoder](https://github.com/SDWebImage/SDWebImagePDFCoder) - coder for PDF vector format. Using built-in frameworks
+- [SDWebImageSVGCoder](https://github.com/SDWebImage/SDWebImageSVGCoder) - coder for SVG vector format. Using built-in frameworks
 - [SDWebImageLottieCoder](https://github.com/SDWebImage/SDWebImageLottieCoder) - coder for Lottie animation format. Based on [rlottie](https://github.com/Samsung/rlottie)
 - and more from community!
 
@@ -67,8 +67,8 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
 #### Integration with 3rd party libraries
-- [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie-iOS](https://github.com/airbnb/lottie-ios), vector animation rending with JSON files
-- [SDWebImageSVGKitPlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [SVGKit](https://github.com/SDWebImage/SDWebImageSVGKitPlugin), SVG using Core Animation rendering
+- [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie-iOS](https://github.com/airbnb/lottie-ios), vector animation rending with remote JSON files
+- [SDWebImageSVGKitPlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [SVGKit](https://github.com/SVGKit/SVGKit), iOS 8+/macOS 10.10+ support SVG rendering using Core Animation
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs
 - [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to integrate [YYImage](https://github.com/ibireme/YYImage) & [YYCache](https://github.com/ibireme/YYCache) for image rendering & caching
 
@@ -147,6 +147,22 @@ imageView.sd_setImage(with: URL(string: "http://www.domain.com/path/to/image.jpg
 In 5.0, we introduced a brand new mechanism for supporting animated images. This includes animated image loading, rendering, decoding, and also supports customizations (for advanced users).
 This animated image solution is available for `iOS`/`tvOS`/`macOS`. The `SDAnimatedImage` is subclass of `UIImage/NSImage`, and `SDAnimatedImageView` is subclass of `UIImageView/NSImageView`, to make them compatible with the common frameworks APIs. See [Animated Image](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-image-50) for more detailed information.
 
+* Objective-C
+
+```objective-c
+SDAnimatedImageView *imageView = [SDAnimatedImageView new];
+SDAnimatedImage *animatedImage = [SDAnimatedImage imageNamed:@"image.gif"];
+imageView.image = animatedImage;
+```
+
+* Swift
+
+```swift
+let imageView = SDAnimatedImageView()
+let animatedImage = SDAnimatedImage(name: "image.gif")
+imageView.image = animatedImage
+```
+
 #### FLAnimatedImage integration has its own dedicated repo
 In order to clean up things and make our core project do less things, we decided that the `FLAnimatedImage` integration does not belong here. From 5.0, this will still be available, but under a dedicated repo [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin).
 

From c975288eb45b859bbb08dcb44290e334ddfe3195 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 9 Mar 2020 20:22:53 +0800
Subject: [PATCH 131/181] Update the readme again with the SwiftPM support on
 codecs

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0b65b8ef..1d24fb83 100644
--- a/README.md
+++ b/README.md
@@ -68,14 +68,15 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 
 #### Integration with 3rd party libraries
 - [SDWebImageLottiePlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [Lottie-iOS](https://github.com/airbnb/lottie-ios), vector animation rending with remote JSON files
-- [SDWebImageSVGKitPlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [SVGKit](https://github.com/SVGKit/SVGKit), iOS 8+/macOS 10.10+ support SVG rendering using Core Animation
+- [SDWebImageSVGKitPlugin](https://github.com/SDWebImage/SDWebImageLottiePlugin) - plugin to support [SVGKit](https://github.com/SVGKit/SVGKit), SVG rendering using Core Animation, iOS 8+/macOS 10.10+ support
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs
 - [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to integrate [YYImage](https://github.com/ibireme/YYImage) & [YYCache](https://github.com/ibireme/YYCache) for image rendering & caching
 
 #### Make our lives easier
 - [libwebp-Xcode](https://github.com/SDWebImage/libwebp-Xcode) - A wrapper for [libwebp](https://chromium.googlesource.com/webm/libwebp) + an Xcode project.
 - [libheif-Xcode](https://github.com/SDWebImage/libheif-Xcode) - A wrapper for [libheif](https://github.com/strukturag/libheif) + an Xcode project.
-- and more third-party C/C++ image codec libraries with CocoaPods/Carthage support.
+- [libavif-Xcode](https://github.com/SDWebImage/libavif-Xcode) - A wrapper for [libavif](https://github.com/AOMediaCodec/libavif) + an Xcode project.
+- and more third-party C/C++ image codec libraries with CocoaPods/Carthage/SwiftPM support.
 
 You can use those directly, or create similar components of your own.
 

From 3d1280315b6500e51b1f06103980d0d52d17dde3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 11 Mar 2020 11:45:19 +0800
Subject: [PATCH 132/181] Keep the progressive decoding process only exist one
 per image download. Cancel the unused progressive decoding when full pixel
 data is available.

---
 .../Core/SDWebImageDownloaderOperation.m      | 39 ++++++++++---------
 1 file changed, 20 insertions(+), 19 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.m b/SDWebImage/Core/SDWebImageDownloaderOperation.m
index 67d1a8e2..1de8212a 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.m
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.m
@@ -54,7 +54,7 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
 
 @property (strong, nonatomic, readwrite, nullable) NSURLSessionTaskMetrics *metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
 
-@property (strong, nonatomic, nonnull) dispatch_queue_t coderQueue; // the queue to do image decoding
+@property (strong, nonatomic, nonnull) NSOperationQueue *coderQueue; // the serial operation queue to do image decoding
 #if SD_UIKIT
 @property (assign, nonatomic) UIBackgroundTaskIdentifier backgroundTaskId;
 #endif
@@ -89,7 +89,8 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
         _finished = NO;
         _expectedSize = 0;
         _unownedSession = session;
-        _coderQueue = dispatch_queue_create("com.hackemist.SDWebImageDownloaderOperationCoderQueue", DISPATCH_QUEUE_SERIAL);
+        _coderQueue = [NSOperationQueue new];
+        _coderQueue.maxConcurrentOperationCount = 1;
 #if SD_UIKIT
         _backgroundTaskId = UIBackgroundTaskInvalid;
 #endif
@@ -384,17 +385,18 @@ didReceiveResponse:(NSURLResponse *)response
         // Get the image data
         NSData *imageData = [self.imageData copy];
         
-        // progressive decode the image in coder queue
-        dispatch_async(self.coderQueue, ^{
-            @autoreleasepool {
+        // keep maxmium one progressive decode process during download
+        if (self.coderQueue.operationCount == 0) {
+            // NSOperation have autoreleasepool, don't need to create extra one
+            [self.coderQueue addOperationWithBlock:^{
                 UIImage *image = SDImageLoaderDecodeProgressiveImageData(imageData, self.request.URL, finished, self, [[self class] imageOptionsFromDownloaderOptions:self.options], self.context);
                 if (image) {
                     // We do not keep the progressive decoding image even when `finished`=YES. Because they are for view rendering but not take full function from downloader options. And some coders implementation may not keep consistent between progressive decoding and normal decoding.
                     
                     [self callCompletionBlocksWithImage:image imageData:nil error:nil finished:NO];
                 }
-            }
-        });
+            }];
+        }
     }
     
     for (SDWebImageDownloaderProgressBlock progressBlock in [self callbacksForKey:kProgressCallbackKey]) {
@@ -461,19 +463,18 @@ didReceiveResponse:(NSURLResponse *)response
                     [self callCompletionBlocksWithError:self.responseError];
                     [self done];
                 } else {
-                    // decode the image in coder queue
-                    dispatch_async(self.coderQueue, ^{
-                        @autoreleasepool {
-                            UIImage *image = SDImageLoaderDecodeImageData(imageData, self.request.URL, [[self class] imageOptionsFromDownloaderOptions:self.options], self.context);
-                            CGSize imageSize = image.size;
-                            if (imageSize.width == 0 || imageSize.height == 0) {
-                                [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorBadImageData userInfo:@{NSLocalizedDescriptionKey : @"Downloaded image has 0 pixels"}]];
-                            } else {
-                                [self callCompletionBlocksWithImage:image imageData:imageData error:nil finished:YES];
-                            }
-                            [self done];
+                    // decode the image in coder queue, cancel all previous decoding process
+                    [self.coderQueue cancelAllOperations];
+                    [self.coderQueue addOperationWithBlock:^{
+                        UIImage *image = SDImageLoaderDecodeImageData(imageData, self.request.URL, [[self class] imageOptionsFromDownloaderOptions:self.options], self.context);
+                        CGSize imageSize = image.size;
+                        if (imageSize.width == 0 || imageSize.height == 0) {
+                            [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorBadImageData userInfo:@{NSLocalizedDescriptionKey : @"Downloaded image has 0 pixels"}]];
+                        } else {
+                            [self callCompletionBlocksWithImage:image imageData:imageData error:nil finished:YES];
                         }
-                    });
+                        [self done];
+                    }];
                 }
             } else {
                 [self callCompletionBlocksWithError:[NSError errorWithDomain:SDWebImageErrorDomain code:SDWebImageErrorBadImageData userInfo:@{NSLocalizedDescriptionKey : @"Image data is nil"}]];

From 13d0e739fbb36f9e99e3cdb8ca29256894f9e359 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 11 Mar 2020 11:54:10 +0800
Subject: [PATCH 133/181] Update the coderQueue QoS based on
 SDWebImageDownloaderLowPriority && SDWebImageDownloaderHighPriority

---
 SDWebImage/Core/SDWebImageDownloaderOperation.m | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/SDWebImage/Core/SDWebImageDownloaderOperation.m b/SDWebImage/Core/SDWebImageDownloaderOperation.m
index 1de8212a..00d803f2 100644
--- a/SDWebImage/Core/SDWebImageDownloaderOperation.m
+++ b/SDWebImage/Core/SDWebImageDownloaderOperation.m
@@ -208,8 +208,13 @@ typedef NSMutableDictionary<NSString *, id> SDCallbacksDictionary;
     if (self.dataTask) {
         if (self.options & SDWebImageDownloaderHighPriority) {
             self.dataTask.priority = NSURLSessionTaskPriorityHigh;
+            self.coderQueue.qualityOfService = NSQualityOfServiceUserInteractive;
         } else if (self.options & SDWebImageDownloaderLowPriority) {
             self.dataTask.priority = NSURLSessionTaskPriorityLow;
+            self.coderQueue.qualityOfService = NSQualityOfServiceBackground;
+        } else {
+            self.dataTask.priority = NSURLSessionTaskPriorityDefault;
+            self.coderQueue.qualityOfService = NSQualityOfServiceDefault;
         }
         [self.dataTask resume];
         for (SDWebImageDownloaderProgressBlock progressBlock in [self callbacksForKey:kProgressCallbackKey]) {

From 8f9174a952caa3b17e8a4fd1b0621bdd7fb4b253 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 11 Mar 2020 12:19:10 +0800
Subject: [PATCH 134/181] Coding Style fix

---
 SDWebImage/Private/SDFileAttributeHelper.h | 10 +++++-----
 SDWebImage/Private/SDFileAttributeHelper.m | 12 ++++++------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/SDWebImage/Private/SDFileAttributeHelper.h b/SDWebImage/Private/SDFileAttributeHelper.h
index b5594e95..3ce6bade 100644
--- a/SDWebImage/Private/SDFileAttributeHelper.h
+++ b/SDWebImage/Private/SDFileAttributeHelper.h
@@ -10,10 +10,10 @@
 /// File Extended Attribute (xattr) helper methods
 @interface SDFileAttributeHelper : NSObject
 
-+ (nullable NSArray<NSString *> *)extendedAttributeNamesAtPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
-+ (BOOL)hasExtendedAttribute:(nonnull NSString *)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
-+ (nullable NSData *)extendedAttribute:(nonnull NSString*)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
-+ (BOOL)setExtendedAttribute:(nonnull NSString*)name value:(nonnull NSData *)value atPath:(nonnull NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError * _Nullable * _Nullable)err;
-+ (BOOL)removeExtendedAttribute:(nonnull NSString*)name atPath:(nonnull NSString*)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (nullable NSArray<NSString *> *)extendedAttributeNamesAtPath:(nonnull NSString *)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)hasExtendedAttribute:(nonnull NSString *)name atPath:(nonnull NSString *)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (nullable NSData *)extendedAttribute:(nonnull NSString *)name atPath:(nonnull NSString *)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)setExtendedAttribute:(nonnull NSString *)name value:(nonnull NSData *)value atPath:(nonnull NSString *)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError * _Nullable * _Nullable)err;
++ (BOOL)removeExtendedAttribute:(nonnull NSString *)name atPath:(nonnull NSString *)path traverseLink:(BOOL)follow error:(NSError * _Nullable * _Nullable)err;
 
 @end
diff --git a/SDWebImage/Private/SDFileAttributeHelper.m b/SDWebImage/Private/SDFileAttributeHelper.m
index fcb8ad47..45c015e0 100644
--- a/SDWebImage/Private/SDFileAttributeHelper.m
+++ b/SDWebImage/Private/SDFileAttributeHelper.m
@@ -10,7 +10,7 @@
 
 @implementation SDFileAttributeHelper
 
-+ (NSArray*)extendedAttributeNamesAtPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (NSArray*)extendedAttributeNamesAtPath:(NSString *)path traverseLink:(BOOL)follow error:(NSError **)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     
     // get size of name list
@@ -39,7 +39,7 @@
     return [NSArray arrayWithArray:names];
 }
 
-+ (BOOL)hasExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (BOOL)hasExtendedAttribute:(NSString *)name atPath:(NSString *)path traverseLink:(BOOL)follow error:(NSError **)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     
     // get size of name list
@@ -67,7 +67,7 @@
     return NO;
 }
 
-+ (NSData*)extendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (NSData *)extendedAttribute:(NSString *)name atPath:(NSString *)path traverseLink:(BOOL)follow error:(NSError **)err {
     int flags = follow? 0 : XATTR_NOFOLLOW;
     // get length
     ssize_t attrLen = getxattr([path fileSystemRepresentation], [name UTF8String], NULL, 0, 0, flags);
@@ -85,12 +85,12 @@
     }
     
     // get attribute data
-    NSMutableData * attrData = [NSMutableData dataWithLength:attrLen];
+    NSMutableData *attrData = [NSMutableData dataWithLength:attrLen];
     getxattr([path fileSystemRepresentation], [name UTF8String], [attrData mutableBytes], attrLen, 0, flags);
     return attrData;
 }
 
-+ (BOOL)setExtendedAttribute:(NSString*)name value:(NSData*)value atPath:(NSString*)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError**)err {
++ (BOOL)setExtendedAttribute:(NSString *)name value:(NSData *)value atPath:(NSString *)path traverseLink:(BOOL)follow overwrite:(BOOL)overwrite error:(NSError **)err {
     int flags = (follow? 0 : XATTR_NOFOLLOW) | (overwrite? 0 : XATTR_CREATE);
     if (0 == setxattr([path fileSystemRepresentation], [name UTF8String], [value bytes], [value length], 0, flags)) return YES;
     // error
@@ -108,7 +108,7 @@
     return NO;
 }
 
-+ (BOOL)removeExtendedAttribute:(NSString*)name atPath:(NSString*)path traverseLink:(BOOL)follow error:(NSError**)err {
++ (BOOL)removeExtendedAttribute:(NSString *)name atPath:(NSString *)path traverseLink:(BOOL)follow error:(NSError **)err {
     int flags = (follow? 0 : XATTR_NOFOLLOW);
     if (0 == removexattr([path fileSystemRepresentation], [name UTF8String], flags)) return YES;
     // error

From 2dcf1b65994d92ef8806f52dc41aa6fdd677489c Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 13 Mar 2020 20:49:15 +0800
Subject: [PATCH 135/181] Bumped version to 5.6.1

Update the CHANGELOG
---
 CHANGELOG.md        | 9 +++++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c56f967b..a4c32f75 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,12 @@
+## [5.6.1 - 5.6 Patch, on Mar 13th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.6.1)
+See [all tickets marked for the 5.6.1 release](https://github.com/SDWebImage/SDWebImage/milestone/65)
+
+### Performances
+- Keep the progressive decoding process only exist one per image download. Cancel the unused progressive decoding when full pixel data is available. #2483
+
+### Fixes
+- Fix the NotificationCenter does not remove the observer and little private header garden #2959
+
 ## [5.6.0 - URLSession Metrics && Vector Format, on Mar 5th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.6.0)
 See [all tickets marked for the 5.6.0 release](https://github.com/SDWebImage/SDWebImage/milestone/63)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 919e806f..8f0f1ae1 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.6.0'
+  s.version = '5.6.1'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 94bc5516..10938b0c 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.6.0</string>
+	<string>5.6.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.6.0</string>
+	<string>5.6.1</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From ef6aebf9ae09db18918e8a922268eb9ef7789be9 Mon Sep 17 00:00:00 2001
From: rain2540 <rain2540@foxmail.com>
Date: Wed, 25 Mar 2020 14:16:19 +0800
Subject: [PATCH 136/181] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1d24fb83..4c371c21 100644
--- a/README.md
+++ b/README.md
@@ -160,7 +160,7 @@ imageView.image = animatedImage;
 
 ```swift
 let imageView = SDAnimatedImageView()
-let animatedImage = SDAnimatedImage(name: "image.gif")
+let animatedImage = SDAnimatedImage(named: "image.gif")
 imageView.image = animatedImage
 ```
 

From a7606eb5e289de68ea8caa485a2563df0529830f Mon Sep 17 00:00:00 2001
From: huangboju <bhuang@xiaohongshu.com>
Date: Wed, 1 Apr 2020 14:38:22 +0800
Subject: [PATCH 137/181] simplify code

---
 SDWebImage/Private/SDFileAttributeHelper.m | 78 +++++++++++-----------
 1 file changed, 39 insertions(+), 39 deletions(-)

diff --git a/SDWebImage/Private/SDFileAttributeHelper.m b/SDWebImage/Private/SDFileAttributeHelper.m
index 45c015e0..65ecacd7 100644
--- a/SDWebImage/Private/SDFileAttributeHelper.m
+++ b/SDWebImage/Private/SDFileAttributeHelper.m
@@ -17,15 +17,15 @@
     ssize_t nameBuffLen = listxattr([path fileSystemRepresentation], NULL, 0, flags);
     if (nameBuffLen == -1) {
         if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
-            [NSDictionary dictionaryWithObjectsAndKeys:
-             [NSString stringWithUTF8String:strerror(errno)], @"error",
-             @"listxattr", @"function",
-             path, @":path",
-             [NSNumber numberWithBool:follow], @":traverseLink",
-             nil]
-            ];
+                         @{
+                             @"error": [NSString stringWithUTF8String:strerror(errno)],
+                             @"function": @"listxattr",
+                             @":path": path,
+                             @":traverseLink": @(follow)
+                         }
+                         ];
         return nil;
-    } else if (nameBuffLen == 0) return [NSArray array];
+    } else if (nameBuffLen == 0) return @[];
     
     // get name list
     NSMutableData *nameBuff = [NSMutableData dataWithLength:nameBuffLen];
@@ -36,7 +36,7 @@
     char *nextName, *endOfNames = [nameBuff mutableBytes] + nameBuffLen;
     for(nextName = [nameBuff mutableBytes]; nextName < endOfNames; nextName += 1+strlen(nextName))
         [names addObject:[NSString stringWithUTF8String:nextName]];
-    return [NSArray arrayWithArray:names];
+    return names.copy;
 }
 
 + (BOOL)hasExtendedAttribute:(NSString *)name atPath:(NSString *)path traverseLink:(BOOL)follow error:(NSError **)err {
@@ -46,13 +46,13 @@
     ssize_t nameBuffLen = listxattr([path fileSystemRepresentation], NULL, 0, flags);
     if (nameBuffLen == -1) {
         if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
-            [NSDictionary dictionaryWithObjectsAndKeys:
-             [NSString stringWithUTF8String:strerror(errno)], @"error",
-             @"listxattr", @"function",
-             path, @":path",
-             [NSNumber numberWithBool:follow], @":traverseLink",
-             nil]
-            ];
+                         @{
+                             @"error": [NSString stringWithUTF8String:strerror(errno)],
+                             @"function": @"listxattr",
+                             @":path": path,
+                             @":traverseLink": @(follow)
+                         }
+                         ];
         return NO;
     } else if (nameBuffLen == 0) return NO;
     
@@ -73,13 +73,13 @@
     ssize_t attrLen = getxattr([path fileSystemRepresentation], [name UTF8String], NULL, 0, 0, flags);
     if (attrLen == -1) {
         if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
-                         [NSDictionary dictionaryWithObjectsAndKeys:
-                          [NSString stringWithUTF8String:strerror(errno)], @"error",
-                          @"getxattr", @"function",
-                          name, @":name",
-                          path, @":path",
-                          [NSNumber numberWithBool:follow], @":traverseLink",
-                          nil]
+                         @{
+                             @"error": [NSString stringWithUTF8String:strerror(errno)],
+                             @"function": @"getxattr",
+                             @":name": name,
+                             @":path": path,
+                             @":traverseLink": @(follow)
+                         }
                          ];
         return nil;
     }
@@ -95,15 +95,15 @@
     if (0 == setxattr([path fileSystemRepresentation], [name UTF8String], [value bytes], [value length], 0, flags)) return YES;
     // error
     if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
-                     [NSDictionary dictionaryWithObjectsAndKeys:
-                      [NSString stringWithUTF8String:strerror(errno)], @"error",
-                      @"setxattr", @"function",
-                      name, @":name",
-                      [NSNumber numberWithUnsignedInteger:[value length]], @":value.length",
-                      path, @":path",
-                      [NSNumber numberWithBool:follow], @":traverseLink",
-                      [NSNumber numberWithBool:overwrite], @":overwrite",
-                      nil]
+                     @{
+                         @"error": [NSString stringWithUTF8String:strerror(errno)],
+                         @"function": @"setxattr",
+                         @":name": name,
+                         @":value.length": [NSNumber numberWithUnsignedInteger:[value length]],
+                         @":path": path,
+                         @":traverseLink": @(follow),
+                         @":overwrite": @(overwrite)
+                     }
                      ];
     return NO;
 }
@@ -113,13 +113,13 @@
     if (0 == removexattr([path fileSystemRepresentation], [name UTF8String], flags)) return YES;
     // error
     if (err) *err = [NSError errorWithDomain:NSPOSIXErrorDomain code:errno userInfo:
-                     [NSDictionary dictionaryWithObjectsAndKeys:
-                      [NSString stringWithUTF8String:strerror(errno)], @"error",
-                      @"removexattr", @"function",
-                      name, @":name",
-                      path, @":path",
-                      [NSNumber numberWithBool:follow], @":traverseLink",
-                      nil]
+                     @{
+                         @"error": [NSString stringWithUTF8String:strerror(errno)],
+                         @"function": @"removexattr",
+                         @":name": name,
+                         @":path": path,
+                         @":traverseLink": @(follow)
+                     }
                      ];
     return NO;
 }

From fbe76bc43666aaa27b510aeef0ecf2e87e27c3b1 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 17:01:51 +0800
Subject: [PATCH 138/181] Added new query cache type support, including the
 SDImageCache API and context option

---
 SDWebImage/Core/SDImageCache.h         | 13 +++++++++++++
 SDWebImage/Core/SDImageCache.m         | 22 ++++++++++++++++++----
 SDWebImage/Core/SDImageCacheDefine.h   |  2 ++
 SDWebImage/Core/SDImageCachesManager.m | 22 +++++++++++-----------
 SDWebImage/Core/SDWebImageDefine.h     |  6 ++++++
 SDWebImage/Core/SDWebImageDefine.m     |  1 +
 SDWebImage/Core/SDWebImageManager.m    |  7 ++++++-
 7 files changed, 57 insertions(+), 16 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index 1b1afd47..d3d97c17 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -268,6 +268,19 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  */
 - (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context done:(nullable SDImageCacheQueryCompletionBlock)doneBlock;
 
+/**
+ * Asynchronously queries the cache with operation and call the completion when done.
+ *
+ * @param key       The unique key used to store the wanted image. If you want transformed or thumbnail image, calculate the key with `SDTransformedKeyForKey`, `SDThumbnailedKeyForKey`, or generate the cache key from url with `cacheKeyForURL:context:`.
+ * @param options   A mask to specify options to use for this cache query
+ * @param context   A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
+ * @param queryCacheType Specify where to query the cache from. By default we use `.all`, which means both memory cache and disk cache. You can choose to query memory only or disk only as well. Pass `.none` is invalid and callback with nil immediatelly.
+ * @param doneBlock The completion block. Will not get called if the operation is cancelled
+ *
+ * @return a NSOperation instance containing the cache op
+ */
+- (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context cacheType:(SDImageCacheType)queryCacheType done:(nullable SDImageCacheQueryCompletionBlock)doneBlock;
+
 /**
  * Synchronously query the memory cache.
  *
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index f7585895..28db40f7 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -426,12 +426,23 @@
 }
 
 - (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context done:(nullable SDImageCacheQueryCompletionBlock)doneBlock {
+    return [self queryCacheOperationForKey:key options:options context:context cacheType:SDImageCacheTypeAll done:doneBlock];
+}
+
+- (nullable NSOperation *)queryCacheOperationForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context cacheType:(SDImageCacheType)queryCacheType done:(nullable SDImageCacheQueryCompletionBlock)doneBlock {
     if (!key) {
         if (doneBlock) {
             doneBlock(nil, nil, SDImageCacheTypeNone);
         }
         return nil;
     }
+    // Invalid cache type
+    if (queryCacheType == SDImageCacheTypeNone) {
+        if (doneBlock) {
+            doneBlock(nil, nil, SDImageCacheTypeNone);
+        }
+        return nil;
+    }
     
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     if (transformer) {
@@ -441,7 +452,10 @@
     }
     
     // First check the in-memory cache...
-    UIImage *image = [self imageFromMemoryCacheForKey:key];
+    UIImage *image;
+    if (queryCacheType != SDImageCacheTypeDisk) {
+        image = [self imageFromMemoryCacheForKey:key];
+    }
     
     if (image) {
         if (options & SDImageCacheDecodeFirstFrameOnly) {
@@ -464,7 +478,7 @@
         }
     }
 
-    BOOL shouldQueryMemoryOnly = (image && !(options & SDImageCacheQueryMemoryData));
+    BOOL shouldQueryMemoryOnly = (queryCacheType == SDImageCacheTypeMemory) || (image && !(options & SDImageCacheQueryMemoryData));
     if (shouldQueryMemoryOnly) {
         if (doneBlock) {
             doneBlock(image, nil, SDImageCacheTypeMemory);
@@ -698,7 +712,7 @@
 
 #pragma mark - SDImageCache
 
-- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
+- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context cacheType:(SDImageCacheType)cacheType completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
     SDImageCacheOptions cacheOptions = 0;
     if (options & SDWebImageQueryMemoryData) cacheOptions |= SDImageCacheQueryMemoryData;
     if (options & SDWebImageQueryMemoryDataSync) cacheOptions |= SDImageCacheQueryMemoryDataSync;
@@ -709,7 +723,7 @@
     if (options & SDWebImagePreloadAllFrames) cacheOptions |= SDImageCachePreloadAllFrames;
     if (options & SDWebImageMatchAnimatedImageClass) cacheOptions |= SDImageCacheMatchAnimatedImageClass;
     
-    return [self queryCacheOperationForKey:key options:cacheOptions context:context done:completionBlock];
+    return [self queryCacheOperationForKey:key options:cacheOptions context:context cacheType:cacheType done:completionBlock];
 }
 
 - (void)storeImage:(UIImage *)image imageData:(NSData *)imageData forKey:(nullable NSString *)key cacheType:(SDImageCacheType)cacheType completion:(nullable SDWebImageNoParamsBlock)completionBlock {
diff --git a/SDWebImage/Core/SDImageCacheDefine.h b/SDWebImage/Core/SDImageCacheDefine.h
index be4e0211..3ca07ec9 100644
--- a/SDWebImage/Core/SDImageCacheDefine.h
+++ b/SDWebImage/Core/SDImageCacheDefine.h
@@ -68,12 +68,14 @@ FOUNDATION_EXPORT UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonn
  @param key The image cache key
  @param options A mask to specify options to use for this query
  @param context A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
+ @param cacheType Specify where to query the cache from. By default we use `.all`, which means both memory cache and disk cache. You can choose to query memory only or disk only as well. Pass `.none` is invalid and callback with nil immediatelly.
  @param completionBlock The completion block. Will not get called if the operation is cancelled
  @return The operation for this query
  */
 - (nullable id<SDWebImageOperation>)queryImageForKey:(nullable NSString *)key
                                              options:(SDWebImageOptions)options
                                              context:(nullable SDWebImageContext *)context
+                                           cacheType:(SDImageCacheType)cacheType
                                           completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock;
 
 /**
diff --git a/SDWebImage/Core/SDImageCachesManager.m b/SDWebImage/Core/SDImageCachesManager.m
index 6b6f7d8a..de03ed96 100644
--- a/SDWebImage/Core/SDImageCachesManager.m
+++ b/SDWebImage/Core/SDImageCachesManager.m
@@ -84,7 +84,7 @@
 
 #pragma mark - SDImageCache
 
-- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context completion:(SDImageCacheQueryCompletionBlock)completionBlock {
+- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context cacheType:(SDImageCacheType)cacheType completion:(SDImageCacheQueryCompletionBlock)completionBlock {
     if (!key) {
         return nil;
     }
@@ -93,30 +93,30 @@
     if (count == 0) {
         return nil;
     } else if (count == 1) {
-        return [caches.firstObject queryImageForKey:key options:options context:context completion:completionBlock];
+        return [caches.firstObject queryImageForKey:key options:options context:context cacheType:cacheType completion:completionBlock];
     }
     switch (self.queryOperationPolicy) {
         case SDImageCachesManagerOperationPolicyHighestOnly: {
             id<SDImageCache> cache = caches.lastObject;
-            return [cache queryImageForKey:key options:options context:context completion:completionBlock];
+            return [cache queryImageForKey:key options:options context:context cacheType:cacheType completion:completionBlock];
         }
             break;
         case SDImageCachesManagerOperationPolicyLowestOnly: {
             id<SDImageCache> cache = caches.firstObject;
-            return [cache queryImageForKey:key options:options context:context completion:completionBlock];
+            return [cache queryImageForKey:key options:options context:context cacheType:cacheType completion:completionBlock];
         }
             break;
         case SDImageCachesManagerOperationPolicyConcurrent: {
             SDImageCachesManagerOperation *operation = [SDImageCachesManagerOperation new];
             [operation beginWithTotalCount:caches.count];
-            [self concurrentQueryImageForKey:key options:options context:context completion:completionBlock enumerator:caches.reverseObjectEnumerator operation:operation];
+            [self concurrentQueryImageForKey:key options:options context:context cacheType:cacheType completion:completionBlock enumerator:caches.reverseObjectEnumerator operation:operation];
             return operation;
         }
             break;
         case SDImageCachesManagerOperationPolicySerial: {
             SDImageCachesManagerOperation *operation = [SDImageCachesManagerOperation new];
             [operation beginWithTotalCount:caches.count];
-            [self serialQueryImageForKey:key options:options context:context completion:completionBlock enumerator:caches.reverseObjectEnumerator operation:operation];
+            [self serialQueryImageForKey:key options:options context:context cacheType:cacheType completion:completionBlock enumerator:caches.reverseObjectEnumerator operation:operation];
             return operation;
         }
             break;
@@ -279,11 +279,11 @@
 
 #pragma mark - Concurrent Operation
 
-- (void)concurrentQueryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context completion:(SDImageCacheQueryCompletionBlock)completionBlock enumerator:(NSEnumerator<id<SDImageCache>> *)enumerator operation:(SDImageCachesManagerOperation *)operation {
+- (void)concurrentQueryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context cacheType:(SDImageCacheType)queryCacheType completion:(SDImageCacheQueryCompletionBlock)completionBlock enumerator:(NSEnumerator<id<SDImageCache>> *)enumerator operation:(SDImageCachesManagerOperation *)operation {
     NSParameterAssert(enumerator);
     NSParameterAssert(operation);
     for (id<SDImageCache> cache in enumerator) {
-        [cache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+        [cache queryImageForKey:key options:options context:context cacheType:queryCacheType completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
             if (operation.isCancelled) {
                 // Cancelled
                 return;
@@ -422,7 +422,7 @@
 
 #pragma mark - Serial Operation
 
-- (void)serialQueryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context completion:(SDImageCacheQueryCompletionBlock)completionBlock enumerator:(NSEnumerator<id<SDImageCache>> *)enumerator operation:(SDImageCachesManagerOperation *)operation {
+- (void)serialQueryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context cacheType:(SDImageCacheType)queryCacheType completion:(SDImageCacheQueryCompletionBlock)completionBlock enumerator:(NSEnumerator<id<SDImageCache>> *)enumerator operation:(SDImageCachesManagerOperation *)operation {
     NSParameterAssert(enumerator);
     NSParameterAssert(operation);
     id<SDImageCache> cache = enumerator.nextObject;
@@ -435,7 +435,7 @@
         return;
     }
     @weakify(self);
-    [cache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+    [cache queryImageForKey:key options:options context:context cacheType:queryCacheType completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
         @strongify(self);
         if (operation.isCancelled) {
             // Cancelled
@@ -455,7 +455,7 @@
             return;
         }
         // Next
-        [self serialQueryImageForKey:key options:options context:context completion:completionBlock enumerator:enumerator operation:operation];
+        [self serialQueryImageForKey:key options:options context:context cacheType:queryCacheType completion:completionBlock enumerator:enumerator operation:operation];
     }];
 }
 
diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 1be59810..1e8afef8 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -259,6 +259,12 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageP
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageThumbnailPixelSize;
 
+/**
+ A SDImageCacheType raw value which specify the source of cache to query. For example, you can query memory only, query disk only, or query from both memory and disk cache.
+ If not provide or the value is invalid, we will use `SDImageCacheTypeAll`. (NSNumber)
+ */
+FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextQueryCacheType;
+
 /**
  A SDImageCacheType raw value which specify the store cache type when the image has just been downloaded and will be stored to the cache. Specify `SDImageCacheTypeNone` to disable cache storage; `SDImageCacheTypeDisk` to store in disk cache only; `SDImageCacheTypeMemory` to store in memory only. And `SDImageCacheTypeAll` to store in both memory cache and disk cache.
  If you use image transformer feature, this actually apply for the transformed image, but not the original image itself. Use `SDWebImageContextOriginalStoreCacheType` if you want to control the original image's store cache type at the same time.
diff --git a/SDWebImage/Core/SDWebImageDefine.m b/SDWebImage/Core/SDWebImageDefine.m
index 866b164d..2809af69 100644
--- a/SDWebImage/Core/SDWebImageDefine.m
+++ b/SDWebImage/Core/SDWebImageDefine.m
@@ -127,6 +127,7 @@ SDWebImageContextOption const SDWebImageContextImageTransformer = @"imageTransfo
 SDWebImageContextOption const SDWebImageContextImageScaleFactor = @"imageScaleFactor";
 SDWebImageContextOption const SDWebImageContextImagePreserveAspectRatio = @"imagePreserveAspectRatio";
 SDWebImageContextOption const SDWebImageContextImageThumbnailPixelSize = @"imageThumbnailPixelSize";
+SDWebImageContextOption const SDWebImageContextQueryCacheType = @"queryCacheType";
 SDWebImageContextOption const SDWebImageContextStoreCacheType = @"storeCacheType";
 SDWebImageContextOption const SDWebImageContextOriginalStoreCacheType = @"originalStoreCacheType";
 SDWebImageContextOption const SDWebImageContextAnimatedImageClass = @"animatedImageClass";
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 4d33e6d7..a58831aa 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -220,10 +220,15 @@ static id<SDImageLoader> _defaultImageLoader;
     }
     // Check whether we should query cache
     BOOL shouldQueryCache = !SD_OPTIONS_CONTAINS(options, SDWebImageFromLoaderOnly);
+    // Get the query cache type
+    SDImageCacheType queryCacheType = SDImageCacheTypeAll;
+    if (context[SDWebImageContextQueryCacheType]) {
+        queryCacheType = [context[SDWebImageContextQueryCacheType] integerValue];
+    }
     if (shouldQueryCache) {
         NSString *key = [self cacheKeyForURL:url context:context];
         @weakify(operation);
-        operation.cacheOperation = [imageCache queryImageForKey:key options:options context:context completion:^(UIImage * _Nullable cachedImage, NSData * _Nullable cachedData, SDImageCacheType cacheType) {
+        operation.cacheOperation = [imageCache queryImageForKey:key options:options context:context cacheType:queryCacheType completion:^(UIImage * _Nullable cachedImage, NSData * _Nullable cachedData, SDImageCacheType cacheType) {
             @strongify(operation);
             if (!operation || operation.isCancelled) {
                 // Image combined operation cancelled by user

From 7f540a6296ec6d8fbf6abf7457816411c5d39519 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 17:03:56 +0800
Subject: [PATCH 139/181] Fix the test cases for cacheType arg

---
 Tests/Tests/SDImageCacheTests.m | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index 93adcd47..f6961ef4 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -610,7 +610,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
 - (void)test50SDImageCacheQueryOp {
     XCTestExpectation *expectation = [self expectationWithDescription:@"SDImageCache query op works"];
     [[SDImageCache sharedImageCache] storeImage:[self testJPEGImage] forKey:kTestImageKeyJPEG toDisk:NO completion:nil];
-    [[SDImageCachesManager sharedManager] queryImageForKey:kTestImageKeyJPEG options:0 context:nil completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+    [[SDImageCachesManager sharedManager] queryImageForKey:kTestImageKeyJPEG options:0 context:nil cacheType:SDImageCacheTypeAll completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
         expect(image).notTo.beNil();
         [expectation fulfill];
     }];
@@ -680,7 +680,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     cachesManager.removeOperationPolicy = SDImageCachesManagerOperationPolicyLowestOnly;
     cachesManager.containsOperationPolicy = SDImageCachesManagerOperationPolicyLowestOnly;
     cachesManager.clearOperationPolicy = SDImageCachesManagerOperationPolicyLowestOnly;
-    [cachesManager queryImageForKey:kTestImageKeyJPEG options:0 context:nil completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+    [cachesManager queryImageForKey:kTestImageKeyJPEG options:0 context:nil cacheType:SDImageCacheTypeAll completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
         expect(image).to.beNil();
     }];
     [cachesManager storeImage:[self testJPEGImage] imageData:nil forKey:kTestImageKeyJPEG cacheType:SDImageCacheTypeMemory completion:nil];
@@ -699,7 +699,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     cachesManager.removeOperationPolicy = SDImageCachesManagerOperationPolicyHighestOnly;
     cachesManager.containsOperationPolicy = SDImageCachesManagerOperationPolicyHighestOnly;
     cachesManager.clearOperationPolicy = SDImageCachesManagerOperationPolicyHighestOnly;
-    [cachesManager queryImageForKey:kTestImageKeyPNG options:0 context:nil completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+    [cachesManager queryImageForKey:kTestImageKeyPNG options:0 context:nil cacheType:SDImageCacheTypeAll completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
         expect(image).to.beNil();
     }];
     [cachesManager storeImage:[self testPNGImage] imageData:nil forKey:kTestImageKeyPNG cacheType:SDImageCacheTypeMemory completion:nil];
@@ -732,7 +732,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     cachesManager.removeOperationPolicy = SDImageCachesManagerOperationPolicyConcurrent;
     cachesManager.containsOperationPolicy = SDImageCachesManagerOperationPolicyConcurrent;
     cachesManager.clearOperationPolicy = SDImageCachesManagerOperationPolicyConcurrent;
-    [cachesManager queryImageForKey:kConcurrentTestImageKey options:0 context:nil completion:nil];
+    [cachesManager queryImageForKey:kConcurrentTestImageKey options:0 context:nil cacheType:SDImageCacheTypeAll completion:nil];
     [cachesManager storeImage:[self testJPEGImage] imageData:nil forKey:kConcurrentTestImageKey cacheType:SDImageCacheTypeMemory completion:nil];
     [cachesManager removeImageForKey:kConcurrentTestImageKey cacheType:SDImageCacheTypeMemory completion:nil];
     [cachesManager clearWithCacheType:SDImageCacheTypeMemory completion:nil];
@@ -772,7 +772,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     cachesManager.removeOperationPolicy = SDImageCachesManagerOperationPolicySerial;
     cachesManager.containsOperationPolicy = SDImageCachesManagerOperationPolicySerial;
     cachesManager.clearOperationPolicy = SDImageCachesManagerOperationPolicySerial;
-    [cachesManager queryImageForKey:kSerialTestImageKey options:0 context:nil completion:nil];
+    [cachesManager queryImageForKey:kSerialTestImageKey options:0 context:nil cacheType:SDImageCacheTypeAll completion:nil];
     [cachesManager storeImage:[self testJPEGImage] imageData:nil forKey:kSerialTestImageKey cacheType:SDImageCacheTypeMemory completion:nil];
     [cachesManager removeImageForKey:kSerialTestImageKey cacheType:SDImageCacheTypeMemory completion:nil];
     [cachesManager clearWithCacheType:SDImageCacheTypeMemory completion:nil];

From de153b0a32a98c81b03ca086a10968346f7f1b98 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 17:12:11 +0800
Subject: [PATCH 140/181] Added the new Async API for disk data query, to avoid
 user to dispatch their own global queu (not IO queue), solve the IO safe
 issue

---
 SDWebImage/Core/SDImageCache.h       |  9 +++++++++
 SDWebImage/Core/SDImageCache.m       | 11 +++++++++++
 SDWebImage/Core/SDImageCacheDefine.h |  1 +
 3 files changed, 21 insertions(+)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index d3d97c17..ec90efb0 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -235,6 +235,15 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  */
 - (nullable NSData *)diskImageDataForKey:(nullable NSString *)key;
 
+/**
+ * Asynchronously load the image data in disk cache. You can decode the image data to image after loaded.
+ *
+ *  @param key The unique key used to store the wanted image
+ *  @param completionBlock the block to be executed when the check is done.
+ *  @note the completion block will be always executed on the main queue
+ */
+- (void)diskImageDataQueryForKey:(nullable NSString *)key completion:(nullable SDImageCacheQueryDataCompletionBlock)completionBlock;
+
 /**
  * Operation that queries the cache asynchronously and call the completion when done.
  *
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 28db40f7..6d9a8cd3 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -314,6 +314,17 @@
     return [self.diskCache containsDataForKey:key];
 }
 
+- (void)diskImageDataQueryForKey:(NSString *)key completion:(SDImageCacheQueryDataCompletionBlock)completionBlock {
+    dispatch_async(self.ioQueue, ^{
+        NSData *imageData = [self diskImageDataBySearchingAllPathsForKey:key];
+        if (completionBlock) {
+            dispatch_async(dispatch_get_main_queue(), ^{
+                completionBlock(imageData);
+            });
+        }
+    });
+}
+
 - (nullable NSData *)diskImageDataForKey:(nullable NSString *)key {
     if (!key) {
         return nil;
diff --git a/SDWebImage/Core/SDImageCacheDefine.h b/SDWebImage/Core/SDImageCacheDefine.h
index 3ca07ec9..479d0dd9 100644
--- a/SDWebImage/Core/SDImageCacheDefine.h
+++ b/SDWebImage/Core/SDImageCacheDefine.h
@@ -36,6 +36,7 @@ typedef NS_ENUM(NSInteger, SDImageCacheType) {
 };
 
 typedef void(^SDImageCacheCheckCompletionBlock)(BOOL isInCache);
+typedef void(^SDImageCacheQueryDataCompletionBlock)(NSData * _Nullable data);
 typedef void(^SDImageCacheCalculateSizeBlock)(NSUInteger fileCount, NSUInteger totalSize);
 typedef NSString * _Nullable (^SDImageCacheAdditionalCachePathBlock)(NSString * _Nonnull key);
 typedef void(^SDImageCacheQueryCompletionBlock)(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType);

From 45be39f4a1dcb5869014a757879e0df3a64e6837 Mon Sep 17 00:00:00 2001
From: huangboju <bhuang@xiaohongshu.com>
Date: Thu, 2 Apr 2020 10:15:12 +0800
Subject: [PATCH 141/181] Update SDFileAttributeHelper.m

---
 SDWebImage/Private/SDFileAttributeHelper.m | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Private/SDFileAttributeHelper.m b/SDWebImage/Private/SDFileAttributeHelper.m
index 65ecacd7..5122089d 100644
--- a/SDWebImage/Private/SDFileAttributeHelper.m
+++ b/SDWebImage/Private/SDFileAttributeHelper.m
@@ -99,7 +99,7 @@
                          @"error": [NSString stringWithUTF8String:strerror(errno)],
                          @"function": @"setxattr",
                          @":name": name,
-                         @":value.length": [NSNumber numberWithUnsignedInteger:[value length]],
+                         @":value.length": @(value.length),
                          @":path": path,
                          @":traverseLink": @(follow),
                          @":overwrite": @(overwrite)

From ae1f6b9b8c0ae1f8bc2c114bad99e7cfc69bd8b3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 2 Apr 2020 11:41:17 +0800
Subject: [PATCH 142/181] Revert the removal to the old SDImageCache protocol
 API, should keep API with to use .all cache type, until next major version

---
 SDWebImage/Core/SDImageCache.m         |  4 ++++
 SDWebImage/Core/SDImageCacheDefine.h   | 15 +++++++++++++++
 SDWebImage/Core/SDImageCachesManager.m |  4 ++++
 3 files changed, 23 insertions(+)

diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 6d9a8cd3..af201386 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -723,6 +723,10 @@
 
 #pragma mark - SDImageCache
 
+- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
+    return [self queryImageForKey:key options:options context:context cacheType:SDImageCacheTypeAll completion:completionBlock];
+}
+
 - (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context cacheType:(SDImageCacheType)cacheType completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
     SDImageCacheOptions cacheOptions = 0;
     if (options & SDWebImageQueryMemoryData) cacheOptions |= SDImageCacheQueryMemoryData;
diff --git a/SDWebImage/Core/SDImageCacheDefine.h b/SDWebImage/Core/SDImageCacheDefine.h
index 479d0dd9..e2449bfd 100644
--- a/SDWebImage/Core/SDImageCacheDefine.h
+++ b/SDWebImage/Core/SDImageCacheDefine.h
@@ -62,6 +62,21 @@ FOUNDATION_EXPORT UIImage * _Nullable SDImageCacheDecodeImageData(NSData * _Nonn
 @protocol SDImageCache <NSObject>
 
 @required
+/**
+ Query the cached image from image cache for given key. The operation can be used to cancel the query.
+ If image is cached in memory, completion is called synchronously, else aynchronously and depends on the options arg (See `SDWebImageQueryDiskSync`)
+
+ @param key The image cache key
+ @param options A mask to specify options to use for this query
+ @param context A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
+ @param completionBlock The completion block. Will not get called if the operation is cancelled
+ @return The operation for this query
+ */
+- (nullable id<SDWebImageOperation>)queryImageForKey:(nullable NSString *)key
+                                             options:(SDWebImageOptions)options
+                                             context:(nullable SDWebImageContext *)context
+                                          completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock;
+
 /**
  Query the cached image from image cache for given key. The operation can be used to cancel the query.
  If image is cached in memory, completion is called synchronously, else aynchronously and depends on the options arg (See `SDWebImageQueryDiskSync`)
diff --git a/SDWebImage/Core/SDImageCachesManager.m b/SDWebImage/Core/SDImageCachesManager.m
index de03ed96..b6b13c12 100644
--- a/SDWebImage/Core/SDImageCachesManager.m
+++ b/SDWebImage/Core/SDImageCachesManager.m
@@ -84,6 +84,10 @@
 
 #pragma mark - SDImageCache
 
+- (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context completion:(SDImageCacheQueryCompletionBlock)completionBlock {
+    return [self queryImageForKey:key options:options context:context cacheType:SDImageCacheTypeAll completion:completionBlock];
+}
+
 - (id<SDWebImageOperation>)queryImageForKey:(NSString *)key options:(SDWebImageOptions)options context:(SDWebImageContext *)context cacheType:(SDImageCacheType)cacheType completion:(SDImageCacheQueryCompletionBlock)completionBlock {
     if (!key) {
         return nil;

From d4da82e9c3ce632e4f48217db57edcfd7c6996c5 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 2 Apr 2020 12:18:12 +0800
Subject: [PATCH 143/181] Update the test cases about the custom ImageCache
 protocol

---
 Tests/Tests/SDImageCacheTests.m         |  32 +++++
 Tests/Tests/SDWebImageDownloaderTests.m |   6 +-
 Tests/Tests/SDWebImageTestCache.h       |  13 +-
 Tests/Tests/SDWebImageTestCache.m       | 152 +++++++++++++++++++++++-
 4 files changed, 197 insertions(+), 6 deletions(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index f6961ef4..0b195f89 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -793,6 +793,38 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)test58CustomImageCache {
+    NSString *cachePath = [[self userCacheDirectory] stringByAppendingPathComponent:@"custom"];
+    SDImageCacheConfig *config = [[SDImageCacheConfig alloc] init];
+    SDWebImageTestCache *cache = [[SDWebImageTestCache alloc] initWithCachePath:cachePath config:config];
+    expect(cache.memoryCache).notTo.beNil();
+    expect(cache.diskCache).notTo.beNil();
+    
+    // Store
+    UIImage *image1 = self.testJPEGImage;
+    NSString *key1 = @"testJPEGImage";
+    [cache storeImage:image1 imageData:nil forKey:key1 cacheType:SDImageCacheTypeAll completion:nil];
+    // Contain
+    [cache containsImageForKey:key1 cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType containsCacheType) {
+        expect(containsCacheType).equal(SDImageCacheTypeMemory);
+    }];
+    // Query
+    [cache queryImageForKey:key1 options:0 context:nil cacheType:SDImageCacheTypeAll completion:^(UIImage * _Nullable image, NSData * _Nullable data, SDImageCacheType cacheType) {
+        expect(image).equal(image1);
+        expect(data).beNil();
+        expect(cacheType).equal(SDImageCacheTypeMemory);
+    }];
+    // Remove
+    [cache removeImageForKey:key1 cacheType:SDImageCacheTypeAll completion:nil];
+    [cache containsImageForKey:key1 cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType containsCacheType) {
+        expect(containsCacheType).equal(SDImageCacheTypeNone);
+    }];
+    // Clear
+    [cache clearWithCacheType:SDImageCacheTypeAll completion:nil];
+    NSArray<NSString *> *cacheFiles = [cache.diskCache.fileManager contentsOfDirectoryAtPath:cachePath error:nil];
+    expect(cacheFiles.count).equal(0);
+}
+
 #pragma mark Helper methods
 
 - (UIImage *)testJPEGImage {
diff --git a/Tests/Tests/SDWebImageDownloaderTests.m b/Tests/Tests/SDWebImageDownloaderTests.m
index da0ee89b..4cd877c1 100644
--- a/Tests/Tests/SDWebImageDownloaderTests.m
+++ b/Tests/Tests/SDWebImageDownloaderTests.m
@@ -474,7 +474,6 @@
     [self waitForExpectationsWithCommonTimeout];
 }
 
-#if SD_UIKIT
 - (void)test22ThatCustomDecoderWorksForImageDownload {
     XCTestExpectation *expectation = [self expectationWithDescription:@"Custom decoder for SDWebImageDownloader not works"];
     SDWebImageDownloader *downloader = [[SDWebImageDownloader alloc] init];
@@ -487,8 +486,8 @@
     UIImage *testJPEGImage = [[UIImage alloc] initWithContentsOfFile:testJPEGImagePath];
     
     [downloader downloadImageWithURL:testImageURL options:0 progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, BOOL finished) {
-        NSData *data1 = UIImagePNGRepresentation(testJPEGImage);
-        NSData *data2 = UIImagePNGRepresentation(image);
+        NSData *data1 = [testJPEGImage sd_imageDataAsFormat:SDImageFormatPNG];
+        NSData *data2 = [image sd_imageDataAsFormat:SDImageFormatPNG];
         if (![data1 isEqualToData:data2]) {
             XCTFail(@"The image data is not equal to cutom decoder, check -[SDWebImageTestDecoder decodedImageWithData:]");
         }
@@ -499,7 +498,6 @@
     [self waitForExpectationsWithCommonTimeout];
     [downloader invalidateSessionAndCancel:YES];
 }
-#endif
 
 - (void)test23ThatDownloadRequestModifierWorks {
     XCTestExpectation *expectation = [self expectationWithDescription:@"Download request modifier not works"];
diff --git a/Tests/Tests/SDWebImageTestCache.h b/Tests/Tests/SDWebImageTestCache.h
index 0736c698..8029ff4d 100644
--- a/Tests/Tests/SDWebImageTestCache.h
+++ b/Tests/Tests/SDWebImageTestCache.h
@@ -9,9 +9,9 @@
 
 #import <SDWebImage/SDMemoryCache.h>
 #import <SDWebImage/SDDiskCache.h>
+#import <SDWebImage/SDImageCacheDefine.h>
 
 // A really naive implementation of custom memory cache and disk cache
-
 @interface SDWebImageTestMemoryCache : NSObject <SDMemoryCache>
 
 @property (nonatomic, strong, nonnull) SDImageCacheConfig *config;
@@ -26,3 +26,14 @@
 @property (nonatomic, strong, nonnull) NSFileManager *fileManager;
 
 @end
+
+// A really naive implementation of custom image cache using memory cache and disk cache
+@interface SDWebImageTestCache : NSObject <SDImageCache>
+
+@property (nonatomic, strong, nonnull) SDImageCacheConfig *config;
+@property (nonatomic, strong, nonnull) SDWebImageTestMemoryCache *memoryCache;
+@property (nonatomic, strong, nonnull) SDWebImageTestDiskCache *diskCache;
+
+- (nullable instancetype)initWithCachePath:(nonnull NSString *)cachePath config:(nonnull SDImageCacheConfig *)config;
+
+@end
diff --git a/Tests/Tests/SDWebImageTestCache.m b/Tests/Tests/SDWebImageTestCache.m
index 68b2a154..143f2c80 100644
--- a/Tests/Tests/SDWebImageTestCache.m
+++ b/Tests/Tests/SDWebImageTestCache.m
@@ -8,7 +8,7 @@
  */
 
 #import "SDWebImageTestCache.h"
-#import <SDWebImage/SDImageCacheConfig.h>
+#import <SDWebImage/SDWebImage.h>
 #import "SDFileAttributeHelper.h"
 
 static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hackemist.SDWebImageTestDiskCache";
@@ -122,3 +122,153 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
 }
 
 @end
+
+@implementation SDWebImageTestCache
+
+- (instancetype)initWithCachePath:(NSString *)cachePath config:(SDImageCacheConfig *)config {
+    self = [super init];
+    if (self) {
+        self.config = config;
+        self.memoryCache = [[SDWebImageTestMemoryCache alloc] initWithConfig:config];
+        self.diskCache = [[SDWebImageTestDiskCache alloc] initWithCachePath:cachePath config:config];
+    }
+    return self;
+}
+
+- (void)clearWithCacheType:(SDImageCacheType)cacheType completion:(nullable SDWebImageNoParamsBlock)completionBlock {
+    switch (cacheType) {
+        case SDImageCacheTypeNone:
+            break;
+        case SDImageCacheTypeMemory:
+            [self.memoryCache removeAllObjects];
+            break;
+        case SDImageCacheTypeDisk:
+            [self.diskCache removeAllData];
+            break;
+        case SDImageCacheTypeAll:
+            [self.memoryCache removeAllObjects];
+            [self.diskCache removeAllData];
+            break;
+        default:
+            break;
+    }
+    if (completionBlock) {
+        completionBlock();
+    }
+}
+
+- (void)containsImageForKey:(nullable NSString *)key cacheType:(SDImageCacheType)cacheType completion:(nullable SDImageCacheContainsCompletionBlock)completionBlock {
+    SDImageCacheType containsCacheType = SDImageCacheTypeNone;
+    switch (cacheType) {
+        case SDImageCacheTypeNone:
+            break;
+        case SDImageCacheTypeMemory:
+            containsCacheType = [self.memoryCache objectForKey:key] ? SDImageCacheTypeMemory : SDImageCacheTypeNone;
+            break;
+        case SDImageCacheTypeDisk:
+            containsCacheType = [self.diskCache containsDataForKey:key] ? SDImageCacheTypeDisk : SDImageCacheTypeNone;
+            break;
+        case SDImageCacheTypeAll:
+            if ([self.memoryCache objectForKey:key]) {
+                containsCacheType = SDImageCacheTypeMemory;
+            } else if ([self.diskCache containsDataForKey:key]) {
+                containsCacheType = SDImageCacheTypeDisk;
+            }
+        default:
+            break;
+    }
+    if (completionBlock) {
+        completionBlock(containsCacheType);
+    }
+}
+
+- (nullable id<SDWebImageOperation>)queryImageForKey:(nullable NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
+    return [self queryImageForKey:key options:options context:context cacheType:SDImageCacheTypeAll completion:completionBlock];
+}
+
+- (nullable id<SDWebImageOperation>)queryImageForKey:(nullable NSString *)key options:(SDWebImageOptions)options context:(nullable SDWebImageContext *)context cacheType:(SDImageCacheType)cacheType completion:(nullable SDImageCacheQueryCompletionBlock)completionBlock {
+    UIImage *image;
+    NSData *data;
+    SDImageCacheType resultCacheType = SDImageCacheTypeNone;
+    switch (cacheType) {
+        case SDImageCacheTypeNone:
+            break;
+        case SDImageCacheTypeMemory:
+            image = [self.memoryCache objectForKey:key];
+            if (image) {
+                resultCacheType = SDImageCacheTypeMemory;
+            }
+            break;
+        case SDImageCacheTypeDisk:
+            data = [self.diskCache dataForKey:key];
+            image = [UIImage sd_imageWithData:data];
+            if (data) {
+                resultCacheType = SDImageCacheTypeDisk;
+            }
+            break;
+        case SDImageCacheTypeAll:
+            image = [self.memoryCache objectForKey:key];
+            if (image) {
+                resultCacheType = SDImageCacheTypeMemory;
+            } else {
+                data = [self.diskCache dataForKey:key];
+                image = [UIImage sd_imageWithData:data];
+                if (data) {
+                    resultCacheType = SDImageCacheTypeDisk;
+                }
+            }
+            break;
+        default:
+            break;
+    }
+    if (completionBlock) {
+        completionBlock(image, data, resultCacheType);
+    }
+    return nil;
+}
+
+- (void)removeImageForKey:(nullable NSString *)key cacheType:(SDImageCacheType)cacheType completion:(nullable SDWebImageNoParamsBlock)completionBlock {
+    switch (cacheType) {
+        case SDImageCacheTypeNone:
+            break;
+        case SDImageCacheTypeMemory:
+            [self.memoryCache removeObjectForKey:key];
+            break;
+        case SDImageCacheTypeDisk:
+            [self.diskCache removeDataForKey:key];
+            break;
+        case SDImageCacheTypeAll:
+            [self.memoryCache removeObjectForKey:key];
+            [self.diskCache removeDataForKey:key];
+            break;
+        default:
+            break;
+    }
+    if (completionBlock) {
+        completionBlock();
+    }
+}
+
+- (void)storeImage:(nullable UIImage *)image imageData:(nullable NSData *)imageData forKey:(nullable NSString *)key cacheType:(SDImageCacheType)cacheType completion:(nullable SDWebImageNoParamsBlock)completionBlock {
+    switch (cacheType) {
+        case SDImageCacheTypeNone:
+            break;
+        case SDImageCacheTypeMemory:
+            [self.memoryCache setObject:image forKey:key];
+            break;
+        case SDImageCacheTypeDisk:
+            [self.diskCache setData:imageData forKey:key];
+            break;
+        case SDImageCacheTypeAll:
+            [self.memoryCache setObject:image forKey:key];
+            [self.diskCache setData:imageData forKey:key];
+            break;
+        default:
+            break;
+    }
+    if (completionBlock) {
+        completionBlock();
+    }
+}
+
+@end

From 067174b1fdceb0d14db0a645da581395c3f91855 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 2 Apr 2020 12:49:15 +0800
Subject: [PATCH 144/181] Added the test case about using the custom cache and
 loader with context option to manager, full pipeline testing

---
 Tests/Tests/SDImageCacheTests.m      |  3 +++
 Tests/Tests/SDWebImageManagerTests.m | 26 ++++++++++++++++++++++++++
 Tests/Tests/SDWebImageTestCache.h    |  2 ++
 Tests/Tests/SDWebImageTestCache.m    | 23 +++++++++++++++++++++--
 Tests/Tests/SDWebImageTestLoader.h   |  2 ++
 Tests/Tests/SDWebImageTestLoader.m   |  9 +++++++++
 6 files changed, 63 insertions(+), 2 deletions(-)

diff --git a/Tests/Tests/SDImageCacheTests.m b/Tests/Tests/SDImageCacheTests.m
index 0b195f89..96fb0f48 100644
--- a/Tests/Tests/SDImageCacheTests.m
+++ b/Tests/Tests/SDImageCacheTests.m
@@ -800,6 +800,8 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     expect(cache.memoryCache).notTo.beNil();
     expect(cache.diskCache).notTo.beNil();
     
+    // Clear
+    [cache clearWithCacheType:SDImageCacheTypeAll completion:nil];
     // Store
     UIImage *image1 = self.testJPEGImage;
     NSString *key1 = @"testJPEGImage";
@@ -816,6 +818,7 @@ static NSString *kTestImageKeyPNG = @"TestImageKey.png";
     }];
     // Remove
     [cache removeImageForKey:key1 cacheType:SDImageCacheTypeAll completion:nil];
+    // Contain
     [cache containsImageForKey:key1 cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType containsCacheType) {
         expect(containsCacheType).equal(SDImageCacheTypeNone);
     }];
diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index c75fc950..ba61529f 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -8,6 +8,8 @@
 
 #import "SDTestCase.h"
 #import "SDWebImageTestTransformer.h"
+#import "SDWebImageTestCache.h"
+#import "SDWebImageTestLoader.h"
 
 @interface SDWebImageManagerTests : SDTestCase
 
@@ -268,6 +270,30 @@
     }];
 }
 
+- (void)test14ThatCustomCacheAndLoaderWorks {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"Custom Cache and Loader during manger query"];
+    NSURL *url = [NSURL URLWithString:@"http://via.placeholder.com/100x100.png"];
+    SDWebImageContext *context = @{
+        SDWebImageContextImageCache : SDWebImageTestCache.sharedCache,
+        SDWebImageContextImageLoader : SDWebImageTestLoader.sharedLoader
+    };
+    [SDWebImageTestCache.sharedCache clearWithCacheType:SDImageCacheTypeAll completion:nil];
+    [SDWebImageManager.sharedManager loadImageWithURL:url options:SDWebImageWaitStoreCache context:context progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
+        expect(image).notTo.beNil();
+        expect(image.size.width).equal(100);
+        expect(image.size.height).equal(100);
+        expect(data).notTo.beNil();
+        NSString *cacheKey = [SDWebImageManager.sharedManager cacheKeyForURL:imageURL];
+        // Check Disk Cache (SDWebImageWaitStoreCache behavior)
+        [SDWebImageTestCache.sharedCache containsImageForKey:cacheKey cacheType:SDImageCacheTypeDisk completion:^(SDImageCacheType containsCacheType) {
+            expect(containsCacheType).equal(SDImageCacheTypeDisk);
+            [expectation fulfill];
+        }];
+    }];
+    
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 - (NSString *)testJPEGPath {
     NSBundle *testBundle = [NSBundle bundleForClass:[self class]];
     return [testBundle pathForResource:@"TestImage" ofType:@"jpg"];
diff --git a/Tests/Tests/SDWebImageTestCache.h b/Tests/Tests/SDWebImageTestCache.h
index 8029ff4d..6c900c6f 100644
--- a/Tests/Tests/SDWebImageTestCache.h
+++ b/Tests/Tests/SDWebImageTestCache.h
@@ -36,4 +36,6 @@
 
 - (nullable instancetype)initWithCachePath:(nonnull NSString *)cachePath config:(nonnull SDImageCacheConfig *)config;
 
+@property (nonatomic, class, readonly, nonnull) SDWebImageTestCache *sharedCache;
+
 @end
diff --git a/Tests/Tests/SDWebImageTestCache.m b/Tests/Tests/SDWebImageTestCache.m
index 143f2c80..d9e34e3d 100644
--- a/Tests/Tests/SDWebImageTestCache.m
+++ b/Tests/Tests/SDWebImageTestCache.m
@@ -49,7 +49,7 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
 @implementation SDWebImageTestDiskCache
 
 - (nullable NSString *)cachePathForKey:(nonnull NSString *)key {
-    return [self.cachePath stringByAppendingPathComponent:key];
+    return [self.cachePath stringByAppendingPathComponent:key.lastPathComponent];
 }
 
 - (BOOL)containsDataForKey:(nonnull NSString *)key {
@@ -72,7 +72,10 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
 }
 
 - (void)removeAllData {
-    [self.fileManager removeItemAtPath:self.cachePath error:nil];
+    for (NSString *path in [self.fileManager subpathsAtPath:self.cachePath]) {
+        NSString *filePath = [self.cachePath stringByAppendingPathComponent:path];
+        [self.fileManager removeItemAtPath:filePath error:nil];
+    }
 }
 
 - (void)removeDataForKey:(nonnull NSString *)key {
@@ -125,6 +128,17 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
 
 @implementation SDWebImageTestCache
 
++ (SDWebImageTestCache *)sharedCache {
+    static dispatch_once_t onceToken;
+    static SDWebImageTestCache *cache;
+    dispatch_once(&onceToken, ^{
+        NSString *cachePath = [[self userCacheDirectory] stringByAppendingPathComponent:@"SDWebImageTestCache"];
+        SDImageCacheConfig *config = SDImageCacheConfig.defaultCacheConfig;
+        cache = [[SDWebImageTestCache alloc] initWithCachePath:cachePath config:config];
+    });
+    return cache;
+}
+
 - (instancetype)initWithCachePath:(NSString *)cachePath config:(SDImageCacheConfig *)config {
     self = [super init];
     if (self) {
@@ -271,4 +285,9 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
     }
 }
 
++ (nullable NSString *)userCacheDirectory {
+    NSArray<NSString *> *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
+    return paths.firstObject;
+}
+
 @end
diff --git a/Tests/Tests/SDWebImageTestLoader.h b/Tests/Tests/SDWebImageTestLoader.h
index d6a3f5f9..bd343cd8 100644
--- a/Tests/Tests/SDWebImageTestLoader.h
+++ b/Tests/Tests/SDWebImageTestLoader.h
@@ -13,4 +13,6 @@
 // A really naive implementation of custom image loader using `NSURLSession`
 @interface SDWebImageTestLoader : NSObject <SDImageLoader>
 
+@property (nonatomic, class, readonly, nonnull) SDWebImageTestLoader *sharedLoader;
+
 @end
diff --git a/Tests/Tests/SDWebImageTestLoader.m b/Tests/Tests/SDWebImageTestLoader.m
index 22978edb..14f6f7e5 100644
--- a/Tests/Tests/SDWebImageTestLoader.m
+++ b/Tests/Tests/SDWebImageTestLoader.m
@@ -16,6 +16,15 @@
 
 @implementation SDWebImageTestLoader
 
++ (SDWebImageTestLoader *)sharedLoader {
+    static dispatch_once_t onceToken;
+    static SDWebImageTestLoader *loader;
+    dispatch_once(&onceToken, ^{
+        loader = [[SDWebImageTestLoader alloc] init];
+    });
+    return loader;
+}
+
 - (BOOL)canRequestImageForURL:(NSURL *)url {
     return YES;
 }

From ce4eced4d45d9985a8abc4d50d085138519e5f15 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Thu, 2 Apr 2020 16:15:10 +0800
Subject: [PATCH 145/181] Added the query cache type cases as well, update some
 documentation

---
 SDWebImage/Core/SDWebImageDefine.h   |  2 +-
 Tests/Tests/SDWebImageManagerTests.m | 23 +++++++++++++++++++++++
 Tests/Tests/SDWebImageTestCache.m    |  1 +
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 1e8afef8..6f02f279 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -260,7 +260,7 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageP
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageThumbnailPixelSize;
 
 /**
- A SDImageCacheType raw value which specify the source of cache to query. For example, you can query memory only, query disk only, or query from both memory and disk cache.
+ A SDImageCacheType raw value which specify the source of cache to query. Specify `SDImageCacheTypeDisk` to query from disk cache only; `SDImageCacheTypeMemory` to query from memory only. And `SDImageCacheTypeAll` to query from both memory cache and disk cache. Specify `SDImageCacheTypeNone` is invalid and totally ignore the cache query.
  If not provide or the value is invalid, we will use `SDImageCacheTypeAll`. (NSNumber)
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextQueryCacheType;
diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index ba61529f..305caf3c 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -294,6 +294,29 @@
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)test15ThatQueryCacheTypeWork {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"Image query cache type works"];
+    NSURL *url = [NSURL URLWithString:@"http://via.placeholder.com/101x101.png"];
+    NSString *key = [SDWebImageManager.sharedManager cacheKeyForURL:url];
+    NSData *testImageData = [NSData dataWithContentsOfFile:[self testJPEGPath]];
+    [SDImageCache.sharedImageCache storeImageDataToDisk:testImageData forKey:key];
+    
+    // Query memory first
+    [SDWebImageManager.sharedManager loadImageWithURL:url options:SDWebImageFromCacheOnly context:@{SDWebImageContextQueryCacheType : @(SDImageCacheTypeMemory)} progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
+        expect(image).beNil();
+        expect(cacheType).equal(SDImageCacheTypeNone);
+        // Query disk secondly
+        [SDWebImageManager.sharedManager loadImageWithURL:url options:SDWebImageFromCacheOnly context:@{SDWebImageContextQueryCacheType : @(SDImageCacheTypeDisk)} progress:nil completed:^(UIImage * _Nullable image2, NSData * _Nullable data2, NSError * _Nullable error2, SDImageCacheType cacheType2, BOOL finished2, NSURL * _Nullable imageURL2) {
+            expect(image2).notTo.beNil();
+            expect(cacheType2).equal(SDImageCacheTypeDisk);
+            [SDImageCache.sharedImageCache removeImageFromDiskForKey:key];
+            [expectation fulfill];
+        }];
+    }];
+    
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 - (NSString *)testJPEGPath {
     NSBundle *testBundle = [NSBundle bundleForClass:[self class]];
     return [testBundle pathForResource:@"TestImage" ofType:@"jpg"];
diff --git a/Tests/Tests/SDWebImageTestCache.m b/Tests/Tests/SDWebImageTestCache.m
index d9e34e3d..762a2d9a 100644
--- a/Tests/Tests/SDWebImageTestCache.m
+++ b/Tests/Tests/SDWebImageTestCache.m
@@ -188,6 +188,7 @@ static NSString * const SDWebImageTestDiskCacheExtendedAttributeName = @"com.hac
             } else if ([self.diskCache containsDataForKey:key]) {
                 containsCacheType = SDImageCacheTypeDisk;
             }
+            break;
         default:
             break;
     }

From 1dc70b84302e77f62f4a6cfa4d7f3ba0ba816cf0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 31 Mar 2020 18:47:51 +0800
Subject: [PATCH 146/181] Refactory the current thumbnail && transformer about
 cache key. Developer should have the API to calcualte the cache key from
 thumbnail or transformer, not hard-coded.

---
 SDWebImage/Core/SDImageCache.h       |  6 +++---
 SDWebImage/Core/SDImageCache.m       |  8 --------
 SDWebImage/Core/SDImageCoder.h       |  2 +-
 SDWebImage/Core/SDImageTransformer.h | 13 +++++++++++--
 SDWebImage/Core/SDImageTransformer.m |  5 +++++
 SDWebImage/Core/SDWebImageManager.h  |  6 ++++++
 SDWebImage/Core/SDWebImageManager.m  | 18 ++++++++++++------
 7 files changed, 38 insertions(+), 20 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index ec90efb0..57aedcb2 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -247,7 +247,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Operation that queries the cache asynchronously and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image
+ * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
  *
  * @return a NSOperation instance containing the cache op
@@ -257,7 +257,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Asynchronously queries the cache with operation and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image
+ * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param options   A mask to specify options to use for this cache query
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
  *
@@ -268,7 +268,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Asynchronously queries the cache with operation and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image
+ * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param options   A mask to specify options to use for this cache query
  * @param context   A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index af201386..197b75c2 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -9,7 +9,6 @@
 #import "SDImageCache.h"
 #import "NSImage+Compatibility.h"
 #import "SDImageCodersManager.h"
-#import "SDImageTransformer.h"
 #import "SDImageCoderHelper.h"
 #import "SDAnimatedImage.h"
 #import "UIImage+MemoryCacheCost.h"
@@ -455,13 +454,6 @@
         return nil;
     }
     
-    id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
-    if (transformer) {
-        // grab the transformed disk image if transformer provided
-        NSString *transformerKey = [transformer transformerKey];
-        key = SDTransformedKeyForKey(key, transformerKey);
-    }
-    
     // First check the in-memory cache...
     UIImage *image;
     if (queryCacheType != SDImageCacheTypeDisk) {
diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 221246ac..038b41f3 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -61,7 +61,7 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeCompressio
  But this may be useful for some custom coders, because some business logic may dependent on things other than image or image data inforamtion only.
  See `SDWebImageContext` for more detailed information.
  */
-FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderWebImageContext;
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderWebImageContext API_DEPRECATED("The coder component will be seperated from Core subspec in the future. Update your code to not rely on this context option.", macos(10.10, API_TO_BE_DEPRECATED), ios(8.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED), watchos(2.0, API_TO_BE_DEPRECATED));;
 
 #pragma mark - Coder
 /**
diff --git a/SDWebImage/Core/SDImageTransformer.h b/SDWebImage/Core/SDImageTransformer.h
index f165cce5..a2a0850c 100644
--- a/SDWebImage/Core/SDImageTransformer.h
+++ b/SDWebImage/Core/SDImageTransformer.h
@@ -18,6 +18,15 @@
  */
 FOUNDATION_EXPORT NSString * _Nullable SDTransformedKeyForKey(NSString * _Nullable key, NSString * _Nonnull transformerKey);
 
+/**
+ Return the thumbnailed cache key which applied with specify thumbnailSize and preserveAspectRatio control.
+ @param key The original cache key
+ @param thumbnailPixelSize The thumbnail pixel size
+ @param preserveAspectRatio The preserve aspect ratio option
+ @return The thumbnailed cache key
+ */
+FOUNDATION_EXPORT NSString * _Nullable SDThumbnailedKeyForKey(NSString * _Nullable key, CGSize thumbnailPixelSize, BOOL preserveAspectRatio);
+
 /**
  A transformer protocol to transform the image load from cache or from download.
  You can provide transformer to cache and manager (Through the `transformer` property or context option `SDWebImageContextImageTransformer`).
@@ -38,10 +47,10 @@ FOUNDATION_EXPORT NSString * _Nullable SDTransformedKeyForKey(NSString * _Nullab
  Transform the image to another image.
 
  @param image The image to be transformed
- @param key The cache key associated to the image
+ @param key The cache key associated to the image. This arg is a hint for image source, not always useful and should be nullable. In the future we will remove this arg.
  @return The transformed image, or nil if transform failed
  */
-- (nullable UIImage *)transformedImageWithImage:(nonnull UIImage *)image forKey:(nonnull NSString *)key;
+- (nullable UIImage *)transformedImageWithImage:(nonnull UIImage *)image forKey:(nonnull NSString *)key API_DEPRECATED("The key arg will be removed in the future. Update your code and don't rely on that.", macos(10.10, API_TO_BE_DEPRECATED), ios(8.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED), watchos(2.0, API_TO_BE_DEPRECATED));
 
 @end
 
diff --git a/SDWebImage/Core/SDImageTransformer.m b/SDWebImage/Core/SDImageTransformer.m
index 26ee45cd..9397ec73 100644
--- a/SDWebImage/Core/SDImageTransformer.m
+++ b/SDWebImage/Core/SDImageTransformer.m
@@ -38,6 +38,11 @@ NSString * _Nullable SDTransformedKeyForKey(NSString * _Nullable key, NSString *
     }
 }
 
+NSString * _Nullable SDThumbnailedKeyForKey(NSString * _Nullable key, CGSize thumbnailPixelSize, BOOL preserveAspectRatio) {
+    NSString *thumbnailKey = [NSString stringWithFormat:@"Thumbnail({%f,%f},%d)", thumbnailPixelSize.width, thumbnailPixelSize.height, preserveAspectRatio];
+    return SDTransformedKeyForKey(key, thumbnailKey);
+}
+
 @interface SDImagePipelineTransformer ()
 
 @property (nonatomic, copy, readwrite, nonnull) NSArray<id<SDImageTransformer>> *transformers;
diff --git a/SDWebImage/Core/SDWebImageManager.h b/SDWebImage/Core/SDWebImageManager.h
index d940f742..4c7cd558 100644
--- a/SDWebImage/Core/SDWebImageManager.h
+++ b/SDWebImage/Core/SDWebImageManager.h
@@ -266,4 +266,10 @@ SDWebImageManager *manager = [SDWebImageManager sharedManager];
  */
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url;
 
+/**
+ * Return the cache key for a given URL and context option.
+ * Some option like `.thumbnailPixelSize` and `imageTransformer` will effect the generated cache key, using this if you have those context associated.
+*/
+- (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url context:(nullable SDWebImageContext *)context;
+
 @end
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index a58831aa..87d5c085 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -114,6 +114,7 @@ static id<SDImageLoader> _defaultImageLoader;
     } else {
         key = url.absoluteString;
     }
+    
     // Thumbnail Key Appending
     NSValue *thumbnailSizeValue = context[SDWebImageContextImageThumbnailPixelSize];
     if (thumbnailSizeValue != nil) {
@@ -123,14 +124,21 @@ static id<SDImageLoader> _defaultImageLoader;
 #else
         thumbnailSize = thumbnailSizeValue.CGSizeValue;
 #endif
-        
         BOOL preserveAspectRatio = YES;
         NSNumber *preserveAspectRatioValue = context[SDWebImageContextImagePreserveAspectRatio];
         if (preserveAspectRatioValue != nil) {
             preserveAspectRatio = preserveAspectRatioValue.boolValue;
         }
-        NSString *transformerKey = [NSString stringWithFormat:@"Thumbnail({%f,%f},%d)", thumbnailSize.width, thumbnailSize.height, preserveAspectRatio];
-        key = SDTransformedKeyForKey(key, transformerKey);
+        key = SDThumbnailedKeyForKey(key, thumbnailSize, preserveAspectRatio);
+    }
+    
+    // Transformer Key Appending
+    id<SDImageTransformer> transformer = self.transformer;
+    if (context[SDWebImageContextImageTransformer]) {
+        transformer = context[SDWebImageContextImageTransformer];
+    }
+    if (transformer) {
+        key = SDTransformedKeyForKey(key, transformer.transformerKey);
     }
     
     return key;
@@ -409,8 +417,6 @@ static id<SDImageLoader> _defaultImageLoader;
             @autoreleasepool {
                 UIImage *transformedImage = [transformer transformedImageWithImage:originalImage forKey:key];
                 if (transformedImage && finished) {
-                    NSString *transformerKey = [transformer transformerKey];
-                    NSString *cacheKey = SDTransformedKeyForKey(key, transformerKey);
                     BOOL imageWasTransformed = ![transformedImage isEqual:originalImage];
                     NSData *cacheData;
                     // pass nil if the image was transformed, so we can recalculate the data from the image
@@ -421,7 +427,7 @@ static id<SDImageLoader> _defaultImageLoader;
                     }
                     // keep the original image format and extended data
                     SDImageCopyAssociatedObject(originalImage, transformedImage);
-                    [self storeImage:transformedImage imageData:cacheData forKey:cacheKey cacheType:storeCacheType options:options context:context completion:^{
+                    [self storeImage:transformedImage imageData:cacheData forKey:key cacheType:storeCacheType options:options context:context completion:^{
                         [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
                     }];
                 } else {

From 543b5c95d42d6b69d2dbbcbd775e9f2c4411856f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 12:04:56 +0800
Subject: [PATCH 147/181] Fix the test case about the original cache key
 calculation rule

---
 SDWebImage/Core/SDImageCache.h       |  6 +++---
 SDWebImage/Core/SDImageTransformer.h |  1 +
 SDWebImage/Core/SDWebImageManager.h  |  5 +++--
 SDWebImage/Core/SDWebImageManager.m  | 23 +++++++++++++++++++++--
 Tests/Tests/SDWebImageManagerTests.m |  2 +-
 5 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index 57aedcb2..1ebeef12 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -247,7 +247,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Operation that queries the cache asynchronously and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
+ * @param key       The unique key used to store the wanted image. If you want transformed or thumbnail image, calculate the key with `SDTransformedKeyForKey`, `SDThumbnailedKeyForKey`, or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
  *
  * @return a NSOperation instance containing the cache op
@@ -257,7 +257,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Asynchronously queries the cache with operation and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
+ * @param key       The unique key used to store the wanted image. If you want transformed or thumbnail image, calculate the key with `SDTransformedKeyForKey`, `SDThumbnailedKeyForKey`, or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param options   A mask to specify options to use for this cache query
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
  *
@@ -268,7 +268,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 /**
  * Asynchronously queries the cache with operation and call the completion when done.
  *
- * @param key       The unique key used to store the wanted image. If you need transformer's image, calculate the key with `SDTransformedKeyForKey` or generate the cache key from url with `cacheKeyForURL:context:`.
+ * @param key       The unique key used to store the wanted image. If you want transformed or thumbnail image, calculate the key with `SDTransformedKeyForKey`, `SDThumbnailedKeyForKey`, or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param options   A mask to specify options to use for this cache query
  * @param context   A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
diff --git a/SDWebImage/Core/SDImageTransformer.h b/SDWebImage/Core/SDImageTransformer.h
index a2a0850c..5b6d535a 100644
--- a/SDWebImage/Core/SDImageTransformer.h
+++ b/SDWebImage/Core/SDImageTransformer.h
@@ -24,6 +24,7 @@ FOUNDATION_EXPORT NSString * _Nullable SDTransformedKeyForKey(NSString * _Nullab
  @param thumbnailPixelSize The thumbnail pixel size
  @param preserveAspectRatio The preserve aspect ratio option
  @return The thumbnailed cache key
+ @note If you have both transformer and thumbnail applied for image, call `SDThumbnailedKeyForKey` firstly and then with `SDTransformedKeyForKey`.`
  */
 FOUNDATION_EXPORT NSString * _Nullable SDThumbnailedKeyForKey(NSString * _Nullable key, CGSize thumbnailPixelSize, BOOL preserveAspectRatio);
 
diff --git a/SDWebImage/Core/SDWebImageManager.h b/SDWebImage/Core/SDWebImageManager.h
index 4c7cd558..c7e52ca9 100644
--- a/SDWebImage/Core/SDWebImageManager.h
+++ b/SDWebImage/Core/SDWebImageManager.h
@@ -262,13 +262,14 @@ SDWebImageManager *manager = [SDWebImageManager sharedManager];
 - (void)cancelAll;
 
 /**
- * Return the cache key for a given URL
+ * Return the cache key for a given URL, does not considerate transformer or thumbnail.
+ * @note This method does not have context option, only use the url and manager level cacheKeyFilter to generate the cache key.
  */
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url;
 
 /**
  * Return the cache key for a given URL and context option.
- * Some option like `.thumbnailPixelSize` and `imageTransformer` will effect the generated cache key, using this if you have those context associated.
+ * @note The context option like `.thumbnailPixelSize` and `.imageTransformer` will effect the generated cache key, using this if you have those context associated.
 */
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url context:(nullable SDWebImageContext *)context;
 
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 87d5c085..f02f23f1 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -95,7 +95,23 @@ static id<SDImageLoader> _defaultImageLoader;
 }
 
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url {
-    return [self cacheKeyForURL:url context:nil];
+    return [self cacheKeyForURL:url cacheKeyFilter:self.cacheKeyFilter];
+}
+
+- (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url cacheKeyFilter:(nullable id<SDWebImageCacheKeyFilter>)cacheKeyFilter {
+    if (!url) {
+        return @"";
+    }
+    
+    NSString *key;
+    // Cache Key Filter
+    if (cacheKeyFilter) {
+        key = [cacheKeyFilter cacheKeyForURL:url];
+    } else {
+        key = url.absoluteString;
+    }
+    
+    return key;
 }
 
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url context:(nullable SDWebImageContext *)context {
@@ -355,7 +371,9 @@ static id<SDImageLoader> _defaultImageLoader;
     if (context[SDWebImageContextOriginalStoreCacheType]) {
         originalStoreCacheType = [context[SDWebImageContextOriginalStoreCacheType] integerValue];
     }
-    NSString *key = [self cacheKeyForURL:url context:context];
+    // origin cache key
+    id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter] ?: self.cacheKeyFilter;
+    NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
     
@@ -405,6 +423,7 @@ static id<SDImageLoader> _defaultImageLoader;
     if (context[SDWebImageContextStoreCacheType]) {
         storeCacheType = [context[SDWebImageContextStoreCacheType] integerValue];
     }
+    // transformed cache key
     NSString *key = [self cacheKeyForURL:url context:context];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index 305caf3c..fbed31ed 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -229,7 +229,7 @@
     SDWebImageContext *context = @{SDWebImageContextOriginalStoreCacheType : @(SDImageCacheTypeDisk), SDWebImageContextStoreCacheType : @(SDImageCacheTypeMemory)};
     NSURL *url = [NSURL URLWithString:kTestJPEGURL];
     NSString *originalKey = [manager cacheKeyForURL:url];
-    NSString *transformedKey = SDTransformedKeyForKey(originalKey, transformer.transformerKey);
+    NSString *transformedKey = [manager cacheKeyForURL:url context:context];
     
     [manager loadImageWithURL:url options:SDWebImageTransformAnimatedImage context:context progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
         expect(image).equal(transformer.testImage);

From dfc8fe27d94b80e4dc711f50f499d48e2abd0d9d Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 12:47:07 +0800
Subject: [PATCH 148/181] Refactory to simplify the code to calculate the
 original cache key, pass null to disable this.

---
 SDWebImage/Core/SDWebImageDefine.h   |  2 +-
 SDWebImage/Core/SDWebImageManager.m  | 21 +++++++++++++++------
 Tests/Tests/SDWebImageManagerTests.m |  1 +
 3 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageDefine.h b/SDWebImage/Core/SDWebImageDefine.h
index 6f02f279..96f71d68 100644
--- a/SDWebImage/Core/SDWebImageDefine.h
+++ b/SDWebImage/Core/SDWebImageDefine.h
@@ -237,7 +237,7 @@ FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageL
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageCoder;
 
 /**
- A id<SDImageTransformer> instance which conforms `SDImageTransformer` protocol. It's used for image transform after the image load finished and store the transformed image to cache. If you provide one, it will ignore the `transformer` in manager and use provided one instead. (id<SDImageTransformer>)
+ A id<SDImageTransformer> instance which conforms `SDImageTransformer` protocol. It's used for image transform after the image load finished and store the transformed image to cache. If you provide one, it will ignore the `transformer` in manager and use provided one instead. If you pass NSNull, the transformer feature will be disabled. (id<SDImageTransformer>)
  */
 FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextImageTransformer;
 
diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index f02f23f1..22c0e06c 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -95,16 +95,13 @@ static id<SDImageLoader> _defaultImageLoader;
 }
 
 - (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url {
-    return [self cacheKeyForURL:url cacheKeyFilter:self.cacheKeyFilter];
-}
-
-- (nullable NSString *)cacheKeyForURL:(nullable NSURL *)url cacheKeyFilter:(nullable id<SDWebImageCacheKeyFilter>)cacheKeyFilter {
     if (!url) {
         return @"";
     }
     
     NSString *key;
     // Cache Key Filter
+    id<SDWebImageCacheKeyFilter> cacheKeyFilter = self.cacheKeyFilter;
     if (cacheKeyFilter) {
         key = [cacheKeyFilter cacheKeyForURL:url];
     } else {
@@ -152,6 +149,9 @@ static id<SDImageLoader> _defaultImageLoader;
     id<SDImageTransformer> transformer = self.transformer;
     if (context[SDWebImageContextImageTransformer]) {
         transformer = context[SDWebImageContextImageTransformer];
+        if (![transformer conformsToProtocol:@protocol(SDImageTransformer)]) {
+            transformer = nil;
+        }
     }
     if (transformer) {
         key = SDTransformedKeyForKey(key, transformer.transformerKey);
@@ -372,9 +372,14 @@ static id<SDImageLoader> _defaultImageLoader;
         originalStoreCacheType = [context[SDWebImageContextOriginalStoreCacheType] integerValue];
     }
     // origin cache key
-    id<SDWebImageCacheKeyFilter> cacheKeyFilter = context[SDWebImageContextCacheKeyFilter] ?: self.cacheKeyFilter;
-    NSString *key = [self cacheKeyForURL:url cacheKeyFilter:cacheKeyFilter];
+    SDWebImageMutableContext *originContext = [context mutableCopy];
+    // disable transformer for cache key generation
+    originContext[SDWebImageContextImageTransformer] = [NSNull null];
+    NSString *key = [self cacheKeyForURL:url context:originContext];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
+    if (![transformer conformsToProtocol:@protocol(SDImageTransformer)]) {
+        transformer = nil;
+    }
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
     
     BOOL shouldTransformImage = downloadedImage && transformer;
@@ -426,7 +431,11 @@ static id<SDImageLoader> _defaultImageLoader;
     // transformed cache key
     NSString *key = [self cacheKeyForURL:url context:context];
     id<SDImageTransformer> transformer = context[SDWebImageContextImageTransformer];
+    if (![transformer conformsToProtocol:@protocol(SDImageTransformer)]) {
+        transformer = nil;
+    }
     id<SDWebImageCacheSerializer> cacheSerializer = context[SDWebImageContextCacheSerializer];
+    
     BOOL shouldTransformImage = originalImage && transformer;
     shouldTransformImage = shouldTransformImage && (!originalImage.sd_isAnimated || (options & SDWebImageTransformAnimatedImage));
     shouldTransformImage = shouldTransformImage && (!originalImage.sd_isVector || (options & SDWebImageTransformVectorImage));
diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index fbed31ed..327c16e7 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -220,6 +220,7 @@
     
     // Use a fresh manager && cache to avoid get effected by other test cases
     SDImageCache *cache = [[SDImageCache alloc] initWithNamespace:@"SDWebImageStoreCacheType"];
+    [cache clearDiskOnCompletion:nil];
     SDWebImageManager *manager = [[SDWebImageManager alloc] initWithCache:cache loader:SDWebImageDownloader.sharedDownloader];
     SDWebImageTestTransformer *transformer = [[SDWebImageTestTransformer alloc] init];
     transformer.testImage = [[UIImage alloc] initWithContentsOfFile:[self testJPEGPath]];

From 8c2141ecda447cbd34e74cab680a8aff41f833da Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 1 Apr 2020 16:30:21 +0800
Subject: [PATCH 149/181] Added the API to query disk image with options and
 context, this is needed if you have animated image/transformer/thumbnail
 usage

---
 SDWebImage/Core/SDImageCache.h | 29 ++++++++++++++++++++++++-----
 SDWebImage/Core/SDImageCache.m | 13 +++++++++++--
 2 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/SDWebImage/Core/SDImageCache.h b/SDWebImage/Core/SDImageCache.h
index 1ebeef12..f2735a36 100644
--- a/SDWebImage/Core/SDImageCache.h
+++ b/SDWebImage/Core/SDImageCache.h
@@ -227,8 +227,7 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 #pragma mark - Query and Retrieve Ops
 
 /**
- * Asynchronously queries the cache with operation and call the completion when done.
- *  Query the image data for the given key synchronously.
+ * Synchronously query the image data for the given key in disk cache. You can decode the image data to image after loaded.
  *
  *  @param key The unique key used to store the wanted image
  *  @return The image data for the given key, or nil if not found.
@@ -236,16 +235,16 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
 - (nullable NSData *)diskImageDataForKey:(nullable NSString *)key;
 
 /**
- * Asynchronously load the image data in disk cache. You can decode the image data to image after loaded.
+ * Asynchronously query the image data for the given key in disk cache. You can decode the image data to image after loaded.
  *
  *  @param key The unique key used to store the wanted image
- *  @param completionBlock the block to be executed when the check is done.
+ *  @param completionBlock the block to be executed when the query is done.
  *  @note the completion block will be always executed on the main queue
  */
 - (void)diskImageDataQueryForKey:(nullable NSString *)key completion:(nullable SDImageCacheQueryDataCompletionBlock)completionBlock;
 
 /**
- * Operation that queries the cache asynchronously and call the completion when done.
+ * Asynchronously queries the cache with operation and call the completion when done.
  *
  * @param key       The unique key used to store the wanted image. If you want transformed or thumbnail image, calculate the key with `SDTransformedKeyForKey`, `SDThumbnailedKeyForKey`, or generate the cache key from url with `cacheKeyForURL:context:`.
  * @param doneBlock The completion block. Will not get called if the operation is cancelled
@@ -306,6 +305,16 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  */
 - (nullable UIImage *)imageFromDiskCacheForKey:(nullable NSString *)key;
 
+/**
+ * Synchronously query the disk cache. With the options and context which may effect the image generation. (Such as transformer, animated image, thumbnail, etc)
+ *
+ * @param key The unique key used to store the image
+ * @param options   A mask to specify options to use for this cache query
+ * @param context   A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
+ * @return The image for the given key, or nil if not found.
+ */
+- (nullable UIImage *)imageFromDiskCacheForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context;
+
 /**
  * Synchronously query the cache (memory and or disk) after checking the memory cache.
  *
@@ -314,6 +323,16 @@ typedef NS_OPTIONS(NSUInteger, SDImageCacheOptions) {
  */
 - (nullable UIImage *)imageFromCacheForKey:(nullable NSString *)key;
 
+/**
+ * Synchronously query the cache (memory and or disk) after checking the memory cache. With the options and context which may effect the image generation. (Such as transformer, animated image, thumbnail, etc)
+ *
+ * @param key The unique key used to store the image
+ * @param options   A mask to specify options to use for this cache query
+ * @param context   A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
+ * @return The image for the given key, or nil if not found.
+ */
+- (nullable UIImage *)imageFromCacheForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context;;
+
 #pragma mark - Remove Ops
 
 /**
diff --git a/SDWebImage/Core/SDImageCache.m b/SDWebImage/Core/SDImageCache.m
index 197b75c2..076fa43c 100644
--- a/SDWebImage/Core/SDImageCache.m
+++ b/SDWebImage/Core/SDImageCache.m
@@ -341,7 +341,12 @@
 }
 
 - (nullable UIImage *)imageFromDiskCacheForKey:(nullable NSString *)key {
-    UIImage *diskImage = [self diskImageForKey:key];
+    return [self imageFromDiskCacheForKey:key options:0 context:nil];
+}
+
+- (nullable UIImage *)imageFromDiskCacheForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context {
+    NSData *data = [self diskImageDataForKey:key];
+    UIImage *diskImage = [self diskImageForKey:key data:data options:options context:context];
     if (diskImage && self.config.shouldCacheImagesInMemory) {
         NSUInteger cost = diskImage.sd_memoryCost;
         [self.memoryCache setObject:diskImage forKey:key cost:cost];
@@ -351,6 +356,10 @@
 }
 
 - (nullable UIImage *)imageFromCacheForKey:(nullable NSString *)key {
+    return [self imageFromCacheForKey:key options:0 context:nil];
+}
+
+- (nullable UIImage *)imageFromCacheForKey:(nullable NSString *)key options:(SDImageCacheOptions)options context:(nullable SDWebImageContext *)context {
     // First check the in-memory cache...
     UIImage *image = [self imageFromMemoryCacheForKey:key];
     if (image) {
@@ -358,7 +367,7 @@
     }
     
     // Second check the disk cache...
-    image = [self imageFromDiskCacheForKey:key];
+    image = [self imageFromDiskCacheForKey:key options:options context:context];
     return image;
 }
 

From d4782871e08aaeae94d9febde0dd773503393bf3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Apr 2020 20:05:28 +0800
Subject: [PATCH 150/181] Fix the issue for Carthage/SwiftPM framework version
 symbols, this should match the framework name SDWebImage, or will get a link
 error when used

---
 WebImage/SDWebImage.h | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index f219978e..eeadf43f 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -9,15 +9,11 @@
 
 #import <SDWebImage/SDWebImageCompat.h>
 
-#if SD_UIKIT
-#import <UIKit/UIKit.h>
-#endif
+//! Project version number for SDWebImage.
+FOUNDATION_EXPORT double SDWebImageVersionNumber;
 
-//! Project version number for WebImage.
-FOUNDATION_EXPORT double WebImageVersionNumber;
-
-//! Project version string for WebImage.
-FOUNDATION_EXPORT const unsigned char WebImageVersionString[];
+//! Project version string for SDWebImage.
+FOUNDATION_EXPORT const unsigned char SDWebImageVersionString[];
 
 // In this header, you should import all the public headers of your framework using statements like #import <WebImage/PublicHeader.h>
 

From 2ca731c2e8ba2e4f2237aaeb1890ca7e6a8ca766 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Apr 2020 22:52:43 +0800
Subject: [PATCH 151/181] Support to provide the background color when you
 encode a alpha UIImage into non-alpha format like JPEG

---
 SDWebImage/Core/SDImageCoder.h           | 6 ++++++
 SDWebImage/Core/SDImageCoder.m           | 1 +
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 5 +++++
 SDWebImage/Core/SDImageIOCoder.m         | 5 +++++
 4 files changed, 17 insertions(+)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 038b41f3..3e0f3b72 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -55,6 +55,12 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeFirstFrame
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeCompressionQuality;
 
+/**
+ A UIColor(NSColor) value to used for non-alpha image encoding when the input image has alpha channel, the background color will be used to compose the alpha one. If not provide, use white color.
+ @note works for `SDImageEncoder`
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeBackgroundColor;
+
 /**
  A SDWebImageContext object which hold the original context options from top-level API. (SDWebImageContext)
  This option is ignored for all built-in coders and take no effect.
diff --git a/SDWebImage/Core/SDImageCoder.m b/SDWebImage/Core/SDImageCoder.m
index df5224ae..14893ff2 100644
--- a/SDWebImage/Core/SDImageCoder.m
+++ b/SDWebImage/Core/SDImageCoder.m
@@ -15,5 +15,6 @@ SDImageCoderOption const SDImageCoderDecodeThumbnailPixelSize = @"decodeThumbnai
 
 SDImageCoderOption const SDImageCoderEncodeFirstFrameOnly = @"encodeFirstFrameOnly";
 SDImageCoderOption const SDImageCoderEncodeCompressionQuality = @"encodeCompressionQuality";
+SDImageCoderOption const SDImageCoderEncodeBackgroundColor = @"encodeBackgroundColor";
 
 SDImageCoderOption const SDImageCoderWebImageContext = @"webImageContext";
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 1db7a495..f5d518eb 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -426,11 +426,16 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
         return nil;
     }
     NSMutableDictionary *properties = [NSMutableDictionary dictionary];
+    // Encoding Options
     double compressionQuality = 1;
     if (options[SDImageCoderEncodeCompressionQuality]) {
         compressionQuality = [options[SDImageCoderEncodeCompressionQuality] doubleValue];
     }
     properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = @(compressionQuality);
+    CGColorRef backgroundColor = [options[SDImageCoderEncodeBackgroundColor] CGColor];
+    if (backgroundColor) {
+        properties[(__bridge NSString *)kCGImageDestinationBackgroundColor] = (__bridge id)(backgroundColor);
+    }
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index f617f437..5ceefc4b 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -248,11 +248,16 @@
     CGImagePropertyOrientation exifOrientation = kCGImagePropertyOrientationUp;
 #endif
     properties[(__bridge NSString *)kCGImagePropertyOrientation] = @(exifOrientation);
+    // Encoding Options
     double compressionQuality = 1;
     if (options[SDImageCoderEncodeCompressionQuality]) {
         compressionQuality = [options[SDImageCoderEncodeCompressionQuality] doubleValue];
     }
     properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = @(compressionQuality);
+    CGColorRef backgroundColor = [options[SDImageCoderEncodeBackgroundColor] CGColor];
+    if (backgroundColor) {
+        properties[(__bridge NSString *)kCGImageDestinationBackgroundColor] = (__bridge id)(backgroundColor);
+    }
     
     // Add your image to the destination.
     CGImageDestinationAddImage(imageDestination, image.CGImage, (__bridge CFDictionaryRef)properties);

From e71bbf239c9e827a70a6ee06fa55dd729062a8b9 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Apr 2020 23:28:08 +0800
Subject: [PATCH 152/181] Supports the encoding max pixel size options as well,
 which let the codec to do thumbnail rescale encoding, better performance than
 transformer to scale and then encode

---
 SDWebImage/Core/SDImageCoder.h           |  9 ++++++-
 SDWebImage/Core/SDImageCoder.m           |  1 +
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 29 ++++++++++++++++++++-
 SDWebImage/Core/SDImageIOCoder.m         | 32 ++++++++++++++++++++++--
 4 files changed, 67 insertions(+), 4 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 3e0f3b72..5c03b2d4 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -57,10 +57,17 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeCompressio
 
 /**
  A UIColor(NSColor) value to used for non-alpha image encoding when the input image has alpha channel, the background color will be used to compose the alpha one. If not provide, use white color.
- @note works for `SDImageEncoder`
+ @note works for `SDImageCoder`
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeBackgroundColor;
 
+/**
+ A CGSize value indicating the max image resolution in pixels during encoding. For vector image, this also effect the output vector data information about width and height. The encoder will not generate the encoded image larger than this limit. Note it always use the aspect ratio of input image.
+ Defaults to CGSizeZero, which means no max size limit at all.
+ @note works for `SDImageCoder`
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxPixelSize;
+
 /**
  A SDWebImageContext object which hold the original context options from top-level API. (SDWebImageContext)
  This option is ignored for all built-in coders and take no effect.
diff --git a/SDWebImage/Core/SDImageCoder.m b/SDWebImage/Core/SDImageCoder.m
index 14893ff2..58176547 100644
--- a/SDWebImage/Core/SDImageCoder.m
+++ b/SDWebImage/Core/SDImageCoder.m
@@ -16,5 +16,6 @@ SDImageCoderOption const SDImageCoderDecodeThumbnailPixelSize = @"decodeThumbnai
 SDImageCoderOption const SDImageCoderEncodeFirstFrameOnly = @"encodeFirstFrameOnly";
 SDImageCoderOption const SDImageCoderEncodeCompressionQuality = @"encodeCompressionQuality";
 SDImageCoderOption const SDImageCoderEncodeBackgroundColor = @"encodeBackgroundColor";
+SDImageCoderOption const SDImageCoderEncodeMaxPixelSize = @"encodeMaxPixelSize";
 
 SDImageCoderOption const SDImageCoderWebImageContext = @"webImageContext";
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index f5d518eb..253034ac 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -409,6 +409,11 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
     if (!image) {
         return nil;
     }
+    CGImageRef imageRef = image.CGImage;
+    if (!imageRef) {
+        // Earily return, supports CGImage only
+        return nil;
+    }
     
     if (format != self.class.imageFormat) {
         return nil;
@@ -436,11 +441,33 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
     if (backgroundColor) {
         properties[(__bridge NSString *)kCGImageDestinationBackgroundColor] = (__bridge id)(backgroundColor);
     }
+    CGSize maxPixelSize = CGSizeZero;
+    NSValue *maxPixelSizeValue = options[SDImageCoderEncodeMaxPixelSize];
+    if (maxPixelSizeValue != nil) {
+#if SD_MAC
+        maxPixelSize = maxPixelSizeValue.sizeValue;
+#else
+        maxPixelSize = maxPixelSizeValue.CGSizeValue;
+#endif
+    }
+    NSUInteger pixelWidth = CGImageGetWidth(imageRef);
+    NSUInteger pixelHeight = CGImageGetHeight(imageRef);
+    if (maxPixelSize.width > 0 && maxPixelSize.height > 0 && pixelWidth > 0 && pixelHeight > 0) {
+        CGFloat pixelRatio = pixelWidth / pixelHeight;
+        CGFloat maxPixelSizeRatio = maxPixelSize.width / maxPixelSize.height;
+        CGFloat finalPixelSize;
+        if (pixelRatio > maxPixelSizeRatio) {
+            finalPixelSize = maxPixelSize.width;
+        } else {
+            finalPixelSize = maxPixelSize.height;
+        }
+        properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
+    }
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
         // for static single images
-        CGImageDestinationAddImage(imageDestination, image.CGImage, (__bridge CFDictionaryRef)properties);
+        CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);
     } else {
         // for animated images
         NSUInteger loopCount = image.sd_imageLoopCount;
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index 5ceefc4b..981d3593 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -221,9 +221,14 @@
     if (!image) {
         return nil;
     }
+    CGImageRef imageRef = image.CGImage;
+    if (!imageRef) {
+        // Earily return, supports CGImage only
+        return nil;
+    }
     
     if (format == SDImageFormatUndefined) {
-        BOOL hasAlpha = [SDImageCoderHelper CGImageContainsAlpha:image.CGImage];
+        BOOL hasAlpha = [SDImageCoderHelper CGImageContainsAlpha:imageRef];
         if (hasAlpha) {
             format = SDImageFormatPNG;
         } else {
@@ -258,9 +263,32 @@
     if (backgroundColor) {
         properties[(__bridge NSString *)kCGImageDestinationBackgroundColor] = (__bridge id)(backgroundColor);
     }
+    CGSize maxPixelSize = CGSizeZero;
+    NSValue *maxPixelSizeValue = options[SDImageCoderEncodeMaxPixelSize];
+    if (maxPixelSizeValue != nil) {
+#if SD_MAC
+        maxPixelSize = maxPixelSizeValue.sizeValue;
+#else
+        maxPixelSize = maxPixelSizeValue.CGSizeValue;
+#endif
+    }
+    NSUInteger pixelWidth = CGImageGetWidth(imageRef);
+    NSUInteger pixelHeight = CGImageGetHeight(imageRef);
+    if (maxPixelSize.width > 0 && maxPixelSize.height > 0 && pixelWidth > 0 && pixelHeight > 0) {
+        CGFloat pixelRatio = pixelWidth / pixelHeight;
+        CGFloat maxPixelSizeRatio = maxPixelSize.width / maxPixelSize.height;
+        CGFloat finalPixelSize;
+        if (pixelRatio > maxPixelSizeRatio) {
+            finalPixelSize = maxPixelSize.width;
+        } else {
+            finalPixelSize = maxPixelSize.height;
+        }
+        properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
+    }
+    
     
     // Add your image to the destination.
-    CGImageDestinationAddImage(imageDestination, image.CGImage, (__bridge CFDictionaryRef)properties);
+    CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);
     
     // Finalize the destination.
     if (CGImageDestinationFinalize(imageDestination) == NO) {

From f798b89fc27f55bcecd1554889f0a9ed81210597 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 3 Apr 2020 23:59:17 +0800
Subject: [PATCH 153/181] Fix the maxPixelSize for animated images, update the
 readme

---
 SDWebImage/Core/SDImageCoder.h           |  5 ++++-
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 12 +++++++++---
 Tests/Tests/SDImageCoderTests.m          | 19 +++++++++++++++++++
 3 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 5c03b2d4..f1e9c340 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -37,6 +37,7 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodePreserveAs
 /**
  A CGSize value indicating whether or not to generate the thumbnail images (or bitmap images from vector format). When this value is provided, the decoder will generate a thumbnail image which pixel size is smaller than or equal to (depends the `.preserveAspectRatio`) the value size.
  Defaults to CGSizeZero, which means no thumbnail generation at all.
+ @note Supports for animated image as well.
  @note When you pass `.preserveAspectRatio == NO`, the thumbnail image is stretched to match each dimension. When `.preserveAspectRatio == YES`, the thumbnail image's width is limited to pixel size's width, the thumbnail image's height is limited to pixel size's height. For common cases, you can just pass a square size to limit both.
  @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
  */
@@ -62,8 +63,10 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeCompressio
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeBackgroundColor;
 
 /**
- A CGSize value indicating the max image resolution in pixels during encoding. For vector image, this also effect the output vector data information about width and height. The encoder will not generate the encoded image larger than this limit. Note it always use the aspect ratio of input image.
+ A CGSize value indicating the max image resolution in pixels during encoding. For vector image, this also effect the output vector data information about width and height. The encoder will not generate the encoded image larger than this limit. Note it always use the aspect ratio of input image..
  Defaults to CGSizeZero, which means no max size limit at all.
+ @note Supports for animated image as well.
+ @note The ouput image's width is limited to pixel size's width, the output image's height is limited to pixel size's height. For common cases, you can just pass a square size to limit both.
  @note works for `SDImageCoder`
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxPixelSize;
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 253034ac..9050cd6e 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -452,21 +452,23 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
     }
     NSUInteger pixelWidth = CGImageGetWidth(imageRef);
     NSUInteger pixelHeight = CGImageGetHeight(imageRef);
+    CGFloat finalPixelSize = 0;
     if (maxPixelSize.width > 0 && maxPixelSize.height > 0 && pixelWidth > 0 && pixelHeight > 0) {
         CGFloat pixelRatio = pixelWidth / pixelHeight;
         CGFloat maxPixelSizeRatio = maxPixelSize.width / maxPixelSize.height;
-        CGFloat finalPixelSize;
         if (pixelRatio > maxPixelSizeRatio) {
             finalPixelSize = maxPixelSize.width;
         } else {
             finalPixelSize = maxPixelSize.height;
         }
-        properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
     }
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
         // for static single images
+        if (finalPixelSize > 0) {
+            properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
+        }
         CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);
     } else {
         // for animated images
@@ -479,7 +481,11 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
             SDImageFrame *frame = frames[i];
             NSTimeInterval frameDuration = frame.duration;
             CGImageRef frameImageRef = frame.image.CGImage;
-            NSDictionary *frameProperties = @{self.class.dictionaryProperty : @{self.class.delayTimeProperty : @(frameDuration)}};
+            NSMutableDictionary *frameProperties = [NSMutableDictionary dictionary];
+            frameProperties[self.class.dictionaryProperty] = @{self.class.delayTimeProperty : @(frameDuration)};
+            if (finalPixelSize > 0) {
+                frameProperties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
+            }
             CGImageDestinationAddImage(imageDestination, frameImageRef, (__bridge CFDictionaryRef)frameProperties);
         }
     }
diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 95b8b5a2..dbdfc6c0 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -271,6 +271,25 @@ withLocalImageURL:(NSURL *)imageUrl
 #if SD_UIKIT
         expect(outputImage.images.count).to.equal(inputImage.images.count);
 #endif
+        
+        // check max pixel size encoding with scratch
+        CGFloat maxWidth = 50;
+        CGFloat maxHeight = 50;
+        CGFloat maxRatio = maxWidth / maxHeight;
+        CGSize maxPixelSize;
+        if (ratio > maxRatio) {
+            maxPixelSize = CGSizeMake(maxWidth, round(maxWidth / ratio));
+        } else {
+            maxPixelSize = CGSizeMake(round(maxHeight * ratio), maxHeight);
+        }
+        NSData *outputMaxImageData = [coder encodedDataWithImage:inputImage format:encodingFormat options:@{SDImageCoderEncodeMaxPixelSize : @(CGSizeMake(maxWidth, maxHeight))}];
+        UIImage *outputMaxImage = [coder decodedImageWithData:outputMaxImageData options:nil];
+        // Image/IO's thumbnail API does not always use round to preserve precision, we check ABS <= 1
+        expect(ABS(outputMaxImage.size.width - maxPixelSize.width) <= 1);
+        expect(ABS(outputMaxImage.size.height - maxPixelSize.height) <= 1);
+#if SD_UIKIT
+        expect(outputMaxImage.images.count).to.equal(inputImage.images.count);
+#endif
     }
 }
 

From db610363f4142848757312288afd46df0610e906 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 13:07:20 +0800
Subject: [PATCH 154/181] Added the test case to ensure the background color
 encoding options on JPEG works

---
 Tests/Tests/SDImageCoderTests.m | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index dbdfc6c0..25ab0632 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -8,6 +8,7 @@
  */
 
 #import "SDTestCase.h"
+#import "UIColor+HexString.h"
 
 @interface SDWebImageDecoderTests : SDTestCase
 
@@ -82,6 +83,21 @@
     expect(decodedImage.size.height).to.equal(image.size.height);
 }
 
+- (void)test08ThatEncodeAlphaImageToJPGWithBackgroundColor {
+    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"png"];
+    UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
+    UIColor *backgroundColor = [UIColor blackColor];
+    NSData *encodedData = [SDImageCodersManager.sharedManager encodedDataWithImage:image format:SDImageFormatJPEG options:@{SDImageCoderEncodeBackgroundColor : backgroundColor}];
+    expect(encodedData).notTo.beNil();
+    UIImage *decodedImage = [SDImageCodersManager.sharedManager decodedImageWithData:encodedData options:nil];
+    expect(decodedImage).notTo.beNil();
+    expect(decodedImage.size.width).to.equal(image.size.width);
+    expect(decodedImage.size.height).to.equal(image.size.height);
+    // Check background color, should not be white but the black color
+    UIColor *testColor = [decodedImage sd_colorAtPoint:CGPointMake(1, 1)];
+    expect(testColor.sd_hexString).equal(backgroundColor.sd_hexString);
+}
+
 - (void)test11ThatAPNGPCoderWorks {
     NSURL *APNGURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImageAnimated" withExtension:@"apng"];
     [self verifyCoder:[SDImageAPNGCoder sharedCoder]

From 1ce44a12b0558dc1df5111fc1835a1be1c9d6759 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 14:19:08 +0800
Subject: [PATCH 155/181] Change the behavior to return the abstract for
 unknown UTI type, this can solve the accident issue for custom coder who
 provide a new format

---
 SDWebImage/Core/NSData+ImageContentType.h | 2 ++
 SDWebImage/Core/NSData+ImageContentType.m | 4 ++--
 Tests/Tests/SDCategoriesTests.m           | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/SDWebImage/Core/NSData+ImageContentType.h b/SDWebImage/Core/NSData+ImageContentType.h
index 8c2f97e8..de2a6bf3 100644
--- a/SDWebImage/Core/NSData+ImageContentType.h
+++ b/SDWebImage/Core/NSData+ImageContentType.h
@@ -45,6 +45,7 @@ static const SDImageFormat SDImageFormatSVG       = 8;
  *
  *  @param format Format as SDImageFormat
  *  @return The UTType as CFStringRef
+ *  @note For unknown format, `kUTTypeImage` abstract type will return
  */
 + (nonnull CFStringRef)sd_UTTypeFromImageFormat:(SDImageFormat)format CF_RETURNS_NOT_RETAINED NS_SWIFT_NAME(sd_UTType(from:));
 
@@ -53,6 +54,7 @@ static const SDImageFormat SDImageFormatSVG       = 8;
  *
  *  @param uttype The UTType as CFStringRef
  *  @return The Format as SDImageFormat
+ *  @note For unknown type, `SDImageFormatUndefined` will return
  */
 + (SDImageFormat)sd_imageFormatFromUTType:(nonnull CFStringRef)uttype;
 
diff --git a/SDWebImage/Core/NSData+ImageContentType.m b/SDWebImage/Core/NSData+ImageContentType.m
index f9014480..87d041ed 100644
--- a/SDWebImage/Core/NSData+ImageContentType.m
+++ b/SDWebImage/Core/NSData+ImageContentType.m
@@ -119,8 +119,8 @@
             UTType = kUTTypeScalableVectorGraphics;
             break;
         default:
-            // default is kUTTypePNG
-            UTType = kUTTypePNG;
+            // default is kUTTypeImage abstract type
+            UTType = kUTTypeImage;
             break;
     }
     return UTType;
diff --git a/Tests/Tests/SDCategoriesTests.m b/Tests/Tests/SDCategoriesTests.m
index f38fe1bc..ee5aaf56 100644
--- a/Tests/Tests/SDCategoriesTests.m
+++ b/Tests/Tests/SDCategoriesTests.m
@@ -25,7 +25,7 @@
     
     // Test invalid format
     CFStringRef type = [NSData sd_UTTypeFromImageFormat:SDImageFormatUndefined];
-    expect(CFStringCompare(kUTTypePNG, type, 0)).equal(kCFCompareEqualTo);
+    expect(CFStringCompare(kUTTypeImage, type, 0)).equal(kCFCompareEqualTo);
     expect([NSData sd_imageFormatFromUTType:kUTTypeImage]).equal(SDImageFormatUndefined);
 }
 

From b427ad5f3f036cbf46d915bd14abc53c244d5cf3 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 15:31:34 +0800
Subject: [PATCH 156/181] Added the support for max file size for lossy
 encoding

---
 SDWebImage/Core/SDImageCoder.h           | 7 +++++++
 SDWebImage/Core/SDImageCoder.m           | 1 +
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 6 ++++++
 SDWebImage/Core/SDImageIOCoder.m         | 8 +++++++-
 4 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index f1e9c340..1676ef94 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -71,6 +71,13 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeBackground
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxPixelSize;
 
+/**
+ A NSUInteger value specify the max ouput data bytes size after encoding. Some lossy format like JPEG/HEIF supports the hint for codec to automatically reduce the quality and match the file size you want. Note this option will override the `SDImageCoderEncodeCompressionQuality`, because now the quality is decided by the encoder. (NSNumber)
+ @note Not all format supports this feature. And this options does not works for vector images.
+ @note works for `SDImageCoder`
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxFileSize;
+
 /**
  A SDWebImageContext object which hold the original context options from top-level API. (SDWebImageContext)
  This option is ignored for all built-in coders and take no effect.
diff --git a/SDWebImage/Core/SDImageCoder.m b/SDWebImage/Core/SDImageCoder.m
index 58176547..37dfdc41 100644
--- a/SDWebImage/Core/SDImageCoder.m
+++ b/SDWebImage/Core/SDImageCoder.m
@@ -17,5 +17,6 @@ SDImageCoderOption const SDImageCoderEncodeFirstFrameOnly = @"encodeFirstFrameOn
 SDImageCoderOption const SDImageCoderEncodeCompressionQuality = @"encodeCompressionQuality";
 SDImageCoderOption const SDImageCoderEncodeBackgroundColor = @"encodeBackgroundColor";
 SDImageCoderOption const SDImageCoderEncodeMaxPixelSize = @"encodeMaxPixelSize";
+SDImageCoderOption const SDImageCoderEncodeMaxFileSize = @"encodeMaxFileSize";
 
 SDImageCoderOption const SDImageCoderWebImageContext = @"webImageContext";
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 9050cd6e..25103513 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -16,6 +16,8 @@
 
 // Specify DPI for vector format in CGImageSource, like PDF
 static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizationDPI";
+// Specify File Size for lossy format encoding, like JPEG
+static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestinationRequestedFileSize";
 
 @interface SDImageIOCoderFrame : NSObject
 
@@ -462,6 +464,10 @@ static NSString * kSDCGImageSourceRasterizationDPI = @"kCGImageSourceRasterizati
             finalPixelSize = maxPixelSize.height;
         }
     }
+    NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
+    if (maxFileSize > 0) {
+        properties[kSDCGImageDestinationRequestedFileSize] = @(maxFileSize);
+    }
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index 981d3593..70781ba7 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -14,6 +14,9 @@
 #import "SDImageHEICCoderInternal.h"
 #import "SDImageIOAnimatedCoderInternal.h"
 
+// Specify File Size for lossy format encoding, like JPEG
+static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestinationRequestedFileSize";
+
 @implementation SDImageIOCoder {
     size_t _width, _height;
     CGImagePropertyOrientation _orientation;
@@ -285,7 +288,10 @@
         }
         properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
     }
-    
+    NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
+    if (maxFileSize > 0) {
+        properties[kSDCGImageDestinationRequestedFileSize] = @(maxFileSize);
+    }
     
     // Add your image to the destination.
     CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);

From 6316f08bb863c9e5ab97d552b3fc22167f4587e9 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 15:52:26 +0800
Subject: [PATCH 157/181] Remove the compression quality when have max file
 size limit, and update the test cases for JPEG

---
 SDWebImage/Core/SDImageCoder.h           |  2 +-
 SDWebImage/Core/SDImageIOAnimatedCoder.m |  2 ++
 SDWebImage/Core/SDImageIOCoder.m         |  2 ++
 Tests/Tests/SDImageCoderTests.m          | 20 ++++++++++++++++++++
 4 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 1676ef94..590fbba0 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -73,7 +73,7 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxPixelSi
 
 /**
  A NSUInteger value specify the max ouput data bytes size after encoding. Some lossy format like JPEG/HEIF supports the hint for codec to automatically reduce the quality and match the file size you want. Note this option will override the `SDImageCoderEncodeCompressionQuality`, because now the quality is decided by the encoder. (NSNumber)
- @note Not all format supports this feature. And this options does not works for vector images.
+ @note This is a hint, no gurantee for output size because of compression algorithm limit. And this options does not works for vector images.
  @note works for `SDImageCoder`
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxFileSize;
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 25103513..fb3dea6e 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -467,6 +467,8 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
     if (maxFileSize > 0) {
         properties[kSDCGImageDestinationRequestedFileSize] = @(maxFileSize);
+        // Remove the quality if we have file size limit
+        properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = nil;
     }
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index 70781ba7..482aea8d 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -291,6 +291,8 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
     if (maxFileSize > 0) {
         properties[kSDCGImageDestinationRequestedFileSize] = @(maxFileSize);
+        // Remove the quality if we have file size limit
+        properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = nil;
     }
     
     // Add your image to the destination.
diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 25ab0632..3c7b5793 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -98,6 +98,26 @@
     expect(testColor.sd_hexString).equal(backgroundColor.sd_hexString);
 }
 
+- (void)test09ThatJPGImageEncodeWithMaxFileSize {
+    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
+    UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
+    // This large JPEG encoding size between (770KB ~ 2.23MB)
+    NSUInteger limitFileSize = 1 * 1024 * 1024; // 1MB
+    // 100 quality (biggest)
+    NSData *maxEncodedData = [SDImageCodersManager.sharedManager encodedDataWithImage:image format:SDImageFormatJPEG options:nil];
+    expect(maxEncodedData).notTo.beNil();
+    expect(maxEncodedData.length).beGreaterThan(limitFileSize);
+    // 0 quality (smallest)
+    NSData *minEncodedData = [SDImageCodersManager.sharedManager encodedDataWithImage:image format:SDImageFormatJPEG options:@{SDImageCoderEncodeCompressionQuality : @(0)}];
+    expect(minEncodedData).notTo.beNil();
+    expect(minEncodedData.length).beLessThan(limitFileSize);
+    NSData *limitEncodedData = [SDImageCodersManager.sharedManager encodedDataWithImage:image format:SDImageFormatJPEG options:@{SDImageCoderEncodeMaxFileSize : @(limitFileSize)}];
+    expect(limitEncodedData).notTo.beNil();
+    // So, if we limit the file size, the output data should in (770KB ~ 2.23MB)
+    expect(limitEncodedData.length).beLessThan(maxEncodedData.length);
+    expect(limitEncodedData.length).beGreaterThan(minEncodedData.length);
+}
+
 - (void)test11ThatAPNGPCoderWorks {
     NSURL *APNGURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImageAnimated" withExtension:@"apng"];
     [self verifyCoder:[SDImageAPNGCoder sharedCoder]

From 82249e82d8aea80b23c7c8b554cc6d6a3bf45381 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 17:48:31 +0800
Subject: [PATCH 158/181] Bumped version to 5.7.0

Update the CHANGELOG
---
 CHANGELOG.md        | 25 +++++++++++++++++++++++++
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4c32f75..9f7c1a9c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,28 @@
+## [5.7.0 - Query Cache Type and Encoding Options, on Apr 4th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.7.0)
+See [all tickets marked for the 5.7.0 release](https://github.com/SDWebImage/SDWebImage/milestone/66)
+
+### Features
+
+#### Cache
+- Added the async version API to query disk image data only
+- Added the sync API to query disk image with context and options, which matches the async version
+
+#### Coder
+- Feature supports encoding options like max file size, max pixel size, as well as background color when using JPEG for alpha image #2972
+- You can use `.encodeMaxFileSize` to limit the desired lossy file size, better than compression quality
+- You can use `.encodeMaxPixelSize` to limit the pixel size, like thumbnail encoding
+
+#### Transformer
+- Refactory the current thumbnail && transformer about cache key. Developer should have the API to calculate the cache key from thumbnail or transformer, not hard-coded. #2966
+
+#### Context Option
+- Added new query cache type support, including the SDImageCache API and context option #2968
+- You use `.queryCacheType` to query image from memory/disk/both cache during image pipeline loading
+
+### Fixes
+- Fix the issue for Carthage/SwiftPM framework version symbols, this should match the framework name SDWebImage, or will get a link error when used #2971 #2969
+- Simplify the xattr helper method's code with modern Objective-C syntax #2967. Thanks @huangboju 
+
 ## [5.6.1 - 5.6 Patch, on Mar 13th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.6.1)
 See [all tickets marked for the 5.6.1 release](https://github.com/SDWebImage/SDWebImage/milestone/65)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 8f0f1ae1..b96039d6 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.6.1'
+  s.version = '5.7.0'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 10938b0c..93161971 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.6.1</string>
+	<string>5.7.0</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.6.1</string>
+	<string>5.7.0</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From e2285181a62daf4d1d3caf66d6d776b667092303 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 17:55:06 +0800
Subject: [PATCH 159/181] Update the CHANGELOG

---
 CHANGELOG.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9f7c1a9c..8c294039 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,9 @@ See [all tickets marked for the 5.7.0 release](https://github.com/SDWebImage/SDW
 - Fix the issue for Carthage/SwiftPM framework version symbols, this should match the framework name SDWebImage, or will get a link error when used #2971 #2969
 - Simplify the xattr helper method's code with modern Objective-C syntax #2967. Thanks @huangboju 
 
+### Changes
+- Change the behavior to return the abstract type for unknown image format, this can solve the accident issue for custom coder who provide a new format #2973
+
 ## [5.6.1 - 5.6 Patch, on Mar 13th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.6.1)
 See [all tickets marked for the 5.6.1 release](https://github.com/SDWebImage/SDWebImage/milestone/65)
 

From bbc65ed0cca55eb759547b3ac5989ec54b20d55c Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 4 Apr 2020 18:30:30 +0800
Subject: [PATCH 160/181] Fix the wrong value assignment for
 SDAnimatedImageView code on macOS, warning

---
 SDWebImage/Core/SDAnimatedImageView.m | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SDWebImage/Core/SDAnimatedImageView.m b/SDWebImage/Core/SDAnimatedImageView.m
index 71ee7e34..e5cad14d 100644
--- a/SDWebImage/Core/SDAnimatedImageView.m
+++ b/SDWebImage/Core/SDAnimatedImageView.m
@@ -470,7 +470,7 @@
 // NSImageView use a subview. We need this subview's layer for actual rendering.
 // Why using this design may because of properties like `imageAlignment` and `imageScaling`, which it's not available for UIImageView.contentMode (it's impossible to align left and keep aspect ratio at the same time)
 - (NSView *)imageView {
-    NSImageView *imageView = imageView = objc_getAssociatedObject(self, SD_SEL_SPI(imageView));
+    NSImageView *imageView = objc_getAssociatedObject(self, SD_SEL_SPI(imageView));
     if (!imageView) {
         // macOS 10.14
         imageView = objc_getAssociatedObject(self, SD_SEL_SPI(imageSubview));

From bddc130914e0bc36103b80b4c4f0657887fa29c2 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 5 Apr 2020 11:51:39 +0800
Subject: [PATCH 161/181] Update the README about the latest SwiftUI support
 and Ecosystem

---
 README.md | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 4c371c21..055c63d9 100644
--- a/README.md
+++ b/README.md
@@ -37,11 +37,11 @@ This library provides an async image downloader with cache support. For convenie
 
 ## Supported Image Formats
 
-- Image formats supported by UIImage (JPEG, PNG, HEIC, ...), including GIF/APNG/HEIC animation
+- Image formats supported by Apple system (JPEG, PNG, TIFF, HEIC, ...), including GIF/APNG/HEIC animation
 - WebP format, including animated WebP (use the [SDWebImageWebPCoder](https://github.com/SDWebImage/SDWebImageWebPCoder) project)
 - Support extendable coder plugins for new image formats like BPG, AVIF. And vector format like PDF, SVG. See all the list in [Image coder plugin List](https://github.com/SDWebImage/SDWebImage/wiki/Coder-Plugin-List)
 
-## Additional modules
+## Additional modules and Ecosystem
 
 In order to keep SDWebImage focused and limited to the core features, but also allow extensibility and custom behaviors, during the 5.0 refactoring we focused on modularizing the library.
 As such, we have moved/built new modules to [SDWebImage org](https://github.com/SDWebImage).
@@ -49,7 +49,9 @@ As such, we have moved/built new modules to [SDWebImage org](https://github.com/
 #### SwiftUI
 [SwiftUI](https://developer.apple.com/xcode/swiftui/) is an innovative UI framework written in Swift to build user interfaces across all Apple platforms.
 
-We support SwiftUI by building with the functions (caching, loading and animation) powered by SDWebImage. You can have a try with [SDWebImageSwiftUI](https://github.com/SDWebImage/SDWebImageSwiftUI)
+We support SwiftUI by building a brand new framework called [SDWebImageSwiftUI](https://github.com/SDWebImage/SDWebImageSwiftUI), which is built on top of SDWebImage core functions (caching, loading and animation).
+
+The new framework introduce two View structs `WebImage` and `AnimatedImage` for SwiftUI world, `ImageIndicator` modifier for any View, `ImageManager` observable object for data source. Supports iOS 13+/macOS 10.15+/tvOS 13+/watchOS 6+ and Swift 5.1. Have a nice try and provide feedback!
 
 #### Coders for additional image formats
 - [SDWebImageWebPCoder](https://github.com/SDWebImage/SDWebImageWebPCoder) - coder for WebP format. Based on [libwebp](https://chromium.googlesource.com/webm/libwebp)
@@ -72,13 +74,18 @@ We support SwiftUI by building with the functions (caching, loading and animatio
 - [SDWebImageFLPlugin](https://github.com/SDWebImage/SDWebImageFLPlugin) - plugin to support [FLAnimatedImage](https://github.com/Flipboard/FLAnimatedImage) as the engine for animated GIFs
 - [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to integrate [YYImage](https://github.com/ibireme/YYImage) & [YYCache](https://github.com/ibireme/YYCache) for image rendering & caching
 
+#### Community driven popular libraries
+- [FirebaseUI](https://github.com/firebase/FirebaseUI-iOS) - Firebase Storage binding for query images, based on SDWebImage loader system
+- [react-native-fast-image](https://github.com/DylanVann/react-native-fast-image) - React Native fast image component, based on SDWebImage Animated Image solution
+- [flutter_image_compress](https://github.com/OpenFlutter/flutter_image_compress) - Flutter compresses image plugin, based on SDWebImageWebPCoder coder plugin
+
 #### Make our lives easier
 - [libwebp-Xcode](https://github.com/SDWebImage/libwebp-Xcode) - A wrapper for [libwebp](https://chromium.googlesource.com/webm/libwebp) + an Xcode project.
 - [libheif-Xcode](https://github.com/SDWebImage/libheif-Xcode) - A wrapper for [libheif](https://github.com/strukturag/libheif) + an Xcode project.
 - [libavif-Xcode](https://github.com/SDWebImage/libavif-Xcode) - A wrapper for [libavif](https://github.com/AOMediaCodec/libavif) + an Xcode project.
 - and more third-party C/C++ image codec libraries with CocoaPods/Carthage/SwiftPM support.
 
-You can use those directly, or create similar components of your own.
+You can use those directly, or create similar components of your own, by using the customizable architecture of SDWebImage.
 
 ## Requirements
 
@@ -116,6 +123,7 @@ You can use those directly, or create similar components of your own.
 - If you'd like to **ask a general question**, use [Stack Overflow](http://stackoverflow.com/questions/tagged/sdwebimage).
 - If you **found a bug**, open an issue.
 - If you **have a feature request**, open an issue.
+- If you **need IRC channel**, use [Gitter](https://gitter.im/SDWebImage/community).
 
 ## Contribution
 
@@ -146,7 +154,14 @@ imageView.sd_setImage(with: URL(string: "http://www.domain.com/path/to/image.jpg
 ## Animated Images (GIF) support
 
 In 5.0, we introduced a brand new mechanism for supporting animated images. This includes animated image loading, rendering, decoding, and also supports customizations (for advanced users).
-This animated image solution is available for `iOS`/`tvOS`/`macOS`. The `SDAnimatedImage` is subclass of `UIImage/NSImage`, and `SDAnimatedImageView` is subclass of `UIImageView/NSImageView`, to make them compatible with the common frameworks APIs. See [Animated Image](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-image-50) for more detailed information.
+
+This animated image solution is available for `iOS`/`tvOS`/`macOS`. The `SDAnimatedImage` is subclass of `UIImage/NSImage`, and `SDAnimatedImageView` is subclass of `UIImageView/NSImageView`, to make them compatible with the common frameworks APIs.
+
+The `SDAnimatedImageView` supports the familiar image loading category methods, works like drop-in replacement for `UIImageView/NSImageView`.
+
+Don't have UIView (like WatchKit or CALayer)? you can still use `SDAnimatedPlayer` the player engine for advanced playback and rendering.
+
+See [Animated Image](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-image-50) for more detailed information.
 
 * Objective-C
 

From ed8887db35e58cbfd14e7bf86bdda150db53a051 Mon Sep 17 00:00:00 2001
From: Brian Amerige <brian@thoughtful.community>
Date: Tue, 7 Apr 2020 13:58:11 -0700
Subject: [PATCH 162/181] [SDWebImageManager] Don't copy attributes from
 originalImage to transformedImage. This fixes
 https://github.com/SDWebImage/SDWebImage/issues/2975.

---
 SDWebImage/Core/SDWebImageManager.m | 2 --
 1 file changed, 2 deletions(-)

diff --git a/SDWebImage/Core/SDWebImageManager.m b/SDWebImage/Core/SDWebImageManager.m
index 22c0e06c..2adf2b64 100644
--- a/SDWebImage/Core/SDWebImageManager.m
+++ b/SDWebImage/Core/SDWebImageManager.m
@@ -453,8 +453,6 @@ static id<SDImageLoader> _defaultImageLoader;
                     } else {
                         cacheData = (imageWasTransformed ? nil : originalData);
                     }
-                    // keep the original image format and extended data
-                    SDImageCopyAssociatedObject(originalImage, transformedImage);
                     [self storeImage:transformedImage imageData:cacheData forKey:key cacheType:storeCacheType options:options context:context completion:^{
                         [self callCompletionBlockForOperation:operation completion:completedBlock image:transformedImage data:originalData error:nil cacheType:SDImageCacheTypeNone finished:finished url:url];
                     }];

From a8177c1327ce94a148cb87beb2de724fbd451d00 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 8 Apr 2020 11:18:03 +0800
Subject: [PATCH 163/181] Update the test case `test12ThatStoreCacheTypeWork`
 to ensure the transformed image does not inherit the image format or any
 attributes from original one

---
 Tests/Tests/SDWebImageManagerTests.m | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/Tests/Tests/SDWebImageManagerTests.m b/Tests/Tests/SDWebImageManagerTests.m
index 327c16e7..fc1a194a 100644
--- a/Tests/Tests/SDWebImageManagerTests.m
+++ b/Tests/Tests/SDWebImageManagerTests.m
@@ -121,7 +121,7 @@
     SDWebImageManager *manager = [[SDWebImageManager alloc] initWithCache:[SDImageCache sharedImageCache] loader:[SDWebImageDownloader sharedDownloader]];
     manager.transformer = transformer;
     [[SDImageCache sharedImageCache] removeImageForKey:kTestJPEGURL withCompletion:^{
-        [manager loadImageWithURL:url options:SDWebImageTransformAnimatedImage progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
+        [manager loadImageWithURL:url options:SDWebImageTransformAnimatedImage | SDWebImageTransformVectorImage progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
             expect(image).equal(transformer.testImage);
             [expectation fulfill];
         }];
@@ -228,21 +228,30 @@
     
     // test: original image -> disk only, transformed image -> memory only
     SDWebImageContext *context = @{SDWebImageContextOriginalStoreCacheType : @(SDImageCacheTypeDisk), SDWebImageContextStoreCacheType : @(SDImageCacheTypeMemory)};
-    NSURL *url = [NSURL URLWithString:kTestJPEGURL];
+    NSURL *url = [NSURL URLWithString:kTestAPNGPURL];
     NSString *originalKey = [manager cacheKeyForURL:url];
     NSString *transformedKey = [manager cacheKeyForURL:url context:context];
     
     [manager loadImageWithURL:url options:SDWebImageTransformAnimatedImage context:context progress:nil completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
         expect(image).equal(transformer.testImage);
+        // the transformed image should not inherite any attribute from original one
+        expect(image.sd_imageFormat).equal(SDImageFormatJPEG);
+        expect(image.sd_isAnimated).beFalsy();
         dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 2*kMinDelayNanosecond), dispatch_get_main_queue(), ^{
             // original -> disk only
-            [manager.imageCache containsImageForKey:originalKey cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType originalCacheType) {
-                expect(originalCacheType).equal(SDImageCacheTypeDisk);
-                // transformed -> memory only
-                [manager.imageCache containsImageForKey:transformedKey cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType transformedCacheType) {
-                    expect(transformedCacheType).equal(SDImageCacheTypeMemory);
-                    [expectation fulfill];
-                }];
+            UIImage *originalImage = [cache imageFromMemoryCacheForKey:originalKey];
+            expect(originalImage).beNil();
+            NSData *originalData = [cache diskImageDataForKey:originalKey];
+            expect(originalData).notTo.beNil();
+            originalImage = [UIImage sd_imageWithData:originalData];
+            expect(originalImage).notTo.beNil();
+            expect(originalImage.sd_imageFormat).equal(SDImageFormatPNG);
+            expect(originalImage.sd_isAnimated).beTruthy();
+            // transformed -> memory only
+            [manager.imageCache containsImageForKey:transformedKey cacheType:SDImageCacheTypeAll completion:^(SDImageCacheType transformedCacheType) {
+                expect(transformedCacheType).equal(SDImageCacheTypeMemory);
+                [cache clearDiskOnCompletion:nil];
+                [expectation fulfill];
             }];
         });
     }];

From f52dc6b4bd5bf29c7da5f1969b0f42e0392079b0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Wed, 8 Apr 2020 11:26:58 +0800
Subject: [PATCH 164/181] Bumped version to 5.7.1

Update the CHANGELOG
---
 CHANGELOG.md        | 7 +++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8c294039..cc6d2f08 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [5.7.1 - 5.7 Patch, on Apr 8th, 2020](https://github.com/SDWebImage/SDWebImage/releases/tag/5.7.1)
+See [all tickets marked for the 5.7.1 release](https://github.com/SDWebImage/SDWebImage/milestone/67)
+
+### Fixes
+- Don't copy attributes from originalImage to transformedImage when caching transformedImage #2976. Thanks @bdaz
+- Fix the wrong value assignment for SDAnimatedImageView code on macOS, warning #2974
+
 ## [5.7.0 - Query Cache Type and Encoding Options, on Apr 4th, 2020](https://github.com/rs/SDWebImage/releases/tag/5.7.0)
 See [all tickets marked for the 5.7.0 release](https://github.com/SDWebImage/SDWebImage/milestone/66)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index b96039d6..46f2061a 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.7.0'
+  s.version = '5.7.1'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 93161971..3f491f95 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.7.0</string>
+	<string>5.7.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.7.0</string>
+	<string>5.7.1</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 13bae85e3dbda81b5ce44a7034e30735dd44d187 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 10 Apr 2020 23:34:23 +0800
Subject: [PATCH 165/181] Fix that when first play animated image and use
 maxBufferSize to 0, the calculation does not works (The CGImage is nil)

---
 SDWebImage/Core/SDAnimatedImagePlayer.m | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/SDWebImage/Core/SDAnimatedImagePlayer.m b/SDWebImage/Core/SDAnimatedImagePlayer.m
index 39658b43..54135094 100644
--- a/SDWebImage/Core/SDAnimatedImagePlayer.m
+++ b/SDWebImage/Core/SDAnimatedImagePlayer.m
@@ -179,12 +179,12 @@
 #pragma mark - Animation Control
 - (void)startPlaying {
     [self.displayLink start];
-    // Calculate max buffer size
-    [self calculateMaxBufferCount];
     // Setup frame
     if (self.currentFrameIndex == 0 && !self.currentFrame) {
         [self setupCurrentFrame];
     }
+    // Calculate max buffer size
+    [self calculateMaxBufferCount];
 }
 
 - (void)stopPlaying {

From a5e129dac7b6e18c2f51551428d258df3d247cf0 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 11 Apr 2020 14:44:38 +0800
Subject: [PATCH 166/181] SDAnimatedImageView animation rendering should not
 use CGContext force decoding, use `kCGImageSourceShouldCacheImmediately`
 instead which can avoid OOM for large number of GIFs #2977

---
 SDWebImage/Core/SDImageCoder.h                |   1 +
 SDWebImage/Core/SDImageCoderHelper.m          |   8 +-
 SDWebImage/Core/SDImageIOAnimatedCoder.m      |  69 ++++++++++--------
 SDWebImage/Core/SDImageIOCoder.m              |   4 +-
 .../Private/SDImageIOAnimatedCoderInternal.h  |   2 +-
 .../project.pbxproj                           |   8 ++
 Tests/Tests/Images/TestImageLarge.png         | Bin 0 -> 313855 bytes
 Tests/Tests/SDImageCoderTests.m               |  60 ++++++++++++---
 8 files changed, 106 insertions(+), 46 deletions(-)
 create mode 100644 Tests/Tests/Images/TestImageLarge.png

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index 590fbba0..fe5ca0cc 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -21,6 +21,7 @@ typedef NSMutableDictionary<SDImageCoderOption, id> SDImageCoderMutableOptions;
  @note works for `SDImageCoder`.
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderDecodeFirstFrameOnly;
+
 /**
  A CGFloat value which is greater than or equal to 1.0. This value specify the image scale factor for decoding. If not provide, use 1.0. (NSNumber)
  @note works for `SDImageCoder`, `SDProgressiveImageCoder`, `SDAnimatedImageCoder`.
diff --git a/SDWebImage/Core/SDImageCoderHelper.m b/SDWebImage/Core/SDImageCoderHelper.m
index 7bba1025..c0547dc6 100644
--- a/SDWebImage/Core/SDImageCoderHelper.m
+++ b/SDWebImage/Core/SDImageCoderHelper.m
@@ -563,14 +563,14 @@ static const CGFloat kDestSeemOverlap = 2.0f;   // the numbers of pixels to over
 
 #pragma mark - Helper Fuction
 + (BOOL)shouldDecodeImage:(nullable UIImage *)image {
-    // Avoid extra decode
-    if (image.sd_isDecoded) {
-        return NO;
-    }
     // Prevent "CGBitmapContextCreateImage: invalid context 0x0" error
     if (image == nil) {
         return NO;
     }
+    // Avoid extra decode
+    if (image.sd_isDecoded) {
+        return NO;
+    }
     // do not decode animated images
     if (image.sd_isAnimated) {
         return NO;
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index fb3dea6e..89220c88 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -122,8 +122,12 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
 }
 
 + (NSTimeInterval)frameDurationAtIndex:(NSUInteger)index source:(CGImageSourceRef)source {
+    NSDictionary *options = @{
+        (__bridge NSString *)kCGImageSourceShouldCacheImmediately : @(YES),
+        (__bridge NSString *)kCGImageSourceShouldCache : @(YES) // Always cache to reduce CPU usage
+    };
     NSTimeInterval frameDuration = 0.1;
-    CFDictionaryRef cfFrameProperties = CGImageSourceCopyPropertiesAtIndex(source, index, nil);
+    CFDictionaryRef cfFrameProperties = CGImageSourceCopyPropertiesAtIndex(source, index, (__bridge CFDictionaryRef)options);
     if (!cfFrameProperties) {
         return frameDuration;
     }
@@ -153,9 +157,10 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     return frameDuration;
 }
 
-+ (UIImage *)createFrameAtIndex:(NSUInteger)index source:(CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize {
++ (UIImage *)createFrameAtIndex:(NSUInteger)index source:(CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize options:(NSDictionary *)options {
+    // Some options need to pass to `CGImageSourceCopyPropertiesAtIndex` before `CGImageSourceCreateImageAtIndex`, or ImageIO will ignore them because they parse once :)
     // Parse the image properties
-    NSDictionary *properties = (__bridge_transfer NSDictionary *)CGImageSourceCopyPropertiesAtIndex(source, index, NULL);
+    NSDictionary *properties = (__bridge_transfer NSDictionary *)CGImageSourceCopyPropertiesAtIndex(source, index, (__bridge CFDictionaryRef)options);
     NSUInteger pixelWidth = [properties[(__bridge NSString *)kCGImagePropertyPixelWidth] unsignedIntegerValue];
     NSUInteger pixelHeight = [properties[(__bridge NSString *)kCGImagePropertyPixelHeight] unsignedIntegerValue];
     CGImagePropertyOrientation exifOrientation = (CGImagePropertyOrientation)[properties[(__bridge NSString *)kCGImagePropertyOrientation] unsignedIntegerValue];
@@ -169,10 +174,15 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     if ([NSData sd_imageFormatFromUTType:uttype] == SDImageFormatPDF) {
         isVector = YES;
     }
-    
+
+    NSMutableDictionary *decodingOptions;
+    if (options) {
+        decodingOptions = [NSMutableDictionary dictionaryWithDictionary:options];
+    } else {
+        decodingOptions = [NSMutableDictionary dictionary];
+    }
     CGImageRef imageRef;
     if (thumbnailSize.width == 0 || thumbnailSize.height == 0 || pixelWidth == 0 || pixelHeight == 0 || (pixelWidth <= thumbnailSize.width && pixelHeight <= thumbnailSize.height)) {
-        NSDictionary *options;
         if (isVector) {
             if (thumbnailSize.width == 0 || thumbnailSize.height == 0) {
                 // Provide the default pixel count for vector images, simply just use the screen size
@@ -187,12 +197,11 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
             CGFloat maxPixelSize = MAX(thumbnailSize.width, thumbnailSize.height);
             NSUInteger DPIPerPixel = 2;
             NSUInteger rasterizationDPI = maxPixelSize * DPIPerPixel;
-            options = @{kSDCGImageSourceRasterizationDPI : @(rasterizationDPI)};
+            decodingOptions[kSDCGImageSourceRasterizationDPI] = @(rasterizationDPI);
         }
-        imageRef = CGImageSourceCreateImageAtIndex(source, index, (__bridge CFDictionaryRef)options);
+        imageRef = CGImageSourceCreateImageAtIndex(source, index, (__bridge CFDictionaryRef)decodingOptions);
     } else {
-        NSMutableDictionary *thumbnailOptions = [NSMutableDictionary dictionary];
-        thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
+        decodingOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailWithTransform] = @(preserveAspectRatio);
         CGFloat maxPixelSize;
         if (preserveAspectRatio) {
             CGFloat pixelRatio = pixelWidth / pixelHeight;
@@ -205,9 +214,9 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         } else {
             maxPixelSize = MAX(thumbnailSize.width, thumbnailSize.height);
         }
-        thumbnailOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = @(maxPixelSize);
-        thumbnailOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
-        imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)thumbnailOptions);
+        decodingOptions[(__bridge NSString *)kCGImageSourceThumbnailMaxPixelSize] = @(maxPixelSize);
+        decodingOptions[(__bridge NSString *)kCGImageSourceCreateThumbnailFromImageIfAbsent] = @(YES);
+        imageRef = CGImageSourceCreateThumbnailAtIndex(source, index, (__bridge CFDictionaryRef)decodingOptions);
     }
     if (!imageRef) {
         return nil;
@@ -288,12 +297,12 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     
     BOOL decodeFirstFrame = [options[SDImageCoderDecodeFirstFrameOnly] boolValue];
     if (decodeFirstFrame || count <= 1) {
-        animatedImage = [self.class createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
+        animatedImage = [self.class createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize options:nil];
     } else {
         NSMutableArray<SDImageFrame *> *frames = [NSMutableArray array];
         
         for (size_t i = 0; i < count; i++) {
-            UIImage *image = [self.class createFrameAtIndex:i source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
+            UIImage *image = [self.class createFrameAtIndex:i source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize options:nil];
             if (!image) {
                 continue;
             }
@@ -369,7 +378,11 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     CGImageSourceUpdateData(_imageSource, (__bridge CFDataRef)data, finished);
     
     if (_width + _height == 0) {
-        CFDictionaryRef properties = CGImageSourceCopyPropertiesAtIndex(_imageSource, 0, NULL);
+        NSDictionary *options = @{
+            (__bridge NSString *)kCGImageSourceShouldCacheImmediately : @(YES),
+            (__bridge NSString *)kCGImageSourceShouldCache : @(YES) // Always cache to reduce CPU usage
+        };
+        CFDictionaryRef properties = CGImageSourceCopyPropertiesAtIndex(_imageSource, 0, (__bridge CFDictionaryRef)options);
         if (properties) {
             CFTypeRef val = CFDictionaryGetValue(properties, kCGImagePropertyPixelHeight);
             if (val) CFNumberGetValue(val, kCFNumberLongType, &_height);
@@ -393,7 +406,7 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         if (scaleFactor != nil) {
             scale = MAX([scaleFactor doubleValue], 1);
         }
-        image = [self.class createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        image = [self.class createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize options:nil];
         if (image) {
             image.sd_imageFormat = self.class.imageFormat;
         }
@@ -597,24 +610,20 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
 }
 
 - (UIImage *)animatedImageFrameAtIndex:(NSUInteger)index {
-    UIImage *image = [self.class createFrameAtIndex:index source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+    if (index >= _frameCount) {
+        return nil;
+    }
+    // Animated Image should not use the CGContext solution to force decode. Prefers to use Image/IO built in method, which is safer and memory friendly, see https://github.com/SDWebImage/SDWebImage/issues/2961
+    NSDictionary *options = @{
+        (__bridge NSString *)kCGImageSourceShouldCacheImmediately : @(YES),
+        (__bridge NSString *)kCGImageSourceShouldCache : @(YES) // Always cache to reduce CPU usage
+    };
+    UIImage *image = [self.class createFrameAtIndex:index source:_imageSource scale:_scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize options:options];
     if (!image) {
         return nil;
     }
     image.sd_imageFormat = self.class.imageFormat;
-    // Image/IO create CGImage does not decode, so we do this because this is called background queue, this can avoid main queue block when rendering(especially when one more imageViews use the same image instance)
-    CGImageRef imageRef = [SDImageCoderHelper CGImageCreateDecoded:image.CGImage];
-    if (!imageRef) {
-        return image;
-    }
-#if SD_MAC
-    image = [[UIImage alloc] initWithCGImage:imageRef scale:_scale orientation:kCGImagePropertyOrientationUp];
-#else
-    image = [[UIImage alloc] initWithCGImage:imageRef scale:_scale orientation:image.imageOrientation];
-#endif
-    CGImageRelease(imageRef);
-    image.sd_isDecoded = YES;
-    image.sd_imageFormat = self.class.imageFormat;
+    image.sd_isDecoded = YES;;
     return image;
 }
 
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index 482aea8d..df93e14e 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -101,7 +101,7 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         return nil;
     }
     
-    UIImage *image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize];
+    UIImage *image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize options:nil];
     CFRelease(source);
     if (!image) {
         return nil;
@@ -193,7 +193,7 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         if (scaleFactor != nil) {
             scale = MAX([scaleFactor doubleValue], 1);
         }
-        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize];
+        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize options:nil];
         if (image) {
             CFStringRef uttype = CGImageSourceGetType(_imageSource);
             image.sd_imageFormat = [NSData sd_imageFormatFromUTType:uttype];
diff --git a/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h b/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
index f2976ea8..cb4ee2c4 100644
--- a/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
+++ b/SDWebImage/Private/SDImageIOAnimatedCoderInternal.h
@@ -13,6 +13,6 @@
 
 + (NSTimeInterval)frameDurationAtIndex:(NSUInteger)index source:(nonnull CGImageSourceRef)source;
 + (NSUInteger)imageLoopCountWithSource:(nonnull CGImageSourceRef)source;
-+ (nullable UIImage *)createFrameAtIndex:(NSUInteger)index source:(nonnull CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize;
++ (nullable UIImage *)createFrameAtIndex:(NSUInteger)index source:(nonnull CGImageSourceRef)source scale:(CGFloat)scale preserveAspectRatio:(BOOL)preserveAspectRatio thumbnailSize:(CGSize)thumbnailSize options:(nullable NSDictionary *)options;
 
 @end
diff --git a/Tests/SDWebImage Tests.xcodeproj/project.pbxproj b/Tests/SDWebImage Tests.xcodeproj/project.pbxproj
index ac80009d..12e43aec 100644
--- a/Tests/SDWebImage Tests.xcodeproj/project.pbxproj	
+++ b/Tests/SDWebImage Tests.xcodeproj/project.pbxproj	
@@ -9,6 +9,9 @@
 /* Begin PBXBuildFile section */
 		1E3C51E919B46E370092B5E6 /* SDWebImageDownloaderTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 1E3C51E819B46E370092B5E6 /* SDWebImageDownloaderTests.m */; };
 		2D7AF0601F329763000083C2 /* SDTestCase.m in Sources */ = {isa = PBXBuildFile; fileRef = 2D7AF05F1F329763000083C2 /* SDTestCase.m */; };
+		320224F72440C39B00E5B29D /* TestImageLarge.png in Resources */ = {isa = PBXBuildFile; fileRef = 320224F62440C39B00E5B29D /* TestImageLarge.png */; };
+		320224F82440C39B00E5B29D /* TestImageLarge.png in Resources */ = {isa = PBXBuildFile; fileRef = 320224F62440C39B00E5B29D /* TestImageLarge.png */; };
+		320224F92440C39B00E5B29D /* TestImageLarge.png in Resources */ = {isa = PBXBuildFile; fileRef = 320224F62440C39B00E5B29D /* TestImageLarge.png */; };
 		320630412085A37C006E0FA4 /* SDAnimatedImageTest.m in Sources */ = {isa = PBXBuildFile; fileRef = 32A571552037DB2D002EDAAE /* SDAnimatedImageTest.m */; };
 		3222417F2272F808002429DB /* SDUtilsTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 3222417E2272F808002429DB /* SDUtilsTests.m */; };
 		322241802272F808002429DB /* SDUtilsTests.m in Sources */ = {isa = PBXBuildFile; fileRef = 3222417E2272F808002429DB /* SDUtilsTests.m */; };
@@ -107,6 +110,7 @@
 		1E3C51E819B46E370092B5E6 /* SDWebImageDownloaderTests.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SDWebImageDownloaderTests.m; sourceTree = "<group>"; };
 		2D7AF05E1F329763000083C2 /* SDTestCase.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SDTestCase.h; sourceTree = "<group>"; };
 		2D7AF05F1F329763000083C2 /* SDTestCase.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SDTestCase.m; sourceTree = "<group>"; };
+		320224F62440C39B00E5B29D /* TestImageLarge.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = TestImageLarge.png; sourceTree = "<group>"; };
 		3222417E2272F808002429DB /* SDUtilsTests.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDUtilsTests.m; sourceTree = "<group>"; };
 		3226ECB920754F7700FAFACF /* SDWebImageTestDownloadOperation.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDWebImageTestDownloadOperation.h; sourceTree = "<group>"; };
 		3226ECBA20754F7700FAFACF /* SDWebImageTestDownloadOperation.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDWebImageTestDownloadOperation.m; sourceTree = "<group>"; };
@@ -239,6 +243,7 @@
 				326E69462334C0C200B7252C /* TestLoopCount.gif */,
 				5F7F38AC1AE2A77A00B0E330 /* TestImage.jpg */,
 				43828A441DA67F9900000E62 /* TestImageLarge.jpg */,
+				320224F62440C39B00E5B29D /* TestImageLarge.png */,
 				433BBBB81D7EF8260086B6E9 /* TestImage.png */,
 				327A418B211D660600495442 /* TestImage.heic */,
 				32905E63211D786E00460FCF /* TestImage.heif */,
@@ -449,6 +454,7 @@
 				329922872365DC6C00EAFD97 /* TestLoopCount.gif in Resources */,
 				3299228C2365DC6C00EAFD97 /* TestImage.heif in Resources */,
 				3234306423E2BAC800C290C8 /* TestImage.pdf in Resources */,
+				320224F92440C39B00E5B29D /* TestImageLarge.png in Resources */,
 				329922892365DC6C00EAFD97 /* TestImageLarge.jpg in Resources */,
 				3299228A2365DC6C00EAFD97 /* TestImage.png in Resources */,
 				329922842365DC6C00EAFD97 /* MonochromeTestImage.jpg in Resources */,
@@ -468,6 +474,7 @@
 				324047452271956F007C53E1 /* TestEXIF.png in Resources */,
 				32B99EA4203B31360017FD66 /* TestImage.jpg in Resources */,
 				3234306323E2BAC800C290C8 /* TestImage.pdf in Resources */,
+				320224F82440C39B00E5B29D /* TestImageLarge.png in Resources */,
 				32B99EA6203B31360017FD66 /* TestImage.png in Resources */,
 				3297A0A023374D1700814590 /* TestImageAnimated.heic in Resources */,
 				32B99EA2203B31360017FD66 /* MonochromeTestImage.jpg in Resources */,
@@ -487,6 +494,7 @@
 				32905E64211D786E00460FCF /* TestImage.heif in Resources */,
 				43828A451DA67F9900000E62 /* TestImageLarge.jpg in Resources */,
 				3234306223E2BAC800C290C8 /* TestImage.pdf in Resources */,
+				320224F72440C39B00E5B29D /* TestImageLarge.png in Resources */,
 				433BBBB71D7EF8200086B6E9 /* TestImage.gif in Resources */,
 				433BBBB91D7EF8260086B6E9 /* TestImage.png in Resources */,
 				3297A09F23374D1700814590 /* TestImageAnimated.heic in Resources */,
diff --git a/Tests/Tests/Images/TestImageLarge.png b/Tests/Tests/Images/TestImageLarge.png
new file mode 100644
index 0000000000000000000000000000000000000000..4573dd8fa4ad3e6f2741e6fa647d156097a0e578
GIT binary patch
literal 313855
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
IxesCg4<Ul>&j0`b

literal 0
HcmV?d00001

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 3c7b5793..4556686f 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -22,7 +22,7 @@
 }
 
 - (void)test02ThatDecodedImageWithImageWorksWithARegularJPGImage {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"jpg"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIImage *decodedImage = [UIImage sd_decodedImageWithImage:image];
     expect(decodedImage).toNot.beNil();
@@ -32,7 +32,7 @@
 }
 
 - (void)test03ThatDecodedImageWithImageDoesNotDecodeAnimatedImages {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"gif"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"gif"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
 #if SD_MAC
     UIImage *animatedImage = image;
@@ -45,7 +45,7 @@
 }
 
 - (void)test04ThatDecodedImageWithImageWorksWithAlphaImages {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"png"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"png"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIImage *decodedImage = [UIImage sd_decodedImageWithImage:image];
     expect(decodedImage).toNot.beNil();
@@ -53,7 +53,7 @@
 }
 
 - (void)test05ThatDecodedImageWithImageWorksEvenWithMonochromeImage {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"MonochromeTestImage" ofType:@"jpg"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"MonochromeTestImage" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIImage *decodedImage = [UIImage sd_decodedImageWithImage:image];
     expect(decodedImage).toNot.beNil();
@@ -63,7 +63,7 @@
 }
 
 - (void)test06ThatDecodeAndScaleDownImageWorks {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIImage *decodedImage = [UIImage sd_decodedAndScaledDownImageWithImage:image limitBytes:(60 * 1024 * 1024)];
     expect(decodedImage).toNot.beNil();
@@ -74,7 +74,7 @@
 }
 
 - (void)test07ThatDecodeAndScaleDownImageDoesNotScaleSmallerImage {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"jpg"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIImage *decodedImage = [UIImage sd_decodedAndScaledDownImageWithImage:image];
     expect(decodedImage).toNot.beNil();
@@ -84,7 +84,7 @@
 }
 
 - (void)test08ThatEncodeAlphaImageToJPGWithBackgroundColor {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"png"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImage" ofType:@"png"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     UIColor *backgroundColor = [UIColor blackColor];
     NSData *encodedData = [SDImageCodersManager.sharedManager encodedDataWithImage:image format:SDImageFormatJPEG options:@{SDImageCoderEncodeBackgroundColor : backgroundColor}];
@@ -99,7 +99,7 @@
 }
 
 - (void)test09ThatJPGImageEncodeWithMaxFileSize {
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"jpg"];
     UIImage *image = [[UIImage alloc] initWithContentsOfFile:testImagePath];
     // This large JPEG encoding size between (770KB ~ 2.23MB)
     NSUInteger limitFileSize = 1 * 1024 * 1024; // 1MB
@@ -118,6 +118,34 @@
     expect(limitEncodedData.length).beGreaterThan(minEncodedData.length);
 }
 
+- (void)test10ThatAnimatedImageCacheImmediatelyWorks {
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestImageLarge" ofType:@"png"];
+    NSData *testImageData = [NSData dataWithContentsOfFile:testImagePath];
+    
+    // Check that animated image rendering should not use lazy decoding (performance related)
+    CFAbsoluteTime begin = CFAbsoluteTimeGetCurrent();
+    SDImageAPNGCoder *coder = [[SDImageAPNGCoder alloc] initWithAnimatedImageData:testImageData options:@{SDImageCoderDecodeFirstFrameOnly : @(NO)}];
+    UIImage *imageWithoutLazyDecoding = [coder animatedImageFrameAtIndex:0];
+    coder = nil;
+    CFAbsoluteTime end = CFAbsoluteTimeGetCurrent();
+    CFAbsoluteTime duration = end - begin;
+    expect(imageWithoutLazyDecoding.sd_isDecoded).beTruthy();
+    CFAbsoluteTime renderingTime = [self measureImageRenderingTime:imageWithoutLazyDecoding];
+    
+    // Check that static image rendering should use lazy decoding
+    CFAbsoluteTime begin2 = CFAbsoluteTimeGetCurrent();
+    UIImage *imageWithLazyDecoding = [SDImageAPNGCoder.sharedCoder decodedImageWithData:testImageData options:@{SDImageCoderDecodeFirstFrameOnly : @(YES)}];
+    CFAbsoluteTime end2 = CFAbsoluteTimeGetCurrent();
+    CFAbsoluteTime duration2 = end2 - begin2;
+    expect(imageWithLazyDecoding.sd_isDecoded).beFalsy();
+    CFAbsoluteTime renderingTime2 = [self measureImageRenderingTime:imageWithLazyDecoding];
+    
+    // lazy decoding need less time
+    expect(duration2).beLessThan(duration);
+    // lazy rendering need more time
+    expect(renderingTime2).beGreaterThan(renderingTime);
+}
+
 - (void)test11ThatAPNGPCoderWorks {
     NSURL *APNGURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImageAnimated" withExtension:@"apng"];
     [self verifyCoder:[SDImageAPNGCoder sharedCoder]
@@ -138,7 +166,7 @@
     // When GIF metadata does not contains any loop count information (`kCGImagePropertyGIFLoopCount`'s value nil)
     // The standard says it should just play once. See: http://www6.uniovi.es/gifanim/gifabout.htm
     // This behavior is different from other modern animated image format like APNG/WebP. Which will play infinitely
-    NSString * testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestLoopCount" ofType:@"gif"];
+    NSString *testImagePath = [[NSBundle bundleForClass:[self class]] pathForResource:@"TestLoopCount" ofType:@"gif"];
     NSData *testImageData = [NSData dataWithContentsOfFile:testImagePath];
     UIImage *image = [SDImageGIFCoder.sharedCoder decodedImageWithData:testImageData options:nil];
     expect(image.sd_imageLoopCount).equal(1);
@@ -339,4 +367,18 @@ withLocalImageURL:(NSURL *)imageUrl
     }
 }
 
+- (CFAbsoluteTime)measureImageRenderingTime:(UIImage *)image {
+    CGImageRef imageRef = image.CGImage;
+    CFAbsoluteTime begin = CFAbsoluteTimeGetCurrent();
+    SDGraphicsBeginImageContext(image.size);
+    CGContextRef context = SDGraphicsGetCurrentContext();
+    CGContextDrawImage(context, CGRectMake(0, 0, image.size.width, image.size.height), imageRef);
+    SDGraphicsEndImageContext();
+    CFAbsoluteTime end = CFAbsoluteTimeGetCurrent();
+    CFAbsoluteTime duration = end - begin;
+    // CoreAnimation's `CA::copy_image` will trigger `CGImageProviderCopyImageBlockSetWithOptions`, which will trigger the ImageIO ImageProviderInfo's callback and decode images.
+    // Since it's hard to use SPI to simulate this case, I just use the method call duration to check, which will cost more than 20ms
+    return duration;
+}
+
 @end

From b65ea693aee8fb1dd0c75bbcd165969ec53044b7 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 11 Apr 2020 16:40:55 +0800
Subject: [PATCH 167/181] Remove the time based test case for lazy decoding,
 because it's unstable. Now use offline manual test for this behavior

---
 Tests/Tests/SDImageCoderTests.m | 26 ++++----------------------
 1 file changed, 4 insertions(+), 22 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 4556686f..4f4ad700 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -126,24 +126,20 @@
     CFAbsoluteTime begin = CFAbsoluteTimeGetCurrent();
     SDImageAPNGCoder *coder = [[SDImageAPNGCoder alloc] initWithAnimatedImageData:testImageData options:@{SDImageCoderDecodeFirstFrameOnly : @(NO)}];
     UIImage *imageWithoutLazyDecoding = [coder animatedImageFrameAtIndex:0];
-    coder = nil;
     CFAbsoluteTime end = CFAbsoluteTimeGetCurrent();
     CFAbsoluteTime duration = end - begin;
     expect(imageWithoutLazyDecoding.sd_isDecoded).beTruthy();
-    CFAbsoluteTime renderingTime = [self measureImageRenderingTime:imageWithoutLazyDecoding];
     
     // Check that static image rendering should use lazy decoding
     CFAbsoluteTime begin2 = CFAbsoluteTimeGetCurrent();
-    UIImage *imageWithLazyDecoding = [SDImageAPNGCoder.sharedCoder decodedImageWithData:testImageData options:@{SDImageCoderDecodeFirstFrameOnly : @(YES)}];
+    SDImageAPNGCoder *coder2 = SDImageAPNGCoder.sharedCoder;
+    UIImage *imageWithLazyDecoding = [coder2 decodedImageWithData:testImageData options:@{SDImageCoderDecodeFirstFrameOnly : @(YES)}];
     CFAbsoluteTime end2 = CFAbsoluteTimeGetCurrent();
     CFAbsoluteTime duration2 = end2 - begin2;
     expect(imageWithLazyDecoding.sd_isDecoded).beFalsy();
-    CFAbsoluteTime renderingTime2 = [self measureImageRenderingTime:imageWithLazyDecoding];
     
-    // lazy decoding need less time
-    expect(duration2).beLessThan(duration);
-    // lazy rendering need more time
-    expect(renderingTime2).beGreaterThan(renderingTime);
+    // lazy decoding need less time (10x)
+    expect(duration2 * 10.0).beLessThan(duration);
 }
 
 - (void)test11ThatAPNGPCoderWorks {
@@ -367,18 +363,4 @@ withLocalImageURL:(NSURL *)imageUrl
     }
 }
 
-- (CFAbsoluteTime)measureImageRenderingTime:(UIImage *)image {
-    CGImageRef imageRef = image.CGImage;
-    CFAbsoluteTime begin = CFAbsoluteTimeGetCurrent();
-    SDGraphicsBeginImageContext(image.size);
-    CGContextRef context = SDGraphicsGetCurrentContext();
-    CGContextDrawImage(context, CGRectMake(0, 0, image.size.width, image.size.height), imageRef);
-    SDGraphicsEndImageContext();
-    CFAbsoluteTime end = CFAbsoluteTimeGetCurrent();
-    CFAbsoluteTime duration = end - begin;
-    // CoreAnimation's `CA::copy_image` will trigger `CGImageProviderCopyImageBlockSetWithOptions`, which will trigger the ImageIO ImageProviderInfo's callback and decode images.
-    // Since it's hard to use SPI to simulate this case, I just use the method call duration to check, which will cost more than 20ms
-    return duration;
-}
-
 @end

From d112d18088a7aa7df9bb8a2fd5352704d9c72cfa Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 11 Apr 2020 17:01:47 +0800
Subject: [PATCH 168/181] Rename the private header `UIColor+HexString` and
 `NSBezierPath+SDRoundedCorners` with SD prefix, to avoid the conflict when
 using CocoaPods

---
 SDWebImage.xcodeproj/project.pbxproj          | 40 +++++++++----------
 SDWebImage/Core/SDImageTransformer.m          |  2 +-
 SDWebImage/Core/UIImage+Transform.m           |  2 +-
 ...ners.h => NSBezierPath+SDRoundedCorners.h} |  2 +-
 ...ners.m => NSBezierPath+SDRoundedCorners.m} |  4 +-
 ...olor+HexString.h => UIColor+SDHexString.h} |  2 +-
 ...olor+HexString.m => UIColor+SDHexString.m} |  4 +-
 Tests/Tests/SDImageCoderTests.m               |  2 +-
 Tests/Tests/SDImageTransformerTests.m         |  2 +-
 Tests/Tests/SDUtilsTests.m                    |  2 +-
 10 files changed, 31 insertions(+), 31 deletions(-)
 rename SDWebImage/Private/{NSBezierPath+RoundedCorners.h => NSBezierPath+SDRoundedCorners.h} (93%)
 rename SDWebImage/Private/{NSBezierPath+RoundedCorners.m => NSBezierPath+SDRoundedCorners.m} (94%)
 rename SDWebImage/Private/{UIColor+HexString.h => UIColor+SDHexString.h} (93%)
 rename SDWebImage/Private/{UIColor+HexString.m => UIColor+SDHexString.m} (93%)

diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index 39537274..bbb554c1 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -90,12 +90,12 @@
 		325C460F223394D8004CAE11 /* SDImageCachesManagerOperation.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C460C223394D8004CAE11 /* SDImageCachesManagerOperation.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325C4610223394D8004CAE11 /* SDImageCachesManagerOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C460D223394D8004CAE11 /* SDImageCachesManagerOperation.m */; };
 		325C4611223394D8004CAE11 /* SDImageCachesManagerOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C460D223394D8004CAE11 /* SDImageCachesManagerOperation.m */; };
-		325C46212233A02E004CAE11 /* UIColor+HexString.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C461E2233A02E004CAE11 /* UIColor+HexString.h */; settings = {ATTRIBUTES = (Private, ); }; };
-		325C46222233A02E004CAE11 /* UIColor+HexString.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C461F2233A02E004CAE11 /* UIColor+HexString.m */; };
-		325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C461F2233A02E004CAE11 /* UIColor+HexString.m */; };
-		325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */; settings = {ATTRIBUTES = (Private, ); }; };
-		325C46282233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
-		325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */; };
+		325C46212233A02E004CAE11 /* UIColor+SDHexString.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C461E2233A02E004CAE11 /* UIColor+SDHexString.h */; settings = {ATTRIBUTES = (Private, ); }; };
+		325C46222233A02E004CAE11 /* UIColor+SDHexString.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C461F2233A02E004CAE11 /* UIColor+SDHexString.m */; };
+		325C46232233A02E004CAE11 /* UIColor+SDHexString.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C461F2233A02E004CAE11 /* UIColor+SDHexString.m */; };
+		325C46272233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.h in Headers */ = {isa = PBXBuildFile; fileRef = 325C46242233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.h */; settings = {ATTRIBUTES = (Private, ); }; };
+		325C46282233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m */; };
+		325C46292233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m in Sources */ = {isa = PBXBuildFile; fileRef = 325C46252233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m */; };
 		325F7CC623893B2E00AEDFCC /* SDFileAttributeHelper.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */; settings = {ATTRIBUTES = (Private, ); }; };
 		325F7CC723893B2E00AEDFCC /* SDFileAttributeHelper.m in Sources */ = {isa = PBXBuildFile; fileRef = 325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */; };
 		325F7CCA238942AB00AEDFCC /* UIImage+ExtendedCacheData.h in Headers */ = {isa = PBXBuildFile; fileRef = 325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */; settings = {ATTRIBUTES = (Public, ); }; };
@@ -423,10 +423,10 @@
 		325C460722339426004CAE11 /* SDWeakProxy.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDWeakProxy.m; sourceTree = "<group>"; };
 		325C460C223394D8004CAE11 /* SDImageCachesManagerOperation.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDImageCachesManagerOperation.h; sourceTree = "<group>"; };
 		325C460D223394D8004CAE11 /* SDImageCachesManagerOperation.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDImageCachesManagerOperation.m; sourceTree = "<group>"; };
-		325C461E2233A02E004CAE11 /* UIColor+HexString.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "UIColor+HexString.h"; sourceTree = "<group>"; };
-		325C461F2233A02E004CAE11 /* UIColor+HexString.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "UIColor+HexString.m"; sourceTree = "<group>"; };
-		325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSBezierPath+RoundedCorners.h"; sourceTree = "<group>"; };
-		325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+RoundedCorners.m"; sourceTree = "<group>"; };
+		325C461E2233A02E004CAE11 /* UIColor+SDHexString.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "UIColor+SDHexString.h"; sourceTree = "<group>"; };
+		325C461F2233A02E004CAE11 /* UIColor+SDHexString.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "UIColor+SDHexString.m"; sourceTree = "<group>"; };
+		325C46242233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "NSBezierPath+SDRoundedCorners.h"; sourceTree = "<group>"; };
+		325C46252233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = "NSBezierPath+SDRoundedCorners.m"; sourceTree = "<group>"; };
 		325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = SDFileAttributeHelper.h; sourceTree = "<group>"; };
 		325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDFileAttributeHelper.m; sourceTree = "<group>"; };
 		325F7CC8238942AB00AEDFCC /* UIImage+ExtendedCacheData.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = "UIImage+ExtendedCacheData.h"; path = "Core/UIImage+ExtendedCacheData.h"; sourceTree = "<group>"; };
@@ -659,10 +659,10 @@
 				325C460D223394D8004CAE11 /* SDImageCachesManagerOperation.m */,
 				32C78E39233371AD00C6B7F8 /* SDImageIOAnimatedCoderInternal.h */,
 				32986560233737C70071958B /* SDImageHEICCoderInternal.h */,
-				325C461E2233A02E004CAE11 /* UIColor+HexString.h */,
-				325C461F2233A02E004CAE11 /* UIColor+HexString.m */,
-				325C46242233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h */,
-				325C46252233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m */,
+				325C461E2233A02E004CAE11 /* UIColor+SDHexString.h */,
+				325C461F2233A02E004CAE11 /* UIColor+SDHexString.m */,
+				325C46242233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.h */,
+				325C46252233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m */,
 				325F7CC423893B2E00AEDFCC /* SDFileAttributeHelper.h */,
 				325F7CC523893B2E00AEDFCC /* SDFileAttributeHelper.m */,
 				329F123F223FAD3400B309FD /* SDInternalMacros.h */,
@@ -882,7 +882,7 @@
 				32D3CDD121DDE87300C4DB49 /* UIImage+MemoryCacheCost.h in Headers */,
 				328BB6AC2081FEE500760D6C /* SDWebImageCacheSerializer.h in Headers */,
 				325F7CCA238942AB00AEDFCC /* UIImage+ExtendedCacheData.h in Headers */,
-				325C46272233A0A8004CAE11 /* NSBezierPath+RoundedCorners.h in Headers */,
+				325C46272233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.h in Headers */,
 				321B378F2083290E00C0EA77 /* SDImageLoadersManager.h in Headers */,
 				329A185B1FFF5DFD008C9A2F /* UIImage+Metadata.h in Headers */,
 				4369C2791D9807EC007E863A /* UIView+WebCache.h in Headers */,
@@ -924,7 +924,7 @@
 				325C460922339426004CAE11 /* SDWeakProxy.h in Headers */,
 				80B6DF812142B43B00BCB334 /* SDAnimatedImageRep.h in Headers */,
 				4A2CAE2F1AB4BB7500B6BC39 /* UIImage+MultiFormat.h in Headers */,
-				325C46212233A02E004CAE11 /* UIColor+HexString.h in Headers */,
+				325C46212233A02E004CAE11 /* UIColor+SDHexString.h in Headers */,
 				325312CA200F09910046BF1E /* SDWebImageTransition.h in Headers */,
 				4A2CAE1A1AB4BB6400B6BC39 /* SDWebImageOperation.h in Headers */,
 				32484765201775F600AF9E5A /* SDAnimatedImageView+WebCache.h in Headers */,
@@ -1133,7 +1133,7 @@
 			files = (
 				3257EAFD21898AED0097B271 /* SDImageGraphics.m in Sources */,
 				3290FA0C1FA478AF0047D20C /* SDImageFrame.m in Sources */,
-				325C46232233A02E004CAE11 /* UIColor+HexString.m in Sources */,
+				325C46232233A02E004CAE11 /* UIColor+SDHexString.m in Sources */,
 				325F7CCB238942AB00AEDFCC /* UIImage+ExtendedCacheData.m in Sources */,
 				3246A70523A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */,
 				321E60C61F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
@@ -1172,7 +1172,7 @@
 				32B9B53F206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
 				43A9186D1D8308FE00B3925F /* SDImageCacheConfig.m in Sources */,
 				32A09E42233358B700339F9D /* SDImageIOAnimatedCoder.m in Sources */,
-				325C46292233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */,
+				325C46292233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m in Sources */,
 				3248477D201775F600AF9E5A /* SDAnimatedImageView+WebCache.m in Sources */,
 				321E60AA1F38E8F600405457 /* SDImageGIFCoder.m in Sources */,
 				321E608E1F38E8C800405457 /* SDImageCoder.m in Sources */,
@@ -1207,7 +1207,7 @@
 			files = (
 				3257EAFC21898AED0097B271 /* SDImageGraphics.m in Sources */,
 				3290FA0A1FA478AF0047D20C /* SDImageFrame.m in Sources */,
-				325C46222233A02E004CAE11 /* UIColor+HexString.m in Sources */,
+				325C46222233A02E004CAE11 /* UIColor+SDHexString.m in Sources */,
 				321E60C41F38E91700405457 /* UIImage+ForceDecode.m in Sources */,
 				3246A70423A567AC00FBEA10 /* SDGraphicsImageRenderer.m in Sources */,
 				3244062D2296C5F400A36084 /* SDWebImageOptionsProcessor.m in Sources */,
@@ -1246,7 +1246,7 @@
 				32B9B53D206ED4230026769D /* SDWebImageDownloaderConfig.m in Sources */,
 				43A9186B1D8308FE00B3925F /* SDImageCacheConfig.m in Sources */,
 				32A09E41233358B700339F9D /* SDImageIOAnimatedCoder.m in Sources */,
-				325C46282233A0A8004CAE11 /* NSBezierPath+RoundedCorners.m in Sources */,
+				325C46282233A0A8004CAE11 /* NSBezierPath+SDRoundedCorners.m in Sources */,
 				3248477B201775F600AF9E5A /* SDAnimatedImageView+WebCache.m in Sources */,
 				321E60A81F38E8F600405457 /* SDImageGIFCoder.m in Sources */,
 				321E608C1F38E8C800405457 /* SDImageCoder.m in Sources */,
diff --git a/SDWebImage/Core/SDImageTransformer.m b/SDWebImage/Core/SDImageTransformer.m
index 9397ec73..8e7a3e2a 100644
--- a/SDWebImage/Core/SDImageTransformer.m
+++ b/SDWebImage/Core/SDImageTransformer.m
@@ -7,7 +7,7 @@
  */
 
 #import "SDImageTransformer.h"
-#import "UIColor+HexString.h"
+#import "UIColor+SDHexString.h"
 #if SD_UIKIT || SD_MAC
 #import <CoreImage/CoreImage.h>
 #endif
diff --git a/SDWebImage/Core/UIImage+Transform.m b/SDWebImage/Core/UIImage+Transform.m
index a01cf12a..b27b3a95 100644
--- a/SDWebImage/Core/UIImage+Transform.m
+++ b/SDWebImage/Core/UIImage+Transform.m
@@ -10,7 +10,7 @@
 #import "NSImage+Compatibility.h"
 #import "SDImageGraphics.h"
 #import "SDGraphicsImageRenderer.h"
-#import "NSBezierPath+RoundedCorners.h"
+#import "NSBezierPath+SDRoundedCorners.h"
 #import <Accelerate/Accelerate.h>
 #if SD_UIKIT || SD_MAC
 #import <CoreImage/CoreImage.h>
diff --git a/SDWebImage/Private/NSBezierPath+RoundedCorners.h b/SDWebImage/Private/NSBezierPath+SDRoundedCorners.h
similarity index 93%
rename from SDWebImage/Private/NSBezierPath+RoundedCorners.h
rename to SDWebImage/Private/NSBezierPath+SDRoundedCorners.h
index 224f2597..dfec18b7 100644
--- a/SDWebImage/Private/NSBezierPath+RoundedCorners.h
+++ b/SDWebImage/Private/NSBezierPath+SDRoundedCorners.h
@@ -12,7 +12,7 @@
 
 #import "UIImage+Transform.h"
 
-@interface NSBezierPath (RoundedCorners)
+@interface NSBezierPath (SDRoundedCorners)
 
 /**
  Convenience way to create a bezier path with the specify rounding corners on macOS. Same as the one on `UIBezierPath`.
diff --git a/SDWebImage/Private/NSBezierPath+RoundedCorners.m b/SDWebImage/Private/NSBezierPath+SDRoundedCorners.m
similarity index 94%
rename from SDWebImage/Private/NSBezierPath+RoundedCorners.m
rename to SDWebImage/Private/NSBezierPath+SDRoundedCorners.m
index d217bf14..b6f7a011 100644
--- a/SDWebImage/Private/NSBezierPath+RoundedCorners.m
+++ b/SDWebImage/Private/NSBezierPath+SDRoundedCorners.m
@@ -6,11 +6,11 @@
  * file that was distributed with this source code.
  */
 
-#import "NSBezierPath+RoundedCorners.h"
+#import "NSBezierPath+SDRoundedCorners.h"
 
 #if SD_MAC
 
-@implementation NSBezierPath (RoundedCorners)
+@implementation NSBezierPath (SDRoundedCorners)
 
 + (instancetype)sd_bezierPathWithRoundedRect:(NSRect)rect byRoundingCorners:(SDRectCorner)corners cornerRadius:(CGFloat)cornerRadius {
     NSBezierPath *path = [NSBezierPath bezierPath];
diff --git a/SDWebImage/Private/UIColor+HexString.h b/SDWebImage/Private/UIColor+SDHexString.h
similarity index 93%
rename from SDWebImage/Private/UIColor+HexString.h
rename to SDWebImage/Private/UIColor+SDHexString.h
index 2a8a3d80..cf67186f 100644
--- a/SDWebImage/Private/UIColor+HexString.h
+++ b/SDWebImage/Private/UIColor+SDHexString.h
@@ -8,7 +8,7 @@
 
 #import "SDWebImageCompat.h"
 
-@interface UIColor (HexString)
+@interface UIColor (SDHexString)
 
 /**
  Convenience way to get hex string from color. The output should always be 32-bit RGBA hex string like `#00000000`.
diff --git a/SDWebImage/Private/UIColor+HexString.m b/SDWebImage/Private/UIColor+SDHexString.m
similarity index 93%
rename from SDWebImage/Private/UIColor+HexString.m
rename to SDWebImage/Private/UIColor+SDHexString.m
index aebb6e3b..7b43c411 100644
--- a/SDWebImage/Private/UIColor+HexString.m
+++ b/SDWebImage/Private/UIColor+SDHexString.m
@@ -6,9 +6,9 @@
  * file that was distributed with this source code.
  */
 
-#import "UIColor+HexString.h"
+#import "UIColor+SDHexString.h"
 
-@implementation UIColor (HexString)
+@implementation UIColor (SDHexString)
 
 - (NSString *)sd_hexString {
     CGFloat red, green, blue, alpha;
diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 3c7b5793..414604d2 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -8,7 +8,7 @@
  */
 
 #import "SDTestCase.h"
-#import "UIColor+HexString.h"
+#import "UIColor+SDHexString.h"
 
 @interface SDWebImageDecoderTests : SDTestCase
 
diff --git a/Tests/Tests/SDImageTransformerTests.m b/Tests/Tests/SDImageTransformerTests.m
index 18ab60ac..94215e0e 100644
--- a/Tests/Tests/SDImageTransformerTests.m
+++ b/Tests/Tests/SDImageTransformerTests.m
@@ -8,7 +8,7 @@
  */
 
 #import "SDTestCase.h"
-#import "UIColor+HexString.h"
+#import "UIColor+SDHexString.h"
 #import <CoreImage/CoreImage.h>
 
 @interface SDImageTransformerTests : SDTestCase
diff --git a/Tests/Tests/SDUtilsTests.m b/Tests/Tests/SDUtilsTests.m
index 4d37f9c4..5b59c74c 100644
--- a/Tests/Tests/SDUtilsTests.m
+++ b/Tests/Tests/SDUtilsTests.m
@@ -12,7 +12,7 @@
 #import "SDDisplayLink.h"
 #import "SDInternalMacros.h"
 #import "SDFileAttributeHelper.h"
-#import "UIColor+HexString.h"
+#import "UIColor+SDHexString.h"
 
 @interface SDUtilsTests : SDTestCase
 

From 74ae21337c415bb542eb901803f3e84799265c34 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sat, 11 Apr 2020 18:12:29 +0800
Subject: [PATCH 169/181] Bumped version to 5.7.2

Update the CHANGELOG
---
 CHANGELOG.md        | 10 ++++++++++
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc6d2f08..8f09d07a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,13 @@
+## [5.7.2 - 5.7 Patch, on Apr 11th, 2020](https://github.com/SDWebImage/SDWebImage/releases/tag/5.7.2)
+See [all tickets marked for the 5.7.2 release](https://github.com/SDWebImage/SDWebImage/milestone/68)
+
+### Fixes
+- SDAnimatedImageView animation rendering should not use CGContext force decoding, use `kCGImageSourceShouldCacheImmediately` instead which can avoid OOM for large number of GIFs #2977
+- Fix that when first play animated image and use maxBufferSize to 0, the calculation does not works (The CGImage is nil) #2982
+
+### Project
+- Rename the private header `UIColor+HexString` and `NSBezierPath+SDRoundedCorners` with SD prefix, to avoid the conflict when using CocoaPods #2983
+
 ## [5.7.1 - 5.7 Patch, on Apr 8th, 2020](https://github.com/SDWebImage/SDWebImage/releases/tag/5.7.1)
 See [all tickets marked for the 5.7.1 release](https://github.com/SDWebImage/SDWebImage/milestone/67)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 46f2061a..7464962c 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.7.1'
+  s.version = '5.7.2'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 3f491f95..6de94d20 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.7.1</string>
+	<string>5.7.2</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.7.1</string>
+	<string>5.7.2</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From b06d60cf3d998efb6958d97915ac1e9164d96dd8 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 12 Apr 2020 17:10:57 +0800
Subject: [PATCH 170/181] Update the readme of modules about custom caches,
 including SDWebImagePINPlugin support

---
 README.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 055c63d9..e83aaba8 100644
--- a/README.md
+++ b/README.md
@@ -64,7 +64,11 @@ The new framework introduce two View structs `WebImage` and `AnimatedImage` for
 - [SDWebImageLottieCoder](https://github.com/SDWebImage/SDWebImageLottieCoder) - coder for Lottie animation format. Based on [rlottie](https://github.com/Samsung/rlottie)
 - and more from community!
 
-#### Loaders
+#### Custom Caches
+- [SDWebImageYYPlugin](https://github.com/SDWebImage/SDWebImageYYPlugin) - plugin to support caching images with [YYCache](https://github.com/ibireme/YYCache)
+- [SDWebImagePINPlugin](https://github.com/SDWebImage/SDWebImagePINPlugin) - plugin to support caching images with [PINCache](https://github.com/pinterest/PINCache)
+
+#### Custom Loaders
 - [SDWebImagePhotosPlugin](https://github.com/SDWebImage/SDWebImagePhotosPlugin) - plugin to support loading images from Photos (using `Photos.framework`) 
 - [SDWebImageLinkPlugin](https://github.com/SDWebImage/SDWebImageLinkPlugin) - plugin to support loading images from rich link url, as well as `LPLinkView` (using `LinkPresentation.framework`) 
 
@@ -77,7 +81,7 @@ The new framework introduce two View structs `WebImage` and `AnimatedImage` for
 #### Community driven popular libraries
 - [FirebaseUI](https://github.com/firebase/FirebaseUI-iOS) - Firebase Storage binding for query images, based on SDWebImage loader system
 - [react-native-fast-image](https://github.com/DylanVann/react-native-fast-image) - React Native fast image component, based on SDWebImage Animated Image solution
-- [flutter_image_compress](https://github.com/OpenFlutter/flutter_image_compress) - Flutter compresses image plugin, based on SDWebImageWebPCoder coder plugin
+- [flutter_image_compress](https://github.com/OpenFlutter/flutter_image_compress) - Flutter compresses image plugin, based on SDWebImage WebP coder plugin
 
 #### Make our lives easier
 - [libwebp-Xcode](https://github.com/SDWebImage/libwebp-Xcode) - A wrapper for [libwebp](https://chromium.googlesource.com/webm/libwebp) + an Xcode project.

From e5adec920bc8bfff150a1a3dc4b16482d611ab3b Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 13 Apr 2020 11:22:30 +0800
Subject: [PATCH 171/181] Fix the test case about encoding check, the expect
 expression syntax is wrong

---
 Tests/Tests/SDImageCoderTests.m | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index 378c5b08..a4574f59 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -311,8 +311,8 @@ withLocalImageURL:(NSURL *)imageUrl
         thumbnailPixelSize = CGSizeMake(round(thumbnailHeight * ratio), thumbnailHeight);
     }
     // Image/IO's thumbnail API does not always use round to preserve precision, we check ABS <= 1
-    expect(ABS(thumbImage.size.width - thumbnailPixelSize.width) <= 1);
-    expect(ABS(thumbImage.size.height - thumbnailPixelSize.height) <= 1);
+    expect(ABS(thumbImage.size.width - thumbnailPixelSize.width)).beLessThanOrEqualTo(1);
+    expect(ABS(thumbImage.size.height - thumbnailPixelSize.height)).beLessThanOrEqualTo(1);
     
     
     if (supportsEncoding) {
@@ -345,8 +345,8 @@ withLocalImageURL:(NSURL *)imageUrl
         NSData *outputMaxImageData = [coder encodedDataWithImage:inputImage format:encodingFormat options:@{SDImageCoderEncodeMaxPixelSize : @(CGSizeMake(maxWidth, maxHeight))}];
         UIImage *outputMaxImage = [coder decodedImageWithData:outputMaxImageData options:nil];
         // Image/IO's thumbnail API does not always use round to preserve precision, we check ABS <= 1
-        expect(ABS(outputMaxImage.size.width - maxPixelSize.width) <= 1);
-        expect(ABS(outputMaxImage.size.height - maxPixelSize.height) <= 1);
+        expect(ABS(outputMaxImage.size.width - maxPixelSize.width)).beLessThanOrEqualTo(1);
+        expect(ABS(outputMaxImage.size.height - maxPixelSize.height)).beLessThanOrEqualTo(1);
 #if SD_UIKIT
         expect(outputMaxImage.images.count).to.equal(inputImage.images.count);
 #endif

From 64b13dc3466e42adcfcd7c4c93ea999e8a63e29a Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 17 Apr 2020 15:51:19 +0800
Subject: [PATCH 172/181] Allows to keep the set image operation key to
 downstream component like downloader or cacher, used for tracing

---
 SDWebImage/Core/UIView+WebCache.m | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/SDWebImage/Core/UIView+WebCache.m b/SDWebImage/Core/UIView+WebCache.m
index 5e9f030a..c12b43d7 100644
--- a/SDWebImage/Core/UIView+WebCache.m
+++ b/SDWebImage/Core/UIView+WebCache.m
@@ -52,10 +52,19 @@ const int64_t SDWebImageProgressUnitCountUnknown = 1LL;
                      setImageBlock:(nullable SDSetImageBlock)setImageBlock
                           progress:(nullable SDImageLoaderProgressBlock)progressBlock
                          completed:(nullable SDInternalCompletionBlock)completedBlock {
-    context = [context copy]; // copy to avoid mutable object
+    if (context) {
+        // copy to avoid mutable object
+        context = [context copy];
+    } else {
+        context = [NSDictionary dictionary];
+    }
     NSString *validOperationKey = context[SDWebImageContextSetImageOperationKey];
     if (!validOperationKey) {
+        // pass through the operation key to downstream, which can used for tracing operation or image view class
         validOperationKey = NSStringFromClass([self class]);
+        SDWebImageMutableContext *mutableContext = [context mutableCopy];
+        mutableContext[SDWebImageContextSetImageOperationKey] = validOperationKey;
+        context = [mutableContext copy];
     }
     self.sd_latestOperationKey = validOperationKey;
     [self sd_cancelImageLoadOperationWithKey:validOperationKey];
@@ -83,6 +92,11 @@ const int64_t SDWebImageProgressUnitCountUnknown = 1LL;
         SDWebImageManager *manager = context[SDWebImageContextCustomManager];
         if (!manager) {
             manager = [SDWebImageManager sharedManager];
+        } else {
+            // remove this manager to avoid retain cycle (manger -> loader -> operation -> context -> manager)
+            SDWebImageMutableContext *mutableContext = [context mutableCopy];
+            mutableContext[SDWebImageContextCustomManager] = nil;
+            context = [mutableContext copy];
         }
         
         SDImageLoaderProgressBlock combinedProgressBlock = ^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {

From e8a357e504ff95b8e8995021941ad00b789f644f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Fri, 17 Apr 2020 16:03:36 +0800
Subject: [PATCH 173/181] Added test case `testUIViewOperationKeyContextWorks`
 to ensure this behavior

---
 Tests/Tests/SDWebCacheCategoriesTests.m | 26 +++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/Tests/Tests/SDWebCacheCategoriesTests.m b/Tests/Tests/SDWebCacheCategoriesTests.m
index e91c5ece..96fc7a3e 100644
--- a/Tests/Tests/SDWebCacheCategoriesTests.m
+++ b/Tests/Tests/SDWebCacheCategoriesTests.m
@@ -350,6 +350,32 @@
     [self waitForExpectationsWithCommonTimeout];
 }
 
+- (void)testUIViewOperationKeyContextWorks {
+    XCTestExpectation *expectation = [self expectationWithDescription:@"UIView operation key context should pass through"];
+    
+    UIView *view = [[UIView alloc] init];
+    NSURL *originalImageURL = [NSURL URLWithString:kTestJPEGURL];
+    SDWebImageManager *customManager = [[SDWebImageManager alloc] initWithCache:SDImageCachesManager.sharedManager loader:SDImageLoadersManager.sharedManager];
+    customManager.optionsProcessor = [SDWebImageOptionsProcessor optionsProcessorWithBlock:^SDWebImageOptionsResult * _Nullable(NSURL * _Nullable url, SDWebImageOptions options, SDWebImageContext * _Nullable context) {
+        // expect manager does not exist, avoid retain cycle
+        expect(context[SDWebImageContextCustomManager]).beNil();
+        // expect operation key to be the image view class
+        expect(context[SDWebImageContextSetImageOperationKey]).equal(NSStringFromClass(view.class));
+        return [[SDWebImageOptionsResult alloc] initWithOptions:options context:context];
+    }];
+    [view sd_internalSetImageWithURL:originalImageURL
+                    placeholderImage:nil
+                             options:0
+                             context:@{SDWebImageContextCustomManager: customManager}
+                       setImageBlock:nil
+                            progress:nil
+                           completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
+        [expectation fulfill];
+    }];
+    
+    [self waitForExpectationsWithCommonTimeout];
+}
+
 #pragma mark - Helper
 - (UIWindow *)window {
     if (!_window) {

From 1708ec67c103d8ffc6938fc551e8aadb67c344d2 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 19 Apr 2020 12:30:39 +0800
Subject: [PATCH 174/181] Support the SwiftPM Objective-C user to use #improt
 <SDWebImage/SDWebImage.h>, by using the link to the public header files and
 construct the same folder layout

---
 .../xcode/package.xcworkspace/contents.xcworkspacedata     | 7 +++++++
 Package.swift                                              | 2 +-
 README.md                                                  | 6 ++++++
 SDWebImage/MapKit/MKAnnotationView+WebCache.h              | 3 +--
 SDWebImage/MapKit/MKAnnotationView+WebCache.m              | 2 --
 SDWebImage/include/SDWebImage/NSButton+WebCache.h          | 1 +
 SDWebImage/include/SDWebImage/NSData+ImageContentType.h    | 1 +
 SDWebImage/include/SDWebImage/NSImage+Compatibility.h      | 1 +
 SDWebImage/include/SDWebImage/SDAnimatedImage.h            | 1 +
 SDWebImage/include/SDWebImage/SDAnimatedImagePlayer.h      | 1 +
 SDWebImage/include/SDWebImage/SDAnimatedImageRep.h         | 1 +
 .../include/SDWebImage/SDAnimatedImageView+WebCache.h      | 1 +
 SDWebImage/include/SDWebImage/SDAnimatedImageView.h        | 1 +
 SDWebImage/include/SDWebImage/SDDiskCache.h                | 1 +
 SDWebImage/include/SDWebImage/SDGraphicsImageRenderer.h    | 1 +
 SDWebImage/include/SDWebImage/SDImageAPNGCoder.h           | 1 +
 SDWebImage/include/SDWebImage/SDImageCache.h               | 1 +
 SDWebImage/include/SDWebImage/SDImageCacheConfig.h         | 1 +
 SDWebImage/include/SDWebImage/SDImageCacheDefine.h         | 1 +
 SDWebImage/include/SDWebImage/SDImageCachesManager.h       | 1 +
 SDWebImage/include/SDWebImage/SDImageCoder.h               | 1 +
 SDWebImage/include/SDWebImage/SDImageCoderHelper.h         | 1 +
 SDWebImage/include/SDWebImage/SDImageCodersManager.h       | 1 +
 SDWebImage/include/SDWebImage/SDImageFrame.h               | 1 +
 SDWebImage/include/SDWebImage/SDImageGIFCoder.h            | 1 +
 SDWebImage/include/SDWebImage/SDImageGraphics.h            | 1 +
 SDWebImage/include/SDWebImage/SDImageHEICCoder.h           | 1 +
 SDWebImage/include/SDWebImage/SDImageIOAnimatedCoder.h     | 1 +
 SDWebImage/include/SDWebImage/SDImageIOCoder.h             | 1 +
 SDWebImage/include/SDWebImage/SDImageLoader.h              | 1 +
 SDWebImage/include/SDWebImage/SDImageLoadersManager.h      | 1 +
 SDWebImage/include/SDWebImage/SDImageTransformer.h         | 1 +
 SDWebImage/include/SDWebImage/SDMemoryCache.h              | 1 +
 SDWebImage/include/SDWebImage/SDWebImage.h                 | 1 +
 SDWebImage/include/SDWebImage/SDWebImageCacheKeyFilter.h   | 1 +
 SDWebImage/include/SDWebImage/SDWebImageCacheSerializer.h  | 1 +
 SDWebImage/include/SDWebImage/SDWebImageCompat.h           | 1 +
 SDWebImage/include/SDWebImage/SDWebImageDefine.h           | 1 +
 SDWebImage/include/SDWebImage/SDWebImageDownloader.h       | 1 +
 SDWebImage/include/SDWebImage/SDWebImageDownloaderConfig.h | 1 +
 .../include/SDWebImage/SDWebImageDownloaderDecryptor.h     | 1 +
 .../include/SDWebImage/SDWebImageDownloaderOperation.h     | 1 +
 .../SDWebImage/SDWebImageDownloaderRequestModifier.h       | 1 +
 .../SDWebImage/SDWebImageDownloaderResponseModifier.h      | 1 +
 SDWebImage/include/SDWebImage/SDWebImageError.h            | 1 +
 SDWebImage/include/SDWebImage/SDWebImageIndicator.h        | 1 +
 SDWebImage/include/SDWebImage/SDWebImageManager.h          | 1 +
 SDWebImage/include/SDWebImage/SDWebImageOperation.h        | 1 +
 SDWebImage/include/SDWebImage/SDWebImageOptionsProcessor.h | 1 +
 SDWebImage/include/SDWebImage/SDWebImagePrefetcher.h       | 1 +
 SDWebImage/include/SDWebImage/SDWebImageTransition.h       | 1 +
 SDWebImage/include/SDWebImage/UIButton+WebCache.h          | 1 +
 SDWebImage/include/SDWebImage/UIImage+ExtendedCacheData.h  | 1 +
 SDWebImage/include/SDWebImage/UIImage+ForceDecode.h        | 1 +
 SDWebImage/include/SDWebImage/UIImage+GIF.h                | 1 +
 SDWebImage/include/SDWebImage/UIImage+MemoryCacheCost.h    | 1 +
 SDWebImage/include/SDWebImage/UIImage+Metadata.h           | 1 +
 SDWebImage/include/SDWebImage/UIImage+MultiFormat.h        | 1 +
 SDWebImage/include/SDWebImage/UIImage+Transform.h          | 1 +
 .../include/SDWebImage/UIImageView+HighlightedWebCache.h   | 1 +
 SDWebImage/include/SDWebImage/UIImageView+WebCache.h       | 1 +
 SDWebImage/include/SDWebImage/UIView+WebCache.h            | 1 +
 SDWebImage/include/SDWebImage/UIView+WebCacheOperation.h   | 1 +
 63 files changed, 73 insertions(+), 5 deletions(-)
 create mode 100644 .swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
 create mode 120000 SDWebImage/include/SDWebImage/NSButton+WebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/NSData+ImageContentType.h
 create mode 120000 SDWebImage/include/SDWebImage/NSImage+Compatibility.h
 create mode 120000 SDWebImage/include/SDWebImage/SDAnimatedImage.h
 create mode 120000 SDWebImage/include/SDWebImage/SDAnimatedImagePlayer.h
 create mode 120000 SDWebImage/include/SDWebImage/SDAnimatedImageRep.h
 create mode 120000 SDWebImage/include/SDWebImage/SDAnimatedImageView+WebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/SDAnimatedImageView.h
 create mode 120000 SDWebImage/include/SDWebImage/SDDiskCache.h
 create mode 120000 SDWebImage/include/SDWebImage/SDGraphicsImageRenderer.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageAPNGCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCache.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCacheConfig.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCacheDefine.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCachesManager.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCoderHelper.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageCodersManager.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageFrame.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageGIFCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageGraphics.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageHEICCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageIOAnimatedCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageIOCoder.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageLoader.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageLoadersManager.h
 create mode 120000 SDWebImage/include/SDWebImage/SDImageTransformer.h
 create mode 120000 SDWebImage/include/SDWebImage/SDMemoryCache.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImage.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageCacheKeyFilter.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageCacheSerializer.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageCompat.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDefine.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloader.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloaderConfig.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloaderDecryptor.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloaderOperation.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloaderRequestModifier.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageDownloaderResponseModifier.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageError.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageIndicator.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageManager.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageOperation.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageOptionsProcessor.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImagePrefetcher.h
 create mode 120000 SDWebImage/include/SDWebImage/SDWebImageTransition.h
 create mode 120000 SDWebImage/include/SDWebImage/UIButton+WebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+ExtendedCacheData.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+ForceDecode.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+GIF.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+MemoryCacheCost.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+Metadata.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+MultiFormat.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImage+Transform.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImageView+HighlightedWebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/UIImageView+WebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/UIView+WebCache.h
 create mode 120000 SDWebImage/include/SDWebImage/UIView+WebCacheOperation.h

diff --git a/.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata b/.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
new file mode 100644
index 00000000..919434a6
--- /dev/null
+++ b/.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>
diff --git a/Package.swift b/Package.swift
index b8f49233..05e22032 100644
--- a/Package.swift
+++ b/Package.swift
@@ -32,8 +32,8 @@ let package = Package(
             dependencies: [],
             path: "SDWebImage",
             sources: ["Core", "Private"],
-            publicHeadersPath: "Core",
             cSettings: [
+                .headerSearchPath("Core"),
                 .headerSearchPath("Private")
             ]
         ),
diff --git a/README.md b/README.md
index e83aaba8..37fa9619 100644
--- a/README.md
+++ b/README.md
@@ -283,6 +283,12 @@ In the source files where you need to use the library, import the umbrella heade
 #import <SDWebImage/SDWebImage.h>
 ```
 
+It's also recommend to use the module import syntax, available for CocoaPods(enable `modular_headers`)/Carthage/SwiftPM.
+
+```objecitivec
+@import SDWebImage;
+```
+
 ### Build Project
 
 At this point your workspace should build without error. If you are having problem, post to the Issue and the
diff --git a/SDWebImage/MapKit/MKAnnotationView+WebCache.h b/SDWebImage/MapKit/MKAnnotationView+WebCache.h
index 59346041..30f5aed1 100644
--- a/SDWebImage/MapKit/MKAnnotationView+WebCache.h
+++ b/SDWebImage/MapKit/MKAnnotationView+WebCache.h
@@ -6,12 +6,11 @@
  * file that was distributed with this source code.
  */
 
-#import "SDWebImageCompat.h"
+#import <SDWebImage/SDWebImage.h>
 
 #if SD_UIKIT || SD_MAC
 
 #import <MapKit/MapKit.h>
-#import "SDWebImageManager.h"
 
 /**
  * Integrates SDWebImage async downloading and caching of remote images with MKAnnotationView.
diff --git a/SDWebImage/MapKit/MKAnnotationView+WebCache.m b/SDWebImage/MapKit/MKAnnotationView+WebCache.m
index 11b91b19..4969c0ba 100644
--- a/SDWebImage/MapKit/MKAnnotationView+WebCache.m
+++ b/SDWebImage/MapKit/MKAnnotationView+WebCache.m
@@ -10,8 +10,6 @@
 
 #if SD_UIKIT || SD_MAC
 
-#import "UIView+WebCache.h"
-
 @implementation MKAnnotationView (WebCache)
 
 - (void)sd_setImageWithURL:(nullable NSURL *)url {
diff --git a/SDWebImage/include/SDWebImage/NSButton+WebCache.h b/SDWebImage/include/SDWebImage/NSButton+WebCache.h
new file mode 120000
index 00000000..c1f89924
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/NSButton+WebCache.h
@@ -0,0 +1 @@
+../../Core/NSButton+WebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/NSData+ImageContentType.h b/SDWebImage/include/SDWebImage/NSData+ImageContentType.h
new file mode 120000
index 00000000..c0852b87
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/NSData+ImageContentType.h
@@ -0,0 +1 @@
+../../Core/NSData+ImageContentType.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/NSImage+Compatibility.h b/SDWebImage/include/SDWebImage/NSImage+Compatibility.h
new file mode 120000
index 00000000..cfad8619
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/NSImage+Compatibility.h
@@ -0,0 +1 @@
+../../Core/NSImage+Compatibility.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDAnimatedImage.h b/SDWebImage/include/SDWebImage/SDAnimatedImage.h
new file mode 120000
index 00000000..f26f5de1
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDAnimatedImage.h
@@ -0,0 +1 @@
+../../Core/SDAnimatedImage.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDAnimatedImagePlayer.h b/SDWebImage/include/SDWebImage/SDAnimatedImagePlayer.h
new file mode 120000
index 00000000..6f713485
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDAnimatedImagePlayer.h
@@ -0,0 +1 @@
+../../Core/SDAnimatedImagePlayer.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDAnimatedImageRep.h b/SDWebImage/include/SDWebImage/SDAnimatedImageRep.h
new file mode 120000
index 00000000..b19ae282
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDAnimatedImageRep.h
@@ -0,0 +1 @@
+../../Core/SDAnimatedImageRep.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDAnimatedImageView+WebCache.h b/SDWebImage/include/SDWebImage/SDAnimatedImageView+WebCache.h
new file mode 120000
index 00000000..6dbc5fa9
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDAnimatedImageView+WebCache.h
@@ -0,0 +1 @@
+../../Core/SDAnimatedImageView+WebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDAnimatedImageView.h b/SDWebImage/include/SDWebImage/SDAnimatedImageView.h
new file mode 120000
index 00000000..0a49071c
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDAnimatedImageView.h
@@ -0,0 +1 @@
+../../Core/SDAnimatedImageView.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDDiskCache.h b/SDWebImage/include/SDWebImage/SDDiskCache.h
new file mode 120000
index 00000000..ba20df74
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDDiskCache.h
@@ -0,0 +1 @@
+../../Core/SDDiskCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDGraphicsImageRenderer.h b/SDWebImage/include/SDWebImage/SDGraphicsImageRenderer.h
new file mode 120000
index 00000000..a9605ccd
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDGraphicsImageRenderer.h
@@ -0,0 +1 @@
+../../Core/SDGraphicsImageRenderer.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageAPNGCoder.h b/SDWebImage/include/SDWebImage/SDImageAPNGCoder.h
new file mode 120000
index 00000000..20cba727
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageAPNGCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageAPNGCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCache.h b/SDWebImage/include/SDWebImage/SDImageCache.h
new file mode 120000
index 00000000..0783c1ce
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCache.h
@@ -0,0 +1 @@
+../../Core/SDImageCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCacheConfig.h b/SDWebImage/include/SDWebImage/SDImageCacheConfig.h
new file mode 120000
index 00000000..0a58b4f8
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCacheConfig.h
@@ -0,0 +1 @@
+../../Core/SDImageCacheConfig.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCacheDefine.h b/SDWebImage/include/SDWebImage/SDImageCacheDefine.h
new file mode 120000
index 00000000..0a469880
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCacheDefine.h
@@ -0,0 +1 @@
+../../Core/SDImageCacheDefine.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCachesManager.h b/SDWebImage/include/SDWebImage/SDImageCachesManager.h
new file mode 120000
index 00000000..d01f76f4
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCachesManager.h
@@ -0,0 +1 @@
+../../Core/SDImageCachesManager.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCoder.h b/SDWebImage/include/SDWebImage/SDImageCoder.h
new file mode 120000
index 00000000..75472fb1
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCoderHelper.h b/SDWebImage/include/SDWebImage/SDImageCoderHelper.h
new file mode 120000
index 00000000..3e68b945
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCoderHelper.h
@@ -0,0 +1 @@
+../../Core/SDImageCoderHelper.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageCodersManager.h b/SDWebImage/include/SDWebImage/SDImageCodersManager.h
new file mode 120000
index 00000000..48b8b531
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageCodersManager.h
@@ -0,0 +1 @@
+../../Core/SDImageCodersManager.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageFrame.h b/SDWebImage/include/SDWebImage/SDImageFrame.h
new file mode 120000
index 00000000..ab05e26e
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageFrame.h
@@ -0,0 +1 @@
+../../Core/SDImageFrame.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageGIFCoder.h b/SDWebImage/include/SDWebImage/SDImageGIFCoder.h
new file mode 120000
index 00000000..04191623
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageGIFCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageGIFCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageGraphics.h b/SDWebImage/include/SDWebImage/SDImageGraphics.h
new file mode 120000
index 00000000..823dbd70
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageGraphics.h
@@ -0,0 +1 @@
+../../Core/SDImageGraphics.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageHEICCoder.h b/SDWebImage/include/SDWebImage/SDImageHEICCoder.h
new file mode 120000
index 00000000..9352871d
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageHEICCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageHEICCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageIOAnimatedCoder.h b/SDWebImage/include/SDWebImage/SDImageIOAnimatedCoder.h
new file mode 120000
index 00000000..3053de3b
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageIOAnimatedCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageIOAnimatedCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageIOCoder.h b/SDWebImage/include/SDWebImage/SDImageIOCoder.h
new file mode 120000
index 00000000..9cd1e482
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageIOCoder.h
@@ -0,0 +1 @@
+../../Core/SDImageIOCoder.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageLoader.h b/SDWebImage/include/SDWebImage/SDImageLoader.h
new file mode 120000
index 00000000..ba476e52
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageLoader.h
@@ -0,0 +1 @@
+../../Core/SDImageLoader.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageLoadersManager.h b/SDWebImage/include/SDWebImage/SDImageLoadersManager.h
new file mode 120000
index 00000000..442dd4c7
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageLoadersManager.h
@@ -0,0 +1 @@
+../../Core/SDImageLoadersManager.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDImageTransformer.h b/SDWebImage/include/SDWebImage/SDImageTransformer.h
new file mode 120000
index 00000000..184361bd
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDImageTransformer.h
@@ -0,0 +1 @@
+../../Core/SDImageTransformer.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDMemoryCache.h b/SDWebImage/include/SDWebImage/SDMemoryCache.h
new file mode 120000
index 00000000..47abcc12
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDMemoryCache.h
@@ -0,0 +1 @@
+../../Core/SDMemoryCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImage.h b/SDWebImage/include/SDWebImage/SDWebImage.h
new file mode 120000
index 00000000..12cbb09a
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImage.h
@@ -0,0 +1 @@
+../../../WebImage/SDWebImage.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageCacheKeyFilter.h b/SDWebImage/include/SDWebImage/SDWebImageCacheKeyFilter.h
new file mode 120000
index 00000000..7481d7d3
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageCacheKeyFilter.h
@@ -0,0 +1 @@
+../../Core/SDWebImageCacheKeyFilter.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageCacheSerializer.h b/SDWebImage/include/SDWebImage/SDWebImageCacheSerializer.h
new file mode 120000
index 00000000..b7d69b29
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageCacheSerializer.h
@@ -0,0 +1 @@
+../../Core/SDWebImageCacheSerializer.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageCompat.h b/SDWebImage/include/SDWebImage/SDWebImageCompat.h
new file mode 120000
index 00000000..c3c301d0
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageCompat.h
@@ -0,0 +1 @@
+../../Core/SDWebImageCompat.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDefine.h b/SDWebImage/include/SDWebImage/SDWebImageDefine.h
new file mode 120000
index 00000000..6112007b
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDefine.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDefine.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloader.h b/SDWebImage/include/SDWebImage/SDWebImageDownloader.h
new file mode 120000
index 00000000..ffb6248e
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloader.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloader.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloaderConfig.h b/SDWebImage/include/SDWebImage/SDWebImageDownloaderConfig.h
new file mode 120000
index 00000000..8959bbbc
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloaderConfig.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloaderConfig.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloaderDecryptor.h b/SDWebImage/include/SDWebImage/SDWebImageDownloaderDecryptor.h
new file mode 120000
index 00000000..fd6de4d8
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloaderDecryptor.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloaderDecryptor.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloaderOperation.h b/SDWebImage/include/SDWebImage/SDWebImageDownloaderOperation.h
new file mode 120000
index 00000000..ef18b7c2
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloaderOperation.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloaderOperation.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloaderRequestModifier.h b/SDWebImage/include/SDWebImage/SDWebImageDownloaderRequestModifier.h
new file mode 120000
index 00000000..f7aa82b9
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloaderRequestModifier.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloaderRequestModifier.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageDownloaderResponseModifier.h b/SDWebImage/include/SDWebImage/SDWebImageDownloaderResponseModifier.h
new file mode 120000
index 00000000..be391197
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageDownloaderResponseModifier.h
@@ -0,0 +1 @@
+../../Core/SDWebImageDownloaderResponseModifier.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageError.h b/SDWebImage/include/SDWebImage/SDWebImageError.h
new file mode 120000
index 00000000..b088fc03
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageError.h
@@ -0,0 +1 @@
+../../Core/SDWebImageError.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageIndicator.h b/SDWebImage/include/SDWebImage/SDWebImageIndicator.h
new file mode 120000
index 00000000..60f464f2
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageIndicator.h
@@ -0,0 +1 @@
+../../Core/SDWebImageIndicator.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageManager.h b/SDWebImage/include/SDWebImage/SDWebImageManager.h
new file mode 120000
index 00000000..20ddf7c7
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageManager.h
@@ -0,0 +1 @@
+../../Core/SDWebImageManager.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageOperation.h b/SDWebImage/include/SDWebImage/SDWebImageOperation.h
new file mode 120000
index 00000000..e7bf5bad
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageOperation.h
@@ -0,0 +1 @@
+../../Core/SDWebImageOperation.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageOptionsProcessor.h b/SDWebImage/include/SDWebImage/SDWebImageOptionsProcessor.h
new file mode 120000
index 00000000..b1e48c72
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageOptionsProcessor.h
@@ -0,0 +1 @@
+../../Core/SDWebImageOptionsProcessor.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImagePrefetcher.h b/SDWebImage/include/SDWebImage/SDWebImagePrefetcher.h
new file mode 120000
index 00000000..1346c8d2
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImagePrefetcher.h
@@ -0,0 +1 @@
+../../Core/SDWebImagePrefetcher.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/SDWebImageTransition.h b/SDWebImage/include/SDWebImage/SDWebImageTransition.h
new file mode 120000
index 00000000..19b24b09
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/SDWebImageTransition.h
@@ -0,0 +1 @@
+../../Core/SDWebImageTransition.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIButton+WebCache.h b/SDWebImage/include/SDWebImage/UIButton+WebCache.h
new file mode 120000
index 00000000..2a9820d8
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIButton+WebCache.h
@@ -0,0 +1 @@
+../../Core/UIButton+WebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+ExtendedCacheData.h b/SDWebImage/include/SDWebImage/UIImage+ExtendedCacheData.h
new file mode 120000
index 00000000..fab25a7e
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+ExtendedCacheData.h
@@ -0,0 +1 @@
+../../Core/UIImage+ExtendedCacheData.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+ForceDecode.h b/SDWebImage/include/SDWebImage/UIImage+ForceDecode.h
new file mode 120000
index 00000000..0ef28712
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+ForceDecode.h
@@ -0,0 +1 @@
+../../Core/UIImage+ForceDecode.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+GIF.h b/SDWebImage/include/SDWebImage/UIImage+GIF.h
new file mode 120000
index 00000000..30e9dd4a
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+GIF.h
@@ -0,0 +1 @@
+../../Core/UIImage+GIF.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+MemoryCacheCost.h b/SDWebImage/include/SDWebImage/UIImage+MemoryCacheCost.h
new file mode 120000
index 00000000..81d6161d
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+MemoryCacheCost.h
@@ -0,0 +1 @@
+../../Core/UIImage+MemoryCacheCost.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+Metadata.h b/SDWebImage/include/SDWebImage/UIImage+Metadata.h
new file mode 120000
index 00000000..65eb11f4
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+Metadata.h
@@ -0,0 +1 @@
+../../Core/UIImage+Metadata.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+MultiFormat.h b/SDWebImage/include/SDWebImage/UIImage+MultiFormat.h
new file mode 120000
index 00000000..5366a33a
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+MultiFormat.h
@@ -0,0 +1 @@
+../../Core/UIImage+MultiFormat.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImage+Transform.h b/SDWebImage/include/SDWebImage/UIImage+Transform.h
new file mode 120000
index 00000000..73bdf3fd
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImage+Transform.h
@@ -0,0 +1 @@
+../../Core/UIImage+Transform.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImageView+HighlightedWebCache.h b/SDWebImage/include/SDWebImage/UIImageView+HighlightedWebCache.h
new file mode 120000
index 00000000..a9898113
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImageView+HighlightedWebCache.h
@@ -0,0 +1 @@
+../../Core/UIImageView+HighlightedWebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIImageView+WebCache.h b/SDWebImage/include/SDWebImage/UIImageView+WebCache.h
new file mode 120000
index 00000000..8e732df7
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIImageView+WebCache.h
@@ -0,0 +1 @@
+../../Core/UIImageView+WebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIView+WebCache.h b/SDWebImage/include/SDWebImage/UIView+WebCache.h
new file mode 120000
index 00000000..6a1b138c
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIView+WebCache.h
@@ -0,0 +1 @@
+../../Core/UIView+WebCache.h
\ No newline at end of file
diff --git a/SDWebImage/include/SDWebImage/UIView+WebCacheOperation.h b/SDWebImage/include/SDWebImage/UIView+WebCacheOperation.h
new file mode 120000
index 00000000..5631d02a
--- /dev/null
+++ b/SDWebImage/include/SDWebImage/UIView+WebCacheOperation.h
@@ -0,0 +1 @@
+../../Core/UIView+WebCacheOperation.h
\ No newline at end of file

From 34b59d1f79824719101149bbf2a5c328bdad5533 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Sun, 19 Apr 2020 12:39:00 +0800
Subject: [PATCH 175/181] Fix the support for SDWebImageMapKit

---
 Package.swift                                 |  4 +-
 SDWebImage.podspec                            |  3 +-
 SDWebImage.xcodeproj/project.pbxproj          | 40 +++++++++++--------
 .../MapKit/MKAnnotationView+WebCache.h        |  0
 .../MapKit/MKAnnotationView+WebCache.m        |  0
 .../MKAnnotationView+WebCache.h               |  1 +
 .../SDWebImageMapKit/SDWebImageMapKit.h       |  1 +
 WebImage/SDWebImage.h                         |  2 +-
 WebImage/SDWebImageMapKit.h                   |  8 ++--
 9 files changed, 34 insertions(+), 25 deletions(-)
 rename {SDWebImage => SDWebImageMapKit}/MapKit/MKAnnotationView+WebCache.h (100%)
 rename {SDWebImage => SDWebImageMapKit}/MapKit/MKAnnotationView+WebCache.m (100%)
 create mode 120000 SDWebImageMapKit/include/SDWebImageMapKit/MKAnnotationView+WebCache.h
 create mode 120000 SDWebImageMapKit/include/SDWebImageMapKit/SDWebImageMapKit.h

diff --git a/Package.swift b/Package.swift
index 05e22032..2e867bc0 100644
--- a/Package.swift
+++ b/Package.swift
@@ -40,8 +40,8 @@ let package = Package(
         .target(
             name: "SDWebImageMapKit",
             dependencies: ["SDWebImage"],
-            path: "SDWebImage/MapKit",
-            publicHeadersPath: "."
+            path: "SDWebImageMapKit",
+            sources: ["MapKit"]
         )
     ]
 )
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 7464962c..f97409bc 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -33,7 +33,6 @@ Pod::Spec.new do |s|
 
   s.subspec 'Core' do |core|
     core.source_files = 'SDWebImage/Core/*.{h,m}', 'WebImage/SDWebImage.h', 'SDWebImage/Private/*.{h,m}'
-    core.exclude_files = 'SDWebImage/MapKit/*.{h,m}'
     core.private_header_files = 'SDWebImage/Private/*.h'
   end
 
@@ -41,7 +40,7 @@ Pod::Spec.new do |s|
     mk.osx.deployment_target = '10.10'
     mk.ios.deployment_target = '8.0'
     mk.tvos.deployment_target = '9.2'
-    mk.source_files = 'SDWebImage/MapKit/*.{h,m}'
+    mk.source_files = 'SDWebImageMapKit/MapKit/*.{h,m}'
     mk.framework = 'MapKit'
     mk.dependency 'SDWebImage/Core'
   end
diff --git a/SDWebImage.xcodeproj/project.pbxproj b/SDWebImage.xcodeproj/project.pbxproj
index bbb554c1..43516df0 100644
--- a/SDWebImage.xcodeproj/project.pbxproj
+++ b/SDWebImage.xcodeproj/project.pbxproj
@@ -112,6 +112,8 @@
 		327054D6206CD8B3006EA328 /* SDImageAPNGCoder.h in Headers */ = {isa = PBXBuildFile; fileRef = 327054D2206CD8B3006EA328 /* SDImageAPNGCoder.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		327054DA206CD8B3006EA328 /* SDImageAPNGCoder.m in Sources */ = {isa = PBXBuildFile; fileRef = 327054D3206CD8B3006EA328 /* SDImageAPNGCoder.m */; };
 		327054DC206CD8B3006EA328 /* SDImageAPNGCoder.m in Sources */ = {isa = PBXBuildFile; fileRef = 327054D3206CD8B3006EA328 /* SDImageAPNGCoder.m */; };
+		3287E6D1244C0C1400007311 /* MKAnnotationView+WebCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 3287E6CD244C0C1400007311 /* MKAnnotationView+WebCache.m */; };
+		3287E6D2244C0C1400007311 /* MKAnnotationView+WebCache.h in Headers */ = {isa = PBXBuildFile; fileRef = 3287E6CE244C0C1400007311 /* MKAnnotationView+WebCache.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		328BB69E2081FED200760D6C /* SDWebImageCacheKeyFilter.h in Headers */ = {isa = PBXBuildFile; fileRef = 328BB69A2081FED200760D6C /* SDWebImageCacheKeyFilter.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		328BB6A22081FED200760D6C /* SDWebImageCacheKeyFilter.m in Sources */ = {isa = PBXBuildFile; fileRef = 328BB69B2081FED200760D6C /* SDWebImageCacheKeyFilter.m */; };
 		328BB6A42081FED200760D6C /* SDWebImageCacheKeyFilter.m in Sources */ = {isa = PBXBuildFile; fileRef = 328BB69B2081FED200760D6C /* SDWebImageCacheKeyFilter.m */; };
@@ -288,8 +290,6 @@
 		80B6DF822142B44400BCB334 /* NSButton+WebCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 321DB3602011D4D60015D2CB /* NSButton+WebCache.m */; };
 		80B6DF832142B44500BCB334 /* NSButton+WebCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 321DB3602011D4D60015D2CB /* NSButton+WebCache.m */; };
 		80B6DF842142B44600BCB334 /* NSButton+WebCache.h in Headers */ = {isa = PBXBuildFile; fileRef = 321DB35F2011D4D60015D2CB /* NSButton+WebCache.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		80B6DFA72142B71600BCB334 /* MKAnnotationView+WebCache.m in Sources */ = {isa = PBXBuildFile; fileRef = 32FDE87A2088871B008D7530 /* MKAnnotationView+WebCache.m */; };
-		80B6DFCD2142B71600BCB334 /* MKAnnotationView+WebCache.h in Headers */ = {isa = PBXBuildFile; fileRef = 32FDE87B2088871B008D7530 /* MKAnnotationView+WebCache.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		A18A6CC9172DC28500419892 /* UIImage+GIF.m in Sources */ = {isa = PBXBuildFile; fileRef = A18A6CC6172DC28500419892 /* UIImage+GIF.m */; };
 		AB615306192DA24600A2D8E9 /* UIView+WebCacheOperation.m in Sources */ = {isa = PBXBuildFile; fileRef = AB615302192DA24600A2D8E9 /* UIView+WebCacheOperation.m */; };
 		ABBE71A818C43B4D00B75E91 /* UIImageView+HighlightedWebCache.m in Sources */ = {isa = PBXBuildFile; fileRef = ABBE71A618C43B4D00B75E91 /* UIImageView+HighlightedWebCache.m */; };
@@ -437,6 +437,8 @@
 		326E2F32236F1D58006F847F /* SDDeviceHelper.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; path = SDDeviceHelper.m; sourceTree = "<group>"; };
 		327054D2206CD8B3006EA328 /* SDImageAPNGCoder.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = SDImageAPNGCoder.h; path = Core/SDImageAPNGCoder.h; sourceTree = "<group>"; };
 		327054D3206CD8B3006EA328 /* SDImageAPNGCoder.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = SDImageAPNGCoder.m; path = Core/SDImageAPNGCoder.m; sourceTree = "<group>"; };
+		3287E6CD244C0C1400007311 /* MKAnnotationView+WebCache.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "MKAnnotationView+WebCache.m"; sourceTree = "<group>"; };
+		3287E6CE244C0C1400007311 /* MKAnnotationView+WebCache.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "MKAnnotationView+WebCache.h"; sourceTree = "<group>"; };
 		328BB69A2081FED200760D6C /* SDWebImageCacheKeyFilter.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDWebImageCacheKeyFilter.h; path = Core/SDWebImageCacheKeyFilter.h; sourceTree = "<group>"; };
 		328BB69B2081FED200760D6C /* SDWebImageCacheKeyFilter.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDWebImageCacheKeyFilter.m; path = Core/SDWebImageCacheKeyFilter.m; sourceTree = "<group>"; };
 		328BB6A82081FEE500760D6C /* SDWebImageCacheSerializer.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = SDWebImageCacheSerializer.h; path = Core/SDWebImageCacheSerializer.h; sourceTree = "<group>"; };
@@ -480,8 +482,6 @@
 		32F7C06E2030114C00873181 /* SDImageTransformer.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = SDImageTransformer.m; path = Core/SDImageTransformer.m; sourceTree = "<group>"; };
 		32F7C07C2030719600873181 /* UIImage+Transform.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "UIImage+Transform.m"; path = "Core/UIImage+Transform.m"; sourceTree = "<group>"; };
 		32F7C07D2030719600873181 /* UIImage+Transform.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "UIImage+Transform.h"; path = "Core/UIImage+Transform.h"; sourceTree = "<group>"; };
-		32FDE87A2088871B008D7530 /* MKAnnotationView+WebCache.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "MKAnnotationView+WebCache.m"; sourceTree = "<group>"; };
-		32FDE87B2088871B008D7530 /* MKAnnotationView+WebCache.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "MKAnnotationView+WebCache.h"; sourceTree = "<group>"; };
 		4369C2751D9807EC007E863A /* UIView+WebCache.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "UIView+WebCache.h"; path = "SDWebImage/Core/UIView+WebCache.h"; sourceTree = "<group>"; };
 		4369C2761D9807EC007E863A /* UIView+WebCache.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "UIView+WebCache.m"; path = "SDWebImage/Core/UIView+WebCache.m"; sourceTree = "<group>"; };
 		4397D2F41D0DE2DF00BB2784 /* NSImage+Compatibility.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "NSImage+Compatibility.h"; path = "Core/NSImage+Compatibility.h"; sourceTree = "<group>"; };
@@ -607,6 +607,23 @@
 			name = AnimatedImage;
 			sourceTree = "<group>";
 		};
+		3287E6C7244C0C1400007311 /* SDWebImageMapKit */ = {
+			isa = PBXGroup;
+			children = (
+				3287E6CC244C0C1400007311 /* MapKit */,
+			);
+			path = SDWebImageMapKit;
+			sourceTree = "<group>";
+		};
+		3287E6CC244C0C1400007311 /* MapKit */ = {
+			isa = PBXGroup;
+			children = (
+				3287E6CE244C0C1400007311 /* MKAnnotationView+WebCache.h */,
+				3287E6CD244C0C1400007311 /* MKAnnotationView+WebCache.m */,
+			);
+			path = MapKit;
+			sourceTree = "<group>";
+		};
 		328BB6972081FDAB00760D6C /* Manager */ = {
 			isa = PBXGroup;
 			children = (
@@ -672,15 +689,6 @@
 			path = Private;
 			sourceTree = "<group>";
 		};
-		32FDE8792088871B008D7530 /* MapKit */ = {
-			isa = PBXGroup;
-			children = (
-				32FDE87B2088871B008D7530 /* MKAnnotationView+WebCache.h */,
-				32FDE87A2088871B008D7530 /* MKAnnotationView+WebCache.m */,
-			);
-			path = MapKit;
-			sourceTree = "<group>";
-		};
 		4369C2851D9811BB007E863A /* WebCache Categories */ = {
 			isa = PBXGroup;
 			children = (
@@ -722,6 +730,7 @@
 			children = (
 				EA9E0C6A2195936400AFB434 /* Configs */,
 				53922D74148C55820056699D /* SDWebImage */,
+				3287E6C7244C0C1400007311 /* SDWebImageMapKit */,
 				4A2CAE001AB4BB5300B6BC39 /* WebImage */,
 				53922D71148C55820056699D /* Frameworks */,
 				53922D70148C55820056699D /* Products */,
@@ -764,7 +773,6 @@
 				53922DA9148C562D0056699D /* Categories */,
 				4369C2851D9811BB007E863A /* WebCache Categories */,
 				32B5CC5D222F89C2005EB74E /* Private */,
-				32FDE8792088871B008D7530 /* MapKit */,
 			);
 			path = SDWebImage;
 			sourceTree = "<group>";
@@ -952,8 +960,8 @@
 			isa = PBXHeadersBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				3287E6D2244C0C1400007311 /* MKAnnotationView+WebCache.h in Headers */,
 				806BE07E2142C65200E02143 /* SDWebImageMapKit.h in Headers */,
-				80B6DFCD2142B71600BCB334 /* MKAnnotationView+WebCache.h in Headers */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -1279,7 +1287,7 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				80B6DFA72142B71600BCB334 /* MKAnnotationView+WebCache.m in Sources */,
+				3287E6D1244C0C1400007311 /* MKAnnotationView+WebCache.m in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
diff --git a/SDWebImage/MapKit/MKAnnotationView+WebCache.h b/SDWebImageMapKit/MapKit/MKAnnotationView+WebCache.h
similarity index 100%
rename from SDWebImage/MapKit/MKAnnotationView+WebCache.h
rename to SDWebImageMapKit/MapKit/MKAnnotationView+WebCache.h
diff --git a/SDWebImage/MapKit/MKAnnotationView+WebCache.m b/SDWebImageMapKit/MapKit/MKAnnotationView+WebCache.m
similarity index 100%
rename from SDWebImage/MapKit/MKAnnotationView+WebCache.m
rename to SDWebImageMapKit/MapKit/MKAnnotationView+WebCache.m
diff --git a/SDWebImageMapKit/include/SDWebImageMapKit/MKAnnotationView+WebCache.h b/SDWebImageMapKit/include/SDWebImageMapKit/MKAnnotationView+WebCache.h
new file mode 120000
index 00000000..28a11933
--- /dev/null
+++ b/SDWebImageMapKit/include/SDWebImageMapKit/MKAnnotationView+WebCache.h
@@ -0,0 +1 @@
+../../MapKit/MKAnnotationView+WebCache.h
\ No newline at end of file
diff --git a/SDWebImageMapKit/include/SDWebImageMapKit/SDWebImageMapKit.h b/SDWebImageMapKit/include/SDWebImageMapKit/SDWebImageMapKit.h
new file mode 120000
index 00000000..8d192441
--- /dev/null
+++ b/SDWebImageMapKit/include/SDWebImageMapKit/SDWebImageMapKit.h
@@ -0,0 +1 @@
+../../../WebImage/SDWebImageMapKit.h
\ No newline at end of file
diff --git a/WebImage/SDWebImage.h b/WebImage/SDWebImage.h
index eeadf43f..929f1b96 100644
--- a/WebImage/SDWebImage.h
+++ b/WebImage/SDWebImage.h
@@ -15,7 +15,7 @@ FOUNDATION_EXPORT double SDWebImageVersionNumber;
 //! Project version string for SDWebImage.
 FOUNDATION_EXPORT const unsigned char SDWebImageVersionString[];
 
-// In this header, you should import all the public headers of your framework using statements like #import <WebImage/PublicHeader.h>
+// In this header, you should import all the public headers of your framework using statements like #import <SDWebImage/PublicHeader.h>
 
 #import <SDWebImage/SDWebImageManager.h>
 #import <SDWebImage/SDWebImageCacheKeyFilter.h>
diff --git a/WebImage/SDWebImageMapKit.h b/WebImage/SDWebImageMapKit.h
index 99c14cd9..84e43156 100644
--- a/WebImage/SDWebImageMapKit.h
+++ b/WebImage/SDWebImageMapKit.h
@@ -9,11 +9,11 @@
 
 #import <MapKit/MapKit.h>
 
-//! Project version number for WebImage.
-FOUNDATION_EXPORT double WebImageMapKitVersionNumber;
+//! Project version number for SDWebImageMapKit.
+FOUNDATION_EXPORT double SDWebImageMapKitVersionNumber;
 
-//! Project version string for WebImage.
-FOUNDATION_EXPORT const unsigned char WebImageMapKitVersionString[];
+//! Project version string for SDWebImageMapKit.
+FOUNDATION_EXPORT const unsigned char SDWebImageMapKitVersionString[];
 
 // In this header, you should import all the public headers of your framework using statements like #import <SDWebImageMapKit/PublicHeader.h>
 

From 816329f403fc34bcff130c234e1fd59e42b4ab10 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 21 Apr 2020 13:44:35 +0800
Subject: [PATCH 176/181] Fix the previous code which does not passthrough the
 correct value to ImageIO

---
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 20 ++++++++------------
 1 file changed, 8 insertions(+), 12 deletions(-)

diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 89220c88..5fb28a9c 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -476,6 +476,7 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         } else {
             finalPixelSize = maxPixelSize.height;
         }
+        properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
     }
     NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
     if (maxFileSize > 0) {
@@ -487,27 +488,22 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
         // for static single images
-        if (finalPixelSize > 0) {
-            properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
-        }
         CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);
     } else {
         // for animated images
         NSUInteger loopCount = image.sd_imageLoopCount;
-        NSDictionary *containerProperties = @{self.class.loopCountProperty : @(loopCount)};
-        properties[self.class.dictionaryProperty] = containerProperties;
-        CGImageDestinationSetProperties(imageDestination, (__bridge CFDictionaryRef)properties);
+        NSDictionary *containerProperties = @{
+            self.class.dictionaryProperty: @{self.class.loopCountProperty : @(loopCount)}
+        };
+        // container level properties (applies for `CGImageDestinationSetProperties`, not individual frames)
+        CGImageDestinationSetProperties(imageDestination, (__bridge CFDictionaryRef)containerProperties);
         
         for (size_t i = 0; i < frames.count; i++) {
             SDImageFrame *frame = frames[i];
             NSTimeInterval frameDuration = frame.duration;
             CGImageRef frameImageRef = frame.image.CGImage;
-            NSMutableDictionary *frameProperties = [NSMutableDictionary dictionary];
-            frameProperties[self.class.dictionaryProperty] = @{self.class.delayTimeProperty : @(frameDuration)};
-            if (finalPixelSize > 0) {
-                frameProperties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
-            }
-            CGImageDestinationAddImage(imageDestination, frameImageRef, (__bridge CFDictionaryRef)frameProperties);
+            properties[self.class.dictionaryProperty] = @{self.class.delayTimeProperty : @(frameDuration)};
+            CGImageDestinationAddImage(imageDestination, frameImageRef, (__bridge CFDictionaryRef)properties);
         }
     }
     // Finalize the destination.

From f84678a44d506d8518bf5e5c35185581ee453f97 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 20 Apr 2020 12:22:09 +0800
Subject: [PATCH 177/181] Add the support for embed thumbnail for
 JPEG/HEIF/AVIF

---
 SDWebImage/Core/SDImageCoder.h           | 8 ++++++++
 SDWebImage/Core/SDImageCoder.m           | 1 +
 SDWebImage/Core/SDImageIOAnimatedCoder.m | 5 +++++
 SDWebImage/Core/SDImageIOCoder.m         | 5 +++++
 4 files changed, 19 insertions(+)

diff --git a/SDWebImage/Core/SDImageCoder.h b/SDWebImage/Core/SDImageCoder.h
index fe5ca0cc..fe4c5f27 100644
--- a/SDWebImage/Core/SDImageCoder.h
+++ b/SDWebImage/Core/SDImageCoder.h
@@ -79,6 +79,14 @@ FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxPixelSi
  */
 FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeMaxFileSize;
 
+/**
+ A Boolean value indicating the encoding format should contains a thumbnail image into the output data. Only some of image format (like JPEG/HEIF/AVIF) support this behavior. The embed thumbnail will be used during next time thumbnail decoding (provided `.thumbnailPixelSize`), which is faster than full image thumbnail decoding. (NSNumber)
+ Defaults to NO, which does not embed any thumbnail.
+ @note The thumbnail image's pixel size is not defined, the encoder can choose the proper pixel size which is suitable for encoding quality.
+ @note works for `SDImageCoder`
+ */
+FOUNDATION_EXPORT SDImageCoderOption _Nonnull const SDImageCoderEncodeEmbedThumbnail;
+
 /**
  A SDWebImageContext object which hold the original context options from top-level API. (SDWebImageContext)
  This option is ignored for all built-in coders and take no effect.
diff --git a/SDWebImage/Core/SDImageCoder.m b/SDWebImage/Core/SDImageCoder.m
index 37dfdc41..0fda1983 100644
--- a/SDWebImage/Core/SDImageCoder.m
+++ b/SDWebImage/Core/SDImageCoder.m
@@ -18,5 +18,6 @@ SDImageCoderOption const SDImageCoderEncodeCompressionQuality = @"encodeCompress
 SDImageCoderOption const SDImageCoderEncodeBackgroundColor = @"encodeBackgroundColor";
 SDImageCoderOption const SDImageCoderEncodeMaxPixelSize = @"encodeMaxPixelSize";
 SDImageCoderOption const SDImageCoderEncodeMaxFileSize = @"encodeMaxFileSize";
+SDImageCoderOption const SDImageCoderEncodeEmbedThumbnail = @"encodeEmbedThumbnail";
 
 SDImageCoderOption const SDImageCoderWebImageContext = @"webImageContext";
diff --git a/SDWebImage/Core/SDImageIOAnimatedCoder.m b/SDWebImage/Core/SDImageIOAnimatedCoder.m
index 5fb28a9c..df6415c3 100644
--- a/SDWebImage/Core/SDImageIOAnimatedCoder.m
+++ b/SDWebImage/Core/SDImageIOAnimatedCoder.m
@@ -484,6 +484,11 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         // Remove the quality if we have file size limit
         properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = nil;
     }
+    BOOL embedThumbnail = NO;
+    if (options[SDImageCoderEncodeEmbedThumbnail]) {
+        embedThumbnail = [options[SDImageCoderEncodeEmbedThumbnail] boolValue];
+    }
+    properties[(__bridge NSString *)kCGImageDestinationEmbedThumbnail] = @(embedThumbnail);
     
     BOOL encodeFirstFrame = [options[SDImageCoderEncodeFirstFrameOnly] boolValue];
     if (encodeFirstFrame || frames.count == 0) {
diff --git a/SDWebImage/Core/SDImageIOCoder.m b/SDWebImage/Core/SDImageIOCoder.m
index df93e14e..11565e12 100644
--- a/SDWebImage/Core/SDImageIOCoder.m
+++ b/SDWebImage/Core/SDImageIOCoder.m
@@ -294,6 +294,11 @@ static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestination
         // Remove the quality if we have file size limit
         properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = nil;
     }
+    BOOL embedThumbnail = NO;
+    if (options[SDImageCoderEncodeEmbedThumbnail]) {
+        embedThumbnail = [options[SDImageCoderEncodeEmbedThumbnail] boolValue];
+    }
+    properties[(__bridge NSString *)kCGImageDestinationEmbedThumbnail] = @(embedThumbnail);
     
     // Add your image to the destination.
     CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);

From d76fb76e0df56854ac06ea2796820fc05c494144 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 20 Apr 2020 17:43:04 +0800
Subject: [PATCH 178/181] Added the test
 cases`test19ThatEmbedThumbnailHEICWorks` to ensure the embed thumbnail works

---
 Tests/Tests/SDImageCoderTests.m | 58 ++++++++++++++++++++++++++++-----
 1 file changed, 50 insertions(+), 8 deletions(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index a4574f59..ca0e1c16 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -231,6 +231,48 @@
         isVectorImage:YES];
 }
 
+- (void)test18ThatImageIOAnimatedCoderAbstractClass {
+    SDImageIOAnimatedCoder *coder = [[SDImageIOAnimatedCoder alloc] init];
+    @try {
+        [coder canEncodeToFormat:SDImageFormatPNG];
+        XCTFail("Should throw exception");
+    } @catch (NSException *exception) {
+        expect(exception);
+    }
+}
+
+- (void)test19ThatEmbedThumbnailHEICWorks {
+    if (@available(iOS 11, macOS 10.13, *)) {
+        // The input HEIC does not contains any embed thumbnail
+        NSURL *heicURL = [[NSBundle bundleForClass:[self class]] URLForResource:@"TestImage" withExtension:@"heic"];
+        CGImageSourceRef source = CGImageSourceCreateWithURL((__bridge CFURLRef)heicURL, nil);
+        expect(source).notTo.beNil();
+        NSArray *thumbnailImages = [self thumbnailImagesFromImageSource:source];
+        expect(thumbnailImages.count).equal(0);
+        
+        CGImageRef imageRef = CGImageSourceCreateImageAtIndex(source, 0, nil);
+        UIImage *image = [[UIImage alloc] initWithCGImage:imageRef];
+        CGImageRelease(imageRef);
+        // Encode with embed thumbnail
+        NSData *encodedData = [SDImageIOCoder.sharedCoder encodedDataWithImage:image format:SDImageFormatHEIC options:@{SDImageCoderEncodeEmbedThumbnail : @(YES)}];
+        
+        // The new HEIC contains one embed thumbnail
+        CGImageSourceRef source2 = CGImageSourceCreateWithData((__bridge CFDataRef)encodedData, nil);
+        expect(source2).notTo.beNil();
+        NSArray *thumbnailImages2 = [self thumbnailImagesFromImageSource:source2];
+        expect(thumbnailImages2.count).equal(1);
+        
+        // Currently ImageIO has no control to custom embed thumbnail pixel size, just check the behavior :)
+        NSDictionary *thumbnailImageInfo = thumbnailImages2.firstObject;
+        NSUInteger thumbnailWidth = [thumbnailImageInfo[(__bridge NSString *)kCGImagePropertyWidth] unsignedIntegerValue];
+        NSUInteger thumbnailHeight = [thumbnailImageInfo[(__bridge NSString *)kCGImagePropertyHeight] unsignedIntegerValue];
+        expect(thumbnailWidth).equal(320);
+        expect(thumbnailHeight).equal(212);
+    }
+}
+
+#pragma mark - Utils
+
 - (void)verifyCoder:(id<SDImageCoder>)coder
 withLocalImageURL:(NSURL *)imageUrl
  supportsEncoding:(BOOL)supportsEncoding
@@ -353,14 +395,14 @@ withLocalImageURL:(NSURL *)imageUrl
     }
 }
 
-- (void)test16ThatImageIOAnimatedCoderAbstractClass {
-    SDImageIOAnimatedCoder *coder = [[SDImageIOAnimatedCoder alloc] init];
-    @try {
-        [coder canEncodeToFormat:SDImageFormatPNG];
-        XCTFail("Should throw exception");
-    } @catch (NSException *exception) {
-        expect(exception);
-    }
+- (NSArray *)thumbnailImagesFromImageSource:(CGImageSourceRef)source API_AVAILABLE(ios(11.0), tvos(11.0), macos(13.0)) {
+    NSDictionary *properties = (__bridge_transfer NSDictionary *)CGImageSourceCopyProperties(source, nil);
+    NSDictionary *fileProperties = properties[(__bridge NSString *)kCGImagePropertyFileContentsDictionary];
+    NSArray *imagesProperties = fileProperties[(__bridge NSString *)kCGImagePropertyImages];
+    NSDictionary *imageProperties = imagesProperties.firstObject;
+    NSArray *thumbnailImages = imageProperties[(__bridge NSString *)kCGImagePropertyThumbnailImages];
+    
+    return thumbnailImages;
 }
 
 @end

From 9a7544163476723c218d7f58143ee892b0ac679d Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 21 Apr 2020 17:49:40 +0800
Subject: [PATCH 179/181] Fix test case compile issue on macOS

---
 Tests/Tests/SDImageCoderTests.m | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Tests/Tests/SDImageCoderTests.m b/Tests/Tests/SDImageCoderTests.m
index ca0e1c16..eaf58ec9 100644
--- a/Tests/Tests/SDImageCoderTests.m
+++ b/Tests/Tests/SDImageCoderTests.m
@@ -251,7 +251,11 @@
         expect(thumbnailImages.count).equal(0);
         
         CGImageRef imageRef = CGImageSourceCreateImageAtIndex(source, 0, nil);
-        UIImage *image = [[UIImage alloc] initWithCGImage:imageRef];
+#if SD_UIKIT
+        UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:1 orientation: UIImageOrientationUp];
+#else
+        UIImage *image = [[UIImage alloc] initWithCGImage:imageRef scale:1 orientation:kCGImagePropertyOrientationUp];
+#endif
         CGImageRelease(imageRef);
         // Encode with embed thumbnail
         NSData *encodedData = [SDImageIOCoder.sharedCoder encodedDataWithImage:image format:SDImageFormatHEIC options:@{SDImageCoderEncodeEmbedThumbnail : @(YES)}];

From 39370d1af85734dffe0e3f89b389976da461be3f Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 21 Apr 2020 17:52:10 +0800
Subject: [PATCH 180/181] Bumped version to 5.7.3

---
 CHANGELOG.md        | 6 ++++++
 SDWebImage.podspec  | 2 +-
 WebImage/Info.plist | 4 ++--
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8f09d07a..c6b8becd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## [5.7.3 - 5.7 Patch, on Apr 21st, 2020](https://github.com/SDWebImage/SDWebImage/releases/tag/5.7.3)
+See [all tickets marked for the 5.7.3 release](https://github.com/SDWebImage/SDWebImage/milestone/70)
+
+### Fixes
+- Fix the encoding options which does not passthrough the correct value to ImageIO #2989
+
 ## [5.7.2 - 5.7 Patch, on Apr 11th, 2020](https://github.com/SDWebImage/SDWebImage/releases/tag/5.7.2)
 See [all tickets marked for the 5.7.2 release](https://github.com/SDWebImage/SDWebImage/milestone/68)
 
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 7464962c..583c53f5 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.7.2'
+  s.version = '5.7.3'
 
   s.osx.deployment_target = '10.10'
   s.ios.deployment_target = '8.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index 6de94d20..b311cc23 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.7.2</string>
+	<string>5.7.3</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.7.2</string>
+	<string>5.7.3</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>

From 11754268f9e5fc80795133f685c474e0bff74dc7 Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Tue, 21 Apr 2020 21:02:35 +0800
Subject: [PATCH 181/181] Update the readme about the SDWebImage Architecture
 Analysis

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 37fa9619..03737944 100644
--- a/README.md
+++ b/README.md
@@ -133,6 +133,7 @@ You can use those directly, or create similar components of your own, by using t
 
 - If you **want to contribute**, read the [Contributing Guide](https://github.com/SDWebImage/SDWebImage/blob/master/.github/CONTRIBUTING.md)
 - For **development contribution guide**, read the [How-To-Contribute](https://github.com/SDWebImage/SDWebImage/wiki/How-to-Contribute)
+- For **understanding code architecture**, read the [Code Architecture Analysis](https://github.com/SDWebImage/SDWebImage/wiki/5.6-Code-Architecture-Analysis)
 
 ## How To Use
 
@@ -316,6 +317,8 @@ All source code is licensed under the [MIT License](https://github.com/SDWebImag
 
 ## Architecture
 
+To learn about SDWebImage's architecture design for contribution, read [The Core of SDWebImage v5.6 Architecture](https://github.com/SDWebImage/SDWebImage/wiki/5.6-Code-Architecture-Analysis). Thanks @looseyi for the post and translation.
+
 #### High Level Diagram
 <p align="center" >
     <img src="https://raw.githubusercontent.com/SDWebImage/SDWebImage/master/Docs/Diagrams/SDWebImageHighLevelDiagram.jpeg" title="SDWebImage high level diagram">