Version 2.5.0

Highlights

• Bumped Fresco's minSdk to 14. We did not remove any Gingerbread-specific code yet, but will do so soon. 091e8b7c4cd11a6cc5b535dd84d8e21a1e243ac0

• Proper nullability annotations for some classes by using new Infer annotations - this improves Kotlin support and null-safety.

• Improved Java-only Fresco setup. 4a9961559c8240cbb88eeecf2303f956d0185120

• Lots of debug logging improvements: More reliable image origin, new MEMORY_BITMAP_SHORTCUT origin, more debug information available. These are available via ImagePerfData#getExtraData()

• Added experimental option to recover from OOMs: f43d5990600c9ac6c3a18e14e4d3c260cf78b462

• Added option to force a single image pipeline instance: 5f5c076fe26b17a849498c27c7541550c3ef3984

• Disk cache support for the Fresco Flipper images plugin.

• Bumped SoLoader version to 0.9.0.

• Use buildSrc for Fresco's internal dependency management.

• WIP: Lots of improvements for our new Fresco Vito UI components.

Pull requests:

• Fixed resource leak problem while using BlurPostProcessor. Thanks @FrancescoJo for the PR.
• Make sure there is at least one overlay in GenericDraweeHierarchy. Thanks @dengweichao for the PR.
• Removed unused padding value. Thanks @erenulas for the PR.

Cleanup

• Removed Drawee-Volley module. If you're using Drawee-Volley, you can still continue using it by just copying the files removed with 7c2517edee7d4080fab0daf54fd4ac4eca6a8497 into your project. We did not significantly change these in a long time, so this has been stable.
• Removed OkHttp2 image pipeline artifact. See deba7d1c3c218377a5b67e58f269914d8f8a88be

Full changelog: https://github.com/facebook/fresco/compare/v2.2.0...v2.3.0

Fixes and Improvements

• Add reportData methods for debugging and crash reporting
• Add support for work instrumentation
• Fix animatable drawables not playing
• Improve debug overlay
• Show Encoded Cache in Flipper Image plugin
• Add option to disable/override encoded cache
• Migrate many deps to use buildSrc

Thanks

Thanks to the following for their pull requests which are included in this release: @iadeelzafar, @xinghui, @JLLeitschuh, @jkcailteux

The full changelog is here.

Fresco 2.1.0 comes with tons of improvements, including a Java-only Fresco version.

Highlights

• A Java-only Fresco version. See below for Gradle setup. Note: If you display animated GIFs, you can use animated-gif-lite instead of animated-gif for Java-only GIF support.
• SoLoader is now optional again. We've worked on a new NativeLoader interface to load native code on Android. Now, with Fresco 2.1.0 all the changes are available for people to use, see below for the Gradle setup. If you want to employ a custom native loading mechanism, just implement a NativeLoaderDelegate and call NativeLoader.init(yourDelegate) before Fresco is initialized.
• New ProducerListener2 and RequestListener2. They give you significantly more flexibility since they allow you to access more image information.
• The possibility to pass down the UI component ID (e.g. Drawee ID / Vito ID) through the whole image pipeline, which, in combination with listeners above, can for example be used for debugging or logging.
• A new memory type for encoded images and byte buffers: Ashmem. Now you can either use Java memory, native memory or Ashmem.
• Faster circular native rounding.
• Improved concurrency handling for deferred releasing - and much more.
• You can look at the full changelog here.

Java-Fresco Gradle setup:

implementation('com.facebook.fresco:fresco:2.1.0') {
    exclude group: 'com.facebook.soloader', module: 'soloader'
    exclude group: 'com.facebook.fresco', module: 'soloader'
    exclude group: 'com.facebook.fresco', module: 'nativeimagefilters'
    exclude group: 'com.facebook.fresco', module: 'nativeimagetranscoder'
    exclude group: 'com.facebook.fresco', module: 'memory-type-native'
    exclude group: 'com.facebook.fresco', module: 'imagepipeline-native'
}

Custom SoLoader Gradle setup:

implementation('com.facebook.fresco:fresco:2.1.0') {     
      exclude group: 'com.facebook.soloader', module: 'soloader'
      exclude group: 'com.facebook.fresco', module: 'soloader'    
 }

