Glide
| View Glide's documentation | 简体中文文档 | Report an issue with Glide
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.
Download
For detailed instructions and requirements, see Glide's download and setup docs page.
You can download a jar from GitHub's releases page.
Or use Gradle:
repositories {
google()
mavenCentral()
}
dependencies {
implementation 'com.github.bumptech.glide:glide:5.0.9'
}
Or Maven:
<dependency>
<groupId>com.github.bumptech.glide</groupId>
<artifactId>glide</artifactId>
<version>5.0.9</version>
</dependency>
For info on using the bleeding edge, see the Snapshots docs page.
R8 / Proguard
The specific rules are already bundled into the aar which can be interpreted by R8 automatically
How do I use Glide?
Check out the documentation for pages on a variety of topics, and see the javadocs.
For Glide v3, see the wiki.
Simple use cases will look something like this:
// For a simple view:
@Override public void onCreate(Bundle savedInstanceState) {
...
ImageView imageView = (ImageView) findViewById(R.id.my_image_view);
Glide.with(this).load("https://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);
Glide
.with(myFragment)
.load(url)
.centerCrop()
.placeholder(R.drawable.loading_spinner)
.into(myImageView);
return myImageView;
}
Status
Version 4 is now released and stable. Updates are released periodically with new features and bug fixes.
Comments/bugs/questions/pull requests are always welcome! Please read CONTRIBUTING.md on how to report issues.
Compatibility
- Minimum Android SDK: Glide v4 requires a minimum API level of 14.
- Compile Android SDK: Glide v4 requires you to compile against API 26 or later.
If you need to support older versions of Android, consider staying on Glide v3, which works on API 10, but is not actively maintained.
- OkHttp 3.x: There is an optional dependency available called
okhttp3-integration, see the docs page.
- Volley: There is an optional dependency available called
volley-integration, see the docs page.
- Round Pictures:
CircleImageView/CircularImageView/RoundedImageView are known to have issues with TransitionDrawable (.crossFade() with .thumbnail() or .placeholder()) and animated GIFs, use a BitmapTransformation (.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
ImageViews as they require special resource optimizations (such as tiling) to work without OutOfMemoryErrors.
Build
Building Glide with gradle is fairly straight forward:
git clone https://github.com/bumptech/glide.git
cd glide
./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.
Samples
Follow the steps in the Build section to set up the project and then:
./gradlew :samples:flickr:run
./gradlew :samples:giphy:run
./gradlew :samples:svg:run
./gradlew :samples:contacturi:run
You may also find precompiled APKs on the releases page.
Development
Follow the steps in the Build section to setup the project and then edit the files however you wish.
Android Studio cleanly imports both Glide's source and tests and is the recommended way to work with Glide.
To open the project in Android Studio:
- Go to File menu or the Welcome Screen
- Click on Open...
- Navigate to Glide's root directory.
- Select
setting.gradle
For more details, see the Contributing docs page.
Getting Help
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.
Contributing
Before submitting pull requests, contributors must sign Google's individual contributor license agreement.
Thanks
Author
Sam Judd - @sjudd on GitHub, @samajudd on Twitter
License
BSD, part MIT and Apache 2.0. See the LICENSE file for details.
Disclaimer
This is not an official Google product.
一个快速高效的 Android 开源媒体管理和图片加载框架：它把媒体解码、内存和磁盘缓存以及资源池化封装在一个简单的接口后面。