Kingfisher — bu nima, asosiy tushunchalar va ImageCache

Kingfisher nima?

Kingfisher — butunlay Swift-da yozilgan Apple platformalari uchun asinxron tasvir yuklash va keshlash kutubxonasi. Kutubxona muallifi Wei Wang (onevcat). Kingfisher tarmoqdan tasvirlarni avtomatik keshlash, transformatsiyalar va zamonaviy Swift texnologiyalari (async/await, Combine, Sendable) qo‘llab-quvvatlashi bilan yuklash uchun vositalar to‘plamini taqdim etadi.

Kutubxona GitHub da 23 000+ yulduz ga ega va Telegram, Snapchat va Dropbox kabi ilovalarda ishlatiladi. Kingfisher GIF, APNG, HEIF va barcha standart tasvir formatlarini qo‘llab-quvvatlaydi. Har bir so‘rov tip-xavfsiz Result qaytaradi va tip konvertatsiya xatolarini bartaraf qiladi.

Kingfisher arxitekturasi uchta asosiy komponentga qurilgan: Manager (yuklash menejeri), Cache (ikki darajali kesh) va Processor (transformatsiyalar). Ushbu komponentlar protokollar orqali bog‘langan bo‘lib, bu qaramliklarni o‘zgartirmasdan istalgan qismni almashtirish imkonini beradi.

Kingfisher qanday ishlaydi: Manager va Cache

KingfisherManager — tasvirlarni yuklash, keshlash va qayta ishlashni muvofiqlashtiruvchi markaziy sinf. U ImageCache va ImageDownloader ga havolalarni o‘z ichiga oladi va barcha bosqichlardan o‘tgandan so‘ng tayyor tasvirni qaytaradigan yagona retrieveImage metodini taqdim etadi.

Yuklash jarayoni

retrieveImage chaqirilganda Manager avval Memory Cache ni tekshiradi — kalit manba URL va CacheSerializer dan tuzilgan UIImage bilan NSCache. Agar tasvir topilsa — darhol qaytariladi. Topilmasa, Disk Cache tekshiriladi — serializer orqali shifrni ochish bilan fayl tizimidan o‘qish. Disk kesh bo‘sh bo‘lsa, ImageDownloader orqali tarmoq so‘rovi bajariladi, natija dekodlanadi, transformatsiya qilinadi va ikkala kesh darajasida saqlanadi.

• Memory Cache — NSCache asosida, xotira ogohlantirishida avtomatik tozalanadi
• Disk Cache — TTL va o‘lcham chegarasini tekshirish bilan fayl saqlash
• ImageDownloader — modifikatorlar orqali so‘rovni o‘zgartirish qo‘llab-quvvatlashi bilan URLSession asosida

Swift Concurrency

7.0 versiyasidan boshlab, Kingfisher async/await ni to‘liq qo‘llab-quvvatlaydi. retrieveImage metodi komplitsiya bloklarisiz to‘g‘ridan-to‘g‘ri Result qaytaradigan asinxron funksiya sifatida mavjud. Bu Structured Concurrency bilan zamonaviy Swift arxitekturalarida kutubxonadan foydalanish imkonini beradi.

Kingfisherning asosiy modullari

Kingfisher bir nechta modullarga bo‘lingan, ularning har biri o‘z vazifasini hal qiladi. Bu bo‘linish komponentlarni sinash va almashtirishni soddalashtiradi.

KingfisherManager

KingfisherManager — yuklash, kesh va protsessorlarni birlashtiruvchi fasad. Sukut bo‘yicha KingfisherManager.shared singltoni ishlatiladi, lekin izolyatsiya qilingan stsenariylar (masalan, modul testlari uchun) uchun moslashtirilgan sozlamalar bilan alohida namuna yaratilishi mumkin.

ImageCache

ImageCache — xotira va disk uchun alohida sozlamalar bilan ikki darajali kesh. Memory Cache ob‘ektlar soni bo‘yicha cheklovga ega emas, lekin xotira yetishmasa tizim tomonidan tozalanadi. Disk Cache fayllarni TTL (sukut bo‘yicha 7 kun), o‘lcham chegarasi (sukut bo‘yicha 0 — cheklanmagan) va avtomatik tozalash bilan katalogda saqlaydi.

ImageProcessor

ImageProcessor — qayta ishlangan tasvirni qaytaradigan yagona process(item:options:) metodi bilan protokol. Ichki tatbiqlar: ResizingImageProcessor (o‘lchamni o‘zgartirish), RoundCornerImageProcessor (yumaloqlash), BlurImageProcessor (Gauss xiraligi), OverlayImageProcessor (rang qo‘shish). Protsessorlar |> operatori bilan birlashtirilishi mumkin.

Kingfisher keshlash tizimi

Kingfisher kesh arxitekturasi write-through tamoyiliga asoslangan: ma‘lumotlar bir vaqtning o‘zida ikkala darajada yoziladi va o‘qish eng tez darajadan — xotiradan boshlanadi. Kesh kaliti so‘rov parametrlari olib tashlanganidan keyin tasvirning mutlaq URL sidir.

Disk Cache hajmini boshqarish uchun oxirgi kirish sanasi bo‘yicha saralash bilan fayllarning umumiy hajmini hisoblash ishlatiladi. Chegara oshib ketganda, hajm chegaraning 50% dan pastga tushgunga qadar eng qadimgi kirish sanasi bo‘lgan fayllar o‘chiriladi. TTL tozalash keshni ishga tushirishda va har bir cleanExpired chaqiruvida sodir bo‘ladi.

Swift-da Kingfisher dan foydalanish misollari

Kingfisher tasvirlarni yuklash uchun bir nechta interfeyslarni taqdim etadi: UIImageView da kengaytma, alohida menejer va SwiftUI View.