Breaking Dependency Change

We bumped the major version since Fresco is now using AndroidX support libraries. If you are still using the previous support library, please use version 1.13.0 until you've migrated to AndroidX.

New Flipper Images Plugin

We've open sourced our Flipper images plugin, which makes it easy for you to debug images within your application. Take a look at the Flipper documentation here: https://fbflipper.com/docs/features/images-plugin.html It also allows you to track unclosed CloseableReferences if you're using the image pipeline directly.

Fixes and Improvements

Highlights:

• Added explicit color management (51efaa75f410a390566f72596099c35d85a42216). See #2323 for more information.
• Added API to get the size of the disk cache.
• Fix scaling up image with RoundingParams.
• Prevent Fresco from crashing for certain invalid GIFs.
• Added local content URI support for fetching encoded images.
• Added CloseableReference leak tracking. You can hook up your own listener to track unclosed references.
• Video thumbnails: generate video thumbnail from content provider when we cannot get file path.
• Updated the Showcase sample app to enable the Flipper images plugin and started using Kotlin.
• Display Image URI in Fresco's debug overlay.
• Improved image origin listener accuracy.
• Added caller context verification to the ImagePipeline. You can now check whether proper image attribution (caller context) is set.

Full changelog: https://github.com/facebook/fresco/compare/v1.13.0...v2.0.0

Thanks

Thanks to the following for their pull requests which are included in this release: @otopba, @lpy and @kexuejin

