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: 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