Nuke Versions Save

• Fix https://github.com/kean/Nuke/issues/709: LazyImage fails to perform memory cache lookup in some scenarios
• (Internal) Replace some of the custom code with native extensions – https://github.com/kean/Nuke/pull/713 by @openmetrue
• Increase the minimum required Xcode version to 14.1 (required by App Store)

New Contributors

• @openmetrue made their first contribution in https://github.com/kean/Nuke/pull/713

• Fix https://github.com/kean/Nuke/issues/710: build failure on watchOS in debug mode – https://github.com/kean/Nuke/pull/711 by @FieryFlames

New Contributors

• @FieryFlames made their first contribution in https://github.com/kean/Nuke/pull/711

• Fix https://github.com/kean/Nuke/issues/693: ImageRequest created with an async function now executes it lazily - https://github.com/kean/Nuke/pull/708 by @khlopko
• Fix https://github.com/kean/Nuke/issues/695: byCroppingToSquare() always return square image – https://github.com/kean/Nuke/pull/696 by @zzmasoud
• Update unit tests – https://github.com/kean/Nuke/pull/701 by @woxtu
• Fix upcoming warnings in Xcode 15

New Contributors

• @khlopko made their first contribution in https://github.com/kean/Nuke/pull/708

• Fix compilation errors on xrOS
• Fix warnings in Xcode 15

• Add makeImageView closure to LazyImageView to allow using custom views for rendering images
• Add onCompletion closure to LazyImage and FetchImage
• Fix an issue with .videoAssetKey value missing from ImageContainer
• Fix an issue with .gif being encoded as .jpeg when .storeEncodedImages policy is used

Nuke 12 enhances the two main APIs introduced in the previous release: LazyImage and the async ImagePipeline methods. They are faster, more robust, and easier to use.

The migration guide is available to help with the update. The minimum requirements are unchanged from Nuke 11.

NukeUI 2.0

NukeUI started as a separate repo, but the initial production version was released as part of Nuke 11. Let's call it NukeUI 1.0. The framework was designed before the AsyncImage announcement and had a few discrepancies that made it harder to migrate from AsyncImage. This release addresses the shortcomings of the original design and features a couple of performance improvements.

• LazyImage now uses SwiftUI.Image instead of NukeUI.Image backed by UIImageView and NSImageView. It eliminates any discrepancies between LazyImage and AsyncImage layout and self-sizing behavior and fixes issues with .redacted(reason:), ImageRenderer, and other SwiftUI APIs that don't work with UIKIt and AppKit based views.
• Remove NukeUI.Image so the name no longer clashes with SwiftUI.Image
• Fix #669: redacted not working for LazyImage
• GIF rendering is no longer included in the framework. Please consider using one of the frameworks that specialize in playing GIFs, such as Gifu. It's easy to integrate, especially with LazyImage.
• Extract progress updates from FetchImage to a separate observable object, reducing the number of body reloads
• LazyImage now requires a single body calculation to render the response from the memory cache (instead of three before)
• Disable animations by default
• Fix an issue where the image won't reload if you change only LazyImage processors or priority without also changing the image source
• FetchImage/image now returns Image instead of UIImage
• Make _PlatformImageView internal (was public) and remove more typealiases

Concurrency

Redesign the concurrency APIs making them more ergonomic and fully Sendable compliant.

• Add ImagePipeline/imageTask(with:) method that returns a new type AsyncImageTask

let task = ImagePipeline.shared.imageTask(with: URL(string: "example.com"))
task.priority = .high
for await progress in task.progress {
    print("Updated progress: ", progress)
}
let image = try await task.image

• The existing convenience ImagePipeline/image(for:) method now returns an image instead of ImageResponse
• Remove the delegate parameter from ImagePipeline/image(for:) method to address the upcoming concurrency warnings in Xcode 14.3
• Remove ImageTaskDelegate and move its methods to ImagePipelineDelegate and add the pipeline parameter

Nuke

• Add a new initializer to ImageRequest.ThumbnailOptions that accepts the target size, unit, and content mode - #677
• ImageCache uses 20% of available RAM which is quite aggressive. It's an OK default on iOS because it clears 90% of the used RAM when entering the background to be a good citizen. But it's not a good default on a Mac. Starting with Nuke 12, the default size is now strictly limited to 512 MB.
• ImageDecoder now defaults to scale 1 for images (configurable using UserInfoKey/scaleKey)
• Removes APIs deprecated in the previous versions
• Update the Performance Guide

NukeVideo

Video playback can be significantly more efficient than playing animated GIFs. This is why the initial version of NukeUI provided support for basic video playback. But it is not something that the majority of the users need, so this feature was extracted to a separate module called NukeVideo.

There is now less code that you need to include in your project, which means faster compile time and smaller code size. With this and some other changes in Nuke 12, the two main frameworks – Nuke and NukeUI – now have 25% less code compared to Nuke 11. In addition to this change, there are a couple of improvements in how the precompiled binary frameworks are generated, significantly reducing their size.

• Move all video-related code to NukeVideo
• Remove ImageContainer.asset. The asset is now added to ImageContainer/userInfo under the new .videoAssetKey.
• Reduce the size of binary frameworks by up to 50%

See https://github.com/kean/Nuke/releases/tag/12.0.0

Redesign the concurrency APIs in Nuke ahead of the upcoming changes in Xcode 14.3, making them safer and ergonomic to use, and fully Sendable-compliant.

• Add ImagePipeline/imageTask(with:) method that returns a new type AsyncImageTask that you can use to monitor the task progress, change its priority, and, of course, fetch the response.

let task = ImagePipeline.shared.imageTask(with: URL(string: "example.com"))
for await progress in task.progress {
    print("Updated progress: ", progress)
}
let image = try await task.image

• The existing convenience ImagePipeline/image(for:) methods now return an image (UIImage or NSImage) instead of ImageResponse
• Remove the delegate parameter from the existing ImagePipeline/image(for:) async/await method to address the upcoming concurrency warnings in Xcode 14.3
• Remove ImageTaskDelegate and move its methods to ImagePipelineDelegate and add the pipeline parameter
• Add one final LazyImage optimization where when the image is in memory cache, LazyImage now requires a single body calculation to render it (instead of three before) – can't get better than this
• Use an improved way to generate xcframeworks, significantly reducing their size

• Fix #671: ImagePipeline/image(for:) hangs if you cancel the async Task before it is started. Thanks @muukii for reporting and providing a sample.

• Remove the convenience LazyImage(url:content:placeholder:) init method that doesn't offer much compared to the main init and remove public _LazyImageContents
• Fix an issue where if you change the LazyImage's processors or priority without also changing the image source, the image wasn't being reloaded
• Remove some of the typealises from NukeUI
• Remove the deprecated APIs in NukeUI
• Add missing scale parameter to init with content
• ImageDecoder now defaults to scale 1 for images
• Remove scale parameter from LazyImage init: it's available via ImageRequest userInfo