• Added leak tracking for CloseableRefererences. You can hook up your custom leak handler for unclosed CloseableReferences which is triggered when a reference is GCed without being explicitly closed.
• You can also use the new Flipper images plugin (https://github.com/facebook/flipper) to track these leaks.

• Open sourced our Fresco Flipper plugin.
• Updated target SDK to 28.
• Replaced gnustl_static with c++_static.
• Updated various dependencies.

This is a hotfix release including changes below

• Optionally downsample gif frames to drawable dimensions 7479a6f
• Expose hasCachedImage for ImagePipeline 90f7aa6

Fixes and Improvements

• SoLoader updated to v0.6.0 with support for App Bundles 6fc071d
• New native image transcoder module (native-imagetranscoder) a6b47b9
• Added new "critically low" foreground memory trim level 9745eb8
• Expose ID generation and submitFetchRequest 7d67c7f
• New function in BitmapUtil to get the dimensions of an image from its Uri 1205892
• Added option to show all FadeDrawable layers per default a340566
• Register LruBitmapPool as memory trimmable 839b5a1
• Added GifAnimationBackend that improves the GIF Lite variant 027f95d
• Add option to control prefetching to bitmap cache per request 6ca0fa9
• Add image request option to override default network images resizing d503601
• okhttp updated to 3.12.1 0866e81

Thanks

Thanks to @dulmandakh for your pull request!

Fixes and Improvements

• Moved native image filters into a separate gradle module (native-filters)
• Fix for OkHttp disk caching (allows you to disable Fresco disk cache and use OkHttp)
• Made most native code optional (jpeg transcoder and native memory chunks)
• Proper support for GIFs when using a RetainingDataSource
• Fix to disable caching for unknown image types
• Fix bug when using DownSample and RegionDecoder together
• Fixed image origin in debug overlay
• Color space support
• Improved HEIF support (on devices which supports decoding them)
• Fixes for Android Studio layout preview
• Improved blurring and rounding with antialiasing (see showcase app)
• Add support for windows ICO image format
• libjpeg update to 1.5.3
• libwebp updated to 1.0.0
• libpng updated to 1.6.35

Thanks

Thanks to the following for their pull requests which are included in this release: @Crysis21, @JuniperPhoton, @dryganets, @Yrlec, @s1rius, @qhyuan1992, @xjy2061, @zjupure

Release Notes v1.10.0

Breaking

• Remove media variations
• Pass DraweeController down to data source generation: a7796dea693cb63f9e0933236335e8a68f24157a

Fixes and Improvements

• Updated Comparison app
• Do not cache images if they are of unknown format 7a874c17bda54a92755d36bce6278599cc0cecc1
• Fix webp add round draw out of bound (#2132) (thanks wangfang) 5357424115b6e3ef9966d141efb66cd72bb5f0e9
• Fix GIF images scaling with FIT_XY scale type 6898a9c39a6ef930fe84c5208daaa08f2a22432d
• Get rid of internal android Predicate (Prepare for Android P) API 0a93ffc58585a1f7104ea7a5e0b93b6c1b16cdcc
• Control memory cache per request d2474bcd7889dd1e2150aef4a861e3393d6d3dc5
• Add configuration option for bitmap count limit 3ccf021877571cc66c1cf28ecc82788f83579ad3
• Handle multiple copies of Fresco 54556c910130a0ea5aa30f547adb1cec826456f5
• Interstitial shows on profile in MediaGallery (thanks Young Kim) d560881e6d2228e90ddd0d1cf62f269b8c4d7fd0
• Mark object passed in .equals() as nullable (thanks Christopher Frazier) e1145cfce57bb1b31dbd88d59a353a484a91cc808ef0
• Many updates for perf logging
• Update SoLoader to 0.5.0 8e9243e94fc9f8117b09b1fb6c4594feda7411c8
• Added RoundedNinepatchDrawable e1aa81f797583c244817fc334395a13d0e33b3bc
• Extend Fresco's ImageFormats to detect HEIF images 84ace378a3c994b0e8d4bf0112bdede6b1af397c

Thanks

Thanks to the following for their pull requests which are included in this release: @cucbin, @chibatching, @mariotaku, @hetovar, @Naman-Bhalla, @woyunowuyuda, @hearsilent

Updated to MIT license

Breaking Changes

• Inlined ProGuard rules such that you no longer need to manually copy-over the Fresco proguard file (thanks @gengjiawen). If you are manually adding Fresco-specific ProGuard files in your Gradle files, you can now remove them

• Added isSameImageRequest() to DraweeController

New APIs

• Added API to pass an ImageRequest to SimpleDraweeView(53c6151d1e5fd4ceb4733c8eecec86b2f4214632 (https://github.com/facebook/fresco/commit/53c6151d1e5fd4ceb4733c8eecec86b2f4214632), thanks @bkpavan)
• Added configurable timeout for HttpUrlConnection network fetcher (005f38a797f2ad9ed4d138df45f44835144c32fd, thanks @jnawaz)

Improvements and bugfixes

• Added image load time to debug overlay
• Updated libwebp to 0.6.1 (thanks @eldk)
• Updated OkHttp to 3.10.0 (thanks @NightlyNexus)
• Updated GifLib to 5.1.4
• Fixed GIF rendering for missing color maps
• Fixed WebP native memory leak (thanks @howardpang)
• Improved equality handling for controllers and ImageRequests
• Made bitmap decoding more robust
• Various other improvements & sample app updates

Thanks

Thanks to the following for their pull requests which are included in this release: @bkpavan, @eldk, @gengjiawen, @howardpang, @jnawaz, @NightlyNexus, @sophiebits!

Version 1.8.1 is a bug-fix release following the main 1.8.0 release. In particular, it addresses the following issues:

• Fresco's SoLoader configuration no longer crashes with certain pro-guard configurations (issue: #2039)
• In previous versions WebP image might fail to load in certain configurations (commit: https://github.com/facebook/fresco/commit/06fe3719a3a3c659438b6c25a8008945e67156a0)

Version 1.8.0 contains several improvements and bug fixes, including:

• Fixed animated image rendering for dynamic frame dimensions (086fd1df)
• Fixed downsampling for PNGs (e2c464ef)
• Fixed WebPs with alpha decoding on API <= 17 devices (705b7745)
• Supporting wide color gamut decoding on Android 8+ (4a64df00)
• Fixed handling pin bitmap errors (a08f9e76, f5eb85eb)

Breaking changes

Switched to using SoLoader (aef3790d)

SoLoader has been released for a while now, and updated just last week. We've made the decision to add a hard dependency on it and make SoLoader the one and only native code loader that we use in Fresco. API-wise, this means SoLoaderShim is gone. If you were using some other native loading library (e.g. ReLinker), you can either:

• keep both and just delete your SoLoaderShim implementation, but this will make your APK size bigger
• switch to SoLoader for the rest of your app as well and remove the other dependency

Thanks

Thanks to the following for their pull requests which are included in this release: @Alonexx, @8enet, @zjupure, @bschnack

This is a bugfix release. For all the relevant changes that made it into this release, please see v1.7.0.

Do Not Use: this release is broken (see #1991)

Version 1.7.0 contains several improvements and bug fixes, including:

• Switched to OkHttp 3.8.0 (bd9dd827)
• Region decoding (bd249fa4)
• Native circular rounding (705379ee)
• Added RetainingDataSourceSupplier (ff3bed97)
• Support inverted rotation orientations (d25944a)

Thanks

Many thanks to the following people who sent pull requests that are included with this release!

• @adamc01
• @Anandsoni14
• @a-d-collins
• @rvndbalaji
• @efrohnhoefer
• @Kazemir
• @w0yne
• @eldk
• @simonzhexu

Version 1.5.0 contains several improvements and bug fixes, including:

• Better control of bitmap GPU uploads
• Add support for fitBottomStart scaleType
• Support for local content video URI thumbnails
• Bug fixes

Sample Apps

The following improvements were made to the Fresco Showcase app:

• Added image resizing example
• Support loading of SVG files not starting with "<svg" (in the Showcase SVG decoder example)

Breaking changes

• MediaIdExtractor was removed

Thanks

Thanks to the following for their pull requests which are included in this release: @a-d-collins, @JuniperPhoton, @DkBai, @IguteChung

Animated Image Changes

Rewritten implementation for animated images (GIFs and animated WebPs) with better performance, particularly when showing multiple GIFs.

This brings improved frame caching and memory management, better control for users of Fresco, new features and some GIF rendering issues have been fixed.

Other Updates in 1.4.0

• Support for Bitmap.prepareToDraw to upload bitmaps to the GPU ahead of time (as suggested by @ ChrisCraik) - enabled via ImagePipelineExperiments
• Fixed Shared Element Transitions. You have to manually call draweeView.setLegacyVisibilityHandlingEnabled(true)
• Per-image custom drawable factory support
• Caching improvements
  • You can now set a custom cache trim strategy for the image pipeline
  • Added BaseCacheEventListener that implements CacheEventListener for convenience
• Easier synchronous requests with DataSources#waitForFinalResult
• Fixed IncreasingQualityDataSource to keep the low res image if the high res request fails
• Various other bug fixes and improvements: BitmapCounterProvider, Media Variations, Progressive JPEGs, EXIF parsing, ZoomableDraweeView touch logic, DraweeView attributes in Android Studio

Breaking Changes

AnimatedDrawable

The old animation code has been removed, including AbstractAnimatedDrawable, AnimatedDrawable, or AnimatedDrawableSupport . Change your casts to AnimatedDrawable2. We also removed com.facebook.fresco:animated-base-support since it is no longer needed.

DrawableFactory

Moved DrawableFactory to com.facebook.imagepipeline.drawable.DrawableFactory. Please change your imports if you're using custom drawable factories.

Small cache threshold

Removed this option from ImagePipelineExperiments as well as related code.

Internal changes

Added void onNewResult(T newResult, @Status int status) to Consumer interface.

Removed deprecated methods

• ImagePipeline#getDataSourceSupplier(ImageRequest, Object, boolean)
• EncodedImage#setEncodedCacheKey(CacheKey)
• EncodedImage#getEncodedCacheKey()
• GenericDraweeHierarchyBuilder#setActualImageMatrix()
• GenericDraweeHierarchyBuilder#getActualImageMatrix()

Sample Apps (now with Kotlin!)

We've updated our Showcase sample app to include more samples and merged other sample apps into it.

There is also a new Kotlin sample app that shows how to use Fresco with Kotlin.

Version 1.3.0 is mainly a bugfix release.

• Showcase application improved and new examples added
• New onUltimateProducerReached() callback method added to ProducerListener.
• It's now possible to load resources using a qualifying resource URI. This allows for loading resources that are not part of the application's main package.

Breaking Changes

PooledByteBuffer and PooledByteBufferInputStream

These two classes have moved package from com.facebook.imagepipeline.memory to com.facebook.imagepipeline.memory. If you directly make use of either class, simply update your imports.

ProducerListener

The ProducerListener interface has a new callback: onUltimateProducerReached(). This identifies the producer which was ultimately responsible for producing the result which was passed back, so can give an idea about how many requests are satisfied from caches.

If you have an implementation of ProducerListener or RequestListener you will need to add an implementation of this method.

Thanks

Thanks to the following for their pull requests which are included in this release: @voiddog, @nesterov-n, @paour and @josephlam1984.

Version 1.2.0 is mainly a bugfix release.

• A MediaIdExtractor interface has been added to benefit from media variations without explicitly adding media IDs to every image request. This is currently experimental though and not recommended unless you're careful and confident in the URLs your app uses.
• Added option to ImageRequestBuilder for setting a custom image decoder for that particular request.
• libfb_jpegturbo is now linked as a shared library.
• Updated to OkHttp v3.6.0.
• Updated libpng to v1.6.26.

Thanks

Thanks to the following for their pull requests which are included in this release: @paour, @desmond1121, @caojianfeng, @FtheGFW, @eldk, @lucas34, @angarron

Version 1.1.0 is mainly a bugfix release.

There is one breaking change: MemoryUiTrimmable was removed. See d41bf01 for details.

All commits going into this release: https://github.com/facebook/fresco/compare/v1.0.1...v1.1.0

Thanks

Thanks to the following for their pull requests which are included in this release: @lucas34

Version 1.0.1 is mainly a bugfix release:

• Fixed an issue where URIs with spaces could not be parsed correctly.
• Updated libwebp to 0.5.2 and fixed some WebP issues.
• Downsampling ratio calculations are now correct.
• The image pipeline now uses the correct producer sequence for local files.
• SimpleDraweeSpanTextView now resizes itself correctly.

New Features

You can use UriUtil.getUriForFile(File) and ImageRequest.fromFile(File) to create URIs and ImageRequests for files.

Thanks

Thanks to the following for their pull requests which are included in this release: @angarron, @korDen, @sachins, @pizza, @JoelMarcey

The version bump was overdue - the library is stable for a long time. It is used in all the major Facebook apps for years (Facebook, Messenger, Moments, Facebook Lite). On top of that it also powers a lot of non Facebook apps like Twitter, Wikipedia and Vimeo. We were careful with breaking changes for at least a year - so here we go: Version 1.0!

With this release, Fresco allows you to easily add support for more image formats and custom decoders. This is configurable using the ImageDecoderConfig class. See our sample application for a practical example.

Fresco now allows you to provide it with more semantic information about different versions and URIs of the same image. The concept is called Media Variations and it uses a media id to group different URIs that refer to the same underlying source image that might be loaded in different sizes. Fresco will try to satisfy a new request by first looking if another already cached image with the same media id exists and displaying that. See our sample application for a practical example.

We added a Debug overlay for drawees. They can show you how large the underlying image is with respect to the actually drawn screen area. This is helpful in order to screen you app for images that should be loaded at a smaller resolution. You can activate it using the DraweeConfig parameter of Fresco.initialize(...).

If you are manually dealing with CloseableReferences you might find yourself leaking memory. One can now specify UnclosedReferenceListener in order to log these leaks or crash in debug builds.

DraweeSpan and BetterImageSpan are new Spannable implementations for displaying Drawees within text.

Breaking Change

Fresco now longer has a direct dependency on the Android Support library. Instead, it expects certain part of the support library to be provided by the including application. If you do not include the Android Support Library yourself already, you will have to add the following line to your build.gradle file:

compile "com.android.support:support-core-utils:24.2.1"

With this version we have also removed methods and classes that have been marked as @Deprecated for some time. For all those cases there are new APIs that are easy to use.

Thanks

Thanks to the following for their pull requests which are included in this release: @PiotrWpl, @rigdern, @nesterov-n, @sdqhzhm, @kukuhyoniatmoko, @ghassett, @sailaway

This is a patch release to fix a bug in ResizeAndRotateProducer which stopped images appearing in some cases.

There is also a new IterativeBoxBlurPostProcessor for performant blurring of images.

Breaking Change

ImageFormat is now a class instead of an enum to allow for future support for custom formats. All default formats can be found in DefaultImageFormats.

• PlatformBitmapFactory now supports more createBitmap variations
• Support for custom Drawable factories
• New DefaultConfig allows to set global defaults for ImageRequests
• RotationOptions allow for better control of rotation (either manual or based on EXIF information)
• We've updated the target, build tools and support library to 24.2.1 which now requires Java 8
• Improved sample applications
• And a variety of other fixes and improvements

Breaking Changes

In support library 24.2 Google split the library into smaller parts. By upgrading our support library dependency to 24.2.1, we've been able to specify the parts which Fresco needs (which is very little).

We recommend both upgrading your support library dependencies similarly and making sure you explicitly depend on the parts of the support library that you need. This can reduce your APK size.

Thanks

Thanks to the following for their pull requests which are included in this release: @eldk, @s1rius, @gtpark, @kunny

• Libjpg-turbo upgraded to version 1.5.0
• Animation Info exposed
• NineOldAndroid dependency removed from ImagePipeline module
• Improved sample applications
• And a variety of other fixes and improvements

Breaking Changes

• Unused flags removed from ImageDecodeOptions.

Thanks

Thanks to the following for their pull requests which are included in this release: @lambdapioneer, @ahmedre, @joonho and @KoMinkyu.

• Fixed ProGuard issues with animated-* and okhttp3 modules
• Disk cache memory index is now persisted across sessions
• Removed unnecessary dependencies on nineoldanroids
• Fixed behavior of zoomables
• Improved sample applications
• And a variety of other fixes and improvements

Breaking Changes

• ImageType has been renamed to CacheChoice

Thanks

Thanks to the following for their pull requests which are included in this release: @huangjunkun, @PiotrWpl, @s1rius and @0mok

• Image pipeline
  • Split out ImagePipelineExperiments from ImagePipelineConfig
  • Volley is now integrated as a backend for the image pipeline as an alternative to OkHttp or HttpUrlConnection
  • Resumed requests occur in their original order
  • Fixed a bug where the OkHttp backend could leak non-successful responses
• Cache
  • Added details of each event to CacheEventListener methods
  • Added caller context as a parameter for CacheKeyFactory methods
  • Added support for synchronous disk cache checks
• Drawee
  • Added support for the hotspot so ripple drawables work as expected in Lollipop and up.
  • GenericDraweeHierarchy now has setter methods supporting resource IDs
  • Fixed drawee scale type transitions when using activity transitions
  • Added support for dynamically changing backgrounds and overlays
• Samples
  • Improved gesture handling in the zoomable sample code
  • Added a new sample app to test scroll performance
• Also
  • Changed Bolts dependency to the smaller Tasks module
  • And a variety of other fixes and improvements

Breaking changes

Experimental config options

To make it clearer which options in ImagePipelineConfig are included for experimental purposes, these have been moved into a separate ImagePipelineExperiments class. Options here should be expected to be volatile and liable to be changed or removed in future releases. Changing these values from their defaults is not recommended in most cases.

These methods are still available in a chain while building your config so if you had the following before:

ImagePipelineConfig config = ImagePipelineConfig.newBuilder(context)
    .setForceSmallCacheThresholdBytes(maxSmallImageBytes)

you can fix it by changing it as follows:

ImagePipelineConfig config = ImagePipelineConfig.newBuilder(context)
    .experiment().setForceSmallCacheThresholdBytes(maxSmallImageBytes)

CacheEventListener

All CacheEventListener methods now receive a new CacheEvent object.

If you have a custom implementation you will need to add the extra parameter to each method. In the case of onEviction() the old parameters have been replaced so you will also need to extract the values from the event if you are making use of them.

CacheKeyFactory

All CacheKeyFactory methods now receive an extra parameter with the caller context object that can be specified when the image is requested.

If you have a custom implementation you will simply need to add the extra parameter to each method.

Multiple drawee backgrounds

It was previously possible to specify multiple backgrounds in a drawee hierarchy. This is still possible but deprecated and if you specify multiple backgrounds these can no longer be rounded.

Thanks

Thanks to the following for their pull requests which are included in this release: @chethann, @droidekas, @sagartrehan, @froxCZ, @nborodikhin, @Ribesg, @dmitrychistyakov, @plamenko, @szpnygo, @s1rius and @Rexee.