MapleBacon
Introduction
MapleBacon is a lightweight and fast Swift library for downloading and caching images.
Example
The folder Example contains a sample projects for you to try.
Requirements
- Swift 5.1
- iOS 10.0+
- Xcode 10.2+
Installation
MapleBacon is available through CocoaPods. To install add it to your Podfile:
pod "MapleBacon"
github "JanGorman/MapleBacon"
Usage
UIImageView
The most basic usage is via an extension on UIImageView. You pass it URL:
import MapleBacon
private var imageView: UIImageView!
func someFunc() {
let url = URL(string: "โฆ")
imageView.setImage(with: url)
}
If you want to add a placeholder while the image is downloading you specify that like this:
func someFunc() {
let url = URL(string: "โฆ")
imageView.setImage(with: url, placeholder: UIImage(named: "placeholder"))
}
If your backend returns images that are not optimised for display, it's good practice to downsample them. MapleBacon comes with support for downsampling via displayOptions:
func someFunc() {
let url = URL(string: "โฆ")
imageView.setImage(with: url, displayOptions: .downsampled)
}
Image Transformers
MapleBacon allows you to apply transformations to images and have the results cached so that you app doesn't need to perform the same work over and over. To make your own transformer, create a class conforming to the ImageTransforming protocol. A transform can be anything you like, let's create one that applies a Core Image sepia filter:
private class SepiaImageTransformer: ImageTransforming {
// The identifier is used as part of the cache key. Make sure it's something unique
let identifier = "com.schnaub.SepiaImageTransformer"
func transform(image: UIImage) -> UIImage? {
let filter = CIFilter(name: "CISepiaTone")!
let ciImage = CIImage(image: image)
filter.setValue(ciImage, forKey: kCIInputImageKey)
filter.setValue(0.5, forKey: kCIInputIntensityKey)
let context = CIContext()
guard let outputImage = filter.outputImage,
let cgImage = context.createCGImage(outputImage, from: outputImage.extent) else {
return image
}
// Return the transformed image which will be cached (or used by another transformer)
return UIImage(cgImage: cgImage)
}
}
You then pass this filter to MapleBacon in one of the convenience methods:
let url = URL(string: "โฆ")
let transformer = SepiaImageTransformer()
imageView.setImage(with: url, transformer: transformer)
If you want to apply multiple transforms to an image, you can chain your transformers:
let chainedTransformer = SepiaImageTransformer()
.appending(transformer: DifferentTransformer())
.appending(transformer: AnotherTransformer())
Or if you prefer, using the custom >>> operator:
let chainedTransformer = SepiaImageTransformer() >>> DifferentTransformer() >>> AnotherTransformer()
(Keep in mind that if you are using Core Image it might not be optimal to chain individual transformers but rather create one transformer that applies multiple CIFilters in one pass. See the Core Image Programming Guide.)
Caching
MapleBacon will cache your images both in memory and on disk. Disk storage is automatically pruned after a week (taking into account the last access date as well) but you can control the maximum cache time yourself too:
let oneDaySeconds: TimeInterval = 60 * 60 * 24
MapleBacon.default.maxCacheAgeSeconds = oneDaySeconds
Combine
On iOS13 and above, you can use Combine to fetch images from MapleBacon
MapleBacon.shared.image(with: url)
.receive(on: DispatchQueue.main) // Dispatch to the right queue if updating the UI
.sink(receiveValue: { image in
// Do something with your image
})
.store(in: &subscriptions) // Hold on to and dispose your subscriptions
Migrating from 5.x
There is a small migration guide in the wiki when moving from the 5.x branch to 6.x
License
MapleBacon is available under the MIT license. See the LICENSE file for more info.
20.9k Dec 30, 2022
11 Jan 10, 2022
343 Oct 29, 2022
1.8k Dec 17, 2022
293 Nov 24, 2022
1k Jan 4, 2023
1 May 5, 2022
1.2k Dec 23, 2022
114 Jun 30, 2022
330 Sep 9, 2022
4.5k Dec 29, 2022
18 Nov 14, 2022
2.8k Jan 3, 2023
2 Oct 28, 2022
8 Dec 16, 2022
0 Feb 26, 2022
0 Jan 6, 2022