Change Log

Version 2.71828 (2018-03-07)

This version is not fully backwards compatible with previous 2.x releases! It is intended to be a stable, pre-3.0 release that users of 3.0.0-SNAPSHOT can use in the mean time.

Its changes are many, as evidenced by the nearly 3 years since 2.5.2. If you are interested in them you can browse the commits here: https://github.com/square/picasso/compare/picasso-parent-2.5.2...2.71828

Otherwise, stay tuned for 3.0 whose change log will be in relation to 2.5.2 and thus encompass any changes present in this release.

Version 2.5.2 (2015-03-20)

• Fix: Correct problems with adapter-based recycling of drawables and interop with external libraries like RoundImageView.

Version 2.5.1 (2015-03-19)

• Specifying transformations in a request now accepts a list.
• Fix: Correctly handle null values from content providers.
• Fix: Ensure contact photo thumbnail Uris are loaded with the correct request handler.
• Fix: Eliminate potential (albeit temporary) memory leak on pre-5.0 Android due to message pooling.
• Fix: Prevent placeholder image aspect ratio from changing while crossfading in image.

Version 2.5.0 (2015-02-06)

• Update to OkHttp 2.x's native API. If you are using OkHttp you must use version 2.0 or newer (the latest is 2.2 at time of writing) and you no longer need to use the okhttp-urlconnection shim.
• Memory and Network policy API controls reading and storing bitmaps in memory and/or disk cache.
• Allow returning InputStream from RequestHandler.
• Allow removing items from memory cache using clearKeyUri.
• fetch() can now accept a Callback.
• Provide option with onlyScaleDown to perform scaling only if the source bitmap is larger than the target.
• Fix: Potential workaround handling improperly cached responses with unknown Content-Length. (#632)
• Fix: Ensure resized images completely fill ImageView (#769)
• Fix: Properly report correct exception when disk cache fails to load (504 gateway error).
• Fix: Resize now properly maintains aspect ratio if width or height is 0.
• Fix: Update debug indicators for the visually impaired (blue color instead of yellow for disk cache hits).

Version 2.4.0 (2014-11-04)

• New RequestHandler beta API adds support for custom bitmap loading.
• priority API for setting request priority. By default fetch() requests are set to Priority.LOW.
• Requests can now be grouped with a tag and can be batch paused, resumed, or canceled.
• Resizing with either height or width of 0 will now maintain aspect ratio.
• Picasso.setSingletonInstance allows setting the global Picasso instance returned from Picasso.with.
• Request stableKey provides an override value for the URI or resource ID when caching.
• Fix: Properly calculate sample size for requests with centerInside().
• Fix: ConcurrentModificationException could occur in the Dispatcher when submitting a request.
• Fix: Correctly log when a request was canceled due to garbage collection.
• Fix: Provide correct target for RemoteViews requests.
• Fix: Propagate exceptions thrown from custom transformations.
• Fix: Invoking shutdown() now will close the disk cache.

Version 2.3.4 (2014-08-25)

• Fix: Revert fail fast when missing internet permission.
• Fix: Account for null paths when naming a Request.
• Add API to allow canceling of remote views requests.

Version 2.3.3 (2014-07-21)

• Fix: Crash when attempting to swap dimension for EXIF transformation.
• Fix: Properly honor alpha value in PicassoDrawable.
• Fix: Use getWidth() and getHeight() instead of getMeasuredWidth() and getMeasuredHeight() during fit().

Version 2.3.2 (2014-06-05)

• Fix: Correctly invalidate PicassoDrawable for GB.
• Fix: Attempt to decode responses with missing Content-Length header.
• Fix: Prevent race condition to initial with() call.

Version 2.3.1 (2014-05-29)

• Fix: Deprecated Response constructor used 0 for content-length.

Version 2.3.0 (2014-05-29)

• Requests will now be automatically replayed if they failed due to network errors.
• Add API for logging. This is mostly useful for debugging Picasso itself.
• Add API for loading images into remote views (notifications and widgets).
• Stats now provide download statistics.
• Updated to use Pollexor 2.0.
• When using OkHttp version 1.6 or newer (including 2.0+) is now required.
• MediaStoreBitmapHunter now properly returns video thumbnails if requested URI is for a video.
• All API calls now properly validate the current thread they must run on.
• Performance: Various optimizations for reducing object allocations.
• Fix: Stats were incorrectly invoked even if the bitmap failed to decode.
• Fix: Handle null intent case in network broadcast receiver extras.
• Fix: Target now correctly invokes bitmap failed if an error drawable or resource is supplied.

Version 2.2.0 (2014-01-31)

• Add support decoding various contact photo URIs.
• Add support for loading android.resource URIs (e.g. load assets from other packages).
• Add support for MICRO/MINI thumbnails for media images.
• Add API to supply custom Bitmap.Config for decoding.
• Performance: Reduce GC by reusing same StringBuilder instance on main thread for key creation.
• Performance: Reduce default buffer allocation to 4k for MarkableInputStream.
• Fix: Detect and decode WebP streams from byte array.
• Fix: Non-200 HTTP responses will now display error drawable if supplied.
• Fix: All exceptions during decode will now dispatch a failure.
• Fix: Catch OutOfMemory errors, dispatch a failure, and output stats in logcat.
• Fix: fit() now handles cases where either width or height was not zero.
• Fix: Prevent crash from null intent on NetworkBroadcastReceiver.
• Fix: Honor exif orientation when no custom transformations supplied.
• Fix: Exceptions during transformations propagate to the main thread.
• Fix: Correct skia decoding problem during underflow.
• Fix: Placeholder uses full bounds.

Version 2.1.1 (2013-10-04)

• Target now has callback for applying placeholder. This makes it symmetric with image views when using into().
• Fix: Another work around for Android's header decoding algorthm readin more than 4K of image data when decoding bounds.
• Fix: Ensure default network-based executor is unregistered when instance is shut down.
• Fix: Ensure connection is always closed for non-2xx response codes.

Version 2.1.0 (2013-10-01)

Duplicate of v2.0.2. Do not use.

Version 2.0.2 (2013-09-11)

• Fix: Additional work around for Android's header decoding algorithm reading more than 4K of image data when decoding bounds.

Version 2.0.1 (2013-09-04)

• Enable filtered bitmaps for higher transform quality.
• Fix: Using callbacks with into() on fit() requests are now always invoked.
• Fix: Ensure final frame of cross-fade between place holder and image renders correctly.
• Fix: Work around Android's behavior of reading more than 1K of image header data when decoding bounds for some images.

Version 2.0.0 (2013-08-30)

• New architecture distances Picasso further from the main thread using a dedicated dispatcher thread to manage requests.
• Request merging. Two requests on the same key will be combined and the result will be delivered to both at the same time.
• fetch() requests are now properly wired up to be used as "warm up the cache" type of requests without a target.
• fit() will now automatically wait for the view to be measured before executing the request.
• shutdown() API added. Clears the memory cache and stops all threads. Submitting new requests will cause a crash after shutdown() has been called.
• Batch completed requests to the main thread to reduce main thread re-layout/draw calls.
• Variable thread count depending on network connectivity. The faster the network the more threads and vice versa.
• Ability to specify a callback with ImageView requests.
• Picasso will now decode the bounds of the target bitmap over the network. This helps avoid decoding 2000x2000 images meant for 100x100 views.
• Support loading asset URIs in the form file:///android_asset/....
• BETA: Ability to rewrite requests on the fly. This is useful if you want to add custom logic for wiring up requests differently.

Version 1.1.1 (2013-06-14)

• Fix: Ensure old requests for targets are cancelled when using a null image.

Version 1.1.0 (2013-06-13)

• load method can now take a Uri.
• Support loading contact photos given a contact Uri.
• Add centerInside() image transformation.
• Fix: Prevent network stream decodes from blocking each other.

Version 1.0.2 (2013-05-23)

• Auto-scale disk cache based on file system size.
• placeholder now accepts null for clearing an existing image when used in an adapter and without an explicit placeholder image.
• New global failure listener for reporting load errors to a remote analytics or crash service.
• Fix: Ensure disk cache folder is created before initialization.
• Fix: Only use the built-in disk cache on API 14+ (but you're all using OkHttp anyways, right?).

Version 1.0.1 (2013-05-14)

• Fix: Properly set priority for download threads.
• Fix: Ensure stats thread is always initialized.

Version 1.0.0 (2013-05-14)

Initial release.