Performance Guide

How to improve image loading performance

Nuke is highly optimized and provides many performance features, but it’s ultimately up to your app to decide how to use them.

Caching #

Enable Aggressive Cache #

By default1, Nuke uses the native HTTP cache, but it’s relatively slow and is subject to the same maximum concurrent operations count as network tasks (because it’s part of the URL loading system). If your app doesn’t take advantage of complex HTTP cache-control parameters, consider enabling the custom aggressive disk.

Store Processed Images #

By default, the aggressive disk cache (if enabled) stores original image data. If your app applies expensive processors or downsamples images, consider storing processed images instead by setting dataCachePolicy to .automatic or .storeEncodedImages depending on the use case.

Use HEIF #

To save disk space see ImageEncoders.ImageIO and ImageEncoder.isHEIFPreferred option for HEIF support. By default, disabled.

Downsample Images #

Ideally, the app should download the images optimized for the target device screen size; but it’s not always feasible. To reduce the memory usage, downsample the images.

// Target size is in points.
let request = ImageRequest(
    url: URL(string: "http://..."),
    processors: [.resize(size: imageView.bounds.size)]

See Image and Graphics Best Practices to learn more about image decoding and downsampling.

In Nuke 10.4, you can also use a new API to generate thumbnails which is more efficient than using ImageProcessors.Resize.

Prefetch Images #

Loading data ahead of time in anticipation of its use (prefetching) is a great way to improve user experience. It’s especially effective for images; it can give users an impression that there is no networking and the images are just magically always there.

To implement prefetching, follow the dedicated guide.

Resumable Downloads #

Make sure your server supports resumable downloads. By default, the pipeline enables resumable downloads on the client side.

Request Priorities #

Nuke allows you to set the request priority and update it for outstanding tasks. It uses priorities for prefetching: the requests created by the prefetcher all have .low priority to make sure they don’t interfere with the “regular” requests. See “Prefetching” to learn more.

There are many other creative ways to use priorities. For example, when the user taps an image in a grid to open it full screen, you can lower the priority of the requests for the images that are not visible on the screen.

final class ImageView: UIView {
    private let task: ImageTask?

    override func willMove(toWindow newWindow: UIWindow?) {
        super.willMove(toWindow: newWindow)

        task?.priority = newWindow == nil ? .low : .high

Create URLs Beforehand #

URL initializer is relatively expensive because it needs to parse the input string. It might take more time than the call to Nuke.loadImage(with:into:) itself. Make sure to create the URL objects in the background.

Auto Retry #

Enable waitsForConnectivity on URLSession to indicate that the session should wait for connectivity to become available instead of failing the request immediately in case of a network failure.

Measure #

If you want to see how the system behaves, how long each operation takes, and how many are performed in parallel, enable the isSignpostLoggingEnabled option and use the os_signpost Instrument. For more information see Apple Documentation: Logging and WWDC 2018: Measuring Performance Using Logging.

  1. The default behavior will most likely change in Nuke 10.