[swift] 킹피셔를 사용하여 이미지를 캐시하는 방법은?

27 Nov 2023

swift

이미지 캐싱은 애플리케이션에서 이미지를 불러와서 표시할 때, 이미지를 다운로드하고 저장하기 위한 기술입니다. 이를 통해 이미지를 효율적으로 관리하고, 반복적인 다운로드를 방지하여 사용자 경험을 향상시킬 수 있습니다. 이번 글에서는 스위프트에서 많이 사용되는 이미지 캐싱 라이브러리 중 하나인 킹피셔(Kingfisher)를 사용하는 방법을 알아보겠습니다.

1. 킹피셔 설치하기

킹피셔는 CocoaPods를 통해 손쉽게 설치할 수 있습니다. Podfile에 다음과 같은 내용을 추가해주세요.

pod 'Kingfisher'

그리고 터미널에서 pod install 명령어를 실행하여 킹피셔를 프로젝트에 설치합니다.

2. 킹피셔를 사용하여 이미지 캐시하기

킹피셔를 사용하여 이미지를 캐시하는 방법은 간단합니다. 먼저 UIImageView에 이미지를 설정해야 합니다. 이 때 Kingfisher의 setImage(with:) 메서드를 사용하면 됩니다. 예를 들어, 다음과 같이 이미지를 설정해보겠습니다.

import Kingfisher

let imageView = UIImageView()
let url = URL(string: "https://example.com/image.jpg")

imageView.kf.setImage(with: url)

위 코드에서 kf.setImage(with:) 메서드를 호출하여 이미지를 설정합니다. setImage(with:) 메서드는 URL을 매개변수로 받아서 해당 URL에서 이미지를 다운로드하고 캐시합니다. 이미지가 캐시되어 있다면 다음 실행에서는 캐시된 이미지를 사용하므로 네트워크 요청을 줄일 수 있습니다.

3. 옵션 설정하기

킹피셔를 사용할 때는 필요에 따라 다양한 옵션을 설정할 수 있습니다. 예를 들어, 이미지가 로딩 중일 때나 오류가 발생했을 때 표시할 콘텐츠를 설정하고 싶다면 placeholder와 failureImage 속성을 사용할 수 있습니다.

imageView.kf.setImage(with: url, placeholder: UIImage(named: "placeholder"), failureImage: UIImage(named: "error"))

위 예제에서는 placeholder에는 로딩 중에 표시할 이미지를, failureImage에는 오류가 발생했을 때 표시할 이미지를 설정합니다.

4. 추가 기능 활용하기

킹피셔는 이미지 캐싱 이외에도 다양한 기능을 제공합니다. 예를 들어, 이미지 다운로드 진행 상태를 감지하고 싶을 때 onProgress 클로저를 사용할 수 있습니다. 또한, 이미지 다운로드 완료 후 특정 동작을 수행하고 싶을 때 completionHandler 클로저를 활용할 수도 있습니다.

imageView.kf.setImage(with: url, onProgress: { receivedSize, totalSize in
    // 이미지 다운로드 중일 때 호출되는 클로저
    let progress = Float(receivedSize) / Float(totalSize)
    print("다운로드 진행률: \(progress * 100)%")
}, completionHandler: { result in
    // 이미지 다운로드 완료 후 호출되는 클로저
    if case .success(let value) = result {
        print("다운로드 완료: \(value.source.url?.absoluteString ?? "")")
    } else {
        print("다운로드 실패")
    }
})

위 예제에서는 onProgress 클로저를 통해 다운로드 진행률을 출력하고, completionHandler 클로저를 통해 다운로드 결과를 출력합니다.

마무리

킹피셔는 스위프트에서 이미지 캐싱을 효율적으로 처리하기 위해 널리 사용되는 라이브러리입니다. 이번 글에서는 킹피셔를 설치하고 사용하는 방법을 간략히 알아보았습니다. 킹피셔를 사용하면 이미지 캐싱이 간편해지고 사용자 경험을 개선할 수 있으므로, 애플리케이션 개발에 유용하게 활용할 수 있습니다.

참고 자료

킹피셔 공식 문서: https://github.com/onevcat/Kingfisher
CocoaPods: https://cocoapods.org/