All Versions
11
Latest Version
Avg Release Cycle
69 days
Latest Release
80 days ago

Changelog History
Page 1

  • v4.10.0

    September 18, 2019

    πŸ”‹ Features

    • βž• Added a Mocks library to mock GlideExecutor in unit/emulator tests (e021f6b)
    • βž• Added an integration library to integrate with Guava's ListenableFuture class (9fb1036)
    • βž• Add granular options for rounded corners (f36a9fa, thanks to dlos@)
    • Include day/night mode in resource id cache keys (1b391c4)
    • βž• Add an API that can be called on Glide manually to clear memory, especially when apps are backgrounded (8a094e9, thanks to mikewallstedt@)
    • βž• Add simple support for wide gamut color spaces (15a21b1, 7910f68)
    • πŸš€ Release more memory in the background on M+ (525e7ba)
    • πŸ‘Œ Support Fragments not hosted by Acitivities (71359c7, thanks to Daniel Tomasiewicz)
    • πŸ– Handle contexts with null application contexts (31b501d, thanks to Daniel Tomasiewicz)

    πŸ› Bugs

    • πŸ›  Fixed incorrect downsampling for rotated images when using Target.SIZE_ORIGINAL (79dac0d, thanks to sonyamollinger@)
    • πŸ›  Fixed returning negative byte values converting ByteBuffers to InputStreams (24f9c28, thanks to sonyamollinger@)
    • πŸ‘‰ Make sure to cancel all preload requests in cancelAll() (047c22d, thanks @paynemiller92)
    • πŸ›  Fixed a series of concurrency bugs introduced by allowing requests to start on background threads (bee6348, 5cccdfb, 01ea6a5, b2a46ef, 6dc03d8, 4de2cda, b96b000, 8907122, 53438b9)
    • πŸ‘‰ Make sure the specified numbers of threads are actually used in the animation executor (#3575, ac4aa53, thanks to @yuriy-budiyev)
    • Avoid blinking when calling RequestManager#pause when the thumbnail portion of a request is complete the full portion is still running (2f56153)
    • πŸ‘‰ Make it less likely to mix support and non-support fragments (2193306, thanks to @limuyang2)
    • Avoid downsampling incorrectly in FitCenter and CenterInside when there was
      an exact power of 2 match in one dimension but not the other (3df5445)
    • Always use orientation corrected sizes in Downsampler (#3673, ebdf8be)
    • πŸ›  Fix transparency in GifDecoder when using RGB_565 (29c553d, thanks to @lihongyu)
    • πŸ”’ Handle security exceptions trying to open MediaStore Uris when applications are given access to a MediaStore Uri via an Intent (#3504, 9c48b48)
    • πŸ›  Fix an unused AnimationExecutor (7bb6f11, thanks to @phxnirvana)

    πŸ—„ Deprecations

    • πŸ—„ Deprecate method to set custom tags in CustomViewTarget (c8d646e)

    Behavior Changes

    • Custom tags in CustomViewTarget are now ignored because they cause Glide to ignore calls to clear() (c8d646e)

    πŸ’₯ Breaking Changes

    πŸ— Build Changes

  • v4.9.0

    February 14, 2019

    πŸ”‹ Features

    • πŸ‘ Allow applying RequestOptions directly in a RequestBuilder without the generated API (ed20643)

    For example previously to apply centerCrop you'd have use a static method and apply():

    Glide.with(fragment) .load(url) .apply(centerCropTransform()) .into(imageView);
    

    Or use the generated API and the annotation processor:

    GlideApp.with(fragment) .load(url) .centerCrop() .into(imageView);
    

    After this change, even without the generated API/annotation processor you can access standard RequestOptions methods directly:

    Glide.with(fragment) .load(url) .centerCrop() .into(imageView);
    

    The generated API is still required for API extensions and to include integration libraries. Hopefully this makes it easier for users who do not include integration libraries and for developers of libraries that are currently unable to use the generated API to use Glide.

    • βž• Add Global/Activity/Fragment scoped RequestListeners (37127f0)
    • βž• Add a CustomTarget class to make it easier to reduce some non-essential boilerplate when implementing custom Targets. onLoadCleared still must be implemented by subclasses of CustomTarget (b3b2d7a)
    • πŸ‘Œ Support loading resources from dynamic modules (#3308, b57ef34, thanks to @SUPERCILEX)
    • βž• Add a varargs .transform() method to replace the equivalent .transforms() method (#2875, #3365, 8a26a6b, thanks to @aleien)
    • πŸ‘‰ Make proguard rules consumable by users of the library (f7d8604, thanks to @rehlma)
    • πŸ’» Stop forcing all requests to be posted to the main thread to avoid unnecessary UI thread work and avoid delays caused by UI thread processing time for images loaded on background threads (8f1ea5c)
    • βž• Add Animatable2Compat callbacks to GifDrawable so that users can be notified when a GIF animation with a non infinite loop count finishes (#3438, a150301, thanks to @AnwarShahriar)

    πŸ› Bugs

    • πŸ›  Fixed an issue where different types of requested resources (Bitmap vs Drawable etc) could share a cache key (cad83d2)
    • β†ͺ Work around an odd compiler bug creating new ArrayLists from other collections on some devices/versions of Android (#3296, 2ca790a)
    • βž• Add Nullable/NonNull annotations to LazyHeaders.Builder (#3446, d6345fb, thanks to @r-ralph)
    • βž• Add a transformation to rotate images (other than from EXIF) (1878585, thanks to @Gnzlt)
    • πŸ›  Fix a race that could lead to doing useless work in MultiModelLoader after cancellation (3c9f92f)
    • πŸ›  Fix a bug in SizeConfigStrategy that could lead to a returned Bitmap having an incorrect config (be51b4e)
    • Avoid classifying all images with non-0 exif orientations as having transparency to allow them to be cached as JPEGs instead of PNGs (e515f47)
    • βž• Add a debug API that allows apps to attach a stack trace showing where a Glide request originated from. Note that this is fairly expensive and isn't meant to be used in production (114b885)
    • πŸ›  Fix bugs handling resource Uris that point to resources in other applications (e2df4d0)

    πŸ—„ Deprecations

    • πŸ—„ Deprecated .transforms(), it's replaced with the identical .transform() method (8a26a6b)

    Behavior Changes

    • RequestListeners for requests started on background threads can now be called on a background thread (8f1ea5c)

    πŸ’₯ Breaking Changes

    • Subclasses of RequestBuilder/RequestOptions may be broken by ed20643. Typically the breakage is relatively simple to fix, but the exact methods that need to be called or that are exposed may have changed for subclasses.

    πŸ— Build Changes

  • v4.8.0

    August 16, 2018

    πŸ”‹ Features

    • Multiple RequestListeners can be added to a single request (9328999, thanks to Adrian)
    • βž• Added a safer version of Glide's base target methods that force callers to implement onLoadCleared and deprecated the unsafe versions. Failing to implement onLoadCleared in
      a Target can lead to UIs displaying incorrect images, runtime exceptions, or various other resource re-use errors (3a70607, thanks to azlatin@).

    πŸ› Bugs

    • πŸ‘ HEIF orientation is supported on O MR1 and higher via ExifInterface (a3f8114)
    • πŸ‘Œ Improved error message for network failures (#2894, ff463d7)
    • Placeholder/error/fallback drawable and id variants now replace previous calls to the same method with the other variant. For example, placeholder(Drawable) will replace previous calls to .placeholder(R.id.xyz)(2dccb5c)
    • πŸ‘Œ Improved synchronization in ModelLoaderRegistry (62e6c11, thanks to @jnlopar)

    πŸ—„ Deprecations

    • πŸš€ Deprecated SimpleTarget and ViewTarget, see the CustomViewTarget description in Features in these release notes for more detail.

    Behavior Changes

    • Requests that are started with a paused RequestManager, usually in a paused Activity or Fragment, are immediately paused so that they display a placeholder instead of nothing (a55e935)

    πŸ’₯ Breaking Changes

    • The deprecated PREFER_ARGB_8888_DISALLOW_HARDWARE DecodeFormat has been removed. Use RequestOptions#disallowHardwareConfig() instead (7eb59f7)
    • βœ‚ Remove pause() and isPaused() from the internal Request interface (9089752)
    • πŸš€ Glide now uses resource ids (in CustomViewTarget) and therefore can no longer be released as a straight jar.

    πŸ— Build Changes

    • βž• Added support for androidx annotations (c3328fe, thanks to @colinrtwhite)
    • ⚑️ Updated to Android Gradle 3.1.3.
  • v4.7.1

    April 13, 2018
  • v4.7.0

    April 10, 2018

    πŸ”‹ Features

    • βž• Added support for data Uris when they're provided as Uris (17c1c3d)
    • πŸ‘Œ Improved scrolling performance by optimizing some Glide internal calls (7664c82, d7635bd, 7ff3bde, thanks to paulsowden@)
    • βž• Added support for downsampling in VideoBitmapDecoder (97d130d)
    • 0️⃣ Provide better default names for annotation generated classes (58bcf53, thanks to @SUPERCILEX)

    πŸ› Bugs

    • πŸ‘Œ Improved handling of cancellation in VolleyStreamFetcher (a690f38)
    • Improved handling of TRIM_MEMORY_RUNNING_CRITICAL (d939314, thanks to @ygnessin)
    • 0️⃣ Avoid delaying the first few requests started in Fragments or Activities by defaulting RequestManagers to started when the containing Activity or Fragment is started (7d1898e)
    • πŸ›  Fixed failures in annotation processor for classes with _ in the package name (99723e3, thanks to @TWiStErRob)
    • πŸ‘ Obey themes when retrieving drawables when the appcompat support library is present (5212e95, thanks to @julianostarek)
    • πŸ›  Fixed a bug that could cause loading another application's launcher icon to fail if the calling application's support library version didn't match exactly (f508d7c)
    • πŸ›  Fixed a bug where a pixel was swapped in the output of GifDecoder (7fb8b12, thanks to @mtopolnik)

    Behavior Changes

    • VideoBitmapDecoder will now obey DownsampleStrategy (97d130d)
    • Preload ahead the first page when using the RecyclerView or ListView preloader before the user scrolls for the first time (dd7fe18, thanks to Anton111111)

    πŸ’₯ Breaking Changes

    • πŸ— Made GlideBuilder.build package private (914060e)
    • πŸ—„ Deprecated non-support fragments (29d481c, thanks to @jaredsburrows)
    • βœ‚ Removed deprecated constructors in transformation implementations (05e3215, b68ba43, 2d0bc2d)
    • βœ‚ Removed ComponentsCallbacks from RequestManager (1937b05)

    πŸ— Build Changes

  • v4.6.1

    February 02, 2018

    πŸ›  This is a bugfix release of Glide 4.6.0

    πŸ› Bugs

    πŸ›  Fixes an issue where pom files in the 4.6.0 release did not list the appropriate dependencies for Glide's various components (#2863)

  • v4.6.0

    February 01, 2018

    πŸš€ This is the January release of Glide.

    πŸ”‹ Features

    • πŸ‘‰ Use buffered streams when writing Bitmap data (860f7d0)
    • Allow re-using ARGB_8888 and RGBA_F16 Bitmaps via re-configuration (2cd953c, 17e0943)

    πŸ› Bugs

    • Return the correct size of RGBA_F16 Bitmaps in Util.getBitmapByteSize to avoid obtaining incorrectly sized Bitmaps for re-use in Downsampler (a198ef6)
    • Avoid converting RGBA_F16 Bitmaps to ARGB_8888 when running transformations that add transparent pixels (73277df)
    • πŸ‘» Avoid an exception when loading remote images that aren't yet in the cache as Files with DiskCacheStrategy.AUTOMATIC (0917ef3, #2824)
    • Avoid inefficiently trying identical parts of load paths multiple times (9d3a6ff, thanks to paulsowden@)

    Behavior Changes

    • Wide gamut PNGs that were decoded as RGBA_F16 even when BitmapFactory’s inConfig was set to ARGB_8888 may be affected by improved handling of RGBA_F16 when decoding and transforming images. If you see any issues decoding or transforming PNGs on Android O or higher, please file an issue so we can investigate.

    πŸ’₯ Breaking Changes

    • βž• Added correct Nullable annotations to all generated classes (35f6a0a, thanks to @SUPERCILEX)
    • βž• Added correct Nullable annotations to RequestManager and other manager classes (bfa237c, thanks to @SUPERCILEX)
    • βž• Add Nullable annotations to the load package (e9f682f, thanks to @SUPERCILEX)

    πŸ— Build Changes

    • πŸš€ Cut build times for Glide by around a factor of two by parallelizing static analysis and unit test tasks on the main library package and removing the redundant release variants across all modules (3968ccb, 1c7434a, 3af80f4, 95637cf)
  • v4.5.0

    January 05, 2018

    πŸš€ This is the December release of Glide.

    πŸ”‹ Features

    • βž• Add an API to pause all requests for a given Activity or Fragment to allow callers to manually reduce memory when their Fragment or Application is backgrounded (@kurtisnelson, 09e33a2)
    • πŸ‘ Fully support Bitmap re-use for RGBA_F16 Bitmaps. Previously Glide supported decoding RGBA_F16 Bitmaps, but would not re-use any stored in the BitmapPool when doing so (cc0288c)
    • πŸ‘Œ Support decoding Videos from resources as AssetFileDescriptors (6e9866b)
    • βž• Added support for the MediaMetadataRetriever#getScaledFrameAtTime method added in OMR1 to marginally reduce memory usage when decoding video frames (ded8f77)
    • πŸ‘Œ Support transcoding BitmapDrawables to byte[]s (015d265)

    πŸ› Bugs

    • Cleaned up old and incorrect @TargetApi annoatations (@SUPERCILEX, 6778396)
    • βž• Added @Nullable and @NonNull annotations to many of Glide's APIs (@SUPERCILEX, dc12b60, c3dafde, 0cffd1d, f541b65, 36e0b80, 650bb77, bd2f215, e35a73b, f37ced1, bb96b63, 276d4ff, c310780, )
    • πŸ›  Fixed a case where restarting an identical request with skipMemoryCache(true) would complete the load from the memory cache (#2663, 3dc1d18)
    • πŸ›  Fixed decoding interlaced and downsampled GIFs as static images (#2698, b64f23d)
    • βž• Added more models to the list of devices requiring a lock when decoding or drawing Bitmaps (@strooooke, #738, c809f7e, e923554)
    • πŸ›  Fixed a race condition where starting multiple loads simultaneously the first time any request is made for a given model and resource could lead to NPEs (#2708, d427cbd)
    • 🏁 Make the annotation processor tests pass on Windows (@SUPERCILEX, #2709, 2b4be8b)
    • πŸ›  Fix NPE and RuntimeExceptions thrown in DefaultConnectivityMonitor on some devices (c902730)
    • Only trim to half of the memory cache maximum size, not the current size, when background the app (@kurtisnelson, 429b7e2)
    • πŸ›  Fix a StateVerifier exception thrown when ResourceEncoder implementations unexpectedly throw exceptions while writing resources to Glide's disk cache (6c7cf3f)
    • πŸ›  Fix an NPE error message when ResourceDrawableDecoder fails to decode an image (d522ac7)
    • πŸ›  Fix an IllegalStateException if a request using .error() is cleared while the error request is running (#2767, 9c70aa5)
    • Cleaned up a number of accessor classes generated by unnecessarily strict visibility in inner classes (@TWiStErRob, e029694)
    • ⚑️ Updated OkHttp and removed a no longer necessary workaround for ClassCastExceptions thrown by the Android framework on O (#2355, 642b2dc)
    • βž• Added missing annotations to overrides on some of Glide's generated classes (@TWiStErRob, 62d7464, 9fde006, d7bb6f9)
    • Avoid throwing exceptions when LruBitmapPool was asked to provide Bitmaps with a null config (c1036c1)

    Behavior Changes

    • ⚠ Default to aar packaging in POMs, so @aar should no longer be required to avoid warnings about jars depending on aars (06ba344)
    • 0️⃣ Default active resource retention to false (73759b9), but leave the option in GlideBuilder to manually enable it. Enabling active resource retention can lead to recycled Bitmap errors or Bitmap re-use bugs if applications call Bitmap.recycle() on any images loaded by Glide or mutate the contents of Bitmaps loaded by Glide.
    • Treat devices with API < 19 as having ActivityManager.isLowRam set to true (#2650, b221d4b)

    πŸ’₯ Breaking Changes

    • βœ‚ Removed deprecated constructors requiring Contexts in most of Glide's default Transformation (23975d9, 733b2e0, 9bedc2b, 55594ba, d8f6224, d840533, 2f76842, 144ac53, 150ebab, 92d761d, a6f1b1c)
    • πŸš€ The @NonNull and @Nullable annotations added in this release may break builds that depend on compiler plugins that do static nullability analysis, typically due a lack of annotations on any implemenations you might have of Glide's interfaces.

    πŸ—„ Deprecations

    πŸ— Build Changes

  • v4.4.0

    December 04, 2017

    πŸš€ This is the November release of Glide.

    πŸ”‹ Features

    • ⚑️ Updated Glide's generated API to allow RequestOptions return values and avoid a bunch of @CheckResult warnings (e78f2ee, 7fccb32)
    • Enabled cache sizes > Integer.MAX_VALUE (d402780, thanks to @bhargavms)
    • βž• Added an API to ViewTarget called clearOnDetach() that allows you to optionally clear and restart requests when the corresponding view is detached and reattached to its window (#2520, d0fd967):

      Glide.with(fragment) .load(url) .into(imageView) .clearOnDetach();

    • βž• Added an API to ViewTarget called waitForLayout() that simplifies the previous mechanism for forcing Glide's ViewTargets to wait for a layout pass before determining the size of the view they wrap (05b8854):

      Glide.with(fragment) .load(url) .into(imageView) .waitForLayout();

    • βž• Added a MockGlideExecutor that could be used as part of a future testing compat library (6cee6d2, thanks to azlatin@)

    • βž• Added an API to specify a custom executor to use when decoding GIF frames (6837543)

    πŸ› Bugs

    • πŸ‘Œ Improved trimming behavior with inconsistent resource sizes (#2550, thanks to @unverbraucht)
    • πŸ›  Fixed overly aggressive escaping of some valid characters in http urls (#2583, 014bf44)
    • βž• Added a direct dependency on support-fragment in Glide's pom (#2547, c1c9be2)
    • πŸ›  Fixed an issue where dereferencing a Target without clearing it would result in the loaded resource never being returned to Glide's memory cache (#2560, 0209662, 7e317c0)
    • πŸ›  Fixed an IllegalStateException when RequestManagers are memoized and then used to start a new load after onDestroy of the corresponding Activity or Fragment (#2262, 8119837)
    • πŸ›  Fixed an NPE when using GifDrawables as thumbnails due to a bug that can fail to clear thumbnails in onStop() (#2555, 9c82c42)
    • πŸ›  Fixed a SecurityException on some devices when trying to register a connectivity receiver (#1417, 6bc908b)
    • πŸ›  Fixed a SecurityException on some devices when trying to obtain connectivity status (#1405, bcd6cc2)
    • πŸ›  Fixed a couple of cases where GifDrawables could continue to animate after clear() or onStop() (#1087, 3dad449, 9d87dea)
    • πŸ‘Œ Improved decode times for GIF frames on earlier versions of ART and some lower end devices by up to 40% (#2471, e7a4942, fa2ebfe, 7c0cd63, 4db20db, 65e5506)
    • Eliminated a few unnecessary object allocations in Glide's request path (b4d778b)
    • πŸ›  Fixed an issue on some devices where ExternalPreferredCacheDiskCacheFactory.java might attempt (and fail) to use external storage if the external storage directory exists but isn't writable (#2641, 5580e51, thanks to @ANPez)
    • Ensure that requests started with onlyRetrieveFromCache don't block on already running equivalent requests that aren't using onlyRetrieveFromCache (#2428, 108a062)
    • πŸ›  Fixed a couple of cases where calling load(Bitmap) or load(Drawable) could cause Glide to re-use or recycle the given Bitmap or Drawable (cff4f2c).
    • πŸ›  Fixed a bug where the disk cache could become unusable until apps are restarted if the system clears the cache directory while the app is open and the app calls DiskCache.clear() (#2465, 16eaa9b).
    • πŸ›  Fix a crash attempting to log a recycled Bitmap's size in Glide's BitmapPool pre-filling APIs (#2574, 7387298)
    • πŸ›  Fixed an error log "Expected to receive an object of but instead got null" when restarting requests with thumbnails where the thumbnail previously completed after the full request (a1e3fa2)
    • πŸ›  Fixed a compilation error when compiling with kapt and -Dkotlin.compiler.execution.strategy="in-process" while using a GlideModule with the @Excludes annotation.

    Behavior Changes

    Resources loaded into Targets outside of Activity/Fragment lifecycles (ie with the Application Context) will be returned to Glide's caches via a WeakReference and ReferenceQueue if the Targets are dereferenced without being cleared. Previously dereferencing these Targets would simply allow the underlying resource to be garbage collected, which could lead to unexpected cache misses (#2560). Transient memory usage may increase for applications that regularly dereference Targets without clearing them as the resources are now re-captured instead of being immediately and unexpectedly garbage collected.

    πŸ”§ To disable this behavior, in an AppGlideModule, call setIsActiveResourceRetentionAllowed:

    @Overridepublic void applyOptions(Context context, GlideBuilder builder) { builder.setIsActiveResourceRetentionAllowed(false); }
    

    Glide.with(fragment).load() and Glide.with(fragment).asDrawable().load() now behave identically. Previously Glide.with(fragment).asDrawable().load() would apply some specific options based on the type of the model provided to load(), but Glide.with(fragment).load() would not. Now both behave identically (8613292).

    Calling RequestBuilder.load(byte[]) will no longer override previously set DiskCacheStrategy and skipMemoryCacheOptions options (c7b7dfe).

    πŸ’₯ Breaking Changes

    • βœ… The RequestManager.load(Object) method has been augmented with the same type specific overloads that are available on RequestBuilder. Unfortunately this may break some tests that mock the return value of RequestManager.load(). Typically those breakages can be resolved by casting:

      when(requestManager.load((Object) any())).thenReturn(requestBuilder);

    βœ… Or if you're passing in null as your model in your tests:

     when(requestManager.load((Object) null)).thenReturn(requestBuilder);
    

    Or if you have a specific type for your model:

     when(requestManager.load(any(Uri.class))).thenReturn(requestBuilder);
    

    βœ… Or if your test has a specific type, but your production code uses an Object:

    // In tests:String url = ... when(requestManager.load((Object) eq(url))).thenReturn(requestBuilder); // In prod code:Object url = ... requestManager.load(url).into(imageView);
    

    πŸ—„ Deprecations

    • πŸ—„ Deprecated void return values for @GlideOption and @GlideType annotated methods (e78f2ee, 7fccb32)
    • πŸ—„ Deprecated DiskLruCacheWrapper.get() in favor of a static factory method (1cfc4af)
    • πŸ—„ Deprecated setResizeExecutor() in GlideBuilder in favor of setSourceExecutor() (6837543)
    • πŸ—„ Deprecated ArrayPool.put(Array, Class<Array>) in favor of ArrayPool.put(Array) (b4d778b)
    • πŸ—„ Deprecated the constructor in ViewTarget that accepts a boolean waitForLayout parameter in favor of the waitForLayout() method on ViewTarget (05b8854).
  • v4.3.1

    November 06, 2017

    πŸš€ This is a bug fix release of Glide 4.3.0.

    πŸ›  Bugfixes

    • πŸ›  Fix ghosting in animated GIFs with certain combinations of disposal settings and frames (c3d0530, #2521, thanks to @michaeimm)
    • πŸ›  Fix a Bitmap re-use bug causing graphical errors, load failures and/or crashes when loading Drawables with a transformation applied that didn't actually change the image for the requested width and height.
      (2371aa6)
    • πŸ›  Fix a race condition causing animated Drawables not to be started when loaded into Views from Glide's memory cache (aa2711b, #2541)