SDWebImage github首頁(yè)翻譯

SDWebImage

此庫(kù)提供UIImageView類別來(lái)支持網(wǎng)絡(luò)遠(yuǎn)程下載圖像。

以下為提供的功能:

* UIImageView類別添加基于Cocoa Touch框架的Web圖像緩存管理。

* 異步圖像下載

* 擁有自動(dòng)緩存過(guò)期處理的異步內(nèi)存/磁盤圖像緩存暴构,

* 支持動(dòng)畫GIF

* 支持WebP格式

* 解壓背景圖像

* 保證相同的URL不會(huì)被下載多次

* 保證假的網(wǎng)址將不被一次又一次地重試

* 保證常遂,主線程將不會(huì)被阻止

* 性能好

* 使用GCD和ARC

* 支持Arm64

UITableView使用UIImageView+WebCache

只需要import UIImageView+WebCache.h之后

調(diào)用sd_setImageWithURL:placeholderImage:

使用Blocks

有了blocks卿捎,你可以知道圖像下載的過(guò)程和什么時(shí)候圖像取得結(jié)束杭措。

Note: 如果是自行取消的話垂蜗,success和failure的block都不會(huì)調(diào)用

使用SDWebImageManager

該SDWebImageManager是UIImageView+WebCache背后的類喘先。它將圖像緩存存儲(chǔ)和異步下載聯(lián)系在一起钳吟。您可以直接使用這個(gè)類來(lái)從網(wǎng)頁(yè)下載圖像收益。也可以緩存在另一個(gè)上下文而不是UIView窘拯。

單獨(dú)使用異步圖像下載器

單獨(dú)使用異步圖像緩存

SDImageCache維持了內(nèi)存緩存和可選的磁盤緩存红且。

可以用queryDiskCacheForKey:done: 來(lái)查看磁盤緩存。

如果返回為nil 意味著當(dāng)前緩存沒(méi)有這張圖片涤姊。

所以你需要負(fù)責(zé)生成圖像并緩存圖像暇番。

緩存的鍵是應(yīng)用中獨(dú)有的標(biāo)識(shí),基本上是圖像的絕對(duì)路徑思喊。

默認(rèn)來(lái)說(shuō)SDImageCache會(huì)在內(nèi)存緩存中發(fā)現(xiàn)不到圖像的情況下 查詢磁盤緩存壁酬。你可以禁止這一操作發(fā)生通過(guò)調(diào)用另一可選方法imageFromMemoryCacheForKey

為了將圖像存儲(chǔ)在緩存里,你可以使用storeImage:forKey:方法恨课,如下:

默認(rèn)的舆乔,圖像會(huì)異步的存儲(chǔ)在內(nèi)存緩存和磁盤緩存中,如果你只想要保存在內(nèi)存中剂公,使用可選擇方案storeImage:forKey:toDisk: 傳空的第三個(gè)參數(shù)希俩。

使用緩存鍵過(guò)濾器

有時(shí),你可能不希望使用圖像的URL作為緩存鍵纲辽,因?yàn)閁RL的一部分是變動(dòng)的(換句話說(shuō):訪問(wèn)控制的目的)颜武。SDWebImageManager提供了一種方法來(lái)設(shè)置緩存鍵過(guò)濾器璃搜,取NSURL作為輸入,輸出一個(gè)緩存鍵NSString鳞上。

下面的示例在application delegate里將URL刪除所有的查詢字符串之后用作緩存鍵過(guò)濾器:

常見(jiàn)問(wèn)題

在UITableViewCell使用動(dòng)態(tài)圖像尺寸

UITableView通過(guò)用于小區(qū)中的第一圖像組確定圖像的大小这吻。如果你的遠(yuǎn)程圖像沒(méi)有大小的占位符圖像相同,您可能會(huì)遇到奇怪的變形比例問(wèn)題因块。下面這篇文章給出了一個(gè)方法來(lái)解決此問(wèn)題(翻譯略)

控制圖像刷新

