Version 1.1.0

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

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

Version 1.0.0 🎉

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

Version 0.14.1

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.

Version 0.14.0

• 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

Version 0.13.0

• 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.

Version 0.12.0

• 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

Version 0.11.0

• 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.

Version 0.10.0

• decreased library size by making animated GIF and animated WebP modules optional
• decreased library size by optimizing native code
• custom scale type support for Drawee
• improved and simplified zoomable functionality: added support for tap listeners and inflation from XML
• OkHttp 3 support
• added ability to disable disk cache for certain requests (for security purposes)
• several bug fixes

Breaking change!

If you are using animated images (animated GIFs or animated WebPs) you need to add the following dependencies to your Gradle file:

animated GIF support:
compile 'com.facebook.fresco:animated-gif:0.10.0'

animated WebP support:
compile 'com.facebook.fresco:animated-webp:0.10.0'

if you’re using Gingerbread you also need to add:
compile 'com.facebook.fresco:animated-base-support:0.10.0'

Drawee changes

If you've been using R.styleable.GenericDraweeView, you now have to use R.styleable.GenericDraweeHierarchy instead.

Version 0.9.0

• reduced library size (made webp support for Jelly Bean and below optional)
• added Stetho plugin
• upgrade to OkHttp 2.6
• rounding is applied to all branches of DraweeHierarchy
• several bug fixes

Breaking change! If you're using webp images below Jelly Bean read this migration guide