Glide is a fast and efficient open source media management and image loading framework for Android that wraps media decoding, memory and disk caching, and resource pooling into a simple and easy to use interface.
Glide supports fetching, decoding, and displaying video stills, images, and animated GIFs. Glide includes a flexible API
that allows developers to plug in to almost any network stack. By default Glide uses a custom HttpUrlConnection
based
stack, but also includes utility libraries plug in to Google's Volley project or Square's OkHttp library instead.
Glide's primary focus is on making scrolling any kind of a list of images as smooth and fast as possible, but Glide is also effective for almost any case where you need to fetch, resize, and display a remote image.
You can download a jar from GitHub's releases page.
Or use Gradle:
repositories {
mavenCentral() // jcenter() works as well because it pulls from Maven Central
}
dependencies {
compile 'com.github.bumptech.glide:glide:4.0.0-RC0'
compile 'com.android.support:support-v4:25.3.1'
annotationProcessor 'com.github.bumptech.glide:compiler:4.0.0-RC0'
}
Or Maven:
<dependency>
<groupId>com.github.bumptech.glide</groupId>
<artifactId>glide</artifactId>
<version>4.0.0-RC0</version>
</dependency>
<dependency>
<groupId>com.google.android</groupId>
<artifactId>support-v4</artifactId>
<version>r7</version>
</dependency>
<dependency>
<groupdId>com.github.bumptech.glide</groupId>
<artifactId>compiler</artifactId>
<version>4.0.0-RC0</version>
<optional>true</optional>
</dependency>
For info on using the bleeding edge, see the Snapshots wiki page.
Depending on your ProGuard (DexGuard) config and usage, you may need to include the following lines in your proguard.cfg (see Configuration wiki for more details):
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public class * extends com.bumptech.glide.AppGlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
# for DexGuard only
-keepresourcexmlelements manifest/application/meta-data@value=GlideModule
Checkout the documentation for pages on a variety of topics, and see the javadocs.
For Glide v3, see the wiki.
Simple use cases with Glide's generated API will look something like this:
// For a simple view:
@Override public void onCreate(Bundle savedInstanceState) {
...
ImageView imageView = (ImageView) findViewById(R.id.my_image_view);
GlideApp.with(this).load("http://goo.gl/gEgYUd").into(imageView);
}
// For a simple image list:
@Override public View getView(int position, View recycled, ViewGroup container) {
final ImageView myImageView;
if (recycled == null) {
myImageView = (ImageView) inflater.inflate(R.layout.my_image_view, container, false);
} else {
myImageView = (ImageView) recycled;
}
String url = myUrls.get(position);
GlideApp
.with(myFragment)
.load(url)
.centerCrop()
.placeholder(R.drawable.loading_spinner)
.into(myImageView);
return myImageView;
}
Version 3 on the 3.0
branch is a stable public release used in multiple open source projects at Google including in the Android Camera
app and in the 2014 Google IO app. Version 4 is currently under development on the master
branch.
Comments/bugs/questions/pull requests are always welcome! Please read CONTRIBUTING.md on how to report issues.
- Android SDK: Glide requires a minimum API level of 10.
- OkHttp 2.x: there are optional dependencies available called
okhttp-integration
, see Integration Libraries wiki page. - OkHttp 3.x: there are optional dependencies available called
okhttp3-integration
, see Integration Libraries wiki page. - Volley: there are optional dependencies available called
volley-integration
, see Integration Libraries wiki page. - Round Pictures:
CircleImageView
/CircularImageView
/RoundedImageView
are known to have issues withTransitionDrawable
(.crossFade()
with.thumbnail()
or.placeholder()
) and animated GIFs, use aBitmapTransformation
(.circleCrop()
will be available in v4) or.dontAnimate()
to fix the issue. - Huge Images (maps, comic strips): Glide can load huge images by downsampling them, but does not support zooming and panning
ImageView
s as they require special resource optimizations (such as tiling) to work withoutOutOfMemoryError
s.
Building Glide with gradle is fairly straight forward:
git clone git@github.com:bumptech/glide.git # use https://github.com/bumptech/glide.git if "Permission Denied"
cd glide
git submodule init && git submodule update
./gradlew jar
Note: Make sure your Android SDK has the Android Support Repository installed, and that your $ANDROID_HOME
environment
variable is pointing at the SDK or add a local.properties
file in the root project with a sdk.dir=...
line.
Follow the steps in the Build section to setup the project and then:
./gradlew :samples:flickr:run
./gradlew :samples:giphy:run
./gradlew :samples:svg:run
You may also find precompiled APKs on the releases page.
Follow the steps in the Build section to setup the project and then edit the files however you wish. Intellij IDEA 14 cleanly imports both Glide's source and tests and is the recommended way to work with Glide.
To open the project in IntelliJ IDEA:
- Go to File menu or the Welcome Screen
- Click on Open...
- Navigate to Glide's root directory.
- Select
build.gradle
To report a specific problem or feature request, open a new issue on Github. For questions, suggestions, or anything else, email Glide's discussion group, or join our IRC channel: irc.freenode.net#glide-library.
Before submitting pull requests, contributors must sign Google's individual contributor license agreement.
- The Android team and Jake Wharton for the disk cache implementation Glide's disk cache is based on.
- Dave Smith for the GIF decoder gist Glide's GIF decoder is based on.
- Chris Banes for his gradle-mvn-push script.
- Corey Hall for Glide's amazing logo.
- Everyone who has contributed code and reported issues!
Sam Judd - @sjudd on GitHub, @samajudd on Twitter
BSD, part MIT and Apache 2.0. See the LICENSE file for details.
This is not an official Google product.