SDWebImage默認(rèn)完成了非常積極的緩存橘原。它忽略了所有類型的緩存控制頭部的HTTP服務(wù)器返回籍铁,并且沒(méi)有時(shí)間限制緩存返回的圖像涡上。這意味著你的圖片網(wǎng)址指向,從來(lái)沒(méi)有改變圖像靜態(tài)URL拒名。如果尖圖像發(fā)生變化吩愧,部分URL應(yīng)該相應(yīng)地改變。

如果你不控制你正在使用的圖像服務(wù)器增显,您可能無(wú)法更改URL時(shí)雁佳,它的內(nèi)容更新。這是用于例如實(shí)化身的URL的情況同云。在這種情況下糖权,你可以使用SDWebImageRefreshCached標(biāo)志。這將略微降低性能炸站,但會(huì)尊重HTTP緩存控制頭:

添加一個(gè)進(jìn)度指示器

GitHub - JJSaccolo/UIActivityIndicator-for-SDWebImage: The easiest way to add a UIActivityView to your SDWebImage view

安裝

有三種方法在項(xiàng)目中使用SDWebImage:

* 使用的CocoaPods

* 復(fù)制所有文件到您的項(xiàng)目

* 導(dǎo)入項(xiàng)目作為靜態(tài)庫(kù)

用CocoaPods安裝

CocoaPods是Objective-C的依賴管理者星澳,能自動(dòng)化并簡(jiǎn)化在項(xiàng)目中使用第三方庫(kù)的過(guò)程中依賴管理。

Subspecs

有3個(gè)subspaces可以使用:Core, MapKit, WebP (這意味你可以只安裝一部分的SDWebImage模塊旱易。默認(rèn)只有Core禁偎,如果你想用WebP,你需要特別指定)

pod ’SDWebImage/WebP’

用Carthage安裝

Carthage是個(gè)輕量級(jí)版本依賴管理者

有許多地方太過(guò)于懶得翻譯了阀坏,不便之處請(qǐng)多提意見(jiàn) 謝謝!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末如暖,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子忌堂,更是在濱河造成了極大的恐慌盒至,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,941評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件士修,死亡現(xiàn)場(chǎng)離奇詭異枷遂,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)李命,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,397評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門登淘,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人封字,你說(shuō)我怎么就攤上這事黔州∷w蓿” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,345評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵流妻,是天一觀的道長(zhǎng)牲蜀。 經(jīng)常有香客問(wèn)我,道長(zhǎng)绅这,這世上最難降的妖魔是什么涣达? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,851評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮证薇,結(jié)果婚禮上度苔,老公的妹妹穿的比我還像新娘。我一直安慰自己浑度,他們只是感情好寇窑,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,868評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著箩张,像睡著了一般甩骏。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上先慷,一...
    開(kāi)封第一講書(shū)人閱讀 51,688評(píng)論 1 305
  • 那天饮笛,我揣著相機(jī)與錄音,去河邊找鬼论熙。 笑死福青,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的赴肚。 我是一名探鬼主播素跺,決...
    沈念sama閱讀 40,414評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼誉券!你這毒婦竟也來(lái)了指厌?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 39,319評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤踊跟,失蹤者是張志新(化名)和其女友劉穎踩验,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體商玫,經(jīng)...
    沈念sama閱讀 45,775評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡箕憾,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,945評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了拳昌。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片袭异。...
    茶點(diǎn)故事閱讀 40,096評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖炬藤,靈堂內(nèi)的尸體忽然破棺而出御铃,到底是詐尸還是另有隱情碴里,我是刑警寧澤,帶...
    沈念sama閱讀 35,789評(píng)論 5 346
  • 正文 年R本政府宣布上真,位于F島的核電站咬腋,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏睡互。R本人自食惡果不足惜根竿,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,437評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望就珠。 院中可真熱鬧寇壳,春花似錦、人聲如沸嗓违。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,993評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)蹂季。三九已至,卻和暖如春疏日,著一層夾襖步出監(jiān)牢的瞬間偿洁,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,107評(píng)論 1 271
  • 我被黑心中介騙來(lái)泰國(guó)打工沟优, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留涕滋,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,308評(píng)論 3 372
  • 正文 我出身青樓挠阁,卻偏偏與公主長(zhǎng)得像宾肺,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子侵俗,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,037評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容