UIImageView da kf orqali yuklash

kf — UIImageView da setImage, cancelDownload va yuklash ko‘rsatkichlarini taqdim etuvchi namespace xususiyati. setImage metodi URLSource va ixtiyoriy Options parametrlari hamda completionHandler ni qabul qiladi.

import Kingfisher

imageView.kf.setImage(
    with: URL(string: "https://example.com/image.jpg"),
    placeholder: UIImage(named: "placeholder"),
    options: [
        .processor(RoundCornerImageProcessor(radius: .point(12))),
        .transition(.fade(0.3)),
        .cacheMemoryOnly
    ],
    progressBlock: { receivedSize, totalSize in
        print("Yuklandi \(receivedSize) / \(totalSize)")
    }
)

Metod cancel orqali bekor qilish va taraqqiyotni kuzatishni qo‘llab-quvvatlovchi DownloadTask ni qaytaradi. Ichki setImage KingfisherManager.shared.retrieveImage ni ImageView ni avtomatik Target sifatida belgilash bilan chaqiradi.

async/await bilan ishlatish

Kingfisher 7.0 dan boshlab setImage metodi asinxron versiyada mavjud. Bu callbacklarsiz Swift Structured Concurrency da tasvir yuklashni integratsiya qilish imkonini beradi.

func loadAvatar() async {
    do {
        let result = try await imageView.kf.setImage(
            with: url,
            options: [.processor(ResizingImageProcessor(
                targetSize: CGSize(width: 100, height: 100)
            ))]
        )
        // result.image UIImage ni o‘z ichiga oladi
    } catch {
        print("Muvaffaqiyatsiz: \(error)")
    }
}

SwiftUI uchun KFImage

KFImage — iOS 15 dan AsyncImage ga o‘xshash, lekin Kingfisher keshlashining to‘liq qo‘llab-quvvatlashi bilan SwiftUI View. View avtomatik ravishda KingfisherManager.shared dan foydalanadi, lekin .configure modifikatori orqali moslashtirilgan menejerni qo‘llab-quvvatlaydi.

struct AvatarView: View {
    let url: URL

    var body: some View {
        KFImage(url)
            .placeholder { ProgressView() }
            .resizable()
            .fade(duration: 0.25)
            .forceTransition()
            .frame(width: 80, height: 80)
            .cornerRadius(40)
    }
}

Kingfisher da yuklash ko‘rsatkichlari

Kingfisher tasvir yuklash taraqqiyotini ko‘rsatish uchun o‘rnatilgan ko‘rsatkichlar tizimini taqdim etadi. IndicatorType — uch variantli sanab o‘tish: .activity (UIActivityIndicatorView), .progress (UIProgressView) va .custom (Indicator protokolining moslashtirilgan tatbiqi). Ko‘rsatkich yuklash vaqtida avtomatik ravishda ImageView ustida ko‘rsatiladi va tugagandan so‘ng yashiriladi.

Moslashtirilgan ko‘rsatkich uchun startAnimatingView() va stopAnimatingView() metodlari bilan Indicator protokolini tatbiq qilish kerak. Bu gibrid yechimlardan foydalanish imkonini beradi: shimmer animatsiyasi bilan skelet, asta-sekin paydo bo‘ladigan o‘rinbosar tasvir yoki shaffoflik animatsiyasi bilan logo. Kingfisher shuningdek KingfisherManager.shared.defaultOptions orqali ko‘rsatkichning global o‘rnatilishini qo‘llab-quvvatlaydi.

Kingfisher vs SDWebImage

iOS platformasida Kingfisher va SDWebImage tasvir yuklash uchun ikkita dominant kutubxonadir. Ularning orasida tanlov loyihaning tiliga, ishlash talablariga va ekotizimga bog‘liq.

Kingfisher ning asosiy ustunligi Swift-first arxitekturasi: async/await, Combine Publishers, Sendable va Result tiplarining to‘liq qo‘llab-quvvatlashi. SDWebImage kengroq plagin ekotizimi (WebP, SVG, MapKit) va Objective-C qo‘llab-quvvatlashi hisobiga yetakchilikni saqlab qoladi.

iOS loyihasida Kingfisher ni sozlash

Kingfisher Swift Package Manager, CocoaPods yoki Carthage orqali o‘rnatiladi. O‘rnatishdan so‘ng modulni import qilish va istalgan yuklash metodini chaqirish kifoya — kutubxona qo‘shimcha konfiguratsiyasiz ishlashga tayyor.

// Swift Package Manager (Package.swift)
dependencies: [
    .package(
        url: "https://github.com/onevcat/Kingfisher.git",
        from: "7.12.0"
    )
]

// CocoaPods (Podfile)
pod 'Kingfisher', '~> 7.12'

Global sozlamalarni moslashtirish uchun KingfisherManager.shared ishlatiladi. Yuklagichning timeout i, kesh strategiyasi va sukut bo‘yicha protsessorlarni o‘zgartirish mumkin. Quyida 14 kun TTL bilan 500 MB kesh konfiguratsiyasi namunasi keltirilgan.

let cache = ImageCache(name: "custom")
cache.memoryStorage.config.totalCostLimit = 100 * 1024 * 1024
cache.diskStorage.config.sizeLimit = 500 * 1024 * 1024
cache.diskStorage.config.expiration = .days(14)
KingfisherManager.shared.cache = cache

ImageDownloader ham menejer orqali sozlanadi: timeoutlar, sarlavhalar va kesh siyosatlari bilan moslashtirilgan URLSessionConfiguration o‘rnatilishi mumkin. Taraqqiyotni kuzatish uchun ActivityIndicator, ProgressView va moslashtirilgan ko‘rsatkichlarni qo‘llab-quvvatlovchi KFIndicator moduli mavjud.