前言
本篇主要解讀SDWebImage的配置文件。正如compat的定義苏章，該配置文件主要是兼容Apple的其他設(shè)備酿雪。也許我們真實(shí)的開發(fā)平臺(tái)只有一個(gè)古涧，但考慮各個(gè)平臺(tái)的兼容性垂券，對(duì)于框架有著很重要的意義。這篇文章的重點(diǎn)是抽取出對(duì)于iOS很重要的用法羡滑，能夠在項(xiàng)目開發(fā)中提高效率。
import
導(dǎo)入這個(gè)頭文件算芯，我們就能訪問系統(tǒng)提供的配置選項(xiàng)了柒昏，我們接下來會(huì)對(duì)該文件出現(xiàn)的配置屬性做出解釋。
OBJC_GC
ifdef OBJC_GC
#error SDWebImage does not support Objective-C Garbage Collection
endif
SDWebImage不支持垃圾回收機(jī)制熙揍，垃圾回收(Gargage-collection)是Objective-c提供的一種自動(dòng)內(nèi)存回收機(jī)制职祷。在iPad/iPhone環(huán)境中不支持垃圾回收功能。
當(dāng)啟動(dòng)這個(gè)功能后届囚，所有的retain,autorelease,release和dealloc方法都將被系統(tǒng)忽略有梆。
SD_MAC
// Apple's defines from TargetConditionals.h are a bit weird.
// Seems like TARGET_OS_MAC is always defined (on all platforms).
// To determine if we are running on OSX, we can only relly on TARGET_OS_IPHONE=0 and all the other platforms
if !TARGET_OS_IPHONE && !TARGET_OS_IOS && !TARGET_OS_TV && !TARGET_OS_WATCH
#define SD_MAC 1
else
#define SD_MAC 0
endif
該指令主要用于判斷當(dāng)前平臺(tái)是不是MAC，單純使用TARGET_OS_MAC是不靠譜的意系。這樣判斷的缺點(diǎn)是泥耀，當(dāng)Apple出現(xiàn)新的平臺(tái)時(shí)，判斷條件要修改蛔添。
TARGET_OS_IPHONE
TARGET_OS_IOS
TARGET_OS_TV
TARGET_OS_WATCH
SD_UIKIT
// iOS and tvOS are very similar, UIKit exists on both platforms
// Note: watchOS also has UIKit, but it's very limited
if TARGET_OS_IOS || TARGET_OS_TV
#define SD_UIKIT 1
else
#define SD_UIKIT 0
endif
iOS 和 tvOS 是非常相似的痰催，UIKit在這兩個(gè)平臺(tái)中都存在，但是watchOS在使用UIKit時(shí)迎瞧，是受限的夸溶。因此我們定義SD_UIKIT為真的條件是iOS 和 tvOS這兩個(gè)平臺(tái)。至于為什么要定義SD_UIKIT后邊會(huì)解釋的凶硅。
SD_IOS
if TARGET_OS_IOS
#define SD_IOS 1
else
#define SD_IOS 0
endif
SD_TV
if TARGET_OS_TV
#define SD_TV 1
else
#define SD_TV 0
endif
SD_WATCH
if TARGET_OS_WATCH
#define SD_WATCH 1
else
#define SD_WATCH 0
endif
平臺(tái)兼容適配
if SD_MAC
#import <AppKit/AppKit.h>
#ifndef UIImage
#define UIImage NSImage
#endif
#ifndef UIImageView
#define UIImageView NSImageView
#endif
#ifndef UIView
#define UIView NSView
#endif
else
#if __IPHONE_OS_VERSION_MIN_REQUIRED != 20000 && __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_5_0
#error SDWebImage doesn't support Deployment Target version < 5.0
#endif
#if SD_UIKIT
#import <UIKit/UIKit.h>
#endif
#if SD_WATCH
#import <WatchKit/WatchKit.h>
#endif
endif
觀察上邊的代碼缝裁，可以發(fā)現(xiàn)，在MAC平臺(tái)上進(jìn)行了如下的轉(zhuǎn)換足绅，這算是一個(gè)編程技巧：
UIImage -----> NSImage
UIImageView -----> NSImageView
UIView -----> NSView
SDWebImage不支持5.0以下的iOS版本捷绑。SD_UIKIT為真時(shí)，導(dǎo)入U(xiǎn)IKit编检，SD_WATCH為真時(shí)胎食，導(dǎo)入WatchKit。
基礎(chǔ)設(shè)置
ifndef NS_ENUM
define NS_ENUM(_type, _name) enum _name : _type _name; enum _name : _type
endif
ifndef NS_OPTIONS
define NS_OPTIONS(_type, _name) enum _name : _type _name; enum _name : _type
endif
if OS_OBJECT_USE_OBJC
#undef SDDispatchQueueRelease
#undef SDDispatchQueueSetterSementics
#define SDDispatchQueueRelease(q)
#define SDDispatchQueueSetterSementics strong
else
#undef SDDispatchQueueRelease
#undef SDDispatchQueueSetterSementics
#define SDDispatchQueueRelease(q) (dispatch_release(q))
#define SDDispatchQueueSetterSementics assign
endif
接口
extern UIImage *SDScaledImageForKey(NSString *key, UIImage *image);
typedef void(^SDWebImageNoParamsBlock)();
extern NSString *const SDWebImageErrorDomain;
static int64_t kAsyncTestTimeout = 5;
dispatch_main_async_safe
我們來看看這個(gè)宏允懂，按理說我使用dispatch_main_async就可以了厕怜，為什么要加入safe呢？那么這個(gè)safe主要是解決那些不安全的問題呢？
ifndef dispatch_main_async_safe
define dispatch_main_async_safe(block)\
if (strcmp(dispatch_queue_get_label(DISPATCH_CURRENT_QUEUE_LABEL), dispatch_queue_get_label(dispatch_get_main_queue())) == 0) {\
block();\
} else {\
dispatch_async(dispatch_get_main_queue(), block);\
}
endif
第一粥航，我們可以像這樣在定義宏的時(shí)候使用換行琅捏，但需要添加 操作符
第二，如果當(dāng)前線程已經(jīng)是主線程了递雀，那么在調(diào)用dispatch_async(dispatch_get_main_queue(), block)有可能會(huì)出現(xiàn)crash
第三柄延，如果當(dāng)前線程是主線程，直接調(diào)用缀程，如果不是搜吧，調(diào)用dispatch_async(dispatch_get_main_queue(), block)
UIImage SDScaledImageForKey(NSString key, UIImage *image)
inline UIImage *SDScaledImageForKey(NSString * _Nullable key, UIImage * _Nullable image) {
if (!image) {
return nil;
}
if SD_MAC
return image;
elif SD_UIKIT || SD_WATCH
if ((image.images).count > 0) {
NSMutableArray<UIImage *> *scaledImages = [NSMutableArray array];
for (UIImage *tempImage in image.images) {
[scaledImages addObject:SDScaledImageForKey(key, tempImage)];
}
return [UIImage animatedImageWithImages:scaledImages duration:image.duration];
}
else {
if SD_WATCH
if ([[WKInterfaceDevice currentDevice] respondsToSelector:@selector(screenScale)]) {
elif SD_UIKIT
if ([[UIScreen mainScreen] respondsToSelector:@selector(scale)]) {
endif
CGFloat scale = 1;
if (key.length >= 8) {
NSRange range = [key rangeOfString:@"@2x."];
if (range.location != NSNotFound) {
scale = 2.0;
}
range = [key rangeOfString:@"@3x."];
if (range.location != NSNotFound) {
scale = 3.0;
}
}
UIImage *scaledImage = [[UIImage alloc] initWithCGImage:image.CGImage scale:scale orientation:image.imageOrientation];
image = scaledImage;
}
return image;
}
endif
}
這個(gè)方法是根據(jù)key來修改圖片的尺寸，需要注意的地方有：
inline 內(nèi)聯(lián)函數(shù)
遞歸函數(shù)
總結(jié)
通過對(duì)該配置文件的理解杨凑，讓我對(duì)配置相關(guān)的信息更加了解了滤奈，我產(chǎn)生了收集這些預(yù)編譯的想法棚瘟，生成一個(gè)內(nèi)容比較豐富的文件惭蟋，能夠很好地讓別人拿過去用奸焙。代碼應(yīng)該寫的簡(jiǎn)潔刀荒，穩(wěn)定倦西。
SDWebImage源碼解讀 之 NSData+ImageContentType 簡(jiǎn)書 博客園
SDWebImage源碼解讀 之 UIImage+GIF 簡(jiǎn)書 博